This site requires JavaScript to be enabled
Welcome Guest|
Recent searches
IE BUMPER

Install Universal Agent for Windows (GUI)

Number of views : 23
Article Number : KB0013856
Published on : 2021-07-07
Last modified : 2021-07-07 03:17:22
Knowledge Base : IT Public Self Help

Details of how to install the Universal Agent for Windows via the Graphical Interface and have it added to a Business Service.

 

Prerequisites

  • A Windows Server host on which you will run Stonebranch tasks
  • A minimum of 500MB of disk space
  • A TCP/IP network connection
  • A valid Active Directory Group setup during Request for Access
  • A Business Service setup during Request for Access
  • SysAdmins installing the agent should be experienced in supporting their particular platform

 

Installation

Download the Universal Agent Installer

(1.) Navigate to the site-licensed share on Austin Disk.

 \\austin.utexas.edu\disk\site-licensed\Stonebranch\Windows 

(2.) Locate the appropriate installer for your host (32- or 64-bit) and copy to your server.

This will be the location where the latest Universal Agent will be provided. As the client is updated by the vendor please visit this location to obtain.

 

Install the Universal Agent

(1.) On the location you copied the agent on your Windows host, double-click the executable to launch the installer.

(2.) Click Next on the Welcome page.

(3.) On the Custom Setup page, retain all the default settings and click Next.

While you can change the install destination, it is recommend that all components be placed in their default location.

(4.) On the Universal Broker Service Account page, select Local System and click Next

If you choose to use a user account, DO NOT USE THE PROVIDED DEFAULT UBrokerService ACCOUNT NAME AND PASSWORD This account is created as a local administrator with logon rights. For security purposes, please choose to run as Local System.

(5.) On the OMS Server Options page, choose to Start the OMS Server automatically...

(6.) Keep the OMS port set to 7878.

(7.) Click Next.

(8.) On the Automation Center Connection Information page, select the appropriate OMS Server(s) for your agent, based on environment.

ENV
OMS Server
DEV 7878@stonebranch-dev.its.utexas,edu
QA 7878@stonebranch-qual.its.utexas.edu
PROD 7878@stonebranch.its.utexas.edu

(9.) You can verify that the Advanced... options are the following, but do not change the defaults.

Automation Center Core HUB01
Network ID OPSAUTOCONF

(10.) Click OK to close the Advanced settings.

(11.) Click Next on the Automation Center Connection Info page.

(12.) Click Install to begin the installation. Once complete, click Finish

 

To avoid elevation errors at execution, when configuring tasks in Stonebranch, ensure that any credential objects used have sufficient privilege(s) to run the commands specified in the task on the OS where the Stonebranch agent is installed and where the task will be running.

 

Install Licenses

This process will describe how to add the licenses to the end of the appropriate license files.

You will need to have local administrator rights to edit and save changes to these files.

(1.) Navigate to c:\ProgramData\Universal\conf\. As this is a hidden location, you will need to explicitly type this in the Windows Explorer bar.

(2.) For agents connecting to either the DEV or QA environments, configure your license files per the example to the right.

# --- ucmd.conf ---

License_Product "INDESCA"
License_Customer "UNIVERSITY OF TEXAS - NON PROD"
License_OS_Type "UNIX"
License_Type "PERPETUAL"
License_Expiration_Date 2029.12.31          YYYY.MM.DD
License_NT_Servers 10000
License_UNIX_Servers 10000
License_Key 268E-89E6-5A91-8443-E69D-5BC7-0EBA-FA3B

# --- usap.conf ---

License_Product "APPLICATION SERVICES"
License_Customer "UNIVERSITY OF TEXAS"
License_OS_Type "UNIX"
License_Type "PERPETUAL"
License_Expiration_Date 2029.12.31          YYYY.MM.DD
License_Soap_End_Points 1
License_Http_End_Points 1
License_XD_Soap_End_Points 1
License_Soap_Inbound_End_Points 1
License_Key A720-077C-C1A5-8419-913A-62C8-DFB0-4227

# --- udm.conf ---

License_Product "INFITRAN"
License_Customer "UNIVERSITY OF TEXAS"
License_OS_Type "UNIX"
License_Type "PERPETUAL"
License_Expiration_Date 2029.12.31          YYYY.MM.DD
License_NT_Servers 10000
License_UNIX_Servers 10000
License_Key B251-1D16-DF68-684F-BC81-E7E5-5A9C-1208

(3.) For agents connecting to the PROD environment, configure your license files per the example to the right.

# --- ucmd.conf ---

License_Product "INDESCA"
License_Customer "UNIVERSITY OF TEXAS"
License_OS_Type "UNIX"
License_Type "PERPETUAL"
License_Expiration_Date 2029.12.31          YYYY.MM.DD
License_NT_Servers 10000
License_UNIX_Servers 10000
License_Key A114-F5DD-889E-7331-6BC8-9BA5-9EBF-748D

# --- usap.conf and udm.conf are the same ---

(4.) Save and close the file(s).

 

To configure tasks in Stonebranch (and avoid SUDO errors) ensure the privilege(s) to run the Stonebranch task is assigned to the OS where the Stonebranch agent is installed and where the task will be running.

 

Add Agent to a Business Service

A Universal Agent can only be added to a Business Service by a Service Provider. To have this done, submit a request to stonebranch-requests@its.utexas.edu with the following information:

  • The department code assigned to your Business Service
  • Name of host(s) where agents are installed
  • The environment(s) for the agent(s).

This will generate a ticket in the Service Management tool.

Once the Service Provider team has completed this task, they will respond via the ticket.

to: stonebranch-requests@its.utexas.edu
 
Please assign the following agents to our Business Service in Stonebranch:
 
Department: DEPT01
 
Agent(s): foo-d01.dept.utexas.edu, foo-d02.dept.utexas.edu
Environment: DEV
 
Agent(s): foo-p01.dept.utexas.edu, foo-p02.dept.utexas.edu
Environment: PROD
 

 

Thank You! Your feedback has been submitted.

Feedback