Using System Helper with Eggplant Manager

System Helper is a service that comes bundled with Eggplant Manager for Mac and Windows. It enables different actions depending on the operating system you're using to run Eggplant Manager. System Helper is inactive by default, so you must start it manually the first time you use it.

Learn more about System Helper for your operating system:

System Helper on Mac

System Helper for Mac allows Eggplant Manager to launch iOS Gateway to run tests on iOS devices.

Start System Helper

You need to start System Helper manually the first time you use it.

  1. Open /Library/TestPlant/start_system_helper.command, or run that command from the Terminal.
  2. On the System Helper Automatic Startup dialog box, click Yes to make System Helper automatically start when you log in to your Mac.

    Eggplant Manager System Helper Automatic Startup dialog for Mac

System Helper on Windows

Eggplant Manager runs with a system service account type rather than a user account, which can cause problems when working with repositories in Windows environments. System Helper runs command line commands for repositories with a local user account (that of whoever is logged in on the Windows machine) instead of the Eggplant Manager system service account, enabling connections to repositories.

Start System Helper

You need to start System Helper from the Windows Start menu the first time you use it.

  1. Go to Start > All Programs > TestPlant > eggPlant Manager, then click System Helper.
  2. On the System Helper Automatic Startup dialog box, click Yes to make System Helper automatically start when you log in to Windows.

    System Helper Automatic Startup dialog window

Enable System Helper in Eggplant Manager

System Helper must be enabled on every repository for which you want to use it.

  1. From the Admin menu, select Repositories.

    Note: Only users with the Administrator role can see and access the Admin menu.

  2. Select an existing repository and click Edit Repository. You can also select New Repository to create a new repository and enable System Helper.
  3. In the edit window, select the Use System Helper checkbox.

    System Helper in repository window

Launch System Helper without Logging In

You can use the Task Scheduler in Windows to launch System Helper any time the machine running it boots up without requiring a logon.

  1. Go to Control Panel > System and Security > Administrative Tools > Task Scheduler.
  2. Click Import Task.
  3. Navigate to C:\TestPlant\applications\resources\systemhelper\SystemHelper.xml and select it.
  4. Click Change User or Group.
  5. Enter the username that System Helper should run under in the Enter the object name to select text box. Click OK.
  6. When prompted, enter the password for the user System Helper should run as. The SystemHelper task now displays in the Task Scheduler Library. You might need to close and restart the Task Scheduler for the list to update.
Note: If you want to launch System Helper using the Task Scheduler, you need to disable System Helper Automatic Startup.

Disable System Helper Automatic Startup

To stop System Helper from automatically starting on login, you must remove its registry key.

  1. Go to the Start menu and search for regedit.
  2. Click Yes to allow the Registry Editor to make changes to your computer.

    Registry Editor permissions panel

  3. Delete TestPlantSystemHelper from this directory: HKEY_CURRENT_USER\SOFTWARE\Microsoft\Windows\CurrentVersion\Run\

 

This topic was last updated on June 21, 2019, at 02:49:49 PM.

Eggplant icon Eggplantsoftware.com | Documentation Home | User Forums | Support | Copyright © 2019 Eggplant