Changes between Version 12 and Version 13 of PlasticSlices/MonitoringRecommendations/MyplcConfiguration


Ignore:
Timestamp:
05/04/12 20:17:10 (8 years ago)
Author:
chaos@bbn.com
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • PlasticSlices/MonitoringRecommendations/MyplcConfiguration

    v12 v13  
    77This page explains how to configure a MyPLC server for the [wiki:PlasticSlices/MonitoringRecommendations Plastic Slices central monitoring configuration].  This page was written for
    88{{{
    9 plastic-slices-monitor-myplc-0.4
     9tango-monitor-myplc-0.5-1
    1010}}}
    1111which is the latest version of the monitoring utilities for a MyPLC server running Fedora 8 or Fedora 12.  It may not work well with older versions.
     
    1313== Upgrading from version 0.3 ==
    1414
    15 If you are currently running `plastic-slices-monitor-myplc-0.3`, you need only do the following steps of this upgrade:
    16  * [#II.Installthemonitoringsoftware II. Install the monitoring software itself and the latest version of GMOC measurement_sender]
    17  * [#V.Testthescript V. Test the new script and make sure it still works]
     15If you are currently running `plastic-slices-monitor-myplc-0.3` or later, you need to do the following steps of this upgrade:
     16 * [#II.Installthemonitoringsoftware II. Install the monitoring software itself]
     17 * [#IV.Testthescript IV. Test the new script and make sure it still works]
     18 * [#V.Installthescriptstorunfromcron V. Install the scripts to run from cron]: the script paths have changed, so you will need to update your crontab.
    1819
    19 If you are installing `plastic-slices-monitor-myplc` for the first time or upgrading from an earlier version, read all sections to see which steps you need to take.
    20 
     20If you are installing `tango-monitor-myplc` for the first time or upgrading from an earlier version, read all sections to see which steps you need to take.
    2121
    2222== Variables ==
     
    4747Do all of these steps every time you install or upgrade the monitoring software.
    4848
    49  1. Download the `plastic-slices-monitor-myplc-0.4.tar.gz` tarball from [http://software.geni.net/local-sw/], and copy it onto your MyPLC host, e.g. into `~/plastic-slices-monitor-myplc-0.4.tar.gz`.
     49 1. Download the `tango-monitor-myplc-0.5-1.noarch.rpm` file from [http://software.geni.net/local-sw/], and copy it onto your MyPLC host, e.g. into `~/tango-monitor-myplc-0.5-1.noarch.rpm`.
    5050
    51  2. Download the GMOC `measurement_sender.pl` script from [http://gmoc-db.grnoc.iu.edu/sources/measurement_api/measurement_sender.pl], and copy it onto your MyPLC host, e.g. into `~/measurement_sender.pl`
    52 
    53  3. Unpack the tarball in `~`, and copy the files into place:
     51 2. Use yum localinstall to install the RPM and any necessary dependencies:
    5452{{{
    55 cd ~
    56 tar xvzf ~/plastic-slices-monitor-myplc-0.4.tar.gz
    57 cd plastic-slices-monitor-myplc-0.4
    58 sudo mkdir -p /usr/local/{bin,lib}
    59 sudo cp bin/{build_gmoc_conf,metric_plc,report_data_to_gmoc} /usr/local/bin
    60 sudo cp lib/rrd_metric.py /usr/local/lib
    61 sudo chmod 555 /usr/local/bin/{build_gmoc_conf,metric_plc,report_data_to_gmoc}
    62 sudo chmod 444 /usr/local/lib/rrd_metric.py
     53sudo yum localinstall ~/tango-monitor-myplc-0.5-1.noarch.rpm
    6354}}}
    6455
    65  4. Copy `measurement_sender` into place:
    66 {{{
    67 sudo cp ~/measurement_sender.pl /usr/local/bin/measurement_sender
    68 sudo chmod 555 /usr/local/bin/measurement_sender
    69 }}}
    70 
    71 === III. Install software dependencies ===
    72 
    73 When installing or upgrading, make sure you have all current software dependencies installed on the system:
    74 {{{
    75 sudo yum install rrdtool-python rrdtool-perl perl-File-Find-Rule perl-XML-Writer perl-libwww-perl perl-Crypt-SSLeay
    76 }}}
    77 The monitoring scripts use these packages to:
    78  * Manage RRD files
    79  * Write the XML-based API format for the GMOC database
    80  * Send the formatted data to GMOC via HTTPS
    81 
    82 === IV. Create required directories and files ===
     56=== III. Create required directories and files ===
    8357
    8458These steps only need to be done the first time you install the monitoring software.
     
    9771}}}
    9872
    99 === V. Test the script ===
     73=== IV. Test the script ===
    10074
    10175Run the monitoring and submission scripts by hand to make sure they work.
     
    10579 2. Run the metric-gathering script by hand to make sure it works:
    10680{{{
    107 sudo -u <cronuser> /usr/local/bin/metric_plc
     81sudo -u <cronuser> /usr/bin/metric_plc
    10882}}}
    10983   * This should produce no output
     
    11286 3. Run the data reporting script by hand to make sure it works:
    11387{{{
    114 sudo -u <cronuser> /usr/local/bin/report_data_to_gmoc <site> <fqdn>
     88sudo -u <cronuser> /usr/bin/report_data_to_gmoc <site> <fqdn>
    11589}}}
    11690   * This should produce no output
    11791   * You should be able to browse to [http://gmoc-dev.grnoc.iu.edu/api-demo/data/], view data by Location, select your site, and find an entry for `<fqdn>`.
    11892
    119 === VI. Install the scripts to run from cron ===
     93=== V. Install the scripts to run from cron ===
    12094
    12195This only needs to be done the first time you install the monitoring software.
     
    127101 and add the new lines:
    128102{{{
    129 */1 * * * * /usr/local/bin/metric_plc
    130 */5 * * * * /usr/local/bin/report_data_to_gmoc <site> <fqdn>
     103*/1 * * * * /usr/bin/metric_plc
     104*/5 * * * * /usr/bin/report_data_to_gmoc <site> <fqdn>
    131105}}}
    132106