Adding SUTs in Eggplant Manager

Before selecting a system under test (SUT) for a test run, you must add it to Eggplant Manager so that the appropriate connection is made at runtime. You add SUTs on the SUTs page by going to Admin > SUTs.

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

For general information about working with the SUTs administration page, see Working with Systems Under Test (SUTs).

You have several methods for adding new SUTs, as well as many types of SUTs that Eggplant Manager supports. The method you choose for adding a SUT might be determined by the type of SUT you're adding as well as other factors. Be sure to read the following sections carefully so that you can make the appropriate choice.

Note: SUTs that you add to Eggplant Manager are placed in the Default Group. Be sure to remove them from this group and add them to your own groups if you intend to use groups to control user access to specific SUTs. For information about using groups to manage access, see Working with Eggplant Automation Cloud Groups.
Note: For information about using Eggplant Automation Cloud with other testing tools, such as Selenium or Appium, see Using Eggplant Automation Cloud with Other Testing Tools.

Using SUT Discovery to Add SUTs

Use the SUT Discovery feature on the SUTs administration page to find test environments and automatically add basic information about the environment. This method is a good choice for adding multiple SUTs as well as for adding mobile device SUTs because much of the information on the New SUT dialog box is filled in for you.

SUT Discovery feature on the SUTs administration page in Eggplant Manager

The SUT Discovery section of the SUT administration page in Eggplant Manager

Choose Discover LAN SUTs, which locates any environment reachable via your LAN, or Discover USB SUTs, which locates mobile devices (Android or iOS) that are currently connected via USB, or Import SUTs from Eggplant Functional. Follow the appropriate instructions shown below to add SUTs with the automatic discovery feature.

Step by Step: Adding LAN SUTs with SUT Discovery

The following steps guide you through adding SUTs from your LAN by using the SUT Discovery feature:

  1. In Eggplant Manager, go to the SUTs page by choosing Admin > SUTs, then locate the SUT Discovery section.
  2. Click Discover LAN SUTs. Eggplant Manager searches for all environments reachable via the LAN. You'll see a progress bar during the search. When the search is complete, the Find LAN SUTs dialog box shows the list of SUTs available to add.
    Select SUTs you want to add in Eggplant Manager's Finding LAN SUTs dialog box
  3. Select the checkbox for the SUTs you want to add, then click Save Selected. The new SUTs are added to the SUTs list at the top of the page. The IP address is added automatically, and the connection type defaults to VNC.
  4. Add or update information about the device in the Edit SUT dialog box, if necessary.

The SUT is now ready to be used for running tests through Eggplant Manager.

Step by Step: Adding Mobile Device SUTs with SUT Discovery

The following steps guide you through adding a USB SUT for a mobile device using SUT Discovery:

  1. Connect the mobile device via USB to the computer where your Eggplant Manager server is running.
  2. In Eggplant Manager, go to the SUTs page by choosing Admin > SUTs, then locate the SUT Discovery section.
  3. Click Discover USB SUTs. Eggplant Manager searches for any devices connected to the Eggplant Manager machine via USB. Eggplant Manager creates a new SUT for each device it finds. The new SUT is added to the SUTs list at the top of the page.
    Note: If more than one device is detected, a new SUT is added for each one.
  4. Add or update information about the device in the Edit SUT dialog box, if necessary.

The mobile device SUT is now ready to be used for running tests through Eggplant Manager.

Note: SUT discovery does not work with Android Gateway 6.0.
Note: If you need to connect to a mobile device that's not plugged directly into your Eggplant Manager machine, you'll need to use a VNC connection. To do this, follow the steps in Manually Adding SUTs. If you use a VNC connection with a mobile SUT, you'll need to manually launch the support application (Android Gateway or iOS Gateway) and make the connection through that application before starting the test run through Eggplant Manager.

Step by Step: Importing SUTs from Eggplant Functional

Follow these steps to import SUTs that you've defined or added in the Eggplant Functional Connection List:

  1. Click Import SUTs from Eggplant Functional. The Import SUTs window opens.

    Import SUTs from Eggplant Functional window in Eggplant Manager

  2. Click Choose File to select your Eggplant Functional preferences file. Follow the instructions to export the preferences file if you haven't done so previously.
  3. Select the SUT you want to import, then click Submit. Your new SUT is added to the SUTs list at the top of the page.

    Import SUTs window with SUTs listed in Eggplant Manager

  4. Add or update information about the SUT in the Edit SUT dialog box, if necessary.

