The Corticon Web Console requires Tomcat 9. It is not bundled with the Corticon Web Console download. The following instructions provide guidelines for installing Corticon Web Console into Tomcat to create a runtime environment. The example is specific to Windows installations, but Linux installations will follow a similar pattern.

Folder Setup

The steps below assume the following file system folder setup:

  • C:\Java_17 : Java 17 installation
  • C:\Tomcat_9 : Apache Tomcat 9 installation

  • C:\Progress\Corticon 7.1: Default Corticon 7.1 installation

Change the folder locations as needed in each step to match your configuration.

Install Tomcat

  1. Download the binary distribution of Apache Tomcat for your platform from: https://tomcat.apache.org/download-90.cgi For Windows, download "64-bit Windows zip".

  2. Create a work folder:
    mkdir C:\Corticon_Work_7.1
  3. Extract the downloaded files to:
    C:\Tomcat_9
  4. Deploy Corticon Web Console to Tomcat Edit the file: C:\Tomcat_10\bin\startup.bat, and then add the lines:
    set JAVA_HOME="C:\Java_17" 
    set CATALINA_OPTS=-DCORTICON_HOME="%CATALINA_HOME%" -DCORTICON_WORK_DIR="C:\Corticon_Work_7.1" 
    set JAVA_OPTS=%JAVA_OPTS% -Dfile.encoding=UTF-8
  5. Copy WAR file to Tomcat Copy the file:
    C:\Progress\Corticon 7.1\WebConsole\Deploy\Tomcat\9\corticon.war
    to:
    C:\Tomcat_9\webapps\corticon.war 
  6. Copy the etc folder (which contains the files logback.xml and CorticonServerConsoleConfig.groovy):
    C:\Progress\Corticon 7.1\WebConsole\etc
    to:
    C:\Corticon_Work_7.1\etc
  7. Edit the file:
    C:\Corticon_Work_7.1\etc\logback.xml
    and then set WORK_DIR_LOGS to the folder to write log files:
    <property name="WORK_DIR_LOGS" value="C:\Corticon_Work_7.1\logs"/>
  8. Configure Tomcat Ports (Optional) Edit the file:
    C:\Tomcat_9\conf\server.xml
    and then set the preferred ports (the port settings here reflect those previously used by Corticon):
    <Connector port="8850" protocol="HTTP/1.1" 
    			 connectionTimeout="20000" 
    			 redirectPort="8851" 
    			 maxParameterCount="1000"/>
    <Server port="8852" shutdown="SHUTDOWN"> 
  9. Restart Tomcat. If Tomcat is running, stop it.
  10. Start Tomcat by running:
    C:\Tomcat_9\bin\startup.bat.