Configuring network settings using the Avaya Aura Device Services configuration utility

Last Updated : Jun 10, 2026 |

About this task

You must use the Avaya Aura® Device Services configuration utility to configure the following network settings:

  • Front-end FQDN

  • Virtual IP address

  • Utility Server virtual IP address and FQDN

  • System Manager FQDN

  • System Manager IP addresses

You might also need to perform additional actions to complete the configuration process after configuring Avaya Aura® Device Services network settings using the cliChangeNet.sh script. The exact actions that you must perform depend on the following:

  • Whether you modified IP addresses of System Manager and Session Manager.

  • Whether you have a standalone or cluster deployment.

  • Whether you use optional Avaya Aura® Device Services features, such as OAuth, Utility Server, or onboard Open LDAP.

You do not need to perform this procedure if you only change DNS or NTP server IP addresses.

Before you begin

  • Configure network settings as described in Configuring network settings using the cliChangeNet.sh script. In a cluster deployment, configure network settings on each cluster node.

  • In a cluster deployment, if you use onboard Open LDAP, back up user data stored on Open LDAP.

    Important:

    When you re-enable Open LDAP replication after applying network changes, all Open LDAP user data is erased. Therefore, you must back up user data and then re-upload user data using the Avaya Aura® Device Services web portal after completing network configuration.

Procedure

  1. Log in to the Avaya Aura® Device Services as an administrator.
  2. Run the following command to start the configuration utility: 
    app configure
  3. Do the following to update front-end FQDN settings:
    1. Navigate to Front-end host, System Manager and Certificate Configuration settings.
    2. If you updated the front-end FQDN of the virtual IP address, in Front-end FQDN, type the new FQDN.
    3. If you updated the local FQDN of the node, in Local frontend host, type the new FQDN of the node.
    4. In Keystore password, type the Keystore password you used when installing Avaya Aura® Device Services.
    5. Click OK and then click Apply.
  4. If you updated the virtual IP address of Avaya Aura® Device Services, do the following:
    1. Navigate to Clustering Configuration > Virtual IP Configuration menu.
    2. In Virtual IP address, type the new virtual IPv4 address.
    3. If you use IPv6, in Virtual IPv6 address, type the new virtual IPv6 address.
    4. Click OK and click Apply.
    Note:

    Perform this step on the seed and backup nodes only. Do not perform this step on other non-seed nodes.

  5. In an Avaya Aura® environment, if you need to update System Manager settings, do the following:
    1. Navigate to Front-end host, System Manager and Certificate Configuration settings.
    2. In System Manager FQDN, type the System Manager FQDN.
    3. In System Manager Enrollment Password, type the enrollment password of the System Manager.
    4. In Keystore password, type the Keystore password you used when installing Avaya Aura® Device Services.
    5. Click OK and then click Apply.
  6. If you need to update third-party identity certificates, import certificates with appropriate FQDNs to Avaya Aura® Device Services as described in Importing third-party CA-signed certificates.
    Note:

    • You must update identity certificates if you change IP addresses or FQDNs of any of Avaya Aura® Device Services nodes.

    • In an environment without Avaya Aura®, Avaya Aura® Device Services always uses third-party identity certificates.

    • If you use System Manager certificates, these certificates are automatically re-generated when you perform step 5.

  7. In an Avaya Aura® environment, if you need to update Session Manager IP addresses, do the following:
    1. Navigate to the Session Manager Configuration menu.
    2. In Session Manager Management IP, type the new Session Manager Management IP address.
    3. In Session Manager Asset IP, type the new Session Manager Asset IP address.
    4. Select Apply.
  8. To update the Utility Server virtual IP address and FQDN, do the following:
    1. Navigate to the Utility Server configuration menu.
    2. In Utility Server VIP, type the new virtual IPv4 address of the Utility Server.
    3. If you use IPv6, in Utility Server Ipv6, type the new virtual IPv6 address of the Utility Server.
    4. In Utility Server FQDN, type the new FQDN of the Utility Server.
  9. In Main Menu, click Continue and click Yes.
  10. When the configuration process completes, click Continue.
  11. In a cluster deployment, perform steps 2 to 3 and then steps 5 to 10 on all remaining nodes of the cluster.

    You must perform step 4 on the seed node only.

  12. In a cluster deployment, on each cluster node, run the app listnodes command and ensure that all cluster nodes have the live status.
  13. In a cluster deployment, configure RSA public and private keys for internode SSH communication as described in Configuring RSA public and private keys for SSH connections in a cluster.
  14. In a cluster deployment, if SSO/OAuth is enabled on Avaya Aura® Device Services, re-configure OAuth replication on all nodes in the cluster.

    For information about configuring OAuth replication, see Enabling OAuth database replication in a cluster environment.

  15. In a cluster deployment, if you use onboard Open LDAP, do the following:
    1. On each cluster node, run the following commands: 
      cdto openldap
sudo ./recover_openldap.sh
    2. On each cluster node, enable Open LDAP replication as described in Enabling Open LDAP replication.
    3. On the seed node, run the following command to restore Open LDAP user data from a backup: 
      tar -xzf /tmp/<BACKUP_NAME> -C /
      For example: 
      tar -xzf /tmp/ldapDBBKUP.tar.gz -C /

Next Steps

If you have components in your deployment that use Avaya Aura® Device Services FQDNs or IP addresses, update these settings accordingly. For example, the following components can use Avaya Aura® Device Services FQDNs or IP addresses:

  • Avaya Aura® Web Gateway uses Avaya Aura® Device Services FQDN if OAuth is configured.

    System Manager uses Avaya Aura® Device Services FQDNs on the Elements page.

  • External load balancer uses Avaya Aura® Device Services FQDN in its certificate.