Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Panel
Table of Contents

Objective

This Universal Agent 7.1.x for UNIX Quick Start Guide provides a short summary on how to install Universal Agent on a UNIX system and execute Universal Command and Universal Data Mover jobs. For a complete description of the installation process, see Universal Agent 7.2.x Installation, Upgrade, and Applying Maintenance.

...

  • System requirements
  • Downloading the Universal Agent 7.1.x for UNIX distribution file.
  • Extracting and installing the Universal Agent 7.1.x on UNIX.
  • Licensing Universal Agent components.
  • Encrypting passwords.
  • Executing a Universal Command job.
  • Executing a Universal Data Mover job.
  • Running a system query.

System Requirements

UNIX Versions

One of the following UNIX operating systems that are supported by Universal Agent 7.1.x:

...

The list of supported systems grows rapidly. Contact Stonebranch, Inc. for a current list of supported UNIX operating systems if you require support for a system that is not listed.

Additional Requirements

  • Superuser (root) access.
  • TCP/IP Socket implementation.
  • Approximately 400 megabytes of disk space for the installation. More disk space is required for variable files, such as log files, spool files, and trace files.
  • Bourne shell or compatible.

Platform Requirements

Since platform requirements may change with new releases of a product, see Platform Support for Universal Controller 7.1.x and Universal Agent 7.1.x to make sure that your platform is supported before performing an installation.

Downloading the Universal Agent 7.1.x for UNIX Distribution File

Stonebranch Inc. provides separate Universal Agent 7.1.x for UNIX product distribution files for different UNIX operating systems:

...

A customer user name and password - provided by Stonebranch, Inc. - are required to access the Customer Portal.

Installing Universal Agent 7.1.x for UNIX

Step 1

Download the Universal Agent 7.1.x for UNIX product distribution file to your work station.

Step 2

Issue a zcat command to uncompress and extract the installation files from the distribution file.

Step 3

To start the installation, issue the following command: sh ./unvinst

Step 4

The output from unvinst is written to file install.log in the current directory.

Licensing your Universal Agent 7.1.x for UNIX Components

Note
titleNote

A Universal Agent eventually will be required to obtain its license information from a Universal Controller or UCAM installation. Support for locally-configured license information will be removed at that time.

...

The format of the product license file name is: <component name>_<customer name>_<operating system>_<schedule or solution>.txt. For example: Agent_Stonebranch_UNIX_A1.txt.

Universal Command Manager License File

For Universal Command Manager, Agent is used as the <component name> in the product license file name and as the name of the product in the product license file itself - see below.
 

The following is a sample Universal Command Manager for UNIX product license file:

Panel

Universal Data Mover Manager License File

For Universal Data Mover Manager, MFT is used as the <component name> in the product license file name and as the name of the product in the product license file itself - see below.
 

The following is a sample Universal Data Mover Manager for UNIX product license file:

Panel

Licensing Method

Enter each component's product license file information into its configuration file:

...

It is recommended that you enter license information at the end of the file. (The values are specified in the same syntax as all other configuration options.)

Restart Universal Broker

For Universal Broker to read the license information, you must stop and restart it:
 

Stop Universal Broker

Panel

Start Universal Broker

Panel

Encrypting User ID and Password for Job Execution

Job execution demands a user ID and password. This information should be stored in an encrypted file, which Universal Command and Universal Data Mover will process before starting a job.

Step 1

Create a file containing a user ID (-userid id) and a password (-pwd password).

Step 2

Run the Universal Encrypt utility to encrypt the contents of the file.

Step 3

Execute Universal Command and Universal Data Mover using the encrypted file (-encryptedfile filename) option.

Executing a Universal Command Job

The command line syntax for executing Universal Command for UNIX is:

Panel

Executing a Universal Data Mover Job

The command line syntax for executing Universal Data Mover for Windows is:

Panel

Running a System Query

Use the Universal Query utility to query the Universal Broker for Broker-related and active component-related information. Universal Query returns information for the Universal Broker, as specified by configuration options on the command line or in a configuration file, as well as information regarding the components managed by Universal Broker.

...