AOSS Ceilometer

Bash and python scripts for managing the AOSS Ceilometer's data ingest and higher level product generation.

NOTE: Most of the code in this repository was copied from the old subversion repository. This code was executed on python 2.6/2.7 environments, but will be run from python 3.6+ from now on. Some scripts may not work out of the box.

Serial Adapter

To communicate with the ceilometer there is an ethernet to serial adapter attached to it. The "rain01" server communicates to it through a special driver from "MOXA" (the manufacturer of the adapter). This driver is automatically installed as part of the root accounts crontab. See the scripts/reinstall_ceilo_driver.sh script for more information.

Operation Installation

These instructions assume the operation "standard practice" that is current at the time of writing. This practice is to create a conda environment using the "root" user under /opt/metobs/aoss_ceilo. These instructions also assume that the newest base conda environment is at /opt/miniconda3/, but it is more likely at a /opt/miniconda3_YYYYMMDD directory or /opt/miniforge_YYYYMMDD directory.

1. Get and install the conda environment:

   cd /tmp
   curl -O "https://gitlab.ssec.wisc.edu/metobs/AossCeilo/-/raw/master/environment.yaml"
   sudo /opt/miniconda3/condabin/conda env create --file environment.yaml --prefix /opt/metobs/aoss_ceilo

2. Clone the git repository into the environment and other setup:

   cd /opt/metobs/aoss_ceilo
   sudo mkdir -p repos/git log lock
   sudo chown metobs:metobsgrp log lock
   sudo git clone "https://gitlab.ssec.wisc.edu/metobs/AossCeilo.git" repos/git/AossCeilo
   sudo ln -s repos/git/AossCeilo/scripts .
   sudo git clone "https://gitlab.ssec.wisc.edu/metobs/MetObsCommon.git" repos/git/MetObsCommon

3. Install the aossceilo python package:

   sudo ${PWD}/bin/pip install -e repos/git/MetObsCommon/
   sudo ${PWD}/bin/pip install -e repos/git/AossCeilo/

4. Install checkmk scripts:

   ln -s /opt/metobs/aoss_ceilo/repos/git/AossCeilo/checkmk/check_aoss_ceilo_archive.sh /usr/lib/check_mk_agent/local/1800/