IJ27215: WASIHS855UPLIFT.SH FAILS WHEN EXECUTED AS NON-ROOT USER

APAR status

• Closed as program error.

Error description

• When upgrading a TEPS installation as a non-root user, running
  wasihs855uplift.sh fail leaving the environment partially
  uplifted.
  Once the WAS and IHS components are in this state,
  WAS uplifted to 8.55.16 and IHS not uplifted, no further
  recovery action is possible without restoreing the installation
  from a prior back-up.
  Any attempted recovery action with out
  performing a restore, will cause the post-configuration jar
  file, WAS_IHS_855_Config.jar, to configure the WAS and IHS
  component incorrectly.
  
  RECREATE INSTRUCTIONS:
  NOTE: itmuser
  will be used as the non-root user for the rest of the recreate
  steps.
  NOTE: /opt/IBM/ITM2 will be used as the new ITM
  installation directory for the rest of the recreate
  steps.
  NOTE: These step apply only to TEPS suporrted platforms
  for Linux and AIX
  
  1) Login to the system as root
   a) Create
  itmuser if it does not already exist.
   b) Create /opt/IBM/ITM2
  if it does not already exist.
   c) Change the ownership of
  /opt/IBM/ITM2 to be owned by itmuser.
  
  2) Login to the system
  as itmuser
   a) Install the TEMS, TEPS and OS agent depending on
  the system from 063000700 media.
   b) Configure the TEMS.
   b)
  Configure the OS agent to connect to the TEMS.
  
  3) Login to
  the system as root
   a) Configure the TEPS to the TEMS.
   b) Run
  secureMain -g <GROUP> lock, where <GROUP> is replaced by the
  primary group of itmuser.
  
  4) Login to the system as itmuser
  
  a) Start the TEMS, TEPS and OS Agent.
   b) Connect the TEPS to a
  TEP client and verify that you can log in and view the
  workspace.
   c) Stop the TEMS, TEPS and OS Agent.
   d) Apply
  6.3.0.7-TIV-ITM-Unix-SP0005 for an AIX system or
  6.3.0.7-TIV-ITM-Linux-SP0005 for a Linux system.
   e) Start the
  TEMS, TEPS and OS Agent.
   f) Connect the TEPS to a TEP client
  and verify that you can log in and view the workspace.
   g) Stop
  the TEMS, TEPS and OS Agent.
   h) Run the wasihs855uplift.sh
  script as instructed in the 6.3.0.7-TIV-ITM-SP0005.README
   i)
  ERROR: Notice that the WAS uplift was successful and the IHS
  uplift failed.
  

Local fix

• 1) Login to the system as itmuser or root
   a) Restore the ITM
  installation directory to a stated prior to running
  wasihs855uplift.sh the first time.
  
  2) Login to the system as
  itmuser
   b) Perform any maintenance actions to get the
  installation back to the 6.3.0.7-TIV-ITM-SP0005 level. Do NOT
  run wasihs855uplift.sh yet
   c) Do NOT run wasihs855uplift.sh
  
  d) Repair wasihs855uplift.sh
   CH=/opt/IBM/ITM2
   cp
  $CH/bin/wasihs855uplift.sh $CH/bin/wasihs855uplift.bad.sh
  
  sed 's/user.ihs.httpPort=80";/user.ihs.httpPort=80,user.ihs.allo
  wNonRootSilentInstall=true";/' $CH/bin/wasihs855uplift.bad.sh >
  $CH/bin/wasihs855uplift.sh
   e) Run the wasihs855uplift.sh
  script as instructed in the 6.3.0.7-TIV-ITM-SP0005.README
   f)
  FIX: Notice that the WAS uplift was successful and the IHS
  uplift was successful.
   e) Start the TEMS, TEPS and OS Agent.
  
  f) Connect the TEPS to a TEP client and verify that you can log
  in and view the workspace.
  

Problem summary

• wasihs855uplift.sh fails when executed as non-root user
  
  
  When upgrading a TEPS installation as a non-root user, running
  wasihs855uplift.sh fails leaving the environment partially
  uplifted.
  Once the WAS and IHS components are in this state, WAS uplifted
  to 8.55.16 and IHS not uplifted, no further recovery action is
  possible without restoreing the installation from a prior
  back-up.
  Any attempted recovery action with out performing a restore,
  will cause the post-configuration jar file,
  WAS_IHS_855_Config.jar, to configure the WAS and IHS component
  incorrectly.
  

Problem conclusion

• The script wasihs855uplift.sh has been changed to fix the
  problem.
  
  
  The fix for this APAR is contained in the following maintenance
  packages:
  
     | service pack | 6.3.0.7-TIV-ITM-SP0014
  

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