IBM Support

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

Technote (FAQ)


Question

How can you start the IBM Rational Requirements Composer server on boot when using a Linux operating system?

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]

    rrc_start.sh

    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: rrc

    For Rational Team Concert: rtc.sh

    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 &"

Cross Reference information
Segment Product Component Platform Version Edition
Software Development Rational Team Concert Installation Linux 2.0.0.1, 2.0

Document information

More support for: Rational Requirements Composer
Installation

Software version: 2.0, 2.0.0.1

Operating system(s): Linux

Reference #: 1425943

Modified date: 05 April 2010