# Modifying Insights Configurations

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

## Requirements

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

## Modifying the Insights Installation

1. Go to **Apps and Features**. Select on **UiPath Insights** and Select Modify.

   ![Screenshot of the Windows Apps and Features interface.](https://dev-assets.cms.uipath.com/assets/images/insights/insights-screenshot-of-the-windows-apps-and-features-interface-161333-29ca5dc1-4df00aff.webp)
2. Select **Next** in the newly opened window.

   ![Screenshot of the UiPath Insights Setup interface.](https://dev-assets.cms.uipath.com/assets/images/insights/insights-screenshot-of-the-uipath-insights-setup-interface-157512-9fbd2fe5-77287829.webp)
3. Select **Change** .

   ![Screenshot of the UiPath Insights Setup interface.](https://dev-assets.cms.uipath.com/assets/images/insights/insights-screenshot-of-the-uipath-insights-setup-interface-159981-113e55ec-de7c76df.webp)

### 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](https://docs.uipath.com/insights/standalone/2024.10/user-guide/insights-installation#installation)
2. Input the new Looker Configuration File Path and select **Next**.

   ![Screenshot of the UiPath Insights Setup interface.](https://dev-assets.cms.uipath.com/assets/images/insights/insights-screenshot-of-the-uipath-insights-setup-interface-158256-b137ca01-9c49f2d2.webp)
3. You can select **Skip** on the next pages if you do not want to implement any other changes.
4. Select **Next**.
5. Lastly, select **Next** in the **Ready To Install** window.

### Modifying the Orchestrator/Identity Properties

1. Input the new Orchestrator URL and Installation Access Token and select **Next**.

   ![Screenshot of the UiPath Insights Setup interface.](https://dev-assets.cms.uipath.com/assets/images/insights/insights-screenshot-of-the-uipath-insights-setup-interface-159711-61082cb4-ba24b3eb.webp)
2. Select **Skip** in the following windows if you do not want to change any other settings available.
3. Lastly, select **Next** in the **Ready To Install** window.

   ![Screenshot of the UiPath Insights Setup interface.](https://dev-assets.cms.uipath.com/assets/images/insights/insights-screenshot-of-the-uipath-insights-setup-interface-159931-9d44a1ad-101fc699.webp)

### 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.
   a. Open the `UiPath.Orchestrator.dll.config` file.
   b. In the `connectionStrings` section, modify the `connectionString` parameter of the key `name="Default"` as follows:
      1. 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}" />`
      2. 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;Password=SecretP@ssword" />
      ```

Example for Windows Authentication:

      ```
      <add name="Default" providerName="System.Data.SqlClient" connectionString="Data Source=sql.uipath.com;Initial Catalog=UiPathOrchestrator;Integrated Security=true" />
      ```
2. Go to **Apps and Features** and select on **UiPath Insights** and Select Modify.
3. You can select **Skip** if you do not want to add any changes in any of the other windows.
4. Input your new Insights database settings.

   ![Screenshot of the UiPath Insights Setup interface.](https://dev-assets.cms.uipath.com/assets/images/insights/insights-screenshot-of-the-uipath-insights-setup-interface-159395-7e790285-732c56c9.webp)
5. Select **Next**.
6. Lastly, select **Next** in the **Ready To Install** window.

   ![Screenshot of the UiPath Insights Setup interface.](https://dev-assets.cms.uipath.com/assets/images/insights/insights-screenshot-of-the-uipath-insights-setup-interface-159727-f11e8d1a-03b2f4e8.webp)

### 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 select on **UiPath Insights** and Select Modify.
2. You can select **Skip** if you do not want changes in other windows.
3. Select **Configure Email Service (SMTP)** .

   ![Screenshot of the UiPath Insights Setup interface.](https://dev-assets.cms.uipath.com/assets/images/insights/insights-screenshot-of-the-uipath-insights-setup-interface-157800-e9193bfd-b686bd44.webp)
4. Enter the Email Settings to Configure the Email Service

   ![Screenshot of the UiPath Insights Setup interface.](https://dev-assets.cms.uipath.com/assets/images/insights/insights-screenshot-of-the-uipath-insights-setup-interface-157199-8888af25-42f3ada8.webp)
5. Select **Next**.
6. Lastly, select **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.

   ![Screenshot of the Certificates interface.](https://dev-assets.cms.uipath.com/assets/images/insights/insights-screenshot-of-the-certificates-interface-158927-d2e955a8-d6e91385.webp)
2. Go to **IIS Manager** and open the **UiPath Insights** website.

   ![docs image](https://dev-assets.cms.uipath.com/assets/images/insights/insights-docs-image-157912-04ef369e-094b9184.webp)
3. Open the **Bindings** page.

   ![Screenshot of the Bindings page.](https://dev-assets.cms.uipath.com/assets/images/insights/insights-screenshot-of-the-bindings-page-160631-6d2435a1-62bf042f.webp)
4. Select the binding and click **Edit**, then choose your new certificate from the **SSL certificate** drop-down menu and click **OK**.

   ![Screenshot of the Edit Site Binding page.](https://dev-assets.cms.uipath.com/assets/images/insights/insights-screenshot-of-the-edit-site-binding-page-160990-041037b0-dbc8c748.webp)
5. Restart IIS.

## Updating Looker Certificate on the Insights Linux Machine

If you want to update or replace the Looker Certificate, follow the instructions below:

1. Export the Insights certificate with a private key asa PFX file.
2. Copy the `insights cert.pfx` file to the Insights Linux Machine by running the following command:
   ```
    scp {certificateFolder}\NewInsightsCert.pfx InsightsUser@LinuxMachine:/Home/InsightsUser/NewInsightsCert.pfx
   ```
3. Download [the script](https://github.com/UiPath/Insights-Customer/blob/master/Scripts/OnPrem/certificateChange.sh) needed to update the certificate by running the following command:
   ```
   wget https://github.com/UiPath/Insights-Customer/blob/master/Scripts/OnPrem/certificateChange.sh
   ```
4. Update the file permissions to make it executable:
   ```
   chmod 755 certificateChange.sh
   ```
5. Run the script using the following command:
   ```
   ./certificateChange.sh -c {cert.pfx filename} -s {RHEL FQDN as listed in certificate SAN}
   ```

You will be asked to provide path to the PFX file and password (if needed for the certificate).

## Updating the Port After an Installation

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

 <colgroup>
  <col/>
  <col/>
 </colgroup>
 
  
    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 &gt; Insights application &gt; Bindings to change the port number. 
  
  
    3. Remove URI port number from Identity Server DB 
    Remove the URI port number from the following parameters found in the  Identity Server database  :
      
         <code>ClientRedirectUris</code> 
         <code>ClientPostLogoutRedirectUris</code> 
      

  
  
    4. Modify<code>provisioning.url</code> parameter in Insights config file 
   
      
         Navigate to <code>C:\Program Files (x86)\UiPath Insights\Insights</code> and open the <code>appsettings.json</code> file to modify Insights settings. 
         Find the <code>provisioning.url</code> parameter. 
         Remove the port number from the URI. 
         Find the <code>portalUrl</code> parameter to add your new URL and port number. e.g., <code>"url": "https://insights.cloudStorage.com:portNo/insights"</code> 
         Save the file. 
      

  
  
    5. Modify<code>permission.url</code> parameter in Insights config file 
   
      
         Navigate to <code>C:\Program Files (x86)\UiPath Insights\Provisioning</code> and open the <code>appsettings.json</code> file. 
         Find the <code>permission.url</code> parameter. 
         Enter your new URL: <code>"Permission": &#123;new url</code> 
         Save the file. 
      

  
  
    6. Reset IIS 
    Open CMD as admin and run <code>iisreset</code> to reset IIS.
