PM11600: Unable to start WebAcess Server for RDS 5.1

Rational Directory Server 5.1.1 (Apache)
Rational Directory Server (Apache) Interim Fix 6 for 5.1.1.2
Rational Directory Server (Apache) Interim Fix 3 for 5.1.1.2
Rational Directory Server (Apache) Interim Fix 4 for 5.1.1.2
Rational Directory Server (Apache) Interim Fix 5 for 5.1.1.2

APAR status

• Closed as program error.

Error description

• OS: Windows 2003 Server
  Tool: RDS 5.1 Apache
  
  Description: In Environment variables if JAVA_HOME has been set
  to any other path example ?JAVA_HOME=C:\Program Files\Java\jre6\
  bin?, when starting the Webaccessserver we get an error message
  stating The JAVA_HOME variable is not defined correctly. (Refer
  to ?More Information? for the complete error message)
  
  Impact: Non Critical, as we know the cause and have a workaround
   for this issue.
  
  Actual Result: If JAVA_HOME has been set to any other path other
   than RDS Java home path, the webaccess server will not start.
  
  Expected Result:  Irrespective of the JAVA_HOME defined in envir
  onment variable the ?Start_RDAWebServer.bat? file should be capa
  ble to handle the request. Also should be able to start the weba
  ccess server.
  
  Reproducible: Yes
  
  Steps to reproduce: Refer to the attached FBR Recording for step
  s to reproduce.
  
  In order to view the fbr recording please download the following
   software:
  http://www.bbsoftware.co.uk/bbflashback/download.aspx?cc=true?st
  art
  
  More information:
  The exact error message seen in the command prompt while running
   the Start_RDAWebServer.bat script
  
  The system cannot find the file specified.
  The JAVA_HOME environment variable is not defined correctly
  This environment variable is needed to run this program
  NB: JAVA_HOME should point to a JDK not a JRE
  
  Workaround provided: Yes
  
  Edit ?Start_RDAWebServer.bat? from the following path ?Installat
  ion home?\ \RDS_5.1\WebAccessServer
  
  Add the following line ?set JAVA_HOME=? such that the batch scri
  pt should look like
  ?rem Copyright (c) Telelogic 2007. All rights reserved.
  @echo off
  set JAVA_HOME=
  cd 'C:\Program Files\IBM\Rational\RDS_5.1\WebAccessServer\apache
  -tomcat-6.0.16\bin'
  C:
  cd ..
  rmdir/S /Q work
  
  
  cd 'C:\Program Files\IBM\Rational\RDS_5.1\WebAccessServer\apache
  -tomcat-6.0.16\bin'
  C:
  Startup?
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  Unable to start WebAcess Server for RDS 5.1
  

Problem conclusion

• This is a typical scenario where in RDS is installed on a
  setup where Java SDK env is already set up. For such issues
  catalina file needs to be updated which is a part for RDS
  installation.
  A technote is created which describes the steps to update
  the file.
   http://www-01.ibm.com/support/docview.wss?uid=swg21459688
  
  For such kind of issues Creating a technote the only
  solution and a fix can't be provided.
  

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

  TLOGIC DIR SRVR

• Fixed component ID

  RATLTDS00

Applicable component levels

• R510 PSN

     UP