- Release Notes
- Getting Started
- UiPath Assistant
- Installation and Upgrade
- About Backward and Forward Compatibility
- Hardware and Software Requirements
- Deployment guidelines
- AWS Deployment
- Azure Marketplace Deployment
- Deploying Unattended Robots - Community License
- Deploying Unattended Robots - Enterprise License
- Installing Terraform
- Updating the Robot
- Setting Up Windows Server for High-Density Robots
- Services the Robot Connects to
- UiPath.Settings File Description
- Robot Types
- Robot Components
- Licensing
- Connecting Robots to Orchestrator
- Processes and Activities
- Logging
- Robot JavaScript SDK
- Specific Scenarios
- Windows Sessions
- Login Using Thales Luna Credential System
- Login Using NShield Key Storage Provider
- Redirecting Robots Through a Proxy Server
- Executing Tasks in a Minimized RDP Window
- Using Mapped Network Drives
- Stopping a Process
- Disable Stop Button
- Custom Package Folders and Network Paths
- CrowdStrike Integration
- Restarting Robot Components
- Troubleshooting
- About Troubleshooting
- Unresponsive Robot Over RDP
- Duplicate Execution Logs
- Frequently Encountered Robot Errors
- Increased Process Execution Duration
- Enforced Package Signature Verification
- Message Too Large to Process
- Errors When Running as Administrator
- NuGet Packages Not Accessible After Migration
- User Access Control Prompt and UI Automation Activities
Deploying Unattended Robots - Enterprise License
Unattended robots are used in automating tasks that do not require human supervision, they usually run in virtual environments on dedicated machines and the automations are controlled from Orchestrator.
An unattended automation can be started manually from Orchestrator when needed, but can also be scheduled if the task has to start at a specific interval (daily, hourly, weekly) or at a specific time and date (end of week).
This document guides you through the process of running your first unattended automation using the Enterprise Licensed Version of UiPath, starting with building the automation, setting up the environment and running the unattended process.
To run an unattended automation, the following steps need to be taken:
To provide a real life example, let's suppose we need to make a backup of log files on a server every day at 9 AM. For that, we need to copy the log file from that day to another folder. In this example, we copy a file called "Logs.txt" from the "Logs" folder to the "Old Logs" folder, overwriting the backup each time.
-
Create a new process, add the Copy File activity, configure the fields/paths to the files, and select the Overwrite option so that the newly copied file can replace the previous file every day.
- Publish the process to Orchestrator.
- Click the Publish button to the right of the Studio ribbon,
- In the Publish properties tab, enter a name for the package.
- In the Publish options tab, for the Publish to option, select Orchestrator Tenant Processes Feed, the location where unattended robots can access the automation.
-
Click Publish.
For more information, see About Publishing Automation Projects in the Studio Guide.
- In Orchestrator, create the process that the unattended robot uses for running the automation.
- Access your Automation Cloud instance at https://cloud.uipath.com, and select your Orchestrator tenant.
- In Orchestrator, select the Shared Folder > Processes, and then click the Plus button on the right side to open the Add Process page.
-
Select the package and click Create to add the process to the Shared Folder.
Note: Keep in mind that you are working with two entities in this process. The first entity is you, the developer who creates and publishes the process. The second one is the Unattended User that runs the automation and the Robot on the Unattended Machine.
Set up a Windows Machine that runs the Unattended Robot, ideally this would be a cloud virtual machine. Make sure that its screen saver functionality is disabled and matches the Hardware and Software Technical Requirements.
For example, you can host your virtual machine on Azure, see the Windows VMs Overview document for details on how to set up a Windows Virtual Machine in Azure.
Other environments such as AWS, VM Ware or Citrix are supported as well if they match the Hardware and Software Technical Requirements.
The unattended robot has two components: the account and the machine on which a job runs. The account is the identity that provides permissions and is used to trigger jobs towards the robot, while the machine provides to computational power for executing the job.
- Create and set up the account.
- Creating the account: For unattended automations, we recommend creating a robot account, which is a service-type identity that does not require an email address. However, if the job must run under a particular user's identity (for permissions or audit purposes), you can opt for creating a user account instead.
- Assign roles to the account.
- Add the account to folders which contain the jobs it needs to run.
-
Create a machine template.
Note: While you could opt to create a single standard machine, for this example we are creating a machine template instead. Machine templates make it easier to deploy several machines by defining the configuration once and then using a single set of client credentials to allow multiple robots to connect to Orchestrator. - In Orchestrator, go to Tenant > Folders.
- Select the target folder from the list, and then select the Machines tab.
- In the top right, click Manage Machines in Folder.
- On the Manage Machines in Folder page, click the Add machine in the top right and select Machine template.
- Configure the machine template and assign one unattended runtime only. For detailed instructions, see Adding a machine template.
- Copy the machine key for later use.
If this machine template should be used to run jobs from several folders, add the machine template you created to all the necessary folders. For instructions, see Assigning machine objects to folders.
UiPathStudio.msi
installer is used
to install Studio, the UiPath Assistant, or the Robot on your machine. Using the
.MSI
installer, the Robot is deployed in Service-Mode by
default, meaning that it is available to all users on the machine. For running the
installer administrator rights are needed.
UiPathStudio.msi
installer can be downloaded from the
Resource Center or directly from the Automation Cloud Home Page.
C:\Program Files \UiPath\Studio
. You can change the install
location by making use of command line
arguments or from the installer interface.
Step-by-step details on how to install the Robot are found in the Installing the Robot document.
From Studio
After the installation is completed, you are presented with the Connect to Orchestrator screen, which by default asks you to use the Use Machine Key as it's the recommended configuration for unattended robots. The machine name is taken automatically, all you have to do is type the Orchestrator URL plus the machine key you saved earlier.
.MSI
installer, when connecting the Robot to Orchestrator, the
entire machine connects, not just the user that's currently logged on the
machine.
From the UiPath Assistant
- Open UiPath Assistant
- On the Preferences menu, select Preferences. The Preferences window is displayed.
- Navigate to Orchestrator Settings.
- In the Orchestrator URL field, enter Orchestrator’s web address.
- In the Machine Key field, enter the key you copied earlier.
Click here for details about the different machine entities in Orchestrator and when to use each.
-
Click Connect. The status should show
Connected, Licensed
Note: When setting up the machine using the Enterprise Installer (.MSI
), you can sign out of the machine as the Robot is able to create its own Windows Session using the credentials provided in Step 3.
In order to test the automation on the Unattended Robot, go to the Automations -> Processes section of the Shared Folder in Orchestrator and look for the process deployed in step 1.
You can see the details of the process and, on the right side, you have the Start Job button.
When clicked, you are presented with the Start Job interface, choose the user and the machine configured earlier then click on Start.
This starts the selected unattended process on the selected machine and can be monitored in the Jobs section of the Shared Folder in Orchestrator.
For the example we provided in this guide, we can schedule it to run on a daily basis at 9 AM. This is configured from the Trigger Section of the Shared Folder in Orchestrator.
Logs.Backup
process to run on the unattended machine on behalf
of the selected user every day at 9 AM UTC.