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.

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.

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.3_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.3_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.3_windows_<bitness>.exe -q -c -dir <installdir> -varfile response.varfile

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

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.

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.

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
                            

  1. Open the terminal and type the command:

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

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

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