Create a Transform File to Deploy Multiple vRealize Log Insight Windows Agents

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

• Verify that you have a copy of the vRealize Log Insight Windows .msi file. See Download Agent Installation Files.
• Download and install the Orca database editor. See https://learn.microsoft.com/en-us/windows/win32/msi/orca-exe.

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

   

   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.