Installing the Rational DOORS database server on Linux or Solaris systems

You can install the Rational® DOORS® database server after you plan your installation and install the Rational DOORS client that is to be used to administer the system. When you install on a Linux or Solaris system, you must install as the root user.

Before you begin

Make sure that you meet the system, licensing, and other requirements. To view a checklist of installation prerequisites, see Installation preparation for Rational DOORS.

Procedure

  1. If the Rational DOORS database server is running, stop it:
    1. On a command line, change the working directory to $DOORSHOME/bin.
    2. Enter this command: dbadmin -data port@DOORSserver -killserver [-password password] Where:
      • port is the port for the server. The default is 36677. If you already installed the Rational DOORS client, you must enter the port number that was entered during the client installation.
      • DOORSserver is the name of the computer that the server is running on.
      • password is the server password. If the password is not set, omit the -password switch.
    Important: Write down the computer name and the port number that you are using for the Rational DOORS database server. When other Rational DOORS users install the client on their computers, they need the computer name and port number to complete the installation.
  2. If you are installing Rational DOORS for the first time, create a non-privileged user account to own the Rational DOORS data and application files. That user is the Rational DOORS owner. For example, you might name the user account doors.
  3. Go to the directory where you saved the Rational DOORS installation files. If you are using an installation CD, that directory is the location where CDs are mounted to. The Rational DOORS installation directory contains several files and an Installers directory. The installation file is in either the Installers/linux directory or the Installers/solaris directory.
  4. Run the installation file. Files are automatically extracted, and the installation procedure begins.
  5. Follow the prompts to install the database server. After the installation, the root user owns the files.
  6. Optional: If you want a user other than the root user to own and start Rational DOORS, run a recursive chown command on the files from the root of the Rational DOORS directory. For example:
    chown -R user:group $DOORSHOME
  7. Edit the startup file of the Rational DOORS owner, as shown in the following table.
    Startup file Code
    Bourne or K shell .profile file DOORSHOME=/doors-install-directory/DOORS_Database_Server

    SERVERDATA=/path-to-data-dir

    PATH=$DOORSHOME/bin:$PATH

    PORTNUMBER=database-server-port-number

    export DOORSHOME SERVERDATA PATH PORTNUMBER

    C shell .login file setenv DOORSHOME /doors-install-directory/DOORS_Database_Server

    setenv SERVERDATA /path-to-data-dir

    setenv PATH $DOORSHOME/bin:$PATH

    setenv PORTNUMBER database-server-port-number

  8. Start the Rational DOORS database server:
    1. Log in by using the credentials of the Rational DOORS owner.
    2. Change your working directory to $DOORSHOME/bin.
    3. If the Rational DOORS database data directory that the SERVERDATA variable specifies does not exist, create that directory.
    4. Enter a command:
      • In most cases, enter ./doorsd &.
      • If you use the Korn shell and do not use doorsd & in a system startup script, enter nohup doorsd &.

What to do next

Start the Rational DOORS client that you are using to administer the system, and set up the administrator password and the database manager. For information, see Setting up the administrator credentials and creating a database manager for Rational DOORS.

Feedback