Forecaster

Download

Download Forecaster
  • Right click on the "Download the Forecaster" link and select "Save target as..." or "Save link as..."
  • This should open the file save as dialog box on Internet Explorer or Firefox and allow you to save the application file to your local computer.

Note: Internet Explorer has difficulty saving the lsvfweb.war file properly. Please ensure you save save it exactly as lsvfweb.war and not as lsvfweb.war.txt or lsvfweb.txt.

Install on Tomcat

The Lone Star Vaccine Forecaster application is called "lsvfweb.war" and must be installed into Tomcat in order to operate on your local system.

  • Save or copy the downloaded file to the Tomcat/webapps directory.
  • On Windows system this is typically here: C:\Program Files\Apache Software Foundation\Tomcat 7.0\webapps

Confirm Installation

If you have followed the previous steps correctly you will see that Tomcat automatically creates a folder named "lsvfweb" inside the webapps folder. The happened because lsvfweb.war is actually a zip file that Tomcat recognizes. When you saved the lsvfweb.war file in the webapps folder, Tomcat recognized it and expanded it into a folder.

Once Tomcat has expanded the webapps folder it will download a 140kb sized file named lsvforecaster.jar and save it in Tomcat's /bin folder or in Tomcat's root folder. This file is the Lone Star Vaccine Forecaster logic and is updated each time Tomcat is started.

Navigate to this URL: http://localhost:8080/lsvfweb/startServlet (May require modification if Tomcat is installed on a different system or not on port 8080.) When successfully started it should show the version of the forecaster.

Once started the Lone Star Vaccine Forecaster listens on port 6708 and responds to TCP/IP requests. The performance and availability of this service can be tested with this command: java -classpath lsv-forecaster.jar org.immregistries.lonestar.core.server.CaretForecasterTester repeat-count [thread-count [host-name [port-number]]]

Test Future Version

The instructions above give directions on how to install the Forecaster for production. Before a new version of the Lone Star Vaccine Forecaster is released for production it is released for test. The installation above can be configured to request the test version instead of the production version. Often this will be the same version, but if a new test version has been released, this configuration change will ensure the latest version out on test is being used.

  • Following standard installation process.
  • Stop Tomcat if it is running.
  • Open he web.xml file in a text editor (such as Windows Wordpad). This file will be found in the [Tomcat Folder]/webapps/fweb/WEB-INF folder.
  • Find the line that reads <param-value>http://florence.immregistries.org/lonestar/lsv-forecaster.jar</param-value> and change to <param-value>http://florence.immregistries.org/lonestar/lsv-forecaster-test.jar</param-value> by simply adding the text -test to the URL.
  • Start Tomcat