- Introduction
- Getting started
- Managing solution projects and packages
- Managing solution deployments
Solutions user guide
Deploying a solution
This step is typically performed by an administrator.
To deploy a solution, take the following steps:
-
Select the Solutions tab at tenant level.
-
Indicate the solution package you plan to deploy. Your options are:
-
Select one of the existing solution packages available in your tenant;
-
Create a new solution package;
-
Upload a solution package from a different tenant.
-
- Deploy the desired version of the solution package using its corresponding three-dot menu.
- In the General details screen, review and update the following details:
- General information - Read-only. Review the package name, version, description, and author;
- Folder selection - Indicate the folder to be used as a parent folder for the solution root;
Important:
- The solution is not deployed in the selected folder; a new child folder is created.
- Solutions create folder components in a new dedicated solution folder. This ensures subsequent operations are clearly scoped and do not conflict with elements outside of the solution, such as a manually created component bearing the same name as a solution component.
- Install as a new root folder under tenant - Use the checkbox to install as a new root folder under the tenant;
- Solution root folder name - Optionally change the root folder name, which you previously configured in the Solutions builder.
- Select Next to go to Overview & Configuration. Now you are prompted with the Solution explorer, which allows you to review the solution components, component properties, and files. Take the following into consideration:
- You can filter the component properties to only show read-only, configurable, or empty fields.
- You can link existing components. For details, refer to .
- You can now save your solution as a draft or validate it and continue. The following image shows several typical validation
errors.
Note:If a component of the same name already exists in the tenant, your options are the following:
- Keep the existing component and do not create an additional one.
- Keep the existing component and add additional new fields from the solution. Note that this option does not alter existing fields.
-
Rename the conflicting resource in the respective service (for instance, Orchestrator, Action Center) in the target tenant.
-
Rename the resource in the solution deployment if possible.
-
Select Deploy, for Solutions to orchestrate the deployment across all affected services. A deployment can be successful or it can fail. You can view the deployment status in the deployment grid.
The following table describes the possible statuses of your deployment:
For an overview of all deployment statuses, refer to Checking the deployment status.Status
Behavior
In progress
The deployment operation is in progress.
Successful
The status changes from In progress to Successful, and all components are deployed. Failed
The status changes from In progress to Failed. In this case, an automatic rollback performed successfully. You can check the activation summary for more details and retry the operation. FailedRollback
The status changes from In progress to FailedRollback. In this case, since some components have already been deployed, make sure to manually clean up the components from the failed services.
- To complete the deployment, take the following steps.
- Add accounts and assign roles - Add user or robot accounts to the solution folder(s) and assign the required roles and permissions.
- Add machines - Make sure machines are assigned to the solution folder(s) that include processes.
- Define account-machine mappings - Define account-machine mappings if needed or use dynamic allocation.
- Define values for assets per robot - Define value(s) for assets per robot, if applicable. This step is not needed for assets set with global values.
-
Activate the apps used in the solution - If the solution contains apps, you must activate them using the provided link. Note that a new window opens, and you must wait for the apps activation confirmation before continuing the deployment activation.
Note:If the solution contains apps, and you do not activate them using the provided link, the deployment activation fails.
-
In the Deployment screen, select Activate deployment. Activation enables your triggers.
