How to setup RQM (Tomcat) to startup as a service?

Disclaimer: the following info is from a document that is in the process of becoming a Tech Note once the content has been reviewed and confirmed. So this is not the absolute final version but it may be helpful as is. If others have experience with this process, please add your comments.

RQM Running as a Service in Tomcat
This example here refers to the RQM server installed under C:\Program Files\IBM\RQM\server. Replace C:\Program Files\IBM\RQM\server with the location of your server.

Start RQM for the first time from Start - Programs - IBM Rational Quality Manager - Start IBM Rational Quality Manager server.
(Just in case there is any special stuff that happens on the first execution).

Shutdown from Start - Programs - IBM Rational Quality Manager - Stop IBM Rational Quality Manager server.

In a command prompt, cd to the C:\Program Files\IBM\RQM\server\tomcat\bin, and install Tomcat as service by issuing the command:
service.bat install tomcat5

Configure the parameters for tomcat service by launching tomcat5w.exe in the C:\Program Files\IBM\RQM\server\tomcat\bin directory.

Set startup to automatic
Note: Make sure it sets and click apply before you close, as it seems to revert on dialog OK sometimes.

Go to the logging Tab and set the log path to:
C:\Program Files\IBM\RQM\server\tomcat\logs (or whatever your jazz path is).

Go to the Java tab, unselect Default, and point it to the IBM JVM.
C:\Program Files\IBM\RQM\server\win32\ibm-java2-i386-50\jre\bin\j9vm\jvm.dll

The Java classpath should be:
C:\Program Files\IBM\RQM\server\tomcat\bin\bootstrap.jar

Set the java options as follows (some of these will be already there):

-Dcatalina.base=C:\Program Files\IBM\RQM\server\tomcat
-Dcatalina.home=C:\Program Files\IBM\RQM\server\tomcat
-Djava.endorsed.dirs=C:\Program Files\IBM\RQM\server\tomcat\common\endorsed
-Djava.io.tmpdir=C:\Program Files\IBM\RQM\server\tomcat\temp
-Dcom.ibm.team.server.configURL=file:///C:\Program Files\IBM\RQM\server/teamserver.properties
-Dlog4j.configuration=file:///C:\Program Files\IBM\RQM\server/log4j.properties
-Djava.awt.headless=true
-Dorg.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin=true
-Dcom.ibm.team.repository.provision.profile=C:\Program Files\IBM\RQM\server\provision_profiles
-Dcom.ibm.team.repository.tempDir=c:\tmp
-Dcom.ibm.rqm.create.samples=false
-DORACLE_JDBC=C:\Program Files\IBM\RQM\server\oracle
-DDB2I_JDBC=C:\Program Files\IBM\RQM\server\db2i
-DDB2Z_JDBC=C:\Program Files\IBM\RQM\server\db2z

Set the memory to 512K heapSize and at least 700MB max Memory. Set the the startup and shutdown paths on their respective tabs to:
C:\Program Files\IBM\RQM\server

You should now have a service available in Windows.

Thanks! It works, but there are few updates because I think this was written for version 1.0, for the current version (2.0) these are the changes:

1) First of all the install folder now is "C:\Program Files\IBM\RQM20" instead of "C:\Program Files\IBM\RQM". You should change it in the instruction.

2) The JVM you should use is "C:\Program Files\IBM\RQM20\server\jre\bin\j9vm"

3) and the Java options should be like these:
-Dcatalina.base=C:\Program Files\IBM\RQM20\server\tomcat
-Dcatalina.home=C:\Program Files\IBM\RQM20\server\tomcat
-Djava.endorsed.dirs=C:\Program Files\IBM\RQM20\server\tomcat\common\endorsed
-Djava.io.tmpdir=C:\Program Files\IBM\RQM20\server\tomcat\temp
-Dcom.ibm.team.server.configURL=file:///C:\Program Files\IBM\RQM20\server\conf\jazz/teamserver.properties
-Dlog4j.configuration=file:///C:\Program Files\IBM\RQM20\server/log4j.properties
-Djava.awt.headless=true
-Dorg.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin=true
-Dcom.ibm.team.repository.provision.profile=C:\Program Files\IBM\RQM20\server\conf\jazz\provision_profiles
-Dcom.ibm.team.repository.tempDir=c:\tmp
-Dcom.ibm.rqm.create.samples=false
-DORACLE_JDBC=C:\Program Files\IBM\RQM20\server\oracle
-DDB2I_JDBC=C:\Program Files\IBM\RQM20\server\db2i
-DDB2Z_JDBC=C:\Program Files\IBM\RQM20\server\db2z

OK great - thanks for the updates! I will try to help move this along as a tech note.

Hi,

I recently wrote a technote on this: Running IBM Rational Quality Manager 2.0 server as a Windows Service @ http://www.ibm.com/support/docview.wss?uid=swg21402914

Let me know if anything is unclear or needs to be added/changed. You can post here (I'm following this thread), or use the text box in the "rate this page" section of the technote itself, which will get e-mailed to me.

Regards,
Patrick

Hi Patrick,

We upgraded RQM from 2.0.0.1 iFix02 to 2.0.1 iFix03. I then followed your suggestion in your technote:

http://www.ibm.com/support/docview.wss?uid=swg21402914

And followed the procedure on createing a service for 2.0.1

and have execute rqm.service.bat install 2.0.1

My question is how do I up the memory on the tomcat service for 2.0.1? Before (in 2.0.0.1) I use to execute tomcat5w.exe to change the configuartions. But now for 2.0.1 when I do that I am seeing the old 2.0.0.1 configurations. But I have verified when running the new service it is running the correct 2.0.1 configuration but defaults to 700 MB as the memory.

The only way I can change the memory is to update the rqm.service.bat script since it is hardcoding the memory to be 700MB , I then change the default to 1500. There must be another way other than doing it this way.


Please advise on changing the tomcat memory.

Hi,

I recently wrote a technote on this: Running IBM Rational Quality Manager 2.0 server as a Windows Service @ http://www.ibm.com/support/docview.wss?uid=swg21402914

Let me know if anything is unclear or needs to be added/changed. You can post here (I'm following this thread), or use the text box in the "rate this page" section of the technote itself, which will get e-mailed to me.

Regards,
Patrick

Hi Arnold,

You can safely modify the hard-coded value in rqm.service.bat in order to increase Tomcat's maximum heap size (JvmMs) when RQM 2.0.1 is configured with Tomcat to run as a Windows service.

This is the line that should be modified:

"%EXECUTABLE%" //US//%SERVICE_NAME% ++JvmOptions "-Djava.awt.headless=true;-DSQLSERVER_JDBC=%SQLSERVER_JDBC%;-DORACLE_JDBC=%ORACLE_JDBC%;-DDB2I_JDBC=%DB2I_JDBC%;-DDB2Z_JDBC=%DB2Z_JDBC%;-Dorg.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin=true;-DJAZZ_HOME=file:///%PATH_URL%conf;-Dcom.ibm.team.repository.tempDir=%TEMP%" --JvmMs 128 --JvmMx 700

(Change the "700" value to some other value, such as 1024 or 1500.)

To apply the change, open a command prompt window, CD to the server directory, and run:

rqm.service.bat remove 2.0.1

rqm.service.bat install 2.0.1

In the current design, I am not aware of any easier/alternate way to accomplish this.

Cheers,
Patrick

I had the same problem and hard coding it worked. Thanks