IZ43658: Recursive gs/lib or gs/lib64 link with data base agent install

APAR status

• Closed as program error.

Error description

• Customer is running ITM 6.2.1 on Linux R 2.6 and ITM for Oracle
  6.2 + FP01 + IF01. After configuring and starting the Oracle
  agent, both on 32-bit and 64-bit systems, a recursive link is
  created in /opt/IBM/ITM/<arch>/gs.
  .
  For 32-bit systems, the link looks like this:
     ls -l /opt/IBM/ITM/li6243/gs/lib64 | grep ^l
     lrwxrwxrwx  1 root root    26 Jan 14 11:38 lib ->
     /opt/IBM/ITM/li6243/gs/lib
  .
  For 64-bit systems, the link looks like this:
     ls -l /opt/IBM/ITM/lx8266/gs/lib64 | grep ^l
     lrwxrwxrwx  1 root root    28 Jan 21 13:45 lib64 ->
     /opt/IBM/ITM/lx8266/gs/lib64
  .
  

Local fix

Problem summary

• After initial configuration of the Oracle agent, any subsequent
  operation such as config, start, or stop creates a stray link in
  CANDLEHOME/<arch>/gs. The link resides in the lib or lib64
  directory (depending on the system), and the link points back to
  itself, like this:
  
     > # ls -l | grep ^l
     lrwxrwxrwx  1 root root      28 Jul  8 19:13 lib64 ->
  /opt/IBM/ITM/lx8266/gs/lib64
  
  The link is extraneous and can be removed. However, it will be
  recreated the next time config, start, or stop is performed for
  the agent. This problem exists for both 32-bit and 64-bit
  platforms. The problem also exists for any other data base
  agents.
  

Problem conclusion

• The code was changed to prevent the stray link from being
  created.
  
  
  Install Actions
  
  These are the steps to remove this link from the system:
  
  1: Run this command => find <CANDLEHOME>/*/gs -name "lib*" -exec
  ls -ld {} \; | grep ^l
  
   You will see something like:
      lrwxrwxrwx  1 root root      28 Jul  8 19:13 lib64 ->
  /opt/IBM/ITM/lx8266/gs/lib64
   or
      lrwxrwxrwx  1 root root      28 Jul  8 19:13 lib64 ->
  /opt/IBM/ITM/lx8266/gs/lib
  
  3. Remove the link ->
   unlink lib64
   unlink lib
  
  
  
  Before upgrading an ITM agent (such as ITM OS agent) or
  component to ITM 622 FP3 or higher.
  1. Stop the Oracle agent.
  
  2. Using the steps above, check if the recursive link exists and
  remove it.
  
  3. Upgrade the ITM agents or components.
  
  
  
  The fix for this APAR is included in the following maintenance
  vehicle:
      | interim fix | 6.2.1-TIV-ITM-IF0004
      | fix pack | 6.2.1-TIV-ITM-FP0003
  

Temporary fix

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

Fix information

• Fixed component name

  OMEG DIST INSTA

• Fixed component ID

  5608A41CI

Applicable component levels

• R621 PSY

     UP