Uninstall the MATRIXX Web Apps

Follow the procedure below to uninstall the My MATRIXX, RS Gateway, and MATRIXX Backoffice Customer Tool WAR files from the /var/lib/tomcat/webapps directory.

Before you begin

See the discussion about uninstalling the MATRIXX Proxy Server in Installation and Configuration, and complete this task on the server hosting the Web application.

Procedure

  1. Log in to the server as a user with sudo permissions.
    For example:

    ssh server_ip_address

    sudo su
  2. Convert all references to log4j.properties to log4j2.xml. This conversion also applies to the corresponding component properties files, such as those for RS Gateway, Notification Framework, Event Streaming Framework, Payment Service, and Gateway Proxy. For details about how to set up the RS Gateway, see the discussion on how to build and deploy an RS Gateway or the section on creating a new REST service class, both of which are in the Business API SDK. For information about setting up logging, see the discussion on MATRIXX log files in MATRIXX Monitoring and Logging.
  3. Open a new terminal and type this command to print the Tomcat log messages at the system prompt:
    tail -f /var/log/tomcat/catalina.date.log

    For example:

    tail -f /var/log/tomcat/catalina.2017-03-31.log
  4. In the terminal where you installed the RPM, check to see which war files were deployed.
    ls /var/lib/tomcat/webapps

    If all four applications were deployed, you will see these directories: matrixx rsgateway, and matrixxcm.

  5. Starting with the 5120 release, all Java/Web applications now utilize the log4j 2.x logging framework. The prior log4j.properties files are no longer supported and will need to be converted to log4j 2.x format files. For details, see the discussion on Web app logging in MATRIXX Web App Administration.
  6. Remove the MATRIXX .war files and their contents. Only specify the .war files that were deployed:
    sudo rm matrixx.war rsgateway.war matrixxcm.war
    As the files are removed, log messages similar to the following should display in the terminal where you ran the tail command: 
    INFO: Undeploying context [/matrixx]
INFO: Undeploying context [/rsgateway]
INFO: Undeploying context [/matrixxcm]
  7. Check to see that the directories were removed, and if not, remove them manually. Replace directory with the name of the war file directory:
    sudo rm -rf directory
    Note: If a /temp directory exists, also remove it.
  8. List the contents of the Tomcat /temp directory:
    ls /var/cache/tomcat/temp
    If the mtx_workspaces directory is listed, remove it.
    Important: You should commit any changes to your workspaces before removing the mtx_workspaces directory.

    sudo rm -rf mtx_workspaces

  9. List the contents of the Tomcat working directory:
    ls ../work/Catalina/localhost

    If a MATRIXX working directory is listed, enter the following command to remove it, where directory is the name of the directory: matrixx, rsgateway, or matrixxcm.

    sudo rm -rf directory