Migrating - Tomcat Configuration

The topics covered on this page include:


These instructions assume that you have Tomcat installed and configured.  If you need to install Tomcat, please refer to Tomcat installation instructions.

Deploy the Application

Important Note regarding unanet.xml file.  If you are migrating to this version from version 7.0 or prior, you may need to edit your unanet.xml file to ensure that the directory locations specified match the actual locations where you have installed Unanet.

The new unanet.war file was copied to the deployment directory (usually c:\unanet\unanet.war) by the install. If your Tomcat environment is configured to use auto deploy, this may be all that you need to do.  In that case, Tomcat will sense that the unanet.war file has changed and redeploy it automatically.  After a minute or so (ie wait for the redeployment to complete), log into your Unanet system and see if the Unanet version has been updated (you can verify this on the About page).   

If it did update,  you can stop here -- your upgrade is finished.

If the version did not update (ie you still see the old version number), continue with the following instructions.

Tomcat Undeploy Issue -- If the unanet application still exists after undeploying and refreshing the browser you will need to take additional manual steps.  Occasionally, when undeploying the unanet.war file in Tomcat, two directories and a file associated with it do not remove themselves properly.  Should this occur, the best way to resolve the issue is by stopping the Tomcat service (as a Windows service if running the Windows platform), then removing the file and directories that did not undeploy.  

Path examples of the file and directories that need to be removed are shown below:


Directories to delete (unanet directory only):  



File to delete:


Once these items are removed, restart the Tomcat service, refresh Tomcat Manager in your browser to verify the Unanet application has fully undeployed (no longer exists as an application in the Tomcat Manager). Then, again follow the deployment directions entering the proper information in the 'Deploy directory or WAR file located on server' fields.


Note: The following variables need to be set in your system.

Variable Name: TOMCAT_HOME
Example Value: c:\tomcat

Variable Name: JAVA_HOME
Example Value: c:\jdk1.8

Variable Name:  Path   (The system’s Path – Path should already exist as an environment variable)
Example Value: c:\jdk1.8\bin    (place this variable at the end of your system’s path)

How you will accomplish this will vary depending on your operating system (though you'll likely start by looking under "My Computer >> Properties").  Of course, your installation locations may be different -- the default of c:\ is used here as an example.  

Important Linux Note:  Support for generating graphical charts in Unanet is accommodated via the jFreeChart jars.  If Unanet is being run on a Linux/Unix server that does not have X11 installed and running, you will need to add an additional Java JVM property to support charting.  Check out Linux/Unix Graphics Support for additional information.

Having Problems?

If you are experiencing difficulties contact Unanet Customer Support for assistance.

Next Step

Step 7 - Verify Migration

Now that your migration is complete, you should verify that is was successful.