Setup Web Server

Owned by Checkmarx Bot (Unlicensed)
Last updated: Feb 14, 2020 by Shauna Corsaro
3 min read


Web Server Setup

VetView 2.0 is designed to run on Apache Tomcat 9. Version 1.7.10 and earlier are programmed for Apache Tomcat 7.  

Server Hardware and Operating System Information

VetView does not require any specific brand or model of server or Operating System. The VetView web server uses a standard JDBC connection to the database. We recommend at least 4GB of available RAM for Tomcat to operate. More memory may be required dependent on your user load and transaction volume.

  • 4GB RAM available for Tomcat ( minimum )


There are lots of good guides on the web about installing Tomcat on the OS of your choice.  There's even a video for installing it on Windows.  Here's a guide we found to installing it via the command line in Ubuntu.

Tomcat Installation

VetView does not require an special installation, in our test environment we use Tomcat 7 for Windows x64. During the installation we use all the default settings, allocating 3-4 GB of RAM for use. This amount a memory may very based on your user load.

Example Setup:

    • Oracle Version - 11g Release 2 for Windows x64
    • 4GB of RAM available to the Tomcat



Prerequisite

Tomcat requires Java JRE 7

Java Install Wizard Screen Shots ( click to enlarge Images )

   


Tomcat Install Wizard Screen Shots ( click to enlarge images )

           


Tomcat by default installs a manager page that can be accessed using the Tomcat Administrator Login that was created during the installation.

Example Tomcat Manager URL: 

  • http://<IP address of web server>:8080/manager/html


Firewall

Web Server Firewall will need to be adjusted to allow access to manager or VetView web pages.

Tomcat Manager Screen Shots ( click to enlarge images )

 

If you use Tomcat 7 manager to deploy VetView, you'll need to up the default limit for WAR file size.

http://nexnet.wordpress.com/2011/04/27/large-war-file-cannot-be-deployed-in-tomcat-7/

(Thanks to UGA's VetView project manager Adam Allen for this tip) 


Adjusting Tomcat Memory

By default Tomcat Memory is configured for initial memory pool of 128MB and a maximum of 256MB.

 

There are 4 memory settings that we recommend you adjust based on user load. To adjust the memory settings you either set the appropriate environment variable or the Tomcat configuration tool for windows.

  • Initial memory pool ( Heap memory ) - 128MB
  • Max memory pool ( Heap memory ) - 3072MB
  • Initial Perm Gen - 128MB
  • Max Perm Gen - 1024MB

Linux

You need to use the set of "non standard" options that are passed to the java command. Run: java -X for details. The options you're looking for are -Xmx and -Xms (this is "initial" heap size) plus perm size.

Tomcat comes with a batch script that looks for the JAVA_OPTS environment variable, but it's not part of the Java runtime. To set the variable like, run a command like:

set JAVA_OPTS="-Xms128m -Xmx3072m -XX:MaxPermSize=1024m -XX:PermSize=128m"

Windows

  1. Open the Tomcat configuration tool from the Windows menu at Start > All Programs > Apache Tomcat > Tomcat Configuration.
  2. Click Configure and select the Java tab.
  3. At the bottom of the window, there are fields for modifying memory allocation.
  4. You'll also need to add the lines for PermSize and MaxPermSize. 
    1. -XX:MaxPermSize=1024m
    2. -XX:PermSize=128m

Tomcat must be restarted for setting to take effect.


    


Next Step


Deploy VetView Project