Skip to main content

Universal Agent for SOA for Linux Installation

Product Distribution File​

Universal Agent for SOA 8.0.0.x is available as an RPM and 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.gz

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 8.0.0.0 release that supports Linux kernel versions 4 and higher is sb-soa-8.0.0.0-linux-4-x86_64-deb.tar.gz.

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

gunzip sb-soa-8.0.x.x-linux-4-x86_64-deb.tar.gz | tar xvf -

RPM Package

gunzip sb-soa-8.0.x.x-linux-3.10-x86_64.tar.gz | 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 8.0.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.........: 8.0.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​

info

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