Loading the D3 package

Complete these instructions to load the D3 package and to run D3_setup.

Procedure

  1. Log in to UNIX as root.

    If root has a password, consult the UNIX system administrator to obtain that password.

  2. Download the .tar installer file from the Rocket Software website at: http://www.rocketsoftware.com/.
  3. Create a destination directory into which the installation files will be loaded. The example below shows that the chosen directory is /tmp. Enter:
    cd /tmp
    Tip: If it is necessary to use a directory other than /tmp, substitute that directory name for /tmp in the instructions. Note that the specific directory to which the D3 installation files are loaded is the decision of the person performing the installation, however /tmp is the most common, and is used for reference here.

    If a previous release of D3 has been loaded, D3 installation files may still be present in the /tmp directory. These are the files loaded from the installer with the tar command. These files must be removed before a new release of D3 is loaded. See Upgrade issues for instructions to remove these files.

  4. Transfer the installation files. Enter:
    tar xvf /tmp/D3lx64102.tar

    The system loads a series of files and returns to the shell prompt. The screen looks similar to:

    x D3_ssn 
    x D3_setup
    x D3_setup
    x D3_copyright
    x D3_ugf
    x D3_install- lx - x.xx-.Z
    x D3_monitor- lx - x.xx-.Z
    x D3_flash- lx - x.xx -.Z
    x D3_sql- lx - x.xx -. Z
    x D3_abs- lx - x.xx-.Z
    x D3_datafiles- lx - x.xx -. Z
    #

    When the tar command completes, the system returns to the shell prompt. To continue the installation, D3_setup must be run. If any errors occur during the setup process, see Installation troubleshooting.

  5. Run D3_setup. Enter:
    /tmp/D3_setup
  6. As part of the setup process, the d3 depends program is run to determine whether all of the required Linux packages are installed. Respond to the prompts by entering y.
  7. Specify the entire path name to D3_setup on the command line as shown in the example above even though the current directory is "/". Do not use a relative reference, such as ./D3_setup.
    Note: If any D3 processes appear to be running, the system displays a similar message:
    root 1640  1  06:03:42  90/0  0:00 d3 - 58 tty90
    This indicates there is one process (PID 1640) still running D3. Kill the process that is running by entering the command below and then restart the D3 installation procedure:
    kill -9 pid.number

    If no D3 processes are running, the system display is similar to:

    The following installation files will be used:
    
    abs:        D3_abs-lx-x.xx-.Z
    
    datafiles:  D3_datafiles-lx-x.xx-.Z
    
    flash:      D3_flash-lx-x.xx-.Z
    
    install:    D3_install-lx-x.xx-.Z 
    
    monitor:    D3_monitor-lx-x.xx-.Z
    
    sql:        D3_sql-lx-x.xx-.Z
    
    Welcome to the D3 installation procedure. You have successfully installed the
    distribution files.
    
    The distribution files are used to build the D3 environment on your UNIX
    machine. When the installation process completes successfully, it can delete
    the distribution files, or leave them on the local hard disk so you can
    install D3 onto other UNIX machines on your Local Area Network without
    re-installing the media.
    
    Do you want to delete the distribution files when the installation routine
    is finished with them? _

    D3_setup displays the installation files that it uses to build the D3 database on the machine. When the installation process completes successfully, it can delete the distribution files, or leave them on the local hard disk. Leaving the files on the local hard disk makes it easier to install D3 on another UNIX machine on the Local Area Network without reinstalling the media. This provides easy access to the ABS and datafiles if you need them later.

  8. When D3_setup completes successfully, type either y to remove the installation files, or n to keep them.
    • If n is typed, the distribution files will not be deleted, and this screen displays:

      When the install completes, the distribution files will NOT be deleted.
      
      After this procedure, you must run the d3 command to complete the
      installation as described in the installation manual.
      
      Do you want to continue the installation? _ 
    • If y is typed, the distribution files are deleted, and this screen displays:

      When the install completes, the distribution files will be deleted.
      
      After this procedure, you must run the d3 command to complete the
      installation as described in the installation manual.
      
      Do you want to continue the installation? _
  9. Enter y.