Install agents in silent mode on Windows

You can configure and install a Deployment Automation agent in silent mode on Windows.

Install an agent silently

Silent mode uses an options file to run an installation in the background.

To install an agent in silent mode on Windows:

  1. Download and extract the agent installation files for Windows from the Software Licensing and Downloads portal (requires login).

  2. The agent installer is wrapped in the self-extracting executable file MicrofocusDA-agent-bundle.exe. Run the executable to extract the agent installer:

    MicroFocusDA-agent-installer.exe

  3. Create an options file and save it as C:/optionsFile.txt. For details, see Agent silent installation options.

    Note: Make sure your options file is in ANSI format. The agent installer does not support UTF.

  4. From a command prompt, run this command:

    MicroFocusDA-agent-installer.exe -silent -options optionsFile.txt

    where optionsFile.txt is your options file.

After you install agents, continue with the next steps in the Installation checklist.

Back to top

Agent silent installation options

The following table describes the agent silent installation options in an optionsFile.txt file for Windows.

Option Description 
-P installLocation
 The target location for installing the agent. 
-V IS_DESTINATION
 The target location for installing the agent. 
-V AgentName
 Name of the agent. You can also specify properties that are resolved dynamically on the server. For details, see Dynamically register agents. 
-V UseRelayYes
 To use an agent relay, set this option to true. Otherwise, set it to false. 
-V RelayHost
 (Required if -V UseRelayYes=true) The host name of the agent relay. 
-V RelayPort
 (Required if -V UseRelayYes=true) The port number of the agent relay. 
-V RelayProxyPort
 (Required if -V UseRelayYes=true) The proxy port number of the agent relay. 
-V ServerHost
 (Required if -V UseRelayYes=false) The host name of the DA server. 
-V ServerPort
 (Required if -V UseRelayYes=false) The port number of the DA server. 
-V ServerMutAuth
 To use mutual authentication with the server, set this option to true. Otherwise, set it to false. For details, see Configure SSL mutual authentication. 
-V JreNew
 To install a new JRE together with the agent, set this option to true. Otherwise, set it to false. 
-V JreInstallLoc
 (Required if -V JreNew=false) Specify the location of a preexisting JRE for the agent. 
-V ServiceYes
 To create a Windows service for the agent, set this option to true. Otherwise, set it to false. 
-V ServiceName
 (Required if -V ServiceYes=True) The name for the Windows service. 
-V ServiceStartAuto
 (Required if -V ServiceYes=True) For the Windows service to start automatically, set this option to true. Otherwise, set it to false. 
-V ServiceAccName
 (Required if -V ServiceYes=True) Specify the log on user account name for the Windows service. 
-V ServiceAccPass
 (Required if -V ServiceYes=True) Specify the log on user account password for the Windows service.

Back to top

Options file example

Use the following example of the optionsFile.txt settings to configure an agent's silent installation on Windows.

In this example, the agent named agent123 connects directly to the server on serverabc (not through an agent relay) and points to a new installation of a JRE. The mutual authentication mode for the agent is turned on. The agent runs as a Windows service named da-Agent123 that is set to start automatically when the system starts. The agent Windows service admin user account name is admin01, and the password is password.

Copy code 
-P installLocation="<install-dir>\Deployment Automation Agent"
-V IS_DESTINATION="<install-dir>\Deployment Automation Agent"
-V AgentName="agent123"
-V UseRelayYes="false"
-V ServerHost="serverabc"
-V ServerPort="7918"
-V ServerMutAuth="true"
-V ServiceYes="true"
-V ServiceName="da-agent123"
-V ServiceStartAuto="true"
-V ServiceAccName="admin01"
-V ServiceAccPass="password"
-V JreNew="true"

Back to top

See also: