UiPath Installation and Upgrade

The UiPath Installation and Upgrade Guide

Insights Backup and Restore

For Orchestrator deployments with the Insights feature enabled, regular backups of your Insights database should be performed inline with the backups of your Orchestrator database.

In addition, you must also back up your configured dashboards.

Dashboard Backup

  1. From Windows Services Manager, stop the following services:
    • Sisense.Repository.
    • Sisense.Discovery.
  2. Copy the contents of the %ProgramData%\Sisense\PrismWeb\Repository\DB directory to the location where your database backups are maintained.
    Note: Be sure to maintain the same file structure.
  3. Copy the contents of the %ProgramData%\Sisense\Infra\Discovery directory to the location where your database backups are maintained.
    Note: Be sure to maintain the same file structure.
  4. Return to Windows Services Manager and restart the stopped services:
    • Sisense.Repository.
    • Sisense.Discovery.

Restore Dashboards

🚧

Important!

Before proceeding with restoring Insights or its attendant dashboards, your Orchestrator database must be restored to a matching backup version and the original Insights certificate needs to be installed (i.e. if this is a new machine, or if you deleted it).

  1. Restore the Insights database.
  2. Re-Install Insights.
  3. From Windows Services Manager, stop the following services:
    • Sisense.Repository.
    • Sisense.Discovery.
  4. Replace the contents of the %ProgramData%\Sisense\PrismWeb\Repository\DB directory with the previously created backups.
  5. Replace the contents of the %ProgramData%\Sisense\Infra\Discovery directory with the previously created backups.
  6. Return to Windows Services Manager and restart the stopped services:
    • Sisense.Repository.
    • Sisense.Discovery.
  7. Re-enable each previously Insights-enabled tenant using the UiPath.InsightsAdminTool:
    a. Navigate to the \Orchestrator\Tools directory.
    For example: cd C:\Program Files (x86)\UiPath\Orchestrator\Tools.
    b. Run the tool using the list command to obtain the previously enabled tenants.
    For example: c:\Program Files (x86)\UiPath\Orchestrator\Tools>UiPath.InsightsAdminTool.exe list -u admin -p ******
    c. For each listed tenant, run the tool using the enable command.
    For example: c:\Program Files (x86)\UiPath\Orchestrator\Tools>UiPath.InsightsAdminTool.exe enable -u admin -p ****** -t Default.
  8. Restart the Insights machine.

Restore Configuration

🚧

Important!

This procedure is only necessary if, after an upgrade, a full uninstall and reinstall had to be performed.

In case of an upgrade failure that requires a full uninstall/reinstall, the previous encryption configuration must be set in order to use the database backup.

  1. Extract the backup .zip file produced by the Insights installer during upgrade.
  2. Locate baseConfiguration.json file in the extracted folder.
  3. From the baseConfiguration.json file, locate the following keys:
{
 "encryption.IV": "value",
 "encryption.aesKey": "value",
 "encryption.licenseKey": "value"
}
  1. From your Insights machine, navigate to http://localhost:3030.
  2. Click on the UiPath logo in the upper-left corner 5 times in a row.
  3. Navigate to the Base configuration page.
  4. In the Encryption section, replace all fields with the ones found in the baseConfiguration.json file.
  5. Click Save Base.

Restore Server Identity

For new Insights installations the server's identity can be reset. This needs to be addressed in order for the restored metadata/configuration to function properly.

This is done via the InsightsBackupTool.

A sample execution command:

{
  "codes": [
    {
      "code": ".\\InsightsBackupTool.exe restore -l log.txt",
      "language": "powershell"
    }
  ]
}

Updated 10 days ago


Insights Backup and Restore


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.