About Apache Tomcat

Genesis runs on the current version of Apache Tomcat 10.   Do not attempt to use Genesis with any other version of Apache Tomcat.

Determine Apache Tomcat Version

Under Core > Diagnostics, you can see the current Apache Tomcat installed on your Windows Server with the current version.

Download the Latest Version of Apache Tomcat 10

https://tomcat.apache.org/download-10.cgi

32-bit/64-bit Windows Service Installer is needed for Windows

Preparing for Apache Tomcat Install ** Important Do Not Skip

If these steps are lost, you could potentially have data lost.

Make a copy of your entire Tomcat folder. x:\tomcat or x:\tomcat_genesis

You will need to get the Java Memory Amount under x:tomcat\bin\Tomcatw10.exe. Double click on Tomcatw10.exe and note the following information:

-The path of the Jave Virtual Machine

-Initial Memory Pool Number and Maximum Memory Pool Number

Uninstalling and Installing Apache Tomcat

Step 1: Stopping tomcat

To stop Tomcat, use the command net stop tomcat10.

Please wait until you receive the message "The Apache Tomcat service was stopped successfully."

Step 2: Uninstalling tomcat via Control Panel

Under Control Panel > Programs > Programs and features, you can see the current Apache Tomcat installed on your Windows Server. 

Right-click the tomcat and click uninstall. Then click uninstall again when the windows pop up.

Click Yes.

Once completed, the x:\tomcat folder will be deleted.

Step 3: Installing Apache Tomcat

Find where the 32-bit/64-bit Windows Service Installer is placed and double-click to start the installer.

Click Next.

Click I agree.

Click Next.

Confirm Windows Service Name is Tomcat10 and then click next.

Confirm that the correct Java Virtual Machine is selected. It should be the same Java as "-The path of the Jave Virtual Machine" in x:tomcat\bin\Tomcatw10.exe and then click next.

Change Destination Folder to x:\tomcat and then click Install.

After installation is completed, uncheck Run Apache Tomcat and Show Readme. Then click Finish.

Copying Files back that were saved in a new folder

Once Apache Tomcat is installed, you will have to move the files from the tomcat - copy back to the location in the tomcat folder.

x:\tomcat - Copy\lib\ojdbc.jar → x:\tomcat\lib\ojdbc.jar

x:\tomcat - Copy\lib\ucp.jar → x:\tomcat\lib\ucp.jar

x:\tomcat\lib\org (this is a folder) → x:\tomcat\lib\org (this is a folder). Some districts may not have this folder. You can skip if your district does not.

**Delete the folders from the tomcat installer in x:\tomcat\webapps\ docs, manager, and ROOT**

Replace them with root and genesis that were copied in the beginning.

x:\tomcat -Copy\webapps\root (this is a folder) → x:\tomcat\webapps\root (this is a folder)

x:\tomcat - Copy\webapps\genesis (this is a folder) → x:\tomcat\webapps\genesis (this is a folder)

x:\tomcat - Copy\conf\Catalina (this is a folder) → x:\tomcat\conf\Catalina (this is a folder)

x:\tomcat - Copy\conf\server.xml (replace the current server.xml with the new one) → x:\tomcat\conf\server.xml

Before Starting Apache Tomcat, you will need a Local Account, not Domain Account to be associated with the Apache Tomcat Services and change the Startup Type to Automatic (Delayed Start). You will make the changes in Services.

**(You can now use a Local System account instead of a local account. Also, allow service to interface with desktop.)**

In Services, right-click on Apache Tomcat and click on properties. Then change Startup Type to Automatic (Delayed Start).

In properties in Log on, select "Local System account" and Check the box "Allow service to interact with desktop" and hit apply

Finally, you will need to update the display name for the Apache Tomcat Service under x:tomcat\bin\Tomcatw8.exe. Double click Tomcatw10.exe and in General, change the Display name to Apache Tomcat. The Display name must be correct, or your nightly builds will not run correctly.

Then do a complete server reboot to have Tomcat startup on its own. Tomcat will take a few minutes to start as the Startup Type is Automatic (Delayed Start).

After the reboot is completed, log in to Genesis and confirm that Core > Diagnostics shows the latest version of Tomcat 8.5. If you have any questions or concerns, do not hesitate to contact the Genesis support team.