You can install or update the Windows agent from the command line.

About this task

You can use the default or specify a service account, and use command-line parameters to specify server, port, and protocol information. 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 following command to install or update with default values. Replace Version-Build_Number with your version and build number.

    The /quiet option runs the command silently, and the /lxv option creates a log file in the current directory.

    Drive:\path-to-msi_file>VMware-Log-Insight-Agent-Version-Build_Number.msi
    /quiet /lxv* li_install.log
  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) : You can specify values for the following command-line options as needed.

    Option

    Description

    SERVERHOST=hostname

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

    SERVERPROTO=protocol

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

    SERVERPORT=portnumber

    The port number used to connect to the server. The default value depends on the value of SERVERPROTO. If SERVERPROTO=cfapi, then the default port is 9543. If SERVERPROTO=syslog, then the default port is 6514.

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

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.