How to start the Rational Requirements Composer server on boot with Linux

Answer

To start the Rational Requirements Composer server on Linux, you need to configure your init.d manually. Here is a step by step including script to copy on your server.

The steps are identical for Rational Team Concert and other Jazz tools but do not require step 1. The Rational Team Concert init script is also provided.
Note: This configuration has been tested on Red Hat Enterprise Linux 5.

1. As IBM Rational Requirements Composer requires Xvfb to run, a script to start the server is necessary. This script:"rrc_start.sh" must be copied in your server install directory [ default for this example]
   
   
   
   The script structure is as follows:
   
   

#! /bin/bash Xvfb :1 -screen 0 800x600x24& export DISPLAY=localhost:1.0 cd /opt/IBM/RRCS20/server/ DISPLAY=localhost:1.0 ./server.startup

Starts Xvfb Export display go to your install directory start the server

2. You need to install your server init in /etc/init.d
   For Rational Requirements Composer:
   
   For Rational Team Concert:
   
   Both files are similar but the Rational Requirements Composer one is more complex. The structure is:
   
   

script code

explanation

#!/bin/bash # # chkconfig: 35 90 12 # description: Rational Requirements Composer server # # Get function from functions library . /etc/init.d/functions # Start the service Rational Requirements Composer start() { # initlog -c "echo -n Starting RRC server: " /opt/IBM/RRCS20/server/rrc_start.sh & ### Create the lock file ### touch /var/lock/subsys/RRC success $"RRC server startup" echo } # stop the service RRC stop() { # initlog -c "echo -n Stopping RRC server: " killproc RRC /opt/IBM/RRCS20/server/server.shutdown pid=$(/sbin/pidof Xvfb ) kill $pid ### Now, delete the lock file ### rm -f /var/lock/subsys/RRC rm -f /tmp/.X1-lock echo } ### main logic ### case "$1" in start) start ;; stop) stop ;; status) status RRC ;; restart|reload|condrestart) stop start ;; *) echo $"Usage: $0 {start|stop|restart|reload|status}" exit 1 esac exit 0

Start the server using the rrc_start.sh script shutdown server using orginal shutdown script retrieve Xvfb PID and kill process remove Xvfb lock

3. Now you need to tell your system to load the script at boot. Edit your /etc/rc.local and on the bottom add a line: "/etc/startup.sh"
4. Create a file " vi /etc/startup.sh" and add the line "/etc/init.d/rrc start &"
   
5. chmod 755 /etc/startup.sh and chmod 755 /etc/init.d/rrc
   
6. Test your service starts: "/etc/init.d/rrc start &"
   
7. Reboot your server : "init 6" you should see your Rational Requirements Composer and /or Rational Team Concert service loading at boot as last services started.
   
8. You can now start and stop your Rational Requirements Composer server using the commands. This will clean up the lock and reset Xvfb preventing error on display at launch.

• "/etc/init.d/rrc start &"
• "/etc/init.d/rrc stop &"
• "/etc/init.d/rrc restart &"