Administration Guide > Installation > New Installation > Installing Utilities (UNIX)

Installing Utilities (UNIX)

This document guides you through the new installation of the utilitiesUtilities support the execution of administrative tasks in an Automation Engine system (such as reorganizing and archiving the Automation Engine database). for UNIX.

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

Automic strongly recommends installing the utilities in a separate directory (such as /opt/uc4/utilities).

Requirements

Supplied Files

Utility files are supplied in compressed tar-file format (util???.tar.gz), and are found in subdirectories of IMAGE:UTILITIES\UNIX. The subdirectory names indicate the supported platforms.

*.sh: normal utility start
without file ending: programs for batch call

File name

Description

UCYBDBar.jar

AE DB ArchiveThe utility AE DB Archive can be used to remove the increasing amounts of data from the Automation Engine database. (archiving the databaseA database is an organized collection of data including relevant data structures.)

ucybchng

AE DB ChangeUtility for changing transport case exports. (editing exported data)

UCYBDBcc.jar

AE DB Client CopyUtility for copying and deleting clients (copying and deleting clients)

UCYBDBLd.jar

AE DB LoadThe utility DB Load can be used to load data into the Automation Engine database. (loading the database)

UCYBDBre.jar

AE DB ReorgData can be reorganized by using the utility DB Reorg. It marks data records with a deletion flag in accordance with the settings that have been specified. (reorganizing the database)

UCYBDBRR

AE DB Revision ReportUtility unloading modification reports from the Automation Engine database. Modification reports include detailed information about object modifications and accesses. (creating revision reports)

UCYBDBUn.jar

AE DB UnloadUtility for unloading the Automation Engine database. (unloading the database)

UCYBLGMX

AE.LogMix (combination of log and trace files)

ucyrepg.jar

AE.Reporting Tool (defining queries)

uc.msl

Message library

UC4LAF.jar

Archive for layout files

*.ini

Initialization files for the utilities

*.sh

Start scripts for calling the utilities

libgcc*, libssp*, libstdc++*, libsysapi, libuc001, libuccache, libucdbup, libucsbepm, libucudb32, libUCYBCLICPY, libUCYBDBLd, libUCYBDBUn, libUCYDBArchive, libUCYDBReorg, libzu00132, libzuxml, ucucli, ucuoci,

Runtime libraries

File ending with "a" indicates AIX
File ending with "sl" indicates HP-UX
File ending with "so" indicates Solaris, Linux and zLinux

As of version 8.0, the file names of all utilities have been changed to lowercase letters. For compatibility reasons, binary links are supplied for UNIX utilities of version 8.0. They link the program calls from old file names to the new ones. These links are only supplied in version 8.0 and no longer appear in later versionsAn application version holds zero or more deployment packages and may have dependencies to zero or more application versions of the same (or to different) applications.

Procedure

1. Installing the Java Runtime Environment (JRE)

This installation step can be ignored if the required version of JRE is already 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 listShows entities in a grid view of directories is used.

2. Unpacking theTAR file and setting up the system environmentAn Environment consists of Deployment Targets which represent your endpoints. Different environments are used for different phases in the software delivery cycle, for example Development, QA, Staging, Production. An environment is typically set up once and used by several applications.

Sample for HP-UX:

Sample for Linux, Solaris and zLinux:

Sample for HP-UX:

Sample for Linux, Solaris and zLinux:

3. Adjusting the INI Files to the System Environment


4. Starting the Utilities

Note that starting this utility's graphical interface on the platform HP Itanium requires the library "libstdc++.so.6" to be loaded with the environment variableIt stores or retrieves values dynamically at runtime. An individual Automation Engine object type. LD_PRELOAD. 

Example of a command loading the library:

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

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

Shell-scriptA particular Automation Engine object type. example "ucybdbld.sh" for opening the graphical user inferface of the utility AE DB Load:

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

java -jar ucybdbld.jar

 


Automic Documentation - Tutorials - Automic Blog - Resources - Training & Services - Automic YouTube Channel - Download Center - Support

Copyright © 2016 Automic Software GmbH