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

Agent-server setup requires a minimum set of properties.


  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 Manager server. 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 vRealize Operations Manager user name, 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/ set-property PropertyKey PropertyValue
    Windows ./bin/ep-agent.bat set-property PropertyKey PropertyValue
    The properties are encrypted in the file.