Symantec Management Agent for UNIX, Linux, and Mac troubleshooting commands

Article:HOWTO93171  |  Created: 2013-10-22  |  Updated: 2013-10-23  |  Article URL http://www.symantec.com/docs/HOWTO93171
Article Type
How To

Subject


Symantec Management Agent for UNIX, Linux, and Mac troubleshooting commands

You can use commands for troubleshooting problems. You must execute them from within a command window on the target system. Unless you specify full path names, execute these commands from the local directory where the binary resides. Binary path locations are specified with each command.

Note:

The default agent installation directory for the Symantec Management Agent is /opt/altiris/notification/nsagent. You can modify it in the Symantec Management Console, under Settings > Installation Settings > Agent settings.

See Installing the Symantec Management Agent for UNIX, Linux, and Mac with a manual push.

Table: Symantec Management Agent commands

Purpose

Command from /opt/altiris/notification/nsagent/bin

Force a policy refresh.

aex-refreshpolicies

Send basic inventory.

aex-sendbasicinv

View available software package tasks with the option to execute them manually.

aex-swdapm

Manually uninstall the agent.

aex-uninstall

Restart the agent.

aex-helper agent restart

The Client Task Agent can display information about any tasks that have been assigned to the UNIX/Linux client. The following table lists useful commands for the Client Task Agent.

Table: Client Task Agent commands

Purpose

Execute this command from /opt/altiris/notification/ctagent/bin

Bring up help on a command.

aex-cta help

List current tasks and their execution instances.

aex-cta list

List tasks that are run on the client and their GUIDs.

aex-cta list --show-task-id

List pending tasks.

aex-cta pending

Refresh agent configuration.

aex-cta refresh

Force re-registration with the task server.

aex-cta register

Get information about currently registered task server.

aex-cta ts

Check if the agent is running.

aex-helper check

Retrieve a list of the managed delivery policies that are executed.

aex-cta list

Retrieve a list of the managed delivery policies and Quick Delivery tasks that are executed on the client.

aex-cta list --show-all-tasks

List plug-in installation tasks.

aex-smf list

Allow the deferment of task execution on the client according to task settings.

aex-swd-defer

Table: Software management commands

Purpose

Execute this command from /opt/altiris/notification/smfagent/bin

Display software management jobs and their status.

aex-smf list

The following table lists aex-helper commands. The aex-helper is a client-side utility to help troubleshoot problems and speed up administrator tasks.

The syntax for the utility is aex-helper [command options]

Table: Aex-helper commands

Purpose

Command from /opt/altiris/notification/nsagent/bin

Register dependencies between solutions.

adddep

Perform various tasks with the UNIX Agent.

agent

Change properties of registered RC services.

changerc

Check if the Symantec Management Agent for UNIX, Linux, and Mac is running.

check

Clean items from the XML registry.

clean

Display help on the specified command.

help

Query the agent for various information.

info

Install and registers RC scripts.

installrc

Work with the agent IPC framework.

ipc

Create wrapper scripts and links for libraries and executables.

link

List objects in the agent's registry.

list

Query the agent for various information.

query

Start, stop, and list registered RC services.

rc

Add an object to the agent's registry.

register

Uninstall solutions.

uninstall

Uninstall RC scripts.

uninstallrc

Remove wrapper scripts and links for libraries and executables.

unlink

Remove objects from the agent's registry.

unregister

Upgrade the Symantec Management Agent Plug-in

upgrade

You can also use a client-side log file to help troubleshoot problems. To troubleshoot using this log file, use the commands in the following table.

Table: Log file commands

Purpose

Command from /opt/altiris/notification/nsagent/var

Raise the logging level to debug state.

aex-helper agent -s Configuration debug_level debug

Turn off the limit of log size.

aex-helper agent -s Configuration debug_file_size 0

Return parameters to default.

aex-helper agent -s Configuration debug_level error

aex-helper agent -s Configuration debug_file_size 1024


Legacy ID



v71630705_v66611926


Article URL http://www.symantec.com/docs/HOWTO93171


Terms of use for this information are found in Legal Notices