Installing the Utilities - UNIX

The AE Utilities support the handling of administrative tasks.

Notes:

• A three-figure code has been supplied for each supported UNIX platform because the utilities for UNIX are available for different platforms. This document replaces the specific codes with the characters "???."

• It is best to install the utilities in a separate directory (such as /opt/uc4/utilities).

• You need a valid user ID for installation (UC4).

• Utilities must be run as administrator.

To Install the Utilities (UNIX)

1. Install the Java Runtime Environment (JRE). (Admin computer)

   This installation step can be ignored if the required version of JRE is already installed.

   1. Use the following command to check which version of the Java Virtual Machine (VM) is currently installed:

   java -version

   If several JRE or Java SDK versions are installed on your computer, make sure that the specified directories are in the proper order in the settings of %PATH% and $PATH. The Java Runtime Environment that is found first in the list of directories is used.

   2. Download the required Java Runtime Environment from http://java.sun.com and install it.

2. Unpack the TAR file and set up the system environment. (Admin computer)

   1. Copy the util???.tar.gz TAR file to a directory (such as AUTOMIC/utility) via FTP.
   2. Log on using the user ID UC4.
   3. Switch to the directory used for the utilities:
      cd utility

   4. Unpack the tar file:
      gzip -d util???.tar.gz or gunzip util???.tar.gz
      tar xvfo util???.tar

      The files are created in their corresponding directories as the file is unpacked. The tar file can be deleted after unpacking.

      Pay special attention to tar messages, which can result from different owners, and verify that all files are correctly unpacked.

   5. Check whether all files show the correct owner and group entries. AE must be the owner and the group must correspond to the identification "UC4. Modifications can only be made by a privileged user (such as root).
      chown UC4 * changes the owner of all files to UC4.
      chgrp Group name * changes the user group of all files.

   6. Set the environment variables in $HOME/.profile.

      • Oracle:

        • Sample for AIX:

          ORACLE_HOME=/usr/oracle; export ORACLE_HOME
          AUTOMIC=/opt/automic/utility; export AUTOMIC
          PATH=.:$ORACLE_HOME/bin[:$PATH]; export PATH
          LIBPATH=.:$AUTOMIC/bin:$ORACLE_HOME/lib:/usr/lib:/lib[:$LIBPATH]; export LIBPATH

        • Sample for Linux, Solaris and zLinux:

          ORACLE_HOME=/oracle/product/9.0.1; export ORACLE_HOME
          AUTOMIC=/opt/automic/utility; export AUTOMIC
          PATH=.:$ORACLE_HOME/bin[:$PATH]; export PATH
          LD_LIBRARY_PATH=.:$AUTOMIC/bin:$ORACLE_HOME/lib:/usr/lib:/lib[:$LD_LIBRARY_PATH]; export LD_LIBRARY_PATH

      • DB2:

        • Sample for AIX:

          DB2DIR=/usr/lpp/db2_06_01;export DB2DIR
          DB2INSTANCE=db2inst1;export DB2INSTANCE
          UC4=/opt/uc4/utility; export UC4
          PATH=.:$DB2DIR/bin[:$PATH]; export PATH
          LIBPATH = $UC4/bin:$DB2DIR:usr/lib:/lib:/usr/lib64[:.:$LIBPATH]

        • Sample for Linux, Solaris and zLinux:

          DB2DIR=/opt/IBMdb2/V7.1;export DB2DIR
          DB2INSTANCE=db2inst1;export DB2INSTANCE
          UC4=/opt/uc4/utility; export UC4
          PATH=.:$DB2DIR/bin[:$PATH]; export PATH
          LD_LIBRARY_PATH=$UC4/bin:$DB2DIR /lib:/usr/lib:/lib[:$LD_LIBRARY_PATH]; export LD_LIBRARY_PATH

3. Adjust the INI Files to the system environment. (Admin computer)

   The INI files and the corresponding utilities share the same name. Adjust the INI file entries as needed.

   • AE.DB Archive: UCYBDBAR.ini (Utility DB Archive)

   • AE.DB Change: UCYBCHNG.ini (Utility DB Change)

   • AE.DB Client Copy: UCYBDBCC.ini Utility DB Client Copy()

     Important! When you use DB Client Copy, you need two databases (source and target).

   • AE.DB Load: UCYBDBLD.ini (Utility DB Load)

   • AE.DB Reorg: UCYBDBRE.ini (Utility DB Reorg)

   • AE.DB Reporting Tool: UCYBDBRT.ini (Utility DB Reporting Tool)

   • AE.DB Revision Report: UCYBDBRR.ini (Utility DB Revision Report)

   • AE.DB Unload: UCYBDBUN.ini (Utility DB Unload)

4. Start the utilities. (Admin computer)

   The utilities can be called as follows:

   • *.sh: Regular utility start
   • Without file ending: program to which start parameters can be assigned for batch calls. For more information, see Start Parameters - Utilities.

   Use chmod +x UCYBDBar.sh to process the start scripts.

   Note: Starting this utility's graphical interface on the platform HP Itanium requires the "libstdc++.so.6" library to be loaded with the environment variable LD_PRELOAD.

   Examples

   • Command to load the library:

     export LD_PRELOAD=/automic/utility/bin/libstdc++.so.6

   • Shell-script ucybdbld.sh to open the graphical user interface of the AE DB Load utility

     You can insert this command in the Shell scripts. The library will then automatically be loaded whenever a utility's GUI is opened.

     export LD_PRELOAD=./libstd++.so.6

     java -jar ucybdbld.jar

Next step:

Loading the AE Database