Knowledge Base

Showing results for 
Search instead for 
Did you mean: 

How do I add startup parameters to the Machine Agent?

How Windows users can pass startup parameters to their Machine Agent


Windows users who wish to pass startup parameters such as proxy details to their Machine Agent should follow these steps:


  1. Stop the Machine Agent service.

  2. Navigate to the <Machine Agent -Dir>\bin directory.

  3. Create a new empty file called MachineAgentService.vmoptions.

  4. Navigate to the <MachineAgent Home>/InstallService.vbs file and add the following lines of code before vmOptionsFile.WriteLine:

    For example:
    Set vmOptionsFile = fsObject.OpenTextFile(scriptDir & "\bin\MachineAgentService.vmoptions", OVERWRITE, True)

    • NOTE: Do not create "MiniDump on crash". If the option is not supported by the JRE, the executable will ignore it.


  5. Save the changes.

  6. Restart the service. 
Version history
Revision #:
4 of 4
Last update:
‎10-05-2020 06:52 PM
Updated by:
Labels (1)

Found this article helpful? Click the Thumbs Up button.
Have an additional comment? Post it below.
0 Kudos

Require your help on the following queries/issues:


  1.  I am not able to find <MachineAgent Home>/InstallService.vbs in the  Non-JRE windows install (i.e. within or even in the latest install

    How do I run this Non-JRE bundled Agent as a Windows service?

  2. If I download the Windows machine agent with JRE bundled (i.e. machineagent-bundle-64bit-windows-, I cannot find out how to specify so that the windows service takes the JRE which is already installed in the host machine. 

    If I delete the <MachineAgent Home>/jre from the bundled after unzipping will it (
    MachineAgentService.exe ) pickup %JAVA_HOME% from the System environments parameter? 

  3.  How/Where to get the list of parameters accepted by MachineAgentService.exe ? Is this exe has a dependency on .NET Framework?

Hi Pranabesh,

 It is required to install Machine agent with the bundled JRE , then only we can able to pass the parameters to machine agent service.

  If you would like to points to JRE located on your host , need to change the Java home parameter & path accordingly.