The imported SUT is now ready to be used for running tests through Eggplant Manager.

Manually Adding SUTs

When you have individual SUTs to add, use the New SUT dialog box on the SUTs administration page. This method requires you to input all the details for the connection, and lets you customize all the information as you enter it. You must use the New SUT dialog box to create a rule-based SUT, as well as certain configurations for mobile device SUTs and VMs.

Step by Step: Adding SUTs with the New SUT Dialog Box

The following instructions guide you through adding a SUT.

  1. In Eggplant Manager, go to Admin > SUTs.
  2. In the SUTs section, click New SUT to open the New SUT dialog box.
  3. Eggplant Manager New SUT dialog box

    The New SUT dialog box in Eggplant Manager.

  4. Specify a unique name for the SUT in the Name field.
  5. Select the type of SUT you are adding from the Type drop-down list. The next section changes depending on the SUT type you choose. Your choices are:
    Note: Your list might also include Mobile Emulator. This SUT type for Android and iOS mobile emulators is available only if you have enabled experimental features on the System Preferences page. Each emulator platform has additional requirements as well.
  6. Select the Active checkbox if you want this SUT to be available to run tests. If the checkbox is not selected, the SUT definition remains but the SUT is unavailable for tests. Default: selected.
  7. Set group membership in the Groups box. When you add new SUTs, the Default Group is automatically selected. Be sure to remove SUTs from this group and add them to your own groups if you intend to use groups to control user access to specific SUTs. For information about using groups to manage access, see Working with Eggplant Automation Cloud Groups.
  8. Enter descriptive text in the Description field, if desired. This field is optional. However, you can use it to provide additional information about the SUT.
  9. On the right side of the New SUT dialog box, fill in the additional information about the SUT. These fields include:
    • Manufacturer
    • Model
    • OS
    • Version
    Note: Although these fields are optional, you should fill them all in if you plan to use Test Advisor to determine coverage.

    Note: If your SUT is a mobile device connected using VNC, click Poll Data to have Eggplant Manager automatically populate these fields.

    SUT Metadata pop-up window in Eggplant Manager

    If you have custom SUT Tags in your environment, they also appear here. Although these fields are optional, any information you enter can be used to create rule-based SUTs as well as for filtering the SUTs list, so it's a good idea to include as much information as you can.

  10. When you finish filling in the information for your new SUT, click Create. Your new SUT appears in the SUTs list.

Editing and Removing SUTs

To edit a SUT, select the SUT in the SUTs list, then click Edit SUT. You can also double-click the SUT in the list. The Edit SUT dialog box contains the same fields as the New SUT dialog box.

To remove an existing SUT, select it in the list and click Remove SUT. You can also click the Remove button on the Edit SUT dialog box.

Note: There is no confirmation when you choose any method for removing a SUT, and this action cannot be undone.

Creating SUT Tags

If you want to record additional information or attributes for your SUTs, create SUT tags. SUT tags are custom fields that, when created, display on the Create and Edit SUT panels. For example, you might add a field named Device to indicate the type of device as shown in the sample screen below. You can also create SUT tags to add criteria you can use for matching your rule-based SUTs.

SUT Tags area of the SUTs page in Eggplant Automation Cloud

Click New Tag to open the New Tag dialog box:

Eggplant Manager New SUT tag panel

The name you enter for the tag appears in the drop-down list of filters. You can also include a description to explain what the tag is used for and any specific information about how information should be entered. For example, you might include a tag such as Accessibility where you want the information stored as a Boolean, true or false, to indicate whether the SUT has accessibility features turned on.

When you have SUT Tags defined, they appear as fields when you add or edit SUTs:

Adding a new SUT in Eggplant Automation Cloud with SUT Tags defined

The value you enter in the tag field becomes something you can use as a filter. For example, if you defined a Location filter, the value you entered in the field might correspond to the physical location of the SUT. So if you selected Location from the Filter drop-down list, you could enter server room in the Value field to find only SUTs entered with that location.

 

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

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