Symantec Management Agent Utility Tool
search cancel

Symantec Management Agent Utility Tool

book

Article ID: 180557

calendar_today

Updated On:

Products

IT Management Suite Client Management Suite Server Management Suite

Issue/Introduction

What is the Symantec Management Agent Utility AeXAgentUtil.exe used for?

Environment

ITMS 8.x

Resolution

The Symantec Management Agent Utility tool (AeXAgentUtil) lets you perform the following functions from the managed computer:

  • Start and stop the Symantec Management Agent
  • Set the default Notification Server the Symantec Management Agent is configured to
  • Remove the Altiris Agent from a managed computer
  • Set up a log file for all running processes of the managed computer

Note: An Symantec Management Agent can only communicate with one Notification Server at a time. If you want to change the Notification Server that the Altiris Agent reports to, use this utility.

Running the utility

  1. On the managed computer, open Command Prompt.

  2. Open the InstallPath\Altiris\Altiris Agent directory and enter the following command:

         AeXAgentUtil [/Parameter]

         where [/Parameter] is the utility parameter you want to perform.

Utility Parameters

The following is a partial list of the parameters you can set to perform various tasks:

AeXAgentUtil

[/? | /h | /help]
[/Start]
[/Stop]
[/Clean]
[/Server:server]
[/Web:web]
[/RegisterMSXML]
[/EnableSmsClient]
[/RegisterClient]
[/ResetGUID]
[/DeleteDevices]
[/UninstallAgents]
[/ListProcess]
[/EnableASP]
[/Log:logname]
[/Diags] 
[/NoDiags]

Parameter

Description

[/? | /h | /help] 

Shows a usage dialog.

[/Start]

Starts the Altiris Agent

[/Stop]

Stops the Altiris Agent

[/Restart]

Stops and starts the Symantec Management Agent

[/Clean]

Attempts to completely remove the Symantec Management Agent. This will attempt to detect the relevant version and remove all files and registry entries.

Use this if the Symantec Management Agent installation fails on managed computers.

[/Server:server]

Sets a server as the Notification Server.

[/Web:web]

Sets the URL of the Notification Server. This is only valid if used with /Server.

By default, the Notification Server URL is
http://ServerName/Altiris.

Example:

To add a server with the Notification Server URL specified:
AeXAgentUtil.exe Server:server02
Web:https://server02/Altiris

[/RegisterMSXML]

Registers the MSXML library (MSXML through MSXML4).The MSXML library is used by the Altiris Agent and this parameter is provided for your managed computers that do not have the MSXML library registered.

[/EnableSmsClient]

Activates the SMS Client.

[/RegisterClient]

Registers the DLLs of the Symantec Management Agent.

[/DeleteDevices]

Deletes the known Altiris legacy device drivers.

[/UninstallAgents]

Deletes all registered agents installed by Altiris solutions (excluding the Altiris Agent).

[/ListProcess]

Logs all running processes to the filename set by /Log. In order to use this, /Log must be set.

[/EnableASP]

Permits the use of ASP pages for IIS 6 or later.

[/ResetGUID]

This parameter has been deprecated.

[/Log:logname]

Sets the log filename that will be used in the system32 directory. If this parameter is omitted, CEReportEvent logger will be used. Quotes are required if the filename has spaces.

 

Examples:

/Log:somelog.log

/Log:“long name.log”

[/Diags]
[/NoDiags]

Enables or Disables the Agent Diagnostics

Sample Scenario

In this scenario, a user has moved physical location from New York to Seattle. His administrator has instructed him to change the Notification Server his agent reports to. The server in New York is called NS NY1 and the server in Seattle is NS SE1. The user needs to do the following:

  1. On the managed computer, open Command Prompt.
  2. Open the InstallDir\Altiris\Altiris Agent directory and enter AeXAgentUtil [/ Server:NS SE1]. For example: 
    C:\Program Files\Altiris\Altiris Agent\AeXAgentUtil.exe /Server:ServerName /Web:https://ServerName.example.com/Altiris

 

Powered by Wolken Software