Remote Altiris Agent Diagnostics 2.0

Article:HOWTO21449  |  Created: 2009-10-16  |  Updated: 2012-05-04  |  Article URL http://www.symantec.com/docs/HOWTO21449
Article Type
How To



Question

How do I remotely troubleshoot an agent without logging into the machine?

Answer

“Remote Altiris Agent Diagnostics” (RAAD) version 2 expands on the diagnostic checks and remediation actions performed by RAAD version 1 (HOWTO9637) to allow those checks and actions against a list of machines and not just the one machine. The Health Checks in RAAD version 2 are designed to take a look at the state of the Altiris solution plug-ins such as Patch, Task, SWD and Recovery to determine if they are working properly. Version 2 also allows the ability to run a Custom Inventory XML against the set of machines and return the results immediately so you can customize your own health check. You can examine more in-depth details of the Agents using the Diagnostics tab which is essentially RAAD version 1.  The biggest advantage with version 2 is that you can run remediation actions such as Configuration Request and Start Patching Cycle against as many machines as you’d like and all at once.

The process is to get a list of machines, run a health check against them, then by evaluating the results or drilling down into the diagnostics choose a remediation action to run against the machines you choose.

Note:
This tool is not supported by Altiris Support. If you have problems or comments please use this KB to send feedback.

Changes:
Ver. 2.1.24.0
         - Fixed blank SWD tab when Agent was upgraded from 6.0 to 7.x

Features:

  • x32 & x64 bit compatible for remote clients
  • Ability to pass credentials used to connect to remote clients
  • Multi-Threaded
  • Customizable and cache User Interface settings
  • Connect to Altiris 6.x and Altiris 7.x Agents
  • Ability to import a computer list from text file or Collection Picker method
  • Health Checks against a computer list for to scan for key data points for the subagents and core agent to function properly:
    • Basic Health Check
    • SWD Health Check
    • Patch Health Check
    • Recovery Health Check
    • Task Health Check
    • PS Health Check
    • Customized
  • Altiris Diagnostics on a single machine
    • See all settings that the Agent UI shows, except remotely
    • View Agent connection details
    • Log Viewer with filtering ability Ability to run Action(s) against multiple remote clients at once or just to a single client:
    • View SWD Details and Run History
    • View Package Server details
    • View Task Manager
    • View NSI Inventory files
    • View Client Policies
    • View Task History and connection details
    • View SWD Execution results
  • Ability to run Action(s) against multiple remote clients at once or just to a single client
    • Run a SWD Program
    • File Copy
    • Remote Execute a command line
    • Install Altiris Agent
    • Run Configuration Request
    • Send Basic Inventory
    • Stop and Start Altiris Services
    • Set Altiris Service to Automatic
    • Delete cached rules IAD/IBD file
    • Reset Agent Guid
    • Redirect Agent
    • WOL
    • Delete cached Inventory files
    • Disable Bandwidth Control
    • Start Patch Cycle
    • Run Patch Inventory
    • Run Patch Update
    • Set Logging Levels
    • Refresh Packages on PS
    • Resend Package Status on PS
    • Launch Resource Manager
    • Launch to Carbon Copy
    • Launch pcAnywhere
    • Launch to Package Sources
    • Reset Task Agent
    • Check for Tasks

Requirements:

  • Run the executable locally, not from a share
  • Host and remote machine must be Windows OS
  • WMI service must be running on remote clients
  • .NET Framework installed on host and remote machine
  • Altiris Agent must be installed on host
  • Firewall on the remote machine will also prevent Altiris actions
  • The following exceptions need to be added:
    • RPC TCP port 135
    • NetBIOS Netlogon and Browsing UDP port 138
    • SMB TCP port 445
    • ISOIPSIGPORT-2 TCP port 1107
  • Once connected, use Remote Execute to add Altiris Agent to firewall exception (it will be displayed as ENABLE), so that other functuions of RAAD v2 will work.

Usage:

To distribute desired application settings such as Remote Execute options edit the RAAD.exe.config and place it in the same folder as RAAD.exe. If user has altered application settings have them go to Settings - Change Application Settings and choose Restore All Setting to Default which will import your altered RAAD.exe.config.

Please add yourself as a subscriber so you receive notifications when this tool has been updated.   

Screenshots:


Attachments

Remote Altiris Agent Diagnostic (RAAD) tool ver 2.1.24.0
RAADv2.zip (1.1 MBytes)
RAAD User Guide (2011-08-02)
RAAD User Guide.pdf (1.2 MBytes)



Legacy ID



49683


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


Terms of use for this information are found in Legal Notices