Loading the D3 package

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

Prerequisites

Complete the following tasks before loading the D3 package:

If a previous release of D3 has been loaded, D3 installation files might still be present in the /tmp directory. These are the files loaded from the installer with the tar command. These files should be:
- Archived to another directory before removing them.
- Removed before a new release of D3 is loaded.
  See Upgrade issues for instructions to remove these files.
Download the .tar installer file from the Rocket Community site at:
https://my.rocketsoftware.com/RocketCommunity/RCLanding
If it is necessary to use a directory other than /tmp, substitute that directory name for /tmp in the instructions.
If D3 is to be installed on multiple AIX machines, a directory that will be shared among all the machines should be selected. In doing so, the installation files will only have to be loaded once.

About this task

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 in these instructions.

If any errors occur during the setup process, see Installation troubleshooting.

You will see the installation files that D3_setup uses to build the D3 database on the machine. When the installation process completes successfully, the distribution files can be deleted or you can 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.

Procedure

Log in to UNIX on the system console as root. If the root user has a password:
- Consult the UNIX system administrator to obtain the root password.
- Enter the password at the Password prompt:
```
 Password:
 #
```
Create a destination directory into which the installation files will be loaded.
The following example shows that the chosen directory is /tmp.

Enter:
```
 cd /tmp
```
Transfer the installation files.
Enter:
```
 tar xvf /tmp/D3aix64.10.3.4.tar
```
The system loads a series of files and returns to the shell prompt. You will see a screen similar to the following:
```
 x D3_ssn
 x D3_setup
 x D3_setup
 x D3_copyright
 x D3_ugf
 x D3_install-rs-x.xx-.Z
 x D3_monitor-rs-x.xx-.Z
 x D3_flash-rs-x.xx-.Z
 x D3_sql-rs-x.xx-.Z
 x D3_abs-rs-x.xx-.Z
 x D3_datafiles-rs-x.xx-.Z
 #
```
When the tar command completes, the system returns to the shell prompt.
Run D3_setup.
You should specify the entire path name to D3_setup on the command line as shown in the example.

Note: Do not use a relative reference, such as ./D3_setup.
Enter:
```
 /tmp/D3_setup
```

Determine if any D3 processes are running:

If any D3 processes appear to be running, you will see a message similar to:
```
 root 1640  1  06:03:42  90/0  0:00 d3 - 58 tty90
```
This example indicates that there is one process (PID 1640) still running D3.

If no D3 processes are running, you will see a message similar to:

 The following installation files will be used:

 abs:        D3_abs-rs-x.xx-.Z
 
 datafiles:  D3_datafiles-rs-x.xx-.Z
 
 flash:      D3_flash-rs-x.xx-.Z
 
 install:    D3_install-rs-x.xx-.Z 
 
 monitor:    D3_monitor-rs-x.xx-.Z
 
 sql:        D3_sql-rs-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? _

Complete one of the following steps:
- If D3 processes are running, go to Step 7.
- If no D3 processes are running, go to Step 8.
If D3 processes are running, complete the following steps:
1. Kill the process that is running by entering the following command:
```
 kill -9 pid.number
```
2. Restart the D3 installation procedure.
When D3_setup completes successfully, complete one of the following steps:
- Type n to keep the installation files.
- Type y to remove the installation files.
Note: Leaving the files on the local hard disk makes it easier to install D3 on another UNIX machine. It also makes it easier to install Monitor, Flash, and SQL patches.
This is because each requires D3_setup to install, which in turn requires the rest of the installation files.
- If n is typed, the distribution files will not be deleted, and you will see a message similar to:
```
 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 you will see a message similar to:
```
 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? _
```

Enter y to continue.

You will see a message similar to:

 SUCCESSES
 ---------
 Filesets listed in this section passed pre-installation verification and
 will be installed.
 Selected filesets
 ------------------
 Pick 10.3.4
 
 << End of Success Section >>
 Restoring files ...
 Press <Enter> to continue ...

Press Enter.

Warning: If there is not enough space in the /usr or root file system, an error message opens.
If you receive an error message regarding not enough space in the /usr or root file system, respond y (yes) for the system to automatically allocate space.

If there is still not enough space, the installation is aborted.

See Installation troubleshooting for the exact text of the error messages and what steps to take to correct this problem.

If the UNIX TERM type is not set, you will see the terminal types.
Enter the appropriate terminal type.