View Source

{warning}*Deprecated* - Please install [GWME-7.1.1-11 - Foundation update with Advanced LDAP] instead.{warning}
h1. Problem

When groundwork is connected to ldap, there are 30-35 ldap calls made out to the LDAP servers.  This was causing slowness, sometimes up to 5 minutes connection time when opening cacti web interface, and other applications that are not part of the core groundwork product.

This problem has been tracked under GWMON-12850. This patch was designed to be compatible with both 7.1.0 and 7.1.1 and is referred to here [GWME-7.1.0-6 - LDAP Patch|SUPPORT:GWME-7.1.0-6 - LDAP Patch].

h1. Solution

Caching was developed into the code to catch any ldap objects after initial call, this stops any additional calls out to ldap that are not necessary after the initial load.  After putting this change in place, user permission changes will not be affected until a browser session times out or is closed.

h2. Automated Installation and rollback Instructions:

{warning}
WARNING: DO NOT REMOVE THE CONTENTS OF THE FILE WHEN RUNNING THE SH FILE.
{warning}
{panel}

*{_}Step 1{_}*: Download patch

{attachments:patterns=TB7.1.1-1.tar.gz-deprecated}


*{_}Step 2{_}*: Unzip the tar to a location that is accessible

*{_}Step 3{_}*: Elevate terminal to root

*{_}Step 4{_}*: Run the install file inside the folder.

*{_}Step 5{_}*: Follow the prompts.
{panel}

h2. Manual Installation Instructions:

*{_}Step 1:_* Download installation package, unzip and place in accessible location.

{attachments:patterns=TB7.1.1-8.tar.gz-deprecated}


{color:#000000}{*}{_}Step 2{_}{*}{color}{color:#000000}: Stop Groundwork{color}


{code}
/usr/local/groundwork/ctlscript.sh stop gwservices
{code}
*{_}Step 3:_* Create backup folder in the unzipped package directory.

{code}
mkdir gwbackupconfig
{code}
*{_}Step 4:_* Copy module.xml into backup folder

{code}
cp -f /usr/local/groundwork/foundation/container/jpp/modules/org/gatein/sso/main/module.xml gwbackupconfig
{code}

*{_}Step 5: _{*}Copy josso-ldap-identitystore-gwpatch-7.1.0.jar into backup folder

{code}
cp -f /usr/local/groundwork/foundation/container/josso-1.8.4/webapps/josso/WEB-INF/lib/josso-ldap-identitystore-gwpatch-7.1.0.jar gwbackupconfig
{code}


*{_}Step 6: _{*}Replace string content in /usr/local/groundwork/foundation/container/jpp/modules/org/gatein/sso/main/module.xml to reflect reference to latest jar file josso-ldap-identitystore-7.1.1-1.jar.


{code}
sed -i -e 's/josso-ldap-identitystore-gwpatch-7.1.0.jar/josso-ldap-identitystore-7.1.1-1.jar/g' '/usr/local/groundwork/foundation/container/jpp/modules/org/gatein/sso/main/module.xml'
{code}
*{_}Step 7:_* Remove old jar file and virtual link.

{code}
rm -rf /usr/local/groundwork/foundation/container/josso-1.8.4/webapps/josso/WEB-INF/lib/josso-ldap-identitystore-gwpatch-7.1.0.jar
{code}

*{_}Step 8:_* Copying new jar file into proper location.


{code}
cp -f josso-ldap-identitystore-7.1.1-1.jar  /usr/local/groundwork/foundation/container/josso-1.8.4/webapps/josso/WEB-INF/lib
{code}

*{_}Step 9:_*  Create virtual link to jar.


{code}
ln -s -f /usr/local/groundwork/foundation/container/josso-1.8.4/webapps/josso/WEB-INF/lib/josso-ldap-identitystore-7.1.1-1.jar /usr/local/groundwork/jpp/modules/org/gatein/sso/main/
{code}

*{_}Step 10:_*   Start GW services


{code}
/usr/local/groundwork/ctlscript.sh start gwservices
{code}

h2. Manual Rollback Instructions

{color:#000000}{*}{_}Step 1{_}{*}{color}{color:#000000}: Stop Groundwork{color}

{code}
/usr/local/groundwork/ctlscript.sh stop gwservices
{code}

*{_}Step 2:_* Remove upgraded jar
{code}
rm -rf /usr/local/groundwork/foundation/container/josso-1.8.4/webapps/josso/WEB-INF/lib/josso-ldap-identitystore-7.1.1-1.jar
{code}
*{_}Step 3:_* Restore module.xml
{code}
cp -f gwbackupconfig/module.xml /usr/local/groundwork/foundation/container/jpp/modules/org/gatein/sso/main
{code}
*{_}Step 4:_* Restore ldap jar file
{code}
cp -f gwbackupconfig/josso-ldap-identitystore-gwpatch-7.1.0.jar  /usr/local/groundwork/foundation/container/josso-1.8.4/webapps/josso/WEB-INF/lib
{code}
*{_}Step 5:_* Create virtual link to jar file


{code}
ln -s -f /usr/local/groundwork/foundation/container/josso-1.8.4/webapps/josso/WEB-INF/lib/josso-ldap-identitystore-gwpatch-7.1.0.jar /usr/local/groundwork/jpp/modules/org/gatein/sso/main/
{code}

*{_}Step 6:_* Start Groundwork Services

{code}
/usr/local/groundwork/ctlscript.sh start gwservices
{code}