Adding Tomcat user accounts

Last Updated : Jun 05, 2026 |

About this task

After you install the Application server, you must add Tomcat user accounts to the server. If you use the Avaya-provided application installation script, the script automatically creates the required Avaya Experience Portal Tomcat user account. Otherwise, you must manually add the user account. Additionally, to administer the Tomcat server from the Tomcat Manager Web interface, you must add a Tomcat user. For details, see the Tomcat application server documentation.

These accounts authorize users to gain access to the Tomcat Manager Web interface from the Experience Portal system to deploy, remove, start, and stop applications on the Application server:

Procedure

  1. Navigate to the configuration directory by running the $APPSERVER_HOME/conf command where $APPSERVER_HOME is the location of the co-resident Application server.
  2. Back up the configuration file of the users by running the cp tomcat-users.xml tomcat-users.xml.old command.
  3. Open tomcat-users.xml in the XML editor of your choice.
  4. Verify if there is a role with the rolename set to manager-gui. Otherwise, add a role with the rolename set to manager by adding <role rolename="manager-gui"/> in a new line immediately after the <tomcat-users> tag.
  5. Verify if there is a user name set to expportal. Otherwise, add the following after the opening <tomcat-users> tag and before the closing </tomcat-users> tag:
    1. A user with the user name set to expportal.
    2. A password set to any password of your choice.
    3. Roles set to manager-gui.

    For example:

    <tomcat-users>

    <role rolename="manager-gui"/>

    <user username="expportal" password="password" roles="manager-gui"/>

    </tomcat-users>

    Note:

    Ensure that no duplicate users with the same user name exist.

    If you add a user, you must restart the Tomcat application server.

  6. To create another user for administering the system, add the following after the opening <tomcat-users> tag and before the closing </tomcat-users> tag:
    1. A user with a username of your choice.
    2. A password set to any password of your choice.
    3. Roles set to manager-gui.

    For example:

    <tomcat-users>

    <role rolename="manager-gui"/>

    <user username="administrator" password="password" roles="manager-gui"/>

    </tomcat-users>

    Note:

    Ensure that no duplicate users with the same user name exist.

    If you add a user, you must restart the Tomcat application server.

  7. Save and close the file.
  8. Restart the Tomcat application server from EPM after changing the user account.