Previous Topic: Updating an Agent with New User Credentials

Next 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 Enterprise Log Manager 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