Install a Load Generator Agent

Installing a Load Generator Agent requires administration rights.

When installing a Load Generator, you are prompted to decide if you want to also install the WAN Emulation driver, see Install the WAN Emulation.

Note: From NeoLoad 9.1, Load Generator Agent services are installed without administration rights. This disables the feature Smart upgrade. To keep the Smart upgrade feature, use the account Local System, this account has administrator rights.

To install a Load Generator Agent with the GUI installer, follow this step:

• Run neoload_2025.1_windows_<bitness>.exe, and select the Load Generator Agent installation option.

To install a Load Generator Agent in console mode, follow this step:

• Run the command line start /wait neoload_2025.1_windows_<bitness>.exe -c

To install a Load Generator Agent in silent mode, follow these steps: 

1. Create a "response.varfile" file with the same parameters as the code snippet below. To customize the file to your needs, define your own values.

   Copy

   
   # install4j response file for NeoLoad LG
   acceptedFingerprintsNotFormated=
   activateCertificateVerification$Boolean=true
   browserbased.installation$Boolean=true
   executeLauncherAction$Boolean=false
   installService$Boolean=true
   isLicenseAgreed$Boolean=false
   startOnBootUp$Boolean=false
   sys.adminRights$Boolean=false
   sys.component.Common$Boolean=true
   sys.component.Controller$Boolean=false
   sys.component.Controller\ Agent$Boolean=false
   sys.component.Load\ Generator$Boolean=true
   sys.component.Monitor\ Agent$Boolean=false
   sys.component.Paexec$Boolean=false
   sys.component.RealBrowser$Boolean=true
   sys.component.Windivert$Boolean=false
   sys.installationTypeId=Load Generator
   sys.languageId=en
   sys.programGroupDisabled$Boolean=true
                               

2. Run the command line neoload_2025.1_windows_<bitness>.exe -q -c -dir <installdir> -varfile response.varfile

Tip: To start the Load Generator as a service, set the installService$Boolean key to True.

Caution: The "windivert32.sys" (or 64) WAN emulation driver can be detected as a malware on windows depending on the antivirus configuration. It is not mandatory if you don't want to use the WAN emulation. If you want to use WAN emulation, whitelist "windivert64.sys" or "windivert32.sys" depending on your system (32 or 64 bits).

To install a Load Generator Agent with the GUI installer, follow these steps: 

1. Open neoload_8_1_0_osx.dmg.

2. Run NeoLoad Installer.app.

3. Select the Load Generator Agent option.

Installing a Load Generator Agent requires you to be part of the sudo group.

Note: When the Load Generator Agent is installed using the root account under Unix, the Agent is automatically declared as a service on the system. The LoadGeneratorAgentService.service service is subsequently launched each time the system is started.

In order for the Load Generator Agent to boot at the restart of your Linux machine, create the LoadGeneratorAgentService.service service during installation.

To create manually your own service "LoadGeneratorAgentService.service", follow these steps: 

1. In the /etc/systemd/system/ directory, create the file LoadGeneratorAgentService.service with the content below by changing your paths accordingly:

   Copy

   [Unit]
   Description=NeoLoad Load Generator Agent
   Before=multi-user.target graphical.target
   After=network-online.target remote-fs.target time-sync.target
   Wants=network-online.target
   [Service]
   Type=exec
   ExecStart="/opt/Neoload8_1/bin/LoadGeneratorAgentService" start-launchd
   SuccessExitStatus=0 143
   [Install]
   WantedBy=multi-user.target graphical.target

2. To enable it so that it can start at boot time, open the terminal and type the command:

   sudo systemctl enable LoadGeneratorAgentService.service

To install a Load Generator Agent with the GUI installer, follow these steps: 

1. Open the terminal and type the command:

   sudo sh neoload_8_1_0_linux_<bitness>.sh

2. Select the Load Generator Agent installation option.

To install a Load Generator Agent in console mode, follow these steps: 

1. Open the terminal and type the command:

   sudo sh neoload_8_1_0_linux_<bitness>.sh -c

2. Select the Load Generator Agent installation option.

To install a Load Generator Agent in silent mode, follow these steps: 

1. Create a "response.varfile" file with the same parameters as the code snippet below. To customize the file to your needs, define your own values.

# install4j response file for NeoLoad LG
acceptedFingerprintsNotFormated=
activateCertificateVerification$Boolean=true
browserbased.installation$Boolean=true
executeLauncherAction$Boolean=false
installService$Boolean=true
isLicenseAgreed$Boolean=false
startOnBootUp$Boolean=false
sys.adminRights$Boolean=false
sys.component.Common$Boolean=true
sys.component.Controller$Boolean=false
sys.component.Controller\ Agent$Boolean=false
sys.component.Load\ Generator$Boolean=true
sys.component.Monitor\ Agent$Boolean=false
sys.component.Paexec$Boolean=false
sys.component.RealBrowser$Boolean=true
sys.component.Windivert$Boolean=false
sys.installationTypeId=Load Generator
sys.languageId=en
sys.programGroupDisabled$Boolean=true
                            

2. Open the terminal and type the command:

   sudo sh neoload_8_1_0_linux_<bitness>.sh -q -c -dir <installdir> -varfile response.varfile

Tip: To start the Load Generator as a service, set the installService$Boolean key to true.

Note: If you intend to use WAN Emulation in your tests, you need to install the WAN Emulation driver manually.