Debugging a running bot in a remote computer

You can attach your IBM RPA Studio to a running bot in a remote computer for debugging. This is useful to debug bots in the production computer, where the environment might affect the bot's operation.

Before you begin

  • The remote computer must have IBM RPA installed.
  • You need to install a Virtual Network Computing (VNC) client on the remote computer.
    • You need to set an administrator password when installing the client.
  • You need to open the ports for inbound Transmission Control Protocol (TCP) in the remote computer. Default ports are 5800 and 5900. You can change the default ports in the VNC client.
  • You need to update the computer configuration for the remote computer in IBM RPA Control Center. In the computer configuration, enter the Vnc Password field.
    • Download the certificate and reinstall it after updating the computer. For more information about the computer configuration, see Computers.
  • To attach to a running bot in a remote computer, the bot must be already in operation in the remote computer.

Procedure

  1. Log in to IBM RPA Studio.
  2. On the Home tab, click Attach To Runtime.
  3. In the Machine name field, enter the remote computer name. The remote computer name you enter here must be an exact match to the computer name configured in the IBM RPA Control Center environment.
  4. Once the search finds the computer, click Attach.

Results

After you click Attach, IBM RPA Studio loads the script for debugging. The bot's operation will pause at the next command after the script loads.

What to do next

You can see the remote computer screen and interact with the remote computer's session:

  1. On the debugger's Window tab, click Debug bar.
  2. Maximize the debug bar window.
  3. Clear the Ignore VNC input option.