Install a Load Generator Agent
The Controller features a built-in Load Generator Agent. You can install Load Generator Agents on other machines to further increase the loading capacity. You can install on Windows, Os X, and Linux.
Tip: To learn how the Load Generator is secured and how to further configure the settings, take a look at how to customize your connection security.

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_2024.2_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_2024.2_windows_<bitness>.exe -c
To install a Load Generator Agent in silent mode, follow these steps:
-
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
-
Run the command line
neoload_2024.2_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:
-
Open
neoload_8_1_0_osx.dmg
. -
Run NeoLoad Installer.app.
-
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:
-
In the
/etc/systemd/system/
directory, create the fileLoadGeneratorAgentService.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 -
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:
-
Open the terminal and type the command:
sudo sh neoload_8_1_0_linux_<bitness>.sh
-
Select the Load Generator Agent installation option.
To install a Load Generator Agent in console mode, follow these steps:
-
Open the terminal and type the command:
sudo sh neoload_8_1_0_linux_<bitness>.sh -c
-
Select the Load Generator Agent installation option.
To install a Load Generator Agent in silent mode, follow these steps:
-
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
-
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.