automation-suite
2022.10
false
UiPath logo, featuring letters U and I in white
Automation Suite Installation Guide
Last updated Nov 21, 2024

Configuring the FQDN post-installation

To update the FQDN of Automation Suite, you need to run the installer again and make the following changes in the cluster_config.json file for all the nodes in the cluster.
  • fqdn - update this field with new FQDN that you need to access the cluster.
    Important:
    The fqdn field only supports lowercase letters.
  • fixed_rke_address - if this value is identical to the fqdn field in cluster_config.json, then you need to update this value as well to reflect the new FQDN.
    Note:

    Changing the FQDN also requires new server certificates. If a new certificate is available, you have two options: either continue with the new self-signed certificate configured by the installer automatically, or stop the installation and bring in a new certificate.

    You can configure the certificate via the server_certificate field in cluster_config.json.

Updating the FQDN in Single-node Evaluation Mode

To update the FQDN in single-node evaluation mode, take the following steps:

  1. Navigate to the UiPathAutomationSuite folder (the location of the installer bundle).
  2. Run the following command to update the FQDN:

Online

sudo ./install-uipath.sh -i ./cluster_config.json -o output.json -a --accept-license-agreementsudo ./install-uipath.sh -i ./cluster_config.json -o output.json -a --accept-license-agreement

Offline

Run the following command to update the FQDN for the infrastructure:

sudo ./install-uipath.sh -i ./cluster_config.json -o ./output.json -k --offline-bundle ./sf-infra.tar.gz --offline-tmp-folder /uipath/tmp --accept-license-agreementsudo ./install-uipath.sh -i ./cluster_config.json -o ./output.json -k --offline-bundle ./sf-infra.tar.gz --offline-tmp-folder /uipath/tmp --accept-license-agreement

Run the following command to update the FQDN for the fabric and services:

sudo ./install-uipath.sh -i ./cluster_config.json -o ./output.json -f -s --install-type offline --accept-license-agreementsudo ./install-uipath.sh -i ./cluster_config.json -o ./output.json -f -s --install-type offline --accept-license-agreement
Note: The installer warns you of the consequences of updating the FQDN. It asks for confirmation before proceeding further. The installer also warns you if there is no new valid certificate related to the FQDN.

Updating the FQDN in multi-node HA-ready production mode

To update the FQDN in multi-node HA-ready production mode, take the following steps:

Run the installer on all the machines (server and agent nodes). Note that the order of execution is very important. You first need to run the installer on all the servers, and then on all remaining agent nodes as well as the Task Mining node.
Note:

There are some variations between the commands you run on the first server node, those you execute on the subsequent server nodes, and those you use on agent nodes, as follows:

  • The -a option is exclusively for commands executed on the first server node. This is where you must run the fabric and service installer.
  • The -k option specifically applies to commands run on the following server nodes, and it skips the execution of the fabric and service installer.
  • The -j server option is used to distinguish between server nodes and agent nodes.

First Server Node

  1. Navigate to the UiPathAutomationSuite folder (the location of the installer bundle).
  2. Run the following command to update the FQDN:

    Online

    sudo ./install-uipath.sh -i cluster_config.json -o output.json -a --accept-license-agreementsudo ./install-uipath.sh -i cluster_config.json -o output.json -a --accept-license-agreement

    Offline

    Run the following command to update FQDN for the infrastructure:

    sudo ./install-uipath.sh -i ./cluster_config.json -o ./output.json -k --offline-bundle ./sf-infra.tar.gz --offline-tmp-folder /uipath/tmp --accept-license-agreementsudo ./install-uipath.sh -i ./cluster_config.json -o ./output.json -k --offline-bundle ./sf-infra.tar.gz --offline-tmp-folder /uipath/tmp --accept-license-agreement

    Run the following command to update FQDN for the fabric and services:

    sudo ./install-uipath.sh -i ./cluster_config.json -o ./output.json -f -s --install-type offline --accept-license-agreementsudo ./install-uipath.sh -i ./cluster_config.json -o ./output.json -f -s --install-type offline --accept-license-agreement
    Note: The installer warns you of the consequences of updating FQDN. It asks for confirmation before proceeding further. The installer also warns you if there is no new valid certificate related to the FQDN.

Subsequent Server Nodes

  1. Navigate to the UiPathAutomationSuite folder (the location of the installer bundle).
  2. Run the following command to update the FQDN:

    Online

    sudo ./install-uipath.sh -i cluster_config.json -o output.json -k -j server --accept-license-agreementsudo ./install-uipath.sh -i cluster_config.json -o output.json -k -j server --accept-license-agreement

    Offline

    sudo ./install-uipath.sh -i ./cluster_config.json -o ./output.json -k -j server --offline-bundle ./sf-infra.tar.gz --offline-tmp-folder /uipath/tmp --accept-license-agreementsudo ./install-uipath.sh -i ./cluster_config.json -o ./output.json -k -j server --offline-bundle ./sf-infra.tar.gz --offline-tmp-folder /uipath/tmp --accept-license-agreement

Additional Agent Nodes and Task Mining Node

  1. Navigate to the UiPathAutomationSuite folder (the location of the installer bundle).
  2. Run the following command to update the FQDN:

    Online

    sudo ./install-uipath.sh -i cluster_config.json -o output.json -k -j agent --accept-license-agreementsudo ./install-uipath.sh -i cluster_config.json -o output.json -k -j agent --accept-license-agreement

    Offline

    sudo ./install-uipath.sh -i ./cluster_config.json -o ./output.json -k -j agent --offline-bundle ./sf-infra.tar.gz --offline-tmp-folder /uipath/tmp --accept-license-agreementsudo ./install-uipath.sh -i ./cluster_config.json -o ./output.json -k -j agent --offline-bundle ./sf-infra.tar.gz --offline-tmp-folder /uipath/tmp --accept-license-agreement

Was this page helpful?

Get The Help You Need
Learning RPA - Automation Courses
UiPath Community Forum
Uipath Logo White
Trust and Security
© 2005-2024 UiPath. All rights reserved.