Installing and Configuring DiveLine

Prerequisite: Uncompress the di-diveline.tar.gz file, as shown in Extracting the Server Installation Package, so that the /di/platform/diveline directory contains the following files and subdirectories:

  • bin—Directory containing executable files used by the server
  • cgi-bin—Directory containing the executable file for Web Server authentication
  • docs—Directory containing a quick reference list for dicfg
  • html—Directory containing html and dlk template files as well as a README file used with Web Server authentication
  • install-files—Directory containing files that are used when installing DiveLine, some files of which need to be copied to other directories
  • samples—Directory containing two sample models and DiveBooks for testing DiveLine
  • ENCRYPTION—The OpenSSL license file
  • INSTALL—Installation notes for 7.2
  • install-di-diveline—The installation shell script
  • README—Directory contents and support email address

NOTE: Text is case-sensitive in Linux.

To install and configure DiveLine:

  1. Navigate to the /diveline directory by entering the following command:

    cd /di/platform/diveline

  2. Check the directory contents for the install-di-diveline installation script by entering the following command:

    ls

  3. View the permissions for the install-di-diveline installation script by entering the following command:

    ls -l install-di-diveline

    The permissions display. If the permissions are -rwxr-xr-x, you can run the utility. If you do not have permission to run the utility:

    1. Enable the execute permission.

      sudo chmod 755 install-di-diveline

    2. Verify that the permissions have changed.

      ls -l install-di-diveline

      The permissions display as -rwxr-xr-x.

  4. Run the install script by entering the following command:

    sudo sh install-di-diveline

    The script begins with useful information about the question and answer process that follows including how to accept default suggestions or exiting the script. The answers given in this step are based on the fact that the server package was unzipped in the /di/platform directory.

    NOTE: Press Enter to confirm the default, shown in brackets, or enter your response. Use y to answer yes and n to answer no.

    The questions are:

    • Where should DI-DiveLine store configuration files and temporary files? [/di/solution/dl-dataroot]

      The default location is /di/platform/dl-dataroot and needs manual entry if it is verified as the correct location.

      NOTE: Verify the location of your dl-dataroot directory before accepting the default or entering a new location.

    • What level of security should be configured for DI-DiveLine? [2]

      The default security level is 2.

      There are three options to choose from:

      • Level 0—No security checking. All users have access to all models and DiveBooks in the models directory.
      • Level 1—Security checking is based on a web login. If a model is not listed in the configuration file, then all users have access to it.
      • Level 2—Security checking based on a web login. If a model is not listed in the ACL file, then no users have access to it.

    • Do you want to install a sample model and divebook? [y]

      The default is y, or yes.

    • Go ahead and install? [y]

      The default is y, or yes.

    If not already installed, the script prompts you to create a new RSA private key and certificate files by entering information.

    NOTE: A DI best practice is to create the private key and certificate files during the DiveLine installation.

    For example:

    • Country Code - US

      IMPORTANT: The country code must be two characters long.

    • State/province - MA
    • Location - Burlington
    • Enter organization - Dimensional Insight
    • Server name - ubuntu
    • Email address - [email protected]

    The script places the privatekey.txt and certificate.pem files in the /di/platform/dl-dataroot/config directory.

    Alternatively, you can create the keypair files after the DiveLine installation. See Creating and Configuring an Encryption Key for instructions.

  5. Navigate to the /di/platform/dl-dataroot/ directory by entering the following command:

    cd /di/platform/dl-dataroot/

  6. View permissions for /config by entering the following command:

    ls -l

    The permissions display. If the permissions are -rwxrwxrwx, you can open and modify the directory and its contents. If you do not have permission:

    1. Enable the execute permission.

      sudo chmod a+rwx config

    2. Verify that the permissions have changed.

      ls -l config

      The permissions display as drwxrwxrwx.

  7. Verify that the keypair files (privatekey.txt and certificate.pem) are created successfully:

    ls

  8. Navigate to the /di/platform/diveline/bin directory by entering the following command:

    cd /di/platform/diveline/bin

  9. Confirm that the init-di-diveline file is in the directory by entering the following command:

    ls

    The contents of the directory display, including the init-di-diveline file.

  10. View the permissions for the init-di-diveline file by entering the following command:

    ls -l init-di-diveline

    The permissions display. If the permissions are -rwxrwxrwx, you can modify the file. If you don't have permissions to edit the file:

    1. Enable the execute permission.

      sudo chmod a+rwx init-di-diveline

    2. Verify that the permissions have changed.

      ls -l init-di-diveline

      The permissions display as -rwxrwxrwx.

  11. Open the init-di-diveline script with a text editor, such as gedit, by entering a command similar to the following:

    gedit init-di-diveline

    The Closedtext editor opens.

    The graphic displays the editable section of the script. The variable values are specific to the installation described in this guide.

  12. For this installation, accept the variable defaults or make edits where necessary:

    • DIDLUSER=diveline—The name of the user that runs the DiveLine server
    • DIBASE=/di/platform—The location of the base DI Platform directory
    • DIDATAROOT=$DIBASE/dl-dataroot—The location of the DiveLine config, acl, cache, log, and data directories
    • DIBINDIR=$DIBASE/diveline/bin—The location of the DiveLine executable files
    • DISERVICE=di-service—The name of the existing di-service

    • DIPORTNUM=2131—The listening port for DiveLine on the server

      NOTE: Specify the port number that you chose when requesting a license. Port 2130 is the default.

  13. Save and close the init-di-diveline file.