Setting Up an Eggplant Performance Injector on Mac

The following instructions describe how to set up and run injectors on Mac systems without the full the Eggplant Performance installation. The instructions are divided into the following tasks:

• Install Java
• Install the injector
• Run the injector
• Configure the port
• View the logs

Step by Step: Install Java

The Mac injector runs using Java, but the application package (.pkg file) does not include it. Verify that a JDK (Java Development Kit) is installed before you install the Eggplant Performance injector.

note

This quote from the Oracle Mac FAQ explains why you need a JDK: "Installing a JRE from Oracle does not update java -version symlinks or add java to your path. For this functionality, you must install the full JDK."

1. Check whether a JDK is installed by entering the following command in a Terminal window:

   java -version

   

2. If you need to download a JDK, click More Info to open the Oracle website.

3. Download a JDK and follow the installation procedure.

   

4. After you install Java, enter java -version in a Terminal window again to display and verify the new version information.

   

Step by Step: Install the Mac Injector

Install the Eggplant Performance injector as follows:

1. Verify the machine on which you want to install the injector meets the system requirements as described in Injector Installation.

2. Download the latest Eggplant Performance Injector (Mac OS) from the Eggplant website. The Mac injector is available to download as an application package .pkg file.

   note

   Injectors do not require a license to operate.

3. Click to install the package file using Apple's Installer application.

   

4. During the installation, you may be asked to provide your Mac user account username and password.

   

5. Proceed through the injector installation wizard.

   

Run the Injector

The Mac injector runs as a daemon, which starts as soon as the installation process is finished, and runs automatically whenever the Mac boots up. You should be able to connect to it from Eggplant Performance Studio.

You can also start the injector daemon as described in Starting the Injector Manually, but you must first stop it as described in Stopping the Injector Daemon below.

note

The user specified to start the daemon must have superuser permissions. Otherwise, the daemon starts with insufficient permissions to write to the log files. When the injector runs with insufficient permissions, it responds to commands from Eggplant Performance Studio, but it does not work properly.

Stopping the Injector Daemon

1. To stop the injector daemon, run the following command in a Terminal:

   sudo launchctl unload /Library/LaunchDaemons/com.testplant.injector.Injector.plist

   note

   You must have superuser permissions in order to stop the daemon. Otherwise, you will see the following error when you execute the command above:

   launchctl: Error unloading: com.testplant.injector.Injector

2. Verify the injector stopped by checking the system log for a message that says the injector "Exited...."

   

Starting the Injector Daemon Manually

As explained above, the daemon restarts automatically when the Mac boots up. You can also restart it manually using the command below if you stop first it as described in Stopping the Injector above.

sudo launchctl load /Library/LaunchDaemons/com.testplant.injector.Injector.plist

note

You must have superuser permissions to start the daemon. Otherwise, the daemon starts with insufficient permissions to write to the log files, as seen below in Console. When you start the daemon with insufficient permissions, it responds to commands from Eggplant Performance Studio, but it does not work properly.

Configure the Port

By default, the injector listens for connections from the Test Controller machine on port 39000. However, you can change the port by performing the following steps:

1. Stop the injector daemon.

2. Using a user with superuser permissions, open the .plist file, which is located at:

   /Library/LaunchDaemons/com.testplant.injector.Injector.plist

   note

   You must have superuser permissions in to edit the .plist file.

3. Edit the line in the .plist file with the contents of the final <string> tag inside the <array> tag after <key>ProgramArguments</key> as shown where the cursor is in the sample screen below. By default this is 39000.

   

View the Injector Logs

You can view the injector logs as follows:

1. Open the Console application by navigating to Applications > Utilities.

2. In the list on the left, click to expand /var/log.

3. Click eggPlantPerformanceInjectorOut.log or eggPlantPerformanceInjectorErr.log.