Administration Guide > Installation > New Installation > Installing the ServiceManager (UNIX)

Installing the ServiceManager (UNIX)

This document guides you through the new installation of a ServiceManager.

Because the ServiceManager for UNIX is available for different platforms, a three-figure code has been supplied for each supported UNIX platform. The codes are described in the Terminology. In this document, the specific code is replaced with the characters "???."

Automic strongly recommends installing the ServiceManager in a separate directory (such as UC4/smgr).

Supplied Files

The ServiceManager files are supplied in compressed form (ucsmgr???.tar.gz), and can be found in subdirectories of IMAGE:SERVICEMANAGER\UNIX. The names of the subdirectories indicate the supported platforms.

Procedure

	1.	Transfer the tar file to the Host and set up the system environment.

Host
Log on using the user ID AE.
Transfer the TAR file ucsmgr??.tar.gz to a directory (such as smgr) via FTP.
Navigate to the ServiceManager directory:
cd servicemanager
Unpack the tar file:
gzip -d ucsmgr???.tar.gz or gunzip ucsmgr???.tar.gz
tar xvfo ucsmgr???.tar
The files will appear in their corresponding directories. The tar file can be deleted after unpacking.
Be sure to note any tar messages (which can be called up by various users) and verify that all files have been correctly unpacked.
Verify that all files have the correct owner and group entries. AE must be the owner. The group must correspond to the identification AE. Modifications can only be made by a privileged user, such as root.
chown UC4 * changes the owner of all files to AE.
chgrpGroup name * changes user group for all files.
Rename the supplied ini file ucybsmgr.ori.ini to ucybsmgr.ini.
Rename the supplied file uc4.ori.smd to uc4.smd.
Adjust the INI file to the system environment.
Set the variable:

AIX: export LIBPATH=Path of the system library directory

HP-UX: export SHLIB_PATH=Path of the system library directory

Solaris, Linux, zLinux: export LD_LIBRARY_PATH=Path of the system library directory

	2.	Start and stop services with the ServiceManager

Host
Start the ServiceManager:
nohup ./ucybsmgr [-iPath and Name of the INI file] Phrase &

The phrase is a ServiceManager environment.
For more information about ServiceManager functions (such as starting and stopping agents), see UCYBSMCL.

Potential Problem

A service cannot be started:

Note that for Automation Engines on UNIX, the file "syntax.bin" is in the same directory as the INI files.