OED Documentation

MAMAC

Version V1.0.0

These features are only available to select people who oversee the OED site (called admins) so this information is not usually of interest to a general user.

Overview

This page describes how to add MAMAC meters to OED so they will be read regularly.

Usage

Either by admin meters creation web page or via a CSV meter upload, add a new meter that has the following attributes:

  1. One needs the IP address of the desired MAMAC meter that is the location address where the meter can be reached. One should be able to go to this address in a web browser and see the landing page for the meter. For this example the IP address of 111.22.33.1 will be used. Use http://111.22.33.1/sm101.xml as the meter URL.
  2. Set the meter Type to "MAMAC" (without quotes).
  3. Set the Reading Frequency to 01:00:00 for one hour.
  4. Set update to yes if you want OED to regularly get this meter data.
  5. Set Displayable, Unit and Default Graphic Unit to the needed/desired values.
  6. The other meter values are standard ones that you want for this meter and can be left as the default values if desired.

Set up the hourly cron job to update MAMAC meters' data on OED if update is yes and you want MAMAC meters to update. This only needs to be done once on the server, generally by an IT person. This mirrors similar steps in the site installation directions.

  1. cp src/scripts/updateMamacMetersOEDCron.bash /etc/cron.hourly/updateMamacMetersOEDCron.bash
  2. Edit /etc/cron.hourly/updateMamacMetersOEDCron.bash to make the necessary modifications to the script. See the script for more detail.
  3. Do: chmod +x /etc/cron.hourly/updateMamacMetersOEDCron.bash to make the script executable.
  4. If you want to immediately run the update on meters without waiting for the hourly script one does: docker compose exec web npm run updateMamacMeters
  5. Note that you will not be able to graph the newly acquired meter data until the daily aggregation (described on the installation page linked above) is run or you manually refresh the readings by doing: docker compose exec web npm run refreshAllReadingViews

Details

Note that OED no longer has access to MAMAC meters so the code should work but report any issues.