Instructions for installing IBM Sterling Connect:Direct for UNIX FixPack. Please note the following before beginning this procedure: Note 1: The cdinstall script referenced below should be run by the userid that owns the C:D UNIX installation directory. Note 2: You will need root privileges to complete this procedure. Note 3: The fixpack files are full installation files and can be used for a new installation. To do so, follow steps 2 and 3 below, and then refer to the Installing Connect:Direct for UNIX chapter of the Connect:Direct for UNIX Getting Started Guide for further installation instructions. Note 4: The cdinstall script incorporates backup/restore functionality. If you select the UPGRADE option when cdinstall detects an existing installation, you will be given a prompt to perform a BACKUP of the existing installation. We recommend choosing this option. If the upgrade fails for any reason, the cdinstall script can be invoked and will detect the existence of the backup file and give you the option to RESTORE the previous installation. 1. Shutdown Connect:Direct for UNIX. This is important to assure all replacement modules are installed correctly. 2. The fixpack installation archive file will need to be uncompressed. For example: uncompress 4.1.0.4-SterlingConnectDirectforUNIX-AIX-pSeries-fp0004.Z On some Linux systems, the uncompress command does not exist, but "gzip -d" will work in its place. 3. Extract the installation script from the fixpack installation file on all systems except Linux with the following cpio command: cpio -civdmB < DEVICE cdinstall where DEVICE is the full path to the maintenance installation file. For example: cpio -civdmB < /cdent/cd4.1.0/4.1.0.4-SterlingConnectDirectforUNIX-AIX-pSeries-fp0004 cdinstall For Linux systems, use the following cpio command: cpio -ivdmB < DEVICE cdinstall Note: C:D UNIX 4.1.0.4 and later includes an automated installation option. To pursue this option, repeat the above step, replacing cdinstall with cdinstall_a in the indicated commands. Refer to the Enterprise Deployment Guide in the C:D UNIX Documentation section of the IBM Support Portal for further details on this option. 4. To run the interactive upgrade or install procedure, execute the cdinstall script: cdinstall This procedure will: a) Ask for your C:D UNIX installation directory with a prompt similar to the following: Enter the FULL path of the Connect:Direct for UNIX 4.1.0.4 installation directory. You can use $HOME to shorten the name:[$HOME/cdunix] Respond with your fully qualified C:D UNIX installation directory, for example: /opt/applications/cdunix You will be given the option to create a backup of the existing Connect:Direct installation during the next prompts. b) When the procedure asks for the location of the maintenance installation file with a prompt similar to the following: Specify the fully qualified name of the Connect:Direct for UNIX installation file (file name prefixed with the absolute path, e.g., /localhome/cdadmin/cdunix): Respond with the fully qualified directory and filename of the maintenance installation file, for example: /cdent/cd4.1.0/4.1.0.4-SterlingConnectDirectforUNIX-AIX-pSeries-fp0004 The procedure will then update the Connect:Direct installation, including detected options, like C:D File Agent. When the procedure requests root privilege, then: a) If you know the root password, or have a system administrator standing by who knows the root password, then answer 'yes' when the cdinstall script prompts for actions that require the root password. b) If you don't have access to the root password, but can use 'sudu' or some other utility consistent with your companies security policies to acquire root privileges, then answer 'no' when the cdinstall script prompts for actions that require the root password, and after the cdinstall script is finished: 1) acquire root privilege with sudo or another method that is consistent with your company's security policies 2) execute the following script: {the C:D UNIX installation directory}/etc/cdcust and select the option to "Set owner and permissions of C:D executables" After installing maintenance, it may be necessary to recompile/relink API programs and user exits. Please refer to the fixlist to see what has changed since you last applied maintenance, and whether a recompile/ relink is recommended. Please contact IBM Sterling Customer Support if you have any questions or problems installing the maintenance.