The agent.properties file contains properties that you can configure to manage communication.

About this task

Agent-server setup requires a minimum set of properties.

Procedure

  1. Specify the location and credentials the agent must use to contact the vRealize Operations Manager server.

    Property

    Property Definition

    agent.setup.serverIP

    Specify the address or hostname of the vRealize Operations Manager server.

    agent.setup.serverSSLPort

    The default value is the standard SSL vRealize Operations Manager server listen port. If your server is configured for a different listen port, specify the port number.

    agent.setup.serverLogin

    Specify the user name for the agent to use when connecting to the vRealize Operations Managerserver. If you change the value from the username default value, verify that the user account is correctly configured on the vRealize Operations Manager server.

    agent.setup.serverPword

    Specify the password for the agent to use, together with the user name specified in agent.setup.camLogin, when connecting to thevRealize Operations Manager server. Verify that the password is the one configured in vRealize Operations Manager for the user account.

  2. (Optional) : Specify the vRealize Operations Manager server certificate thumbprint.

    Property

    Property Definition

    agent.setup.serverCertificateThumbprint

    Provides details about the server certificate to trust.

    This parameter is required to run a silent installation.

    Either the SHA1 or SHA256 algorithm can be used for the thumbprint.

    By default, the vRealize Operations Manager server generates a self-signed CA certificate that is used to sign the certificate of all the nodes in the cluster. In this case, the thumbprint must be the thumbprint of the CA certificate, to allow for the agent to communicate with all nodes.

    As a vRealize Operations Manager administrator, you can import a custom certificate instead of using the default. In this instance, you must specify a thumbprint corresponding to that certificate as the value of this property.

    To view the certificate thumbprint value, log into the vRealize Operations Manager Administration interface at https://IP Address/admin and click the SSL Certificate icon located on the right of the menu bar. Unless you replaced the original certificate with a custom certificate, the second thumbprint in the list is the correct one. If you did upload a custom certificate, the first thumbprint in the list is the correct one.

  3. (Optional) : Specify the location and file name of the platform token file.

    This file is created by the agent during installation and contains the identity token for the platform object.

    Property

    Property Definition

    Windows: agent.setup.tokenFileWindows

    Linux: agent.setup.tokenFileLinux

    Provides details about the location and name of the platform token file.

    The value cannot include backslash (\) or percentage(%) characters, or environment variables.

    Ensure that you use forward slashes (/) when specifying the Windows path.

  4. (Optional) : Specify any other required properties by running the appropriate command.

    Operating System

    Command

    Linux

    ./bin/ep-agent.sh set-property PropertyKey PropertyValue

    Windows

    ./bin/ep-agent.bat set-property PropertyKey PropertyValue

    The properties are encrypted in the agent.properties file.