Setting up the Runtime Environment

Setting up a proper runtime environment for LOUI Products requires the following:

• Network connection to a running instance of ActiveMQ broker
• directory with write access for the log files
• Proper config files

For a quick setup guide, please refer to the #Setup section below.

ActiveMQ Broker

The production instance of the ActiveMQ broker for DCT runs on joe.lowell.edu. It should only be connected to while trying to operate a real system at DCT. For testing one should try to connect to sabzi.lowell.edu.

The connection URL for the ActiveMQ Broker is specified in jndi.properties file for the appropriate product. Please refer to the section below for more details.

Log Files

A LOUI product will write to one or more log files during the operation. The location and level of logging is specified in log4j.properties file for the appropriate product. The log files are rotated automatically daily and properly labeled. The timestamp for the log statements is in UT but the log rotation happens based on local time at midnight.

By default, the main log file for each application is app.log and they are located under /var/log/LOUI/ directory:

/var/log/LOUI/
├── cat
├── gwaves
├── joe
├── joeClient
├── lmi
└── observerTargetlist

6 directories

Unless there is a very good reason, log4j.properties should not be modified and default values should be used.

Config Files

All the config files for the LOUI applications should be in the proper directory under /opt/LOUI/ directory. This path is built into the applications and has to exist on the installation computer:

/opt/LOUI/
├── MasterInstrumentConfiguration.xml
├── activemqTCS
│   ├── instrumentConfiguration.xml
│   └── jndi.properties
├── cat
│   ├── jndi.properties
│   └── log4j.properties
├── gwaves
│   ├── CameraConfiguration_GDR.xml
│   ├── CameraConfiguration_WFS.xml
│   ├── Jndi_GDR.properties
│   ├── Jndi_WFS.properties
│   ├── log4j_GDR.properties
│   └── log4j_WFS.properties
├── hipo
│   ├── CameraConfigurationBlue.xml
│   ├── CameraConfigurationRed.xml
│   ├── instrumentConfigurationBlue.xml
│   ├── instrumentConfigurationRed.xml
│   ├── jndiBlue.properties
│   └── jndiRed.properties
├── joe
│   ├── jndi.properties
│   └── log4j.properties
├── joeClient
│   ├── jndi.properties
│   └── log4j.properties
├── lmi
│   ├── CameraConfiguration.xml
│   ├── jndi.properties
│   └── log4j.properties
├── nasa42
│   ├── instrumentConfiguration.xml
│   └── jndi.properties
├── nihts
│   ├── CameraConfiguration.xml
│   ├── jndi.properties
│   └── log4j.properties
└── observerTargetlist
    ├── jndi.properties
    └── log4j.properties

10 directories, 31 files

The config files are either xml or java property files. There is main config file that is used by most applications /opt/LOUI/MasterInstrumentConfiguration.xml. Each application's specific configuration is under a separate subdirectory and the names of these subdirectories cannot be changed. Depending on the application, there are 2 or 3 config files:

• CameraConfiguration.xml
  Contains the default values for different modes of operation of a CCD camera
• jndi.properties
  contains parameters used for connecting to the ActiveMQ broker and/or database
• log4j.properties
  contains the parameters for log4j framework such as log file location, logging levels, and rotation schedule

Setup

Easiest way to set up the configuration environment is to checkout the whole tree structure.

• Create /opt/LOUI/ directory for storing the configuration files
• Check out the whole tree for the config files

  $ cd /opt/LOUI
  $ svn checkout svn://jumar.lowell.edu/LOUI_Configuration/trunk/prod .
  

• Edit the jndi.properties file for the appropriate applications to point to the right machine and right broker.