Setting Up Eggplant Performance Injectors on Windows

The Windows injector software is installed with Eggplant Performance by default. But you can also install the Windows injector separately on a remote machine using the injector-only .msi file available for download. Instructions for installing the injector separately are provided below. For information about how injectors work, including information about the localhost injector installed with Eggplant Performance, see Managing Injectors.

For performance tests that use Optical Character Recognition (OCR) with Citrix virtual users (VUs), you must install an additional package on each injector machine: the Eggplant Performance OCR engine. You should install this component alongside the Windows injector (or alongside Eggplant Performance for the localhost injector).

Note: The OCR engine package uses 1 GB of disk space, so it should only be installed if needed.

Note: If you want to install Eggplant Performance on a machine where a Windows injector is installed, you must remove the existing injector before you can install Eggplant Performance. The Eggplant Performance installer will detect the injector and display a message telling you that you must uninstall it before you can install Eggplant Performance. Similarly, you must uninstall Eggplant Performance before you can install an injector.

Note: If Eggplant Performance Controller's localhost injector is sufficient for your testing, you do not need to perform the steps below.

If you want to install injectors separately on additional Windows systems without the full of Eggplant Performance product, follow the instructions below. The instructions are divided into the following tasks:

Install the injector
Run the injector
Install the injector service
Configure the injector service port
View the logs

Step by Step: Install the Injector

Verify that the machine on which you want to install the injector meets the system requirements as described in Injector Installation.
Download the latest Eggplant Performance Injector (Windows) installer from the Eggplant website.
Execute the installer.

Note: The injector is available in a .zip file that you can extract without running an installer. Injectors do not require a license to operate.

Run the Injector

Start the injector-only installation by running the runInjector.bat batch file, which, in the default installation location, is located at:

C:\Program Files (x86)\eggPlant Performance\bin\ or in C:\Program Files (x86)\eggPlant Performance Injector\bin\.

runInjector.bat

The injector listens on port 39000 by default. To change this, pass the desired port number as a parameter to the batch file on the command line as shown in the sample screen below. If you change the port, you must also set the corresponding Injector port within the Injector definition on the Controller.

Install the Injector Service

For convenience, you may want to install and run the injector as a Windows service. Running the injector as a service allows you to manage the injector process remotely (providing you have sufficient permissions). You can also set the injector to Automatic so that it restarts any time the machine reboots.

To install the injector as a Windows service, run the installInjectorService.bat batch file (located in C:\Program Files (x86)\eggPlant Performance Injector\bin\ in the default installation location) as Administrator.

This batch file creates a Windows service called Eggplant Performance Injector Service.

After you install the injector service, we recommend changing the Startup type from Manual to Automatic as follows:

In Control Panel, open Administrative tools, and then open Services.
Locate the service named Eggplant Performance Injector Service, right-click it, and then click Properties.
On the General tab, select Automatic from the drop-down list for the Startup type.
Change the user account you use to log on for the service, if necessary on the Log On tab. The Local System account often does not have the necessary permissions to start the service.
Click OK to save your changes.

Uninstall the Injector Service

To uninstall the injector service, run the following batch file as Administrator, located in C:\Program Files (x86)\eggPlant Performance Injector\bin\ in the default installation location: uninstallInjectorService.bat

Change the Default Injector Service Port

Injectors listen on port 39000 by default. However, you can configure the injector service to listen on a different port by adding a line of code to the installInjectorService.bat file before you run it.

In the Startup configuration section of he .bat file, add the following line of code:

set PR_STARTPARAMS=-p;<port_number>

Where <port_number> is the port on which you want the injector to listen. With this code, the port changes from 39000 to what is specified here. The Startup configuration section should look like this:

REM Startup configuration

set PR_STARTUP=auto

set PR_STARTMODE=jvm

set PR_STARTCLASS=com.testplant.injector.Injector

set PR_STARTMETHOD=startWindowsService

set PR_STARTPARAMS=-p;39001

Note: If you previously installed an injector on the same machine, you must uninstall the service before you modify you modify the .bat file. When you run the .bat file for installation, be sure to use the Run as Administrator option.

View the Injector Logs

Injector logs are stored in the injector.log file at the following location:

%APPDATA%\eggPlant Performance\logs\Injector\

If the injector is run as a service, then the logs can be located at:

eggplant performance injector service-stdout.YYYY-MM-DD.log
eggplant performance injector service-stderr.YYYY-MM-DD.log

This topic was last updated on August 19, 2021, at 03:30:52 PM.