Previous Topic: Troubleshoot the Report Agent on a UNIX ComputerNext Topic: Library Path Environment Variable Example

Troubleshooting Guide › Troubleshooting the Reporting Service › How to Troubleshoot the Reporting Service › Troubleshoot the Report Agent on a Windows Computer

Troubleshoot the Report Agent on a Windows Computer

Valid on Windows

The Report Agent collects scheduled snapshots of the local CA ControlMinder database and any policy model databases (PMDBs) on the endpoint, and sends this snapshot in XML format to the report queue on the Distribution Server.

Note: The Report Agent also performs other tasks. For more information about the Report Agent, see the Reference Guide.

To troubleshoot the Report Agent on a Windows computer

  1. Verify that the following configuration settings are correct. The configuration settings are located in the following registry key: 
    HKEY_LOCAL_MACHINE\SOFTWARE\ComputerAssociates\AccessControl\ReportAgent

    Note: You can use either CA ControlMinder Endpoint Management or selang commands to verify the value of the configuration settings. However, for this procedure we recommend that you use selang commands in the config environment to change the value of configuration settings. Using selang commands lets you change the configuration settings in this procedure without having to stop and restart CA ControlMinder.

    reportagent_enabled

    Specifies whether reporting is enabled (1) on the local computer.

    Default: 0

    Important! You must set the value of this configuration setting to 1 to enable the Report Agent to run automatically. If the value of this configuration setting is 0, the Report Agent does not send scheduled snapshots of the database to the Distribution Server. However, if the value of this configuration setting is 0 you can still run the Report Agent in debug mode.

    schedule

    Defines the schedule of when reports are generated and sent to the Distribution Server.

    You specify this setting in the following format: time@day[,day2][...]

    Default: 00:00@Sun,Mon,Tue,Wed,Thu,Fri,Sat

    Example: "19:22@Sun,Mon" generates reports every Sunday and Monday at 7:22 pm.

    send_queue

    Defines the name of the Message Queue on the Distribution Server to which the Report Agent sends snapshots of the local database.

    Default: queue/snapshots

    Important! Do not change the default value of this configuration setting.

  2. Verify that the following configuration setting is correct. The configuration setting is located in the following registry key: 
    HKEY_LOCAL_MACHINE\SOFTWARE\ComputerAssociates\AccessControl\Common\communication
    Distribution_Server

    Defines the Distribution Server URL.

    Note: The default port for TCP communication is 7222 and the default port for SSL communication is 7243. You should verify that the Distribution Server URL specifies the correct port number for the communication type.

    Default: none

    Example: ssl://172.24.176.145:7243. This URL configures the Report Agent to communicate with the Distribution Server at the IP address 172.24.176.145 on port 7243, using the SSL protocol.

  3. Verify that the CA ControlMinder Report Agent service is started.

    Note: You must set the reportagent_enabled configuration setting to 1 to configure the CA ControlMinder Report Agent service to start automatically.

  4. Open a command prompt window and stop CA ControlMinder: 
    secons -s

    CA ControlMinder stops, including the Report Agent service.

  5. Run the Report Agent in debug mode, using the following command: 
    reportagent -debug 0 -task 0 -now
    reportagent

    Runs the Report Agent.

    -debug 0

    Specifies to run the Report Agent in debug mode and to display the output on the console.

    Note: You cannot run the Report Agent in debug mode if the Report Agent service is started.

    -task 0

    Specifies that the Report Agent collects and sends information about the CA ControlMinder database, and any local PMDBs, to the Distribution Server. This information is used to generate CA ControlMinder reports.

    -now

    Specifies to run the Report Agent now.

  6. Review the Report Agent output as follows:
  7. Start CA ControlMinder: 
    seosd -start

    CA ControlMinder starts and the Report Agent service is started.

Example: Report Agent Output

The following Report Agent output shows the Send Queue and Report File parameters:

------------------------------------------------------------------------
Send report parameters:
------------------------------------------------------------------------
Send Queue................... queue/snapshots
Report File.................. C:\Program Files\CA\AccessControl\data\db2xml\ACDB.xml
------------------------------------------------------------------------
start sending report to queue 'queue/snapshots'...