Windows Installation - Licensing

Owned by Stonebranch (Deactivated)
Last updated: Jan 31, 2024

Licensing Universal Agent for Windows Components

After Universal Agent for Windows has been installed, you must configure the following components with product licenses before they can be used:

  • Universal Command Manager
  • Universal Data Mover Manager
  • Universal Connector for SAP
  • Universal Connector for PeopleSoft
  • Universal Application Container Server

Note

Universal Application Container Server (as a component of Universal Command Agent for SOA 6.7.x for Windows) is packaged, and licensed, separately.

Product License File

For each component, product license information (license parameter keywords and their values) is contained in a separate text file provided by your Stonebranch, Inc. account representative.

Format

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

  • For Universal Command Manager, Indesca is used as the <component name> in the product license file name and as the name of the product in the file itself.
  • For Universal Data Mover Manager, Infitran is used as the <component name> in the product license file name and as the name of the product in the file itself.

Sample

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

License_Product "INDESCA"
License_Customer "STONEBRANCH"
License_OS_Type "NT"
License_Type "PERPETUAL"
License_Expiration_Date 2029.12.31          YYYY.MM.DD
License_NT_Servers 100
License_UNIX_Servers 100
License_OS400_Servers 10000
License_OS390_Servers 10000
License_Tandem_Servers 10000
License_OS390_Unix_Servers 10000
License_Key ABCD-1234-EFGH-5678-IJKL-MNOP-9999


Entering License Information

Universal Agent for Windows components can be configured with product licenses either by:

  1. Entering the information from their product license file into their 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.)
    • Universal Command Manager: ucmd.conf
    • Universal Data Mover Manager: udm.conf
    • Universal Connector for SAP: usap.conf
    • Universal Connector for PeopleSoft: upps.conf
    • Universal Application Container Server: uacs.conf
  2. Specifying the information on the Universal Configuration Manager License Information page for that component, either by.
    1. Entering the information specified in the license file.
    2. Importing the license file.

Note

Universal Configuration Manager is installed during the Universal Agent 7.6.x for Windows installation.

Licensing via Universal Configuration Manager

To enter license information via the Universal Configuration Manager, perform the following steps:

Step 1

On the Windows Control Panel, double-click the Universal Configuration Manager icon to display the Universal Configuration Manager screen.

Step 2

In the Installed Components tree, click + next to the component that you want to configure with license information.

Step 3

Click License Information to display the License Information page.
 

 

Step 4

If you want to enter the license information on the page, make sure that you enter the information exactly as it is in the license information file. All information is case-sensitive; punctuation and spacing must be maintained.

Step 5

If you want to import the license file:

  1. Click the Import button.
  2. On the Select License File dialog that displays, select the license file to import.
  3. Click the Open button. The information is imported to the License information page.

Step 6

Click the OK button to save the license information.

Restart Universal Broker

For Universal Broker to read the license information, you must start / restart it.

Via Windows Services

Step 1

Go to Windows Services.

Step 2

Locate and select Universal Broker.

Step 3

If Universal Broker is not running, click Start.
 
If Universal Broker is running, click Restart.

Via Universal Configuration Manager

If you enter license information via the Universal Configuration Manager (see above), Universal Broker is restarted automatically, and the license information is read, when you click OK to save the license information.