You can install or update the vRealize Log Insight Windows agent, specify a service account, and configure command-line parameters for the server, port, and protocol.

About this task

For MSI command-line options, see the Microsoft Developer Network (MSDN) Library Web site and search for MSI command-line options.

Prerequisites

  • Verify that you have permissions to perform installations and start services on the Windows machine.

  • If you use the silent installation options /quiet or /qn, verify that you run the installation as an administrator. If you are not an administrator and run silent installation, the installation does not prompt for administrator privileges and fails. Use the logging option and parameters /lxv* file_name for diagnostic purposes.

Procedure

  1. Log in to the Windows machine on which to install or update the vRealize Log Insight Windows agent.
  2. Open a Command Prompt window.
  3. Change to the directory where you have the vRealize Log Insight Windows agent .msi file.
  4. Run the command to start the installation or update and replace Version-Build_Number with your version and build number.
    Drive:\path-to-msi_file>VMware-Log-Insight-Agent-Version-Build_Number.msi

    Drive:\path-to-msi_file>VMware-Log-Insight-Agent-30.msi.

  5. (Optional) : Specify a user service account for the vRealize Log Insight Windows agent service to run under.

    Drive:\path-to-msi_file>VMware-Log-Insight-Agent-*.msi SERVICEACCOUNT=domain\user SERVICEPASSWORD=user_password

    Note:

    The account supplied in the SERVICEACCOUNT parameter is granted with the Log On As a Service right and full-write access to the %ProgramData%\VMware\Log Insight Agent directory. If the supplied account does not exist it is created. The username must not exceed 20 characters. If you do not specify a SERVICEACCOUNT parameter, the vRealize Log Insight Windows agent service is installed or updated under the LocalSystem service account.

  6. (Optional) : Enter the vRealize Log Insight server, port, and protocol.

    Parameter

    Description

    SERVERHOST

    IP address or host name of the vRealize Log Insight virtual appliance.

    SERVERPROTO

    Protocol that the agent uses to send events to the vRealize Log Insight server. The possible values are cfapi and syslog. Use the default cfapi setting.

    SERVERPORT

    The port number depends on the value of SERVERPROTO. The default value for SERVERPORT is 9000, which corresponds to the default SERVERPROTO=cfapi. Use SERVERPORT=514 for SERVERPROTO=syslog.

    The command-line parameters correspond to hostname, proto, and port in the [server] section of the liagent.ini file.

  7. Press Enter.

Results

The command installs or updates the vRealize Log Insight Windows agent as a Windows service. The vRealize Log Insight Windows agent service starts when you start the Windows machine.

What to do next

Verify that the command-line parameters you set are applied correctly in the liagent.ini file. See Configuring Log Insight Windows Agent After Installation.