Uninstalling the Tomcat application server

Last Updated : Jun 05, 2026 |

About this task

Important:

By uninstalling the Tomcat application server:

  • All the applications deployed on the co-resident application server are deleted.

  • All the components or libraries deployed on the co-resident application server are deleted.

  • All the customized configuration information of the application server are deleted.

  • All log files under the application server directory are deleted.

  • The Application Server menu is not available in the EPM.

Before you begin

  • Make sure that the applications hosted by the co-resident application server are not handling any active calls.

  • Backup the required configuration files, data files, web applications and associated components, libraries and binaries from the directory where the application server is installed.

Procedure

  1. Log on to Linux on the Experience Portal server.

    If you are an Avaya Services representative, and use Avaya Enterprise Linux, the Avaya Service accounts will not be available after the Avaya Enterprise Linux upgrade. The Avaya Service accounts will be available through EASG configuration during the Experience Portal upgrade.

    • Log on to the local Linux console as root.

    • Or log on remotely as a non-root user and then change the user to root by entering the su - root command.

  2. Enter the systemctl stop appserver.service command to stop the Application server.
  3. Change to the application server home by entering the cd $APPSERVER_HOME command.
  4. Change to the parent directory by entering the cd .. command.
  5. Remove the Tomcat soft link by entering the rm -f tomcat command.
  6. Remove the Tomcat directory by entering the rm -rf <tomcat-subdirectory> where Tomcat-subdirectory is the directory where Tomcat is extracted. The directory form is apache-tomcat*or jakarta-tomcat*.
  7. In the /opt/Tomcat/tomcat/lib/config/voiceportal.properties file, set the value of enableLocalAppServer to false.
  8. Unregister the service by entering the systemctl disable appserver command.
  9. Remove the application server service script by entering the rm /etc/systemd/system/appserver.service command.
  10. Remove the appserver scripts by entering the rm /etc/profile.d/appserver.* command.

    If the system prompts for confirmation, type Y and press Enter.

  11. Restart the vpms service by entering the systemctl restart vpms command.

    This command shuts down and restarts the vpms server.

  12. Check the status of the vpms service by entering the systemctl is-active vpms command.

    The command displays the message: active