Subscribe

UiPath Installation and Upgrade

The UiPath Installation and Upgrade Guide

Modifying Insights Configurations

Requirements

To modify or uninstall Insights, you need to have the original installation file.

Modifying the Insights Installation

  1. Go to Apps and Features. Click on UiPath Insights and Select Modify.
  1. Click Next in the newly opened window.
  1. Click Change .

Modifying the Looker Configuration File Path

  1. If you want to modify the SMTP configuration, replace a Linux certificate, or change the database authentication to windows authentication, then you must first rerun the Preinstallation Tool
  2. Input the new Looker Configuration File Path and click Next.
  1. You can click Skip on the next pages if you do not want to implement any other changes.

  2. Click Next.

  3. Lastly, click Next in the Ready To Install window.

Modifying the Orchestrator/Identity Properties

  1. Input the new Orchestrator URL and Installation Access Token and click Next. See Installation key for instructions on how to get an Installation Access Token.
  1. Click Skip in the following windows if you do not want to change any other settings available.

  2. Lastly, select Next in the Ready To Install window.

Modifying the Insights Database Connection

  1. Go to Orchestrator Server and update the Insights database connection string. You need to manually change it in Orchestrator configuration file.
Click for details on how to manually update the connection string in the Orchestrator configuration file
  1. Open the UiPath.Orchestrator.dll.config file.
  2. In the connectionStrings section, modify the connectionString parameter of the key name="Default" as follows:
    a. For SQL Authentication: connectionString="Data Source={YOUR_ORCH_DB_HOST};Initial Catalog={YOUR_ORCH_DB_NAME};User ID={YOUR_ORCH_DB_SQL_USER};Password={YOUR_ORCH_DB_SQL_PASSWORD}" />
    b. For Windows Authentication: connectionString="Data Source={YOUR_ORCH_DB_HOST};Initial Catalog={YOUR_ORCH_DB_DATABASE_NAME};Integrated Security=true" />

Example for SQL Authentication:

<add name="Default" providerName="System.Data.SqlClient" connectionString="Data Source=sql.uipath.com;Initial Catalog=UiPathOrchestrator;User ID=docs-uipath;[email protected]" />

Example for Windows Authentication:

<add name="Default" providerName="System.Data.SqlClient" connectionString="Data Source=sql.uipath.com;Initial Catalog=UiPathOrchestrator;Integrated Security=true" />
  1. Go to Apps and Features and click on UiPath Insights and Select Modify.

  2. You can click Skip if you do not want to add any changes in any of the other windows.

  3. Input your new Insights database settings.

  1. Click Next.

  2. Lastly, click Next in the Ready To Install window.

Modifying the SMTP configuration

📘

Note:

The email service configuration is not removed if you uncheck the Configuring Email Service (SMTP) option.

  1. Navigate to Apps and Features and click on UiPath Insights and Select Modify.

  2. You can click Skip if you do not want changes in other windows.

  3. Click Configure Email Service (SMTP) .

  1. Enter the Email Settings to Configure the Email Service
  1. Click Next.

  2. Lastly, click Next in the Ready To Install window.

Updating the Portal Certificate in IIS

  1. Make sure your new certificate is imported to both Personal (for the certificate) and Trusted Root Certification Authorities (for the root certificate). Also ensure the certificate is valid.
  1. Go to IIS Manager and open the UiPath Insights website.
  1. Open the Bindings page.
  1. Select the binding and click Edit, then choose your new certificate from the SSL certificate drop-down menu and click OK.
  1. Restart IIS.

  2. Follow the instructions to Initialize Looker on the Insights Linux Machine to rerun the LookerPreinstallationTool.exe and generate a ZIP file that contains the new certificate.

  3. Copy the outputted ZIP file, which contains the new certificate, to the Insights Linux Machine.

  4. Unzip the Looker files by running the command below:

unzip <Insights_Lookerfiles_timestamp.zip>
  1. Run the Looker initialization script by running the command below:
bash insights/looker-initialization.sh -k <Public Key>

Updating the Port after an Installation

To update the port number after Insights installation, you need to follow these steps.

Step

Action

1. Create domain-signed certificate

Create a domain-signed certificate with the new URL.

2. Change port number in IIS

Open IIS Manager and navigate to Site > Insights application > Bindings to change the port number.

3. Remove URI port number from Identity Server DB

Remove the URI port number from the the following parameters found in the Identity Server database:
ClientRedirectUris
ClientPostLogoutRedirectUris

4. Modify provisioning.url parameter in Insights config file

  1. Navigate to C:\Program Files (x86)\UiPath Insights\Insights and open the appsettings.json file to modify Insights settings.

  2. Find the provisioning.url parameter.

  3. Remove the port number from the URI.

  4. Find the portalUrl parameter to add your new URL and port number.
    e.g., "url": "https://insights.cloudStorage.com:portNo/insights"

  5. Save the file.

5. Modify permission.url parameter in Insights config file

  1. Navigate to C:\Program Files (x86)\UiPath Insights\Provisioning and open the appsettings.json file.

  2. Find the permission.url parameter.

  3. Enter your new URL: "Permission": {new url

  4. Save the file.

6. Reset IIS

Open CMD as admin and run iisreset to reset IIS.

Updated 9 days ago


Modifying Insights Configurations


Suggested Edits are limited on API Reference Pages

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