Introduction

These pages provide information on the installation of Stonebranch, Inc.'s Universal Agent on Microsoft Windows operating systems. Unless otherwise specified, all references to Universal Agent for Windows refer to one of the 7.6.x versions (for example: 7.6.0.0).

Installation Packages

Universal Agent is installed with one required installation package and three optional installation packages.

To obtain a Universal Agent package, you must download the corresponding product distribution file from the Stonebranch Customer Portal.

The following table lists the packages available, their supported platforms, distribution file names, and whether or not the package is required.

The word LEVEL in each distribution file name is a numeric value representing the product maintenance level contained in the distribution file.

Distribution File Format

The product distribution files are in a Windows self-extracting archive file format.

The names of the distribution files have the following format:

PROD-VRML-OS-HW.exe

• PROD is the package content

• VRML is the version, release, modification, and maintenance levels (for example, 7.6.0.0)

• OS is the name of the operating system supported

• HW is the hardware type supported

Universal Agent Installation Methods

There are two installation methods available for Universal Agent for Windows packages:

Detailed information for each method can be found on the following pages.

• System Installation

• User Mode Installation

System Installation

The system installation method uses a traditional Windows Installer-based package. This installation method "assumes" that it is the only Universal Agent instance on a system, and has the following distinguishing characteristics:

• The application is listed in Programs and Features, under the Windows Control Panel.

• Application files default to traditional install locations (for example, C:\Program Files).

• Universal Manager and Utility components are installed in the Windows System32 directory.

• Configuration and component definition files reside in in common, well-known locations (for example, C:\ProgramData).

• The installation contains the logic necessary to create a new account for running the Universal Broker service.

• The Universal Broker service name is not configurable. Its display name is Universal Broker, its registered service name is UBrokerService, and its Application event log message source is ubroker.

• The install contains logic to support upgrades from any prior release.

• Removal requires a proper Uninstall, via the Windows Control Panel.

• The installation is compatible with enterprise deployment tools (for example, SMS).

• The installation may install system libraries that the Universal Agent requires.

• The installation can automatically configure the Agent to simplify integration with other Stonebranch applications.

Pre-Installation Guidelines

Before starting the Universal Agent for Windows system installation, it is recommended that you close all other Windows programs. Active programs may be using system files that the Universal Agent installation may update.

If a system file is in use during the installation, it is placed in a temporary location. A reboot is required to free the file and move it from the temporary location to its final destination. Closing all programs before the installation reduces the possibility that a file will be in use and that you will have to reboot your computer.

Installation Path

The default installation path for most packages is:

• "C:\Program Files"

For the remaining 32-bit packages, the default installation path is:

• "C:\Program Files (x86)"

Installation Summary