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)
-
Install the Java Runtime Environment (JRE). (Admin computer)
This installation step can be ignored if the required version of JRE is already installed.
- Use the following command to check which version of the Java Virtual Machine (VM) is currently installed:
- Download the required Java Runtime Environment from http://java.sun.com and install it.
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.
-
Unpack the TAR file and set up the system environment. (Admin computer)
- Copy the util???.tar.gz TAR file to a directory (such as AUTOMIC/utility) via FTP.
- Log on using the user ID UC4.
- Switch to the directory used for the utilities:
cd utility -
Unpack the tar file:
gzip -d util???.tar.gz or gunzip util???.tar.gz
tar xvfo util???.tarThe 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.
- 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. -
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 HP-UX:
ORACLE_HOME=/opt/Oracle; export ORACLE_HOME
AUTOMIC=/opt/automic/utility; export AUTOMIC
PATH=.:$ORACLE_HOME/bin[:$PATH]; export PATH
SHLIB_PATH=.:$AUTOMIC/bin:$ORACLE_HOME/lib:/usr/lib:/lib[:$SHLIB_PATH]; export SHLIB_PATH -
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 HP-UX:
DB2DIR=/opt/IBMdb2/V6.1; export DB2DIR
UC4=/opt/uc4/utility; export UC4
PATH=.:$DB2DIR/bin[:$PATH]; export PATH
SHLIB_PATH=$UC4/bin:$DB2DIR/lib:/usr/lib:/lib[:$SHLIB_PATH]; export SHLIB_PATH -
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
-
-
-
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)
-
-
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 utility AE DB Load
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: