Creating an administrative user

Last Updated : Jul 01, 2026 |
Prolog information
Metadata
Keywords:
You must use a non-root Linux user with sudo privileges to install the Avaya Aura® Device Services application. The User ID (UID) of the Linux user that performs the installation must be the same on all nodes in the cluster.
This procedure describes how to add a user and an administrative group. For a clustered deployment of Avaya Aura® Device Services, perform the steps described in this procedure on every node in the cluster.
Important:
You must create only one administrative user on each virtual machine.
Before you begin
Deploy RHEL 9.6 on virtual machines.
  1. Log in to the virtual machine with deployed RHEL 9.6 as the root user using an SSH connection.
  2. Run the following command to create a group for the administrative user:
    ADDITIONAL INFORMATION: groupadd -g 4001 <admin_group>
    In this command, <admin_group> is one of the following:
    • If you fresh install Release 10.3.x, this is a group name of your choice.
    • If you migrate from a previous Avaya Aura® Device Services release, this is the same administrative group that you use in that release.
    For example:
    groupadd -g 4001 admingrp
    Important:
    For Group ID (GID), you must use 4001.
  3. Run the following command to add an administrative user in the new administrative group:
    ADDITIONAL INFORMATION: usermod -g <admin_group> -u 4001 <admin_name>
    In this command, <admin_group> is the name of the group you created in the previous step, and <admin_name> is one of the following:
    • If you fresh install Release 10.3.x, this is the name of the administrative user that you created when deploying the virtual machine.
    • If you migrate from a previous Avaya Aura® Device Services release, this is the same administrative user that you use in that release.
    For example:
    usermod -g admingrp -u 4001 aadsadmin
    Important:
    For User ID (UID), you must use 4001.
  4. Run the following command to create a password for the new administrative user and then enter the password:
    ADDITIONAL INFORMATION: passwd <admin_name>
    In this command, <admin_name> is the administrative user name. For example:
    passwd aadsadmin
  5. Run the following command to provide sudo privileges for the new administrative user:
    ADDITIONAL INFORMATION: usermod -aG wheel <admin_name>
    For example:
    usermod -aG wheel aadsadmin
Next steps
  • Enable the YUM package manager on RHEL.
  • Install additional packages required by Avaya Aura® Device Services.
Related links
Initial setup for software-only VMware deployments
Characters supported for Avaya Aura Device Services passwords