Using Sessions Controller to Access a Robot Session for Scenario Creation and Maintenance

This article covers the why and the how related to using Sessions Controller with AppsWatch.

Automai Sessions Controller is a service used to manage robot and ScenarioBuilder sessions. It works behind the scenes to maintain active sessions so the scenario images can be buffered and to prevent any connection errors during scenario playback. It can start automatically and run in the background while executing processes (scenarios/scripts) without human supervision.

It should also be used to access ScenarioBuilder for creating and maintaining scenarios. This is the best way to ensure the scenarios execute the same in ScenarioBuilder and the robots because the creation and execution environments are the same.

However, this also means you can’t use the robot to create/maintain scenarios while you are also executing scenarios in AppsWatch.

Sessions Controller is not installed as part of the ScenarioStation install, so you will have to install it manually.

Obtain Needed Information

Before starting the configuration obtain the following information from SSrdpManager:

  • Username and password used for each ScenarioStation (if domain account, domain name)
  • Desktop resolution
  • Color depth
  • Font smoothing setting (selected or not)
  • Send key setting

Install Sessions Controller on All ScenarioStation Machines

Sessions Controller must be installed on each machine where ScenarioStation is installed, so follow these steps for each machine.

  1. Download exe.
  2. Double-click on the downloaded file to launch the installation wizard. If needed, click here for directions on performing the install.
  3. Once the install is complete, double-click the Sessions Controller icon on the desktop. The Sessions Controller window appears.
  4. Enter the ScenarioStation’s username and password. If the account is a domain account, enter the domain name in the field provided.
  5. Using the information obtained, set the screen resolution, color quality, font smoothing and send enter key to match.
  6. Select the Robot checkbox.
  7. Click Submit. The "Connection created successfully" message will be displayed and the window closes.

Set up Sessions Controller

Once Sessions Controller has been installed on all ScenarioStation machines, follow these steps to set up Sessions Controller on the machine you want to use for accessing the ScenarioStations. Note that is cannot be one of the ScenarioStation machines if the machine has a desktop operating system installed.

Follow these steps to set up Sessions Controller on a machine OTHER than the one where the robot is installed. It can be a workstation or server operating system.

  1. Go to the machine where you want to use Sessions Controller and download exe.
  2. Double-click on the downloaded file to launch the installation wizard. If needed, click here for directions on performing the install.
  3. Once the install is complete, double-click the Sessions Controller icon on the desktop. The Sessions Controller window appears.
  4. Enter the robot’s username and password. If the robot account is a domain account, enter the domain name in the field provided.
  5. Using the information obtained from installing Sessions Controller on the ScenarioStation, set the screen resolution, color quality, font smoothing and send enter key to match.
  6. If the Robot checkbox is selected, clear it.
  7. Select the ScenarioBuilder checkbox.
  8. In the Enter host name field, enter machine name or IP address of the machine where the ScenarioStation is installed.
  9. Click Submit. The "Connection created successfully" message will be displayed and the window closes.

If you want to add sessions for connecting to other ScenarioStation’s, right-click on the Sessions Controller icon in the sys tray, click Add new session, and then follow steps 4-9 above.

Connecting to a ScenarioBuilder Session

Once you have Sessions Controller installed and a ScenarioBuilder session configured you can use it to access ScenarioBuilder and create and maintain scenarios. To connect to the session, right-click the Sessions Controller icon in the sys tray and then click the session you want to use.

The selected session opens. Through this connection, you can create and edit your scripts.

Troubleshooting Tips

Connection Error

Refer to the solutions below if you receive the "ERRCONNECT_PASSWORD_CERTAINLY_EXPIRED" connection error.

Solution 1

  1. Go to the machine where Sessions Controller is installed.
  2. Go to the "...\Automai\Sessions Controller\resources\app\php" folder and open the "SSrdpManager.conf" file.
  3. Change "securityoption=3" to "securityoption=1".
  4. Save the change and close the file.
  5. Try to connect to the user session again.

Solution 2

NOTE – this only applies if the user is a domain user.

  1. Go to the machine where Sessions Controller is installed.
  2. Go to the "...\Automai\Sessions Controller\resources\app\php\sessions" folder and open the user connection file.
  3. Look for the hostname and replace it with "localhost".
  4. Save the change and close the file.
  5. Try to connect to the user session again.

    Keyboard Stops Working

    While rare, it is possible that the keyboard might stop working while the ScenarioBuilder user session is open. If this happens, try to minimize and then maximize the ScenarioBuilder session window or close and reopen it.