Installing the DOORS database server on Linux systems

You can install the IBM® Engineering Requirements Management DOORS® (DOORS) database server after you plan your installation and install the DOORS client that is to be used to administer the system. When you install on a Linux 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 DOORS.

Procedure

  1. If the 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 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 DOORS database server. When other 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 DOORS for the first time, create a non-privileged user account to own the DOORS data and application files. That user is the DOORS owner. For example, you might name the user account doors.
  3. Go to the directory where you saved the DOORS installation files. If you are using an installation CD, that directory is the location where CDs are mounted to. The DOORS installation directory contains several files and an Installers directory. The installation file is in either the Installers/linux 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 DOORS, run a recursive chown command on the files from the root of the DOORS directory. For example:
    chown -R user:group $DOORSHOME
  7. Edit the startup file of the 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 DOORS database server:
    1. Log in by using the credentials of the DOORS owner.
    2. Change your working directory to $DOORSHOME/bin.
    3. If the 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 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 user's credentials and creating a database manager for DOORS.

Feedback