PM95998: [wi 278105] Documentation on running Tomcat as a service for minimum and maximum JVM heap settings is incorrect

APAR status

• Closed as program error.

Error description

• Documentation on running Tomcat as a service for minimum and
  maximum JVM heap settings is incorrect
  
  
  CLM 4.0.x
  Windows CLM Servers
     Configuring Tomcat as a Service
  
  
  
  Problem Description:
  
  The following URL documents how to configure Tomcat as a
  Service:
  
  http://pic.dhe.ibm.com/infocenter/clmhelp/v4r0m3/index.jsp?re=1?
  topic=/com.ibm.jazz.install.doc/topics/t_run_rqm64_win_service.h
  tml?scope=null
  
  However, on step 8), the following recommendation is incorrect
  for setting the minimum and maximum JVM heap settings within the
  Java Options text field:
  
  -DJAZZ_HOME=file:///C:/PROGRA~1/IBM/JazzTeamServer/server/conf
  -Djava.awt.headless=true
  -Dorg.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlu
  gin=true
  -Dcom.ibm.team.repository.tempDir=C:\Program
  Files\IBM\JazzTeamServer\server\tomcat\temp
  -Djazz.connector.sslProtocol=SSL_TLS
  -Djazz.connector.algorithm=IbmX509
   -Dlog4j.configuration=file:///C:/PROGRA~1/IBM/JazzTeamServer/se
  rver/conf/startup_log4j.properties
   -Xmx4g    ?---   INCORRECT
   -Xms4g    ?---   INCORRECT
   -Xgcpolicy:gencon
  
  Based on the following Apache Tomcat documentation, the settings
  should be made on the 'Java' Tab, under the 'Initial memory
  pool' and 'Maximum memory pool' setting:
  
  http://tomcat.apache.org/tomcat-7.0-doc/windows-service-howto.ht
  ml
  
  
  Workaround:  Set the Initial and Maximum memory pool settings
  within the Java Tab entries and not within the Java Options
  field text.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  Documentation on running Tomcat as a service for minimum and
  maximum JVM heap settings is incorrect
  

Problem conclusion

• Corrected description:
  9. In Initial memory pool and Maximum memory pool, change
  the pool size to 4096.
  

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

  RATL TEAM CONCE

• Fixed component ID

  5724V0400

Applicable component levels

• R403 PSN

     UP