| Panel | ||||
|---|---|---|---|---|
|
Objective
This Universal Agent 7.1.x for Windows Quick Start Guide provides a short summary on how to perform a Universal Agent installation on a Windows system and execute Universal Command and Universal Data Mover jobs. For a complete description of the installation process, see Universal Agent 7.2.x Installation, Upgrade, and Applying Maintenance.
...
- System requirements
- Downloading the Universal Agent 7.1.x for Windows distribution file.
- Extracting and installing Universal Agent 7.1.x on Windows.
- Licensing Universal Agent components.
- Encrypting passwords.
- Executing a Universal Command job.
- Executing a Universal Data Mover job.
- Running a system query.
System Requirements
Windows Versions
- Windows Server 2012
- Windows Server 2012 R2
- Windows Server 2016
- Windows Server 2019
System Installation |
|
|---|---|
User Mode Installation |
|
Additional Requirements
System Install |
| |||||
|---|---|---|---|---|---|---|
User Mode Install |
|
Platform Requirements
Since platform requirements may change with new releases of a product, please consult the Platform Support for Universal Controller 7.1.x and Universal Agent 7.1.x page to make sure that your platform is supported before performing an installation.
Downloading the Universal Agent 7.1.x for Windows Distribution File
The Universal Agent 7.1.x for Windows product distribution files (for System Install and User Mode Install) are available for download from the Stonebranch Customer Portal.
A customer user name and password - provided by Stonebranch, Inc. - are required to access the Customer Portal.
Installing Universal Agent 7.1.x via the Windows Installer Graphical Interface
Step 1 | Download the appropriate Universal Agent 7.1.x for Windows product distribution file to your work station: User Mode Install
|
|---|---|
Step 2 | Execute the distribution file to extract the files. The installation starts after the files are extracted. It first will verify that your machine meets the minimum system requirements. If the requirements are met, a Welcome dialog displays. |
Step 3 | Click the <Next> button. A list of Universal Agent components included in the package then displays. A drive icon displays next to each item in the list, indicating that the component will be installed. The Install To: field identifies the location where the components will be installed.
|
Step 4 | When you have selected the components (and their installation destinations) that you want to install, click the <Next> button to continue the installation process. Depending on the components selected, the installation may prompt for additional values, such as working folders for Server components. Follow the directions provided with each dialog to complete the installation. |
Licensing your Universal Agent 7.1.x for Windows Components
| Note | ||
|---|---|---|
| ||
A Universal Agent eventually will be required to obtain its license information from a Universal Controller or UCAM installation. Support for locally-configured license information will be removed at that time. |
...
The format of the product license file name is: <component name>_<customer name>_<operating system>_<schedule or solution>.txt. For example: Agent_Stonebranch_NT_A1.txt.
Universal Command Manager License File
For Universal Command Manager, Agent is used as the <component name> in the product license file name and as the name of the product in the product license file itself - see below.)
The following is a sample Universal Command Manager for Windows product license file:
| Panel |
|---|
Universal Data Mover Manager License File
For Universal Data Mover Manager, MFT is used as the <component name> in the product license file name and as the name of the product in the product license file itself - see below.)
The following is a sample Universal Data Mover Manager for Windows product license file:
| Panel |
|---|
Licensing Methods
Universal Agent 7.1.x for Windows components can be configured with product licenses either by:
...
| Note | ||
|---|---|---|
| ||
Universal Configuration Manager is installed during the Universal Agent 7.1.x for Windows installation. |
| Anchor | ||||
|---|---|---|---|---|
|
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:
|
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. |
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.
Encrypting User ID and Password for Job Execution
Job execution demands a user ID and password. This information should be stored in an encrypted file, which Universal Command and Universal Data Mover will process before starting a job.
Step 1 | Create a file containing a user ID (-userid id) and a password (-pwd password) for each component. |
|---|---|
Step 2 | Run the Universal Encrypt utility to encrypt the contents of the file. |
Step 3 | Execute Universal Command and Universal Data Mover using the encrypted file (-encryptedfile filename) option. |
Executing a Universal Command Job
The command line syntax for executing Universal Command for Windows is:
| Panel |
|---|
Executing a Universal Data Mover Job
The command line syntax for executing Universal Data Mover for Windows is:
| Panel |
|---|
Running a System Query
Use the Universal Query utility to query the Universal Broker for Broker-related and active component-related information. Universal Query returns information for the Universal Broker, as specified by configuration options on the command line or in a configuration file, as well as information regarding the components managed by Universal Broker.
...