Alteryx Connect Knowledge Base

Definitive answers from Connect experts.

How to Upgrade Tomcat in Alteryx Connect

LisaL
Alteryx
Alteryx
Created

If you wish to upgrade the Apache Tomcat plugin in a Connect deployment, you can do so.  Here are some tips on that process.  Tomcat's site provides a good overview of what's involved.

Prerequisites

  • Alteryx Connect
    • Any version, but particularly versions prior 2021.2
  • Apache Tomcat software download package, verified with OpenPGP keys and SHA-512 checksums

Procedure

  1. Take a backup of your Connect environment, and test it on a Sandbox/Test environment before upgrading the Tomcat version in the actual production environment.  Keep a copy of the server.xml file if using SSL.  Keep a copy of the Tomcat folder (path: xf3/tomcat).
  2. Stop the Alteryx Connect Service before upgrading the Tomcat version.
  3. Deploy the upgrade.
  4. Replace the contents of the Tomcat folder (path: xf3/tomcat) with the current Tomcat folder, and then restart the Connect service.
  5. Overwrite the new server.xml file, once you do the update, with your current server.xml file.
  6. Replace the following files within the installation directory's /bin/ folder (e.g. C:\Program Files\AlteryxConnect\bin\):

    bootstrap.jar
    catalina.bat
    catalina.sh
    daemon.sh
    service.bat
    tcnative-1.dll
    tomcat9.exe
    tomcat9w.exe

  7. Replace following files within the installation directory's /conf/ folder (e.g. C:\Program Files\AlteryxConnect\conf\):

    web.xml

  8. Replace following files within the installation directory's /lib/ folder (e.g. C:\Program Files\AlteryxConnect\lib\):

    annotations-api.jar
    catalina*.jar (all files starting with catalina)
    ecj-4.18.jar
    el-api.jar
    jasper*.jar (all files starting with jasper)
    jsp-api.jar
    servlet-api.jar
    tomcat*.jar (all files starting with tomcat)
    websocket-api.jar

  9. Add manager.xml file under the /webapps/ROOT/WEB-INF/
 

 

  • For the check of running Tomcat version, execute the command (java -cp catalina.jar org.apache.catalina.util.ServerInfo) under lib folder. (You need to have installed Java for it – for example java.com).


No ratings