Skip to content

Desktops

In many unattended automation scenarios it is necessary to have a remote desktop available to run Manatee in. The functionality to ensure that a desktop is available needs configuration in Cuesta as described here also relies on the pistia software component which is the service that reads the configured desktops and logins and maintains the actual connections. Pistia (aka the agent) can be run in two modes:

  1. GLOBAL where it will try to connect using all logins across all desktops except those configured for a local agent
  2. LOCAL will only connect using the logins for a single desktop, the desktop that has the same “machine” name as where the local pistia agent runs

Each desktop represents machine/desktop that you can log into. A desktop may have multiple logins (multiple users) connected at the same time.

For a local agent you need to provide the machine on which the agent runs. This will make it possible for the agent to pick up the logins and maintain connections using these. You can also specify a default host address and port or configure these for logins individually.

desktop-local

Each login needs a username and a password and optionally domain, host address and port. For the credentials you must use unexpired secrets otherwise you will get errors.

desktop-expired-secret

Once created an agent (pistia) will use the logins to connect to the desktop and report any errors or successes back.

desktop-error

Example setups

A typical setup would either be to have only local agents and a pistia agent service instance running on all servers where you need to login to one or more accounts or a single global pistia agent that connects to all desktops.

Local only agents

For the first case you want to create a number of local desktops, each corresponding to a server where you want to login to one or more accounts. You then create logins for each desktop and configure the logins with the necessary credentials.

desktop-example-local

The local pistia agent should then be run with the --machine-only flag which will trigger it to only connect to the desktops with the same machine name as the machine where the agent runs.

A single global agent

The second common scenario is where we have a single pistia agent running on a server that connects to all desktops. In this case you need to create a one or more global desktops and add logins to them.

desktop-example-global

You can also build combinations of a single global agent and a number of local agents. In this case you need to create a global desktop and a number of local desktops and configure the logins accordingly. You should not run multiple global agents as they will pick the same logins and cause each other to disconnect/reconnect all the time.