Quickstart Guide

The steps outlined here should get you started quickly with evaluating and testing a new archiver appliance. Note, these steps are not meant for production deployments, but are meant for evaluating and getting to know the system. For more details on how to deploy in a cluster or in a production environment, please see the Installation guide.
For folks familiar with deployment of WAR files, the archiver appliance consists of 4 WAR files. These steps deploy these WAR files on a single Tomcat JVM, set the log levels to ERROR and start the VM. To simplify matters, we are not persisting configuration and therefore there are no steps to define a connection pool for the configuration database.
Here are the steps to get started quickly.
  1. Make sure you have a recent version of Sun Java 1.8 from Oracle by running java -version. You should see something like so
  2. Download the installation package to a Linux machine into a brand new folder. This should give you a tar.gz file like archappl_vx.x.x.tar.gz.
  3. Download a recent version of Tomcat 7.x. into the same folder. You should now have two files in this folder like so
  4. Untar the archappl_vx.x.x.tar.gz. This should untar into 4 WAR files and a bash script like so
  5. Run the script like so
  6. This should start the Tomcat process in the foreground. Once all the webapps have been initialized (it takes about 2-5 minutes), you should see a log message in the console All components in this appliance have started up. We should be ready to start accepting UI requests like so
  7. Open a browser to http://<<machinename>>:17665/mgmt/ui/index.html and you should see the home screen for your archiver appliance.
  8. If your EPICS environment variables are set up correctly, you should be able to start archiving PV's right away. Note it takes about 5 minutes for the archiver appliance to measure the event rate, storage rate etc and to transition PVs from the Initial sampling state to the Being archived state.
  9. To stop the appliance, use a CTRL-C in the console.

Quickstart using predefined VMs

An alternate way to quickly get started and test the system is to use the predefined VM's provided by Martin. These consists of three repos needed to set up an EPICS Archiver Appliance test environment:
  1. vagrant_archiver_appliance
  2. puppet_module_archiver_appliance
  3. puppet_module_epics_softioc
Simply follow the rules in the README of the first repo and the other two repos will be pulled in automatically.