Agent General Information

1. Overview
2. Accounts the Agent Uses for Day-to-day Operations
3. Information Sent During Check-in
   1. Computers
   2. Monitors
4. Blacklisting an Agent
5. Agent Signups
   1. Resignup
   2. MACSignup
6. Document Revision History

Overview

LabTech agents are client applications that run as a service on a computer, and enable it to report into your LabTech server for reporting, monitoring, script execution, etc. Computers running the LabTech agent are sometimes referred to as agent computers, remote computers or just remotes.  Before you deploy agents, the client and location must be configured in LabTech. For more information on deploying agents, please refer to the appropriate documentation for the type of agent (e.g, Windows, Mac, Linux).

This document will cover some basic agent information.

Accounts the Agent Uses for Day-to-day Operations

• LTSVC runs under the LOCAL SYSTEM account in low priority.
• LTTRAY runs as each and every user that is logged in to run commands (e.g., capture screenshot, VNC to specific session, prompt user, chat, etc.).

Information Sent During Check-in

Every time an agent status update occurs (every five minutes) the following information is sent to the LabTech server.

Computers

• Total Memory
• Available Memory
• CPU Usage
• Users Logged in
• Idle Time
• Bytes In
• Bytes Out
• Installed Tools
• Uptime
• Remote Address
• Local Address
• MAC Address
• LabTech status (Permissions) column of table
• Flags
• Bandwidth

Monitors

• All Failed and Successful Monitors

Blacklisting an Agent

The registry key ‘MACBlackList’ can be used to blacklist an agent.  This needs to be set at HKLM\SOFTWARE\LabTech\Global (32bit) or HKLM\SOFTWARE\Wow6432Node\LabTech\Global (64bit). If the value is set to ‘ALL’ then it shuts down all signups. If it is a comma seperated list of MAC addresses (e.g., mac,mac,mac,mac), then it will not allow any matches to signup. Use this to blacklist an agent.  MAC Format is 00-00-00-00-00-00 in hex.

Agent Signups

Resignup

Resignup is a registry key that controls the resignup of a decommissioned agent. Default value = True. When the agent attempts to check-in to the server and the password is not the correct password, the server will not allow it access. The server will communicate to the agent to drop the account and resignup. Please note that an agent will open resignup if it has NEVER checked in successfully to the system. This secures agents againt DNS Poisoning, but allows agents that have been removed from the system to recommission themselves.

To change the default value:

1. Open the Registry Editor on the LabTech server (e.g., regedit).
2. Locate HKLM\SOFTWARE\LabTech\Global (32bit) or HKLM\SOFTWARE\Wow6432Node\LabTech\Global (64bit).
3. Right-click in the list of values and select New > String Value.
4. Create the appropriate string value (Resignup) and set the Value to 'False' if you do not want agents to ever recommission themselves.
5. Close the Registry Editor.

MACSignup

If you were deploying a brand new agent and then decided to format the computer, reinstall Windows and then re-install the agent, typically the agent would be given a new agent ID. These registry keys will prevent this allowing you to keep the history if the MAC address matches.

Example: If you were re-imaging a bunch of machines and wanted to re-sign them all up approximately an hour after they were down, you would set the MacSignupTimeLimit lower, re-signup all of the machines and then increase the value.

• MacSignup: Global registry key. Enables the ability for NEW agent signups to use existing computer accounts instead of making a new account, by default. The account it uses is the one with the SAME MAC address. Default value = True.
• MacSignupTimeLimit: This is how long the agent must be offline, in minutes, before the system will allow the account to be reassigned.
  Default value = -4320 minutes (3 days). The negative number indicates offline. To disable this, you can set it to a positive number and online agents can be re-assigned or you can change the MacSignup key to 'False'.

To change the default values:

1. Open the Registry Editor on the LabTech server (e.g., regedit).
2. Locate HKLM\SOFTWARE\LabTech\Global (32bit) or HKLM\SOFTWARE\Wow6432Node\Global\LabTech (64bit).
3. Right-click in the list of values and select New > String Value.
4. Create the appropriate string values, if applicable.
5. Close the Registry Editor.

Document Revision History