How To Change The Insights URL

How to change the Insights URL ?

The Insights URL is both referenced by Orchestrator and components on the Insights server. When updating the URL, all the different references need to be updated for all functionality to work.

Changing the URL

  1. Login to the Insights Machine.
  2. Open a browser and go to http://localhost:3030
  3. On the right hand side, click the UiPath logo five times. This will open up a hidden configuration display.
image.png
  1. On the right select 'Base Configuration'
image.png
  1. Scroll down to the section 'System'. Click on the drop down and then modify the URL to the new URL.
image.png
  1. At the top of the screen, select 'Save Base'
​​​​​​​image.png
  1. Most likely the Insights certificate needs to be updated. Follow the instructions here: https://docs.uipath.com/installation-and-upgrade/docs/insights-additional-configurations#updating-the-insights-certificate
    • Hint: In the underlying engine there is a bug that the certificate chain will not be correctly imported for a PFX file. So do not skip the step of exporting the public key.
  2. Make a backup of the file: C:\Program Files (x86)\UiPath\Orchestrator\Tools\UiPath.InsightsAdminTool.exe.config.
  3. Open the file and search for the old URL and do a find and replace on it with the new URL.
    • Hint: This file requires admin priviledges to modify. So open an admin prompt and execute the following commands:
      • notepad "C:\Program Files (x86)\UiPath\Orchestrator\Tools\UiPath.InsightsAdminTool.exe.config"
      • Then modify the the file and click save.
    • Updating this file ensures that the Insights admin tool still knows how to talk to Insights.
  4. Make a backup of the file: C:\Program Files\Sisense\DataConnectors\JVMContainer\Connectors\UiFrost\uipath_insights.properties
  5. Open the file and search for the old URL do a find and replace on it with the new URL
    • Using an admin prompt:
      • notepad "C:\Program Files\Sisense\DataConnectors\JVMContainer\Connectors\UiFrost\uipath_insights.properties
    • Modifying this file ensure the custom data connector has the correct references.
  6. On the Orchestrator DB, modify the [dbo].[Settings] fine the row with name 'Insights.Portal.BaseUrl' and modify it with the updated URL.
    • Make sure that no trailing slashes are used.
    • Alternatively, this change can be made by modify the Insights password. Go to Add/Remove programs, modify the Insights installation. When it asks for the Insights URL provide the new URL (without trailing slashes). Then go through the prompts and choose to update the Insights password. By changing the insights password the base url will also get updated.
  7. In the Insights DB, change the same reference under [dbo].[Settings] (or skip this step if the URL was modified using the installer).
  8. After the above has been done, verify that everything is still working
    • Login to Orchestrator and make sure that Insights is still accessible.