Asset Vision®Asset Vision® OptimizeIntroduction and SetupHow to Download and Setup the Optimize Agent

How to Download and Setup the Optimize Agent

The Agent installation file can be downloaded from your Asset Vision Optimize instance.  The file can be installed on an individual basis or packaged and distributed across your environment using your preferred distribution method.  Agent status can be monitored by an Asset Vision admin under the System Configuration tab.  The status menu displays all agent machines, update, problem, and various upgrade statuses that are explained in detail below.

Downloading and Installing the Optimize Agent

Downloading and Installing the Optimize Agent
  1. Navigate to Setup > Agents > Deployment > Agent Download.
  2. Click on the desired Download Installer link to download the appropriate installer package:
    • EXE for Windows-based machines
    • PKG for Mac OS X based machines

Installing an Agent on a Windows-based machine

For Windows-based machines, the executable (EXE) may be run locally on the client machine, or executed using any existing remote management tool to install the agent. Once agents are installed and start reporting in you will see them under the Status menu. Locally Administrator privileges are required to install the agent onto the machine.

As an optional installation verification step, once the agent is installed, there will be two Windows Services created:

  1. SSI Survey Client - The main Agent service. It has an associated process named SurveyClientNT.exe that runs anytime the machine is running.
  2. SSI Installer Service - The Installer/Controller for the SSI Survey Client service. It has an associated process named SCInstallerNT.exe which is run only anytime the SSI Survey Client needs to be restarted, installed, uninstalled, or updated.

Installing an Agent on a Mac OS X machine

For Mac OS X machines, the PKG file is to be run locally on the client machine. Once agents are installed and start reporting in you will see them under the Status menu. Locally Administrator privileges are required to install the agent onto the machine.

To install the agent:

  • Run the OSX agent installer (avagent.pkg).
  • Proceed through the typical OS X installer steps.
  • You may be prompted to enter administrative account credentials. Enter these credentials and click on Install Software. The installer process will start.
  • When the process completes installation you’ll see a final window with a message "Installation complete!". Click on Close.

As an optional installation verification step, once the agent is installed, you should see two running processes in Activity Monitor that will indicate its proper installation:

  1. avagent.bin - This is the primary agent executable.
  2. avagent-usage.bin - This is the agent session client.

NOTE: In-place upgrades of the OSX agent are not supported. To install a new version of the OSX agent, an existing agent must be uninstalled first.

Post-installation Steps:

macOS Catalina

After the agent is installed on macOS Catalina, you may see popup windows that request "Input Monitoring" and "Screen Recording" permissions. These are required for the macOS agent. Once these permissions are granted, click on the "Quit Now" for them to take effect.

macOS Mojave

After the agent is installed on macOS Mojave, you will need to grant "Accessibility" permission to the "avagent-usage" application. This permission is required for the macOS agent. A user can grant this permission under "Security & Privacy" as show below:

macOS High Sierra

No additional permissions are required for High Sierra or older.

Installing an Agent on a Chrome OS device

Installation of an Agent on a Chrome OS device requires that you have an active Google Directory Services account and Google-approved Chrome OS devices enrolled and managed in your Google Admin Console. For more information regarding installing and configuring agents on Chrome OS devices, please see the Chrome OS Agent Configuration lesson.

Check the Status of the Agent

Check the Status of the Agent

The Agent Status Dashboard provides a default summary display of agent status data and can be configured to add additional graphs, charts, and other visual representations of Optimize Agent data.

Machines with Agents

Machines with Agents

The Machines with Agents menu displays all machines that have agents installed.  The Quick status column provides a color coded guide for agent status.  

  • Green: agent is up to date and has recently reported in
  • Yellow: agent is out of date and requires update
  • Red: agent has not made contact in more than a week

All other menus organized under the Machines with Agents menu are a subset of this menu but with predefined filters for ease of display and management.

Machines with Updated Agents

Updated Agents

Updated Agents displays all machines that have been updated to the latest agent version and have recently reported in.

Devices with Statuses other than Updated

Check if Device has a Problem Status

All of the other sub-menu items link to data views with filters to help find machines with agents that are not fully up-to-date:

  • Problem Status displays all machines with agents that have not reported in within the last week or have reported an error status from the agent.
  • Version Upgrade Pending displays all machines that have been selected for an agent upgrade, but have not yet reported in and upgraded to the Required Version.
  • Non-Current Version displays all machines that have not been upgraded to the latest agent version package.  The Current Package version can be viewed under the Advanced settings in the Agent Configuration menu.
  • Config Update Pending displays all machines that have not been updated to the latest Agent Configuration settings.  The latest Agent Required Config Time can be viewed under the Advanced settings in the Agent Configuration menu.
  • Machines without Agents displays all machines that have been discovered in your environment but do not have an Optimize Agent installed.