As part of deploying multiple agents, you must create a transform file that specifies configuration parameters for deployment. The .mst transform file is applied to the .msi file when you install agents. Parameters include the destination server for the agents and the communication protocol, port, and user account for installing and starting the Log Insight agent service.

Parameters include the destination server for the agents and the communication protocol, port, and user account for installing and starting the Log Insight agent service.

Prerequisites

Procedure

  1. Open the vRealize Log Insight Windows agent .msi file in the Orca editor and select Transform > New Transform.
  2. Edit the Property table and add necessary parameters and values for a customized installation or upgrade.
    Figure 1. Property Table
    You can add rows of parameters and values to a Property table to customize the installation or upgrade of a Windows agent.
    1. Click Property.
    2. From the Table drop-down menu, select Add Row.
    3. Enter a property name and value in the Add Row dialog box.
      Parameters are shown in the following table.
    Parameter Description
    SERVERHOST

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

    The default is loginsight.

    SERVERPROTO

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

    The default is cfapi.

    SERVERPORT
    Communication port that the agent uses to send log events to the vRealize Log Insight or third party server. By default the agent uses the appropriate port based on the options that are set for SSL and the protocol. See default port values provided in the list below. You need to specify the port option only if it's different from these defaults.
    • cfapi with SSL activated: 9543
    • cfapi with SSL deactivated: 9000
    • syslog with SSL activated: 6514
    • syslog with SSL deactivated: 514
    SERVICEACCOUNT User service account under which the Log Insight Windows Agent service is run.
    Note: The account supplied in the SERVICEACCOUNT parameter must have the Log On As a Service privilege and write access to %ProgramData%\VMware\Log Insight Agent directory so that the installer runs correctly. If you do not specify a SERVICEACCOUNT parameter, the vRealize Log Insight Windows agent service is installed under the LocalSystem service account.
    SERVICEPASSWORD Password for the user service account.
    AUTOUPDATE

    Activate or deactivate auto-update for the agent. You must also activate auto-update from the vRealize Log Insight server to fully activate auto-update. The default is yes.

    LIAGENT_SSL

    Activate secure connection. If SSL is activated, the agent uses TLS 1.2 protocol to communicate to the server. The default is yes.

  3. Select Transform > Generate Transform and save the .mst transform file.

What to do next

Use the .msi and .mst files to deploy the vRealize Log Insight Windows agent.