Previous Topic: Updating an Agent with New User CredentialsNext Topic: AgentAuthUtil Command Examples


Run the AgentAuthUtil Utility

Use this procedure to update user credentials for the agent.

Important! This procedure is not part of the normal installation process.

To update the agent with new low-privilege user account credentials

  1. Log onto a Windows server where you have installed an agent.
  2. Access the command prompt and navigate to ...\CA\elmagent\bin.

    This is the directory that contains the AgentAuthUtil program that you use to perform the update.

  3. Enter the following command:
    agentauthutil -dir "<agent install directory>" <agent-username>
    

    Note: For a local user account, do not specify a domain, not even a dot (.).

    The default agent install directory is C:\Program Files\CA\elmagent, and the agent-username is the name you assigned to the user account you created in the Users group for this Windows server.

    When this command completes, the agent user named agent-username has full control (modify, read, execute, write, delete, list contents) over the agent installation folder, subfolders, and files.

  4. Enter the following command:
    agentauthutil -srv caelmagent <agent-username>
    

    The service name is caelmagent, and the agent-username is the name you assigned to the user account you created in the Users group for this Windows server.

    When this command completes, the agent user named agent-username can start, stop, pause, or continue (resume) the CA User Activity Reporting Module Agent service on the Windows agent host.

  5. Verify that the response messages indicate that each operation completed successfully.

    In this example, agent-username is elmagentusr. Example response messages from running this utility follow:

    This graphic shows a set of example responses messages generated by the agent authorization utility.

More information

Create a User Account for the Agent