Debugging a scheduled script
Attach IBM RPA Studio to a remote computer to debug scheduled scripts after they start. 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 scheduled 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 a scheduled script in a remote computer, a scheduled script must exist in the IBM RPA Control Center tenant for the remote computer. For more information, see Scheduling scripts.
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 Schedule.
-
In the Machine name field, enter the remote computer name. The remote computer name must be the IP address or FQDN.
-
After the search finds the computer, click Attach.
Tip:Use the following steps to obtain the IP address or FQDN:
- Open the Windows™ command prompt.
- Enter the following command:
- In the IPv4 Address field, get the IP address.
- Enter the following command to obtain FQDN:
ipconfig/all
echo %COMPUTERNAME%.%USERDNSDOMAIN%
Results
After you click Attach, IBM RPA Studio attaches to the scheduled job, and waits for it to start. You can follow the remaining time for the schedule to start in the Attach to Schedule window.
After the scheduled bot starts, the bot's operation begins paused so you can debug the script.
What to do next
- On the debugger's Window tab, click Debug bar.
- Maximize the debug bar window.
- Clear the Ignore VNC input option.