UiPath Documentation
automation-suite
2.2510
true
UiPath logo, featuring letters U and I in white

Automation Suite on Linux installation guide

Last updated Mar 26, 2026

Updating the cluster configuration

After regenerating the cluster_config.json file but before performing the upgrade, you can make various changes, such as updates to the database configuration, certificate configuration, and more. For details, see Performing advanced configuration.

Additionally, there are a few service-specific configurations that you must apply before upgrading. To check which changes are required for your Automation Suite cluster, see the following table:

Conditions

Actions

1. You installed Automation Suite 2023.4 or earlier in an offline environment.

  • AND

2. You upgrade to Automation Suite 2023.10 or later.

You must manually add install_type: offline to the cluster_config.json file.

{
  "install_type": "offline",
  "fqdn": "<sample_fqdn>",
  ...
}
{
  "install_type": "offline",
  "fqdn": "<sample_fqdn>",
  ...
}

1. Orchestrator is installed on the old Automation Suite version.

  • AND

2. You upgrade from Automation Suite 2022.10.

Set the following parameter in the cluster_config.json file to confirm that you agree with blocking classic folder executions. Without consent, the upgrade will fail. 

{
  "orchestrator": {
    "enabled": true,
    "block_classic_executions": true
  }
}
{
  "orchestrator": {
    "enabled": true,
    "block_classic_executions": true
  }
}

For details, refer to Orchestrator-specific configuration.

1. Apps is installed on the old Automation Suite version.

  • AND

2. You upgrade from Automation Suite 2022.10 or earlier.
  1. Create a database for Apps with the following default name: AutomationSuite_Apps.
  2. If you want to overwrite the default SQL connection string, update the ODBC connection string for the Apps database in the cluster_config.json file. 
{
  "apps": {
    "sql_connection_str": "SERVER=sqlserver.mycompany.com,1433;DATABASE=AutomationSuite_Apps;DRIVER={ODBC Driver 17 for SQL Server};UID=testadmin;PWD=***;MultipleActiveResultSets=False;Encrypt=YES;TrustServerCertificate=NO;Connection Timeout=30;"
  }
}
{
  "apps": {
    "sql_connection_str": "SERVER=sqlserver.mycompany.com,1433;DATABASE=AutomationSuite_Apps;DRIVER={ODBC Driver 17 for SQL Server};UID=testadmin;PWD=***;MultipleActiveResultSets=False;Encrypt=YES;TrustServerCertificate=NO;Connection Timeout=30;"
  }
}

For an example of the ODBC connection string, refer to Database configuration.

1. AI Center is installed on the old Automation Suite version and connects to an external Orchestrator.
  1. Copy the Orchestrator certificates to the server node on which you plan to trigger the upgrade. For details, refer to Copy the Orchestrator certificate to the virtual machine.
  2. Update the cluster_config.json file with the following configuration: 
    {
  "aicenter": {
    "enabled": true,
    "orchestrator_url": "https://orchestrator.example.com",
    "identity_server_url": "https://orchestrator.example.com/identity",
    "orchestrator_cert_file_path": "/opt/UiPathAutomationSuite/UiPath_Installer/orch.cer",
    "identity_cert_file_path": "/opt/UiPathAutomationSuite/UiPath_Installer/orch.cer",
    "metering_api_key": "test"
  }
}
{
  "aicenter": {
    "enabled": true,
    "orchestrator_url": "https://orchestrator.example.com",
    "identity_server_url": "https://orchestrator.example.com/identity",
    "orchestrator_cert_file_path": "/opt/UiPathAutomationSuite/UiPath_Installer/orch.cer",
    "identity_cert_file_path": "/opt/UiPathAutomationSuite/UiPath_Installer/orch.cer",
    "metering_api_key": "test"
  }
}
  3. Ensure that cluster_config.json includes the following parameter: 
    {
  "sql_connection_string_template": "DOTNET connection string templates",
  "sql_connection_string_template_odbc": "ODBC connection string templates",
  "pyodbc_sql_connection_str": "***"
}
{
  "sql_connection_string_template": "DOTNET connection string templates",
  "sql_connection_string_template_odbc": "ODBC connection string templates",
  "pyodbc_sql_connection_str": "***"
}

1. Process Mining is installed on the old Automation Suite version.
  1. Update the sqlalchemy connection string template applicable for PostgreSQL in the cluster_config.json file before the upgrade.

postgresql_connection_string_template_sqlalchemy_pyodbc

postgresql+psycopg2://<user>:<password>@<postgresql host>:<postgresql port>/<airflow db name>

When upgrading from Microsoft SQL Server to PostgreSQL database data migration is not required.

1. You enabled FIPS.

You must add the fips_enabled_nodes parameter in cluster_config.json. For details, refer to General configuration.

Was this page helpful?

Connect

Need help? Support

Want to learn? UiPath Academy

Have questions? UiPath Forum

Stay updated