UiPath Documentation
maestro-automate
latest
false
Maestro Automate user guide

Administration

What an administrator turns on so that builders in a company account can build, test, and deploy Maestro Automate workflows.

This page is for administrators of a company's UiPath account. If you signed up yourself, your account is ready to use, and you can skip this page.

In a company account, builders can only work with Maestro Automate after an administrator turns on the services it uses. Automation Cloud, UiPath's cloud platform, groups a company's work into an organization, and each organization has one or more tenants, which are separate areas with their own services, users, and settings. The steps below apply to every tenant where people build workflows.

1. Turn on the services​

Turn on these services for the tenant. Managing services describes how.

ServiceWhat workflows use it for
OrchestratorRuns deployed workflows and stores their runs. Required.
Integration ServiceThe connections to other apps, such as Slack or Gmail.
Action CenterHuman steps, such as approvals and escalations.
Data FabricData entities that workflows read and write.
Document Understanding and Intelligent Xtraction and Processing (IXP)Nodes that read and extract data from documents.

Insights isn't required.

2. Turn on Personal Workspaces​

Builders create, test, and deploy their first workflows in a Personal Workspace, a private folder that belongs to each user. Turn on Personal Workspaces for the users or groups that build workflows, and let them run personal automations. Personal workspaces describes how.

Studio Web has a few more tenant settings, such as the license model. Prerequisites for using Studio Web lists them.

3. Check licensing​

Each plan includes a number of runs per month, and some users need a license for some features. Licensing for administrators has the numbers and the access table.

Governance​

Your organization's governance settings apply to every Maestro Automate workflow from the first run, including policies, AI model governance, access control, and deployment approvals.

Deployments in Orchestrator​

Orchestrator lists every deployed workflow, whichever tool deployed it. Builders follow, retry, and cancel runs in Maestro, so you need Orchestrator only for the tasks below.

Manage deployments​

  1. In Orchestrator, select the Solutions tab.
  2. In the left panel, select the folder the workflow is deployed to, such as a user's My Workspace or a shared folder.

The Deployments tab lists each deployment with its status, such as Active, its version, its last operation, and its stages. Select a deployment to open its panel, with Start job, Edit, Uninstall, and the Resources, History, and Jobs tabs.

Deploy a published package​

A package that was published without being deployed, for example to the Orchestrator Tenant Feed from Studio Desktop, waits in Orchestrator:

  1. In Orchestrator, select Tenant at the top of the left panel.
  2. Select Solutions, then the Packages tab. Each solution is listed with its latest version.
  3. Select the solution. Its panel opens.
  4. Select Deploy.

To go back to an earlier version, open the Versions tab of the same panel, and select the deploy icon on the version's row.

Runs as jobs​

Orchestrator lists each run as a job of the type Maestro Flow, under Automations > Jobs. A run that failed at a step shows as Running there until someone retries or cancels it in Maestro, because it's waiting.

To end a run from the list, select the ⋮ menu at the end of its row, then select one of these:

  • Stop ends the run. Its status changes to Stopped.
  • Kill forces the run to end right away. Its status shows Terminating, then Stopped.

The same menu has Duplicate job, which starts a new run with the same inputs.

Limits​

Each tenant runs up to 50 Maestro Automate runs at the same time. A run lasts up to 24 hours, and a run is kept for 30 days after it ends. Limits and fair use describes them.

How long run data is kept​

A Maestro Automate run is kept for 30 days after it ends, and is then deleted. The work the run calls, the traces of that work, and audit events have their own retention settings:

DataWhere you see itHow long it's kept
The runInstance management in Maestro, and the job of the run in Orchestrator, with its logs30 days after the run ends. Then it's deleted.
Work the run callsThe jobs of the agents, RPA workflows, and other automations that the run startsTheir own retention settings. The 30 days don't apply to them.
Traces of the work the run callsThe traces of agents and other automations90 days by default. An administrator can shorten it to 1 or 7 days.
Audit eventsAutomation Cloud audit logsCaptured the same way in Maestro Automate and Maestro Orchestrate.

These pages describe the other retention settings:

Keep a copy for longer​

To keep a run's results, write them to an app or a Data Fabric entity before the run ends.

To keep traces and audit logs outside UiPath, an organization administrator can stream them to your own destination with Data Export. Data Export sends the data as it's produced, so the 30 days and the trace retention don't apply to the copy. The tenant needs Insights.

Phone numbers for voice workflows​

A workflow that answers or places phone calls needs a phone number connected to the tenant and bound to the deployed workflow. Deployment in the Agents guide describes how to set one up.

Next steps​

Was this page helpful?

Connect

Need help? Support(opens in new window)

Want to learn? UiPath Academy(opens in new window)

Have questions? UiPath Forum(opens in new window)

Stay updated