/
Getting Started with Universal Command Agent for SOA - XD Connector

Getting Started with Universal Command Agent for SOA - XD Connector

Jul 15, 2024

 

Objective

The objective of this document is to assist in the following activities regarding the Universal Command Agent for SOA: XD Connector:

  • Installing Universal Agent for SOA 6.x, which is comprised of:

    • Universal Command Agent for SOA

    • Universal Event Monitor for SOA

  • Validating the WebSphere environment.

  • Running the XD Connector on Universal Command Agent for SOA.

Installation Requirements

The following is required for running Universal Command Agent for SOA with an XD Connector:

  • Universal Agent 6.x (64-bit package): installed, licensed, and running.

Installation

Note

These instructions describe installation of the Universal Agent for SOA 6.x for the Linux x86_64 Debian package.

 

Universal Agent for SOA 6.x is packaged as a Debian file (extension .deb). It is installed using the Linux dpkg command.

The name of the Universal Agent for SOA 6.x package file has the following format:

sb-soa-6.4.1.0-linux-3-x86_64-deb.tar.Z

(The name assumes product maintenance level 6.4.1.0 for Universal Agent for SOA 6.4.x.)
 

To unpack and install Universal Agent for SOA, perform the following steps:

Step 1

Create a directory (or select an existing directory) in which to save the package file.

Step 2

Save the package file into that directory.

Step 3

Uncompress and extract the installation files in the current working directory. The command to extract the files is:
 

zcat sb-soa-6.4.1.0-linux-3-x86_64-deb.tar.Z | tar xvf -

 
If your operating system does not support the zcat command, use the following command:
gunzip sb-soa-6.4.1.0-linux-3-x86_64-deb.tar.Z
 
The output of the gunzip command provides the following tar file:
tar -xvf sb-soa-6.4.1.0-linux-3-x86_64-deb.tar

Step 4

After the extraction is complete, run the installation script, upsinst, which executes the dpkg command:
 

./upsinst

 

 
An installation log is written to file install.log in the current directory. upsinst automatically restarts the Universal Broker daemon, ubrokerd, at the end of the install.

Step 5

From the license file that was sent to you by Stonebranch, Inc., add the license information to the /etc/universal/uacs.conf file.

Step 6

Recycle Universal Broker using the following commands (cd to /opt/universal/ubroker):
 
First:
 

./ubrokerd stop

 

 
Then:
 

./ubrokerd start

 

 

Step 7

Use Universal Query (cd to /opt/universal/bin) to validate that the Universal Application Container Server component of Universal Command Agent for SOA 6.4.x is running:
 
uquery -host localhost (or the name of your server)
 
The output should have the following format:
 

Component ID..............: 1360109684 Component Name............: uac (Server) Component Description.....: Universal Application Container Server Component Version.........: 6.4.x Level 1 Release Build 101 Component Type............: uac Component Process ID......: 23331000 Component Start Time......: 18:14:42 Component Start Date......: 02/05/13 Component Command ID......: uac Component State...........: REGISTERED Component MGR UID.........: Component MGR Work ID.....: Component MGR Host Name...: Component MGR IP Address..: Component MGR Port........: Component Comm State......: ESTABLISHED Component Comm State Time.: 18:14:44 Component Comm State Date.: 02/05/13 Component MGR Restartable.: NO Component Comment.........: