Skip to main content

Persistent Connection Service (PCS)

The Eggplant Gateway Persistent Connection Service (PCS) is a service that enables you to manage your system under test (SUT) connections. It provides a web user interface that you can use to start, view, and stop your SUT connections.

PCS can manage connections you create in Eggplant Gateway, which are stored in a json file, or connections you create and save in Eggplant Functional using the Connection List, and which are stored in the Eggplant.plist file.

Installing PCS​

PCS is included with the Eggplant Gateway installation. For information about installing Eggplant Gateway, see Install Eggplant Gateway.

Starting PCS​

Launch PCS by following the steps below:

  1. Open a terminal.

  2. Change to your Eggplant Gateway directory.

  3. Run one of the following commands, depending on if you want to manage the connections you defined with Eggplant Gateway or those in your Eggplant Functional connection list:

    For Eggplant Gateway Connections:

    .\epgw.exe service

    For Eggplant Functional Connections:

    .\epgw.exe service --settingsStore studio

    PCS logs its start-up output to the terminal. When you see the message, "Sending connection list version 1 to clients", PCS is running.

Viewing Connections​

  1. Open a browser and navigate to localhost:5000 to display the PCS web interface. You see "Eggplant Gateway Available Connections" with a list of any available connections, including the name, status, and port for each connection.
note

You can only start and stop existing connections. You cannot add them using PCS at this time.

PCS Web UI The Eggplant Gateway PCS web UI with a connected demo SUT

Starting and Stopping Connections​

You can start and stop any of the connections listed in PCS, by selecting the connection, right-clicking and toggling the green arrow to start or red square to stop.

When you start a connection, you can see the progress, such as Connecting, under Status in PCS. If an error occurs, you see it under Error. When a connection starts successfully, a connection viewer window opens in PCS.

Last updated on