Universal Agent FAQ

Frequently Asked Questions for Universal Agent (All Platforms)
Updated July 25, 2003

This FAQ is Copyright (c) 2003 by OC Systems, Inc. ALL RIGHTS RESERVED.

1. General

1.1 What is the Universal Agent?

A Unicenter agent that provides a framework for communication between arbitrary applications and Unicenter NSM. The entire NSM portion of the Unicenter agent has already been written. This means you don't have to read, learn, or use, the Unicenter Agent SDK.

You need only add detail to specify what application information you want extracted. You use Aprobe to extract the desired application information.

1.2 Is the Universal Agent ca smart-certified?

Yes, for both the Windows and Solaris platforms.

1.3 What documentation is available?

The "Getting Started" document is available on the NSM manager machine at Start->Programs->OC Systems Universal Agent Integration->Getting Started Document. This document provides an overview of the product and describes how to install both the NSM Integration and Agent Modules for Windows and Solaris.

The primary documentation source is the Universal Agent Support page. Here you will find FAQs, agent integration examples, and update-to-date documentation.

1.4 What platforms are supported?

The Windows and Solaris platforms are currently supported. See the System Requirements page for details.

1.5 What is Aprobe?

Aprobe is OC Systems' patented application patching technology. See the Aprobe Product page for details.

1.6 How do I get technical support?

The best way is to send e-mail to or phone 703-359-8160, extension 3. You can expect a quick response between 9am and 5pm Eastern US Time.

2. Installation

2.1 Could you give me an overview of the product installation pieces and parts?

There are 3-components: the Universal Agent Integration, the Universal Agent Module for Windows, and the Universal Agent Module for Solaris.

You must install the Integration component first, then install as many Module (Windows or Solaris) components as desired, limited by licensing agreements.

The Integration component must be installed on the Unicenter NSM manager machine.

The Module components may be installed on any machine (Windows or Solaris) where a Unicenter agent is already installed. Note that this may include the Unicenter NSM manager machine.

2.2 How do I install the Universal Agent Integration?

The Universal Agent Integration installation package is distributed as a self-extracting InstallShield file and should be installed only on the Windows NSM manager machine.

This is described in the Getting Started Guide, but all you need do is execute the program UAIntegrationInstall.exe and follow the instructions it provides.

2.3 How do I install the Windows Universal Agent Module?

The Universal Agent Module installation package is distributed as a self-extracting InstallShield file and should be installed only on a Windows machine.

This is described in the Getting Started Guide, but all you need do is execute the program UAModuleInstall.exe and follow the instructions it provides.

2.4 How do I install the Solaris Universal Agent Module?

The Universal Agent Module installation package is distributed as a compressed "tar" file and should be installed only on a Solaris machine.

This is described in the Getting Started document, but all you need do is execute the following command sequence. Note that the recommended installation location is /opt/ocsua2_agent:

   cd /opt
   uncompress install_agent_solaris.tar.Z
   tar -xvf install_agent_solaris.tar
   cd ocsua2_agent
   . /opt/aprobe/setup
   install_agent_solaris.sh

2.5 Which files do I need to know about under the Universal Agent Integration Installation Directory?

First, don't delete the product installation directory; It is needed to un-install the Universal Agent Integration component!

The Universal Agent Integration installation resides on the Windows machine where the Unicenter NSM manager is installed. The Universal Agent Integration installation directory is normally located at:
C:\Program Files\OC Systems\Universal Agent Integration
There are no files of interest here.

2.6 Which files do I need to know about under the Universal Agent Module Installation Directory?

First, don't delete the product installation directory; It is needed to un-install the Universal Agent Module component!

The Windows Universal Agent Module installation resides on a Windows machine(s) and is normally located at:
C:\Program Files\OC Systems\Universal Agent Module

The Solaris Universal Agent Module installation resides on a Solaris machine(s) and is normally located at:
/opt/ocsua2_agent

For both the Windows and Solaris Universal Agent Module installations, you need to know about the following two files:

agent_support.h
This is the header file for the Universal Agent APIs. You need this file to compile new agents.
agent_support.dll (Windows)
agent_support.ual (Solaris)
This probe library provides the interface between the Aprobe "probes" you develop and Unicenter NSM. You need this file to execute new agents.

3. Agent Integration Examples

3.1 Where are the examples and how can I get them?

Examples (with full source code) of Universal Agent Integrations are available for download:

Each includes a readme file that covers installation and usage.

3.2 Do I need a C compiler to build the examples?

Yes:

  • On Windows, you need Microsoft Visual Studio 6.0 or higher.
  • On Solaris, you need a Sun Workshop compiler. (You can also use gcc but you'll have to change the Makefile.)

3.3 I'm getting compilation errors trying to build, looks like I'm missing a header file?

You're probably missing the "agent_support.h" header file.

First, you must locate file "agent_support.h". This file is located in the Universal Agent Module Installation Directory.

Either copy file "agent_support.h" directly into the example installation directory or modify the (n)make file to point to it.

3.4 I've built the example, now how do I run it?

First, you must locate file "agent_support.dll" (for Windows) or file "agent_support.ual" (for Solaris). This file is located in the Universal Agent Module Installation Directory.

Either copy file "agent_support.dll(ual)" directly into the example installation directory or modify the (following) Aprobe command line parameter to point to it.

Given that you've developed 2 probes named "foo.dll(.ual)" and "bar.dll(.ual)", for application "MyApp.exe(MyApp)", here's the command line you need to execute:

Windows:
aprobe -u foo.dll -u bar.dll -u agent_support.dll MyApp.exe
Solaris:
aprobe -u foo.ual -u bar.ual -u agent_support.ual MyApp