Universal Agent for SOA for Linux Installation

Owned by
Stonebranch
Jun 19, 2023
2 min read

Product Distribution File

Universal Agent for SOA 6.7.0.x is available as a Debian installation package.

The name of the Universal Agent for SOA for Linux distribution file has the following format:

sb-soa-v.r.m.l-linux-arch[-pkg].tar.Z

In this format:

  • v.r.m.l is the version, release, modification, and level of the Universal Agent for SOA application.
  • arch is the base target architecture.
  • pkg is an optional package type identifier.

For example, the name of the 64-bit Debian distribution for the 6.7.0.0 release that supports Linux kernel versions 3 and higher is sb-soa-6.7.0.0-linux-3-x86_64-deb.tar.Z.

Unpacking and Installation Procedures

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 file in the current working directory. The command to extract the files is:
 
Debian Package

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

RPM Package

zcat sb-soa-6.7.x.x-linux-2.6-x86_64.tar.Z | tar xvf -

 
You also can use the gzip command to uncompress and extract the files:
 
Debian Package

gzip -cd sb-soa-6.7.x.x-linux-3-x86_64-deb.tar.Z | tar xvf -

RPM Package

gzip -cd sb-soa-6.7.x.x-linux-2.6-x86_64.tar.Z | tar xvf -

Step 4

After the extraction is complete, run the installation script, upsinst, which executes the debian packaging commands:
 

./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 Agent for SOA 6.7.x is running:
 
uquery -i localhost (or the name of your server)
 
The output for Universal Application Container Server should have the following format:
 

 Component ID..............: 1360109684
 Component Name............: uac (Server)
 Component Description.....: Universal Application Container Server
 Component Version.........: 6.7.0 Level 0 Release Build 100
 Component Type............: uac
 Component Process ID......: 23331000
 Component Start Time......: 18:14:42
 Component Start Date......: 01/05/19
 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.: 01/05/19
 Component MGR Restartable.: NO
 Component Comment.........:

Removing Universal Agent for SOA for Linux

Note

Before removing Universal Agent for SOA for Linux, stop the ubrokerd daemon. Also, it is strongly recommended that you back up existing data before removing Universal Agent for SOA for Linux.

Debian Package
Universal Agent for SOA for Linux is removed with the dpkg command. The command must be executed with the superuser authority.

sudo dpkg -r ups

RPM Package
Universal Agent for SOA for Linux is removed with the rpm command. The command must be executed with the superuser authority.

sudo rpm -e ups

Listing Universal Agent for SOA for Linux Information

Debian Package
To list information for Universal Agent for SOA for Linux, issue the following command:

dpkg -l ups

RPM Package
To list information for Universal Agent for SOA for Linux, issue the following command:

rpm -qi ups