Debugging a script at run time in a remote computer
Attach IBM RPA Studio to a remote computer to debug a script at run time. Use this feature to track the step by step of the debugging process in IBM RPA Studio and watch the remote computer screen in the process. It's useful to remote debug scripts in the production computer, where the environment might affect the script's operation.
Before you begin
Before you start the procedure, you must comply with the following requirements. These requirements are general requirements for all versions of the product:
- The remote computer must have IBM RPA installed.
- To attach to scripts at run time in a remote computer, the script must be already in operation in the remote computer.
Requirements for IBM RPA clients before 23.0.3
In addition to the general requirements, you must comply with the following requirements if your IBM RPA client is on version before 23.0.3. Apply these requirements and configurations to the remote computer that runs the script:
- Install a Virtual Network Computing (VNC) client on the remote computer and set an administrator password when you install the client.
- Open the default ports
5800
and5900
for inbound Transmission Control Protocol (TCP) in the remote computer. You can change the default ports in the VNC client. - Edit the computer configuration for the remote computer in IBM RPA Control Center to enter the VNC password. For more information, see Managing computers.
- Download the certificate and reinstall it after you edit the computer.
Procedure
- Log in to IBM RPA Studio.
- On the Home tab, click Attach To Runtime.
- In the Machine name field, enter the remote computer name. The remote computer name that you enter must be an exact match to the computer name configured in the IBM RPA Control Center environment.
- After 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:
- On the debugger's Window tab, click Debug bar.
- Maximize the debug bar window.
- Clear the Ignore VNC input option.