IBM Support

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

Question & Answer


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


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:"" must be copied in your server install directory [ default for this example]

    The script structure is as follows:

  2. #! /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
  3. You need to install your server init in /etc/init.d
    For Rational Requirements Composer: rrc

    For Rational Team Concert:

    Both files are similar but the Rational Requirements Composer one is more complex. The structure is:

  4. script code
    # 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/ &
    ### Create the lock file ###
    touch /var/lock/subsys/RRC
    success $"RRC server startup"

    # stop the service RRC
    stop() {
    # initlog -c "echo -n Stopping RRC server: "
    killproc RRC
    pid=$(/sbin/pidof Xvfb )
    kill $pid
    ### Now, delete the lock file ###
    rm -f /var/lock/subsys/RRC
    rm -f /tmp/.X1-lock

    ### main logic ###
    case "$1" in
    status RRC
    echo $"Usage: $0 {start|stop|restart|reload|status}"
    exit 1

    exit 0
    Start the server using the script

    shutdown server using orginal shutdown script

    retrieve Xvfb PID and kill process

    remove Xvfb lock
  5. 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/"
  6. Create a file " vi /etc/" and add the line "/etc/init.d/rrc start &"
  7. chmod 755 /etc/ and chmod 755 /etc/init.d/rrc
  8. Test your service starts: "/etc/init.d/rrc start &"
  9. 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.
  10. 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 &"

[{"Product":{"code":"SSUC3U","label":"IBM Engineering Workflow Management"},"Business Unit":{"code":"BU055","label":"Cognitive Applications"},"Component":"Installation","Platform":[{"code":"PF016","label":"Linux"}],"Version":"; 2.0","Edition":"","Line of Business":{"code":"LOB02","label":"AI Applications"}},{"Product":{"code":"SSWMEQ","label":"Rational Requirements Composer"},"Business Unit":{"code":"BU055","label":"Cognitive Applications"},"Component":"Installation","Platform":[{"code":"PF016","label":"Linux"}],"Version":"2.0;","Edition":"","Line of Business":{"code":"LOB02","label":"AI Applications"}}]

Product Synonym

Rational Team Concert

Document Information

Modified date:
16 June 2018