Changes between Version 11 and Version 12 of PlasticSlices/MonitoringRecommendations/PlnodeConfiguration


Ignore:
Timestamp:
05/04/12 20:24:13 (12 years ago)
Author:
chaos@bbn.com
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • PlasticSlices/MonitoringRecommendations/PlnodeConfiguration

    v11 v12  
    77This page explains how to configure a MyPLC !PlanetLab node for the [wiki:PlasticSlices/MonitoringRecommendations Plastic Slices central monitoring configuration].  This page was written for
    88{{{
    9 plastic-slices-monitor-plnode-0.5
     9tango-monitor-plnode-0.6-1
    1010}}}
    1111which is the latest version of the monitoring utilities for a MyPLC !PlanetLab node running Fedora 8 or Fedora 12.
    1212
    13 == Upgrading from version 0.4 ==
     13== Upgrading from version 0.4 or later ==
    1414
    1515If you are currently running `plastic-slices-monitor-plnode-0.4`, 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]
     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-plnode` for the first time or upgrading from an earlier version, read all sections to see which steps you need to take.
     20If you are installing `tango-monitor-plnode` for the first time or upgrading from an earlier version, read all sections to see which steps you need to take.
    2021
    2122== Variables ==
    … …  
    4445=== II. Install the monitoring software ===
    4546
    46  1. Download the `plastic-slices-monitor-plnode-0.5.tar.gz` tarball from [http://software.geni.net/local-sw/], and copy it onto your node, e.g. into `~/plastic-slices-monitor-plnode-0.5.tar.gz`.
     47 1. Download `tango-monitor-plnode-0.6-1.noarch.rpm` from [http://software.geni.net/local-sw/], and copy it onto your node, e.g. into `~/tango-monitor-plnode-0.6-1.noarch.rpm`.
    4748
    48  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 node, e.g. into `~/measurement_sender.pl`
     49 2. Use yum localinstall to install the RPM and any necessary dependencies:
     50{{{
     51sudo yum localinstall ~/tango-monitor-plnode-0.6-1.noarch.rpm
     52}}}
     53   * IF this doesn't work for you because you do not have a working yum on your plnode and can't resolve package dependencies, see [wiki:GpoLab/MyplcPackageInstallationTips#Debuggingmonitoringdependencies] for some other suggestions which might work.
    4954
    50  3. Unpack the tarball in `~`, and copy the files into place:
    51 {{{
    52 cd ~
    53 tar xvzf ~/plastic-slices-monitor-plnode-0.5.tar.gz
    54 cd plastic-slices-monitor-plnode-0.5
    55 sudo mkdir -p /usr/local/{bin,lib}
    56 sudo cp bin/{build_gmoc_conf,metric_plnode,report_data_to_gmoc} /usr/local/bin
    57 sudo cp lib/{metricscollector.py,rrd_metric.py} /usr/local/lib
    58 sudo chmod 555 /usr/local/bin/{build_gmoc_conf,metric_plnode,report_data_to_gmoc}
    59 sudo chmod 444 /usr/local/lib/{metricscollector.py,rrd_metric.py}
    60 }}}
    61 
    62  4. Copy `measurement_sender` into place:
    63 {{{
    64 sudo cp ~/measurement_sender.pl /usr/local/bin/measurement_sender
    65 sudo chmod 555 /usr/local/bin/measurement_sender
    66 }}}
    67 
    68 === III. Install software dependencies ===
    69 
    70 When installing or upgrading, make sure you have all current software dependencies installed on the system:
    71 
    72  * IF your nodes can run yum, simply install the dependencies:
    73 {{{
    74 sudo yum install rrdtool-python rrdtool-perl perl-File-Find-Rule perl-XML-Writer perl-libwww-perl perl-Crypt-SSLeay
    75 }}}
    76 
    77  * IF this doesn't work for you, see [wiki:GpoLab/MyplcPackageInstallationTips#Debuggingmonitoringdependencies] for some other suggestions which might work.
    78 
    79 === IV. Create required directories and files ===
     55=== III. Create required directories and files ===
    8056
    8157These steps only need to be done the first time you install the monitoring software.
    … …  
    9369}}}
    9470
    95 === V. Test the script ===
     71=== IV. Test the script ===
    9672
    9773Run the monitoring and submission scripts by hand to make sure they work.
    … …  
    10177 2. Run the metric-gathering script by hand to make sure it works:
    10278{{{
    103 sudo /usr/local/bin/metric_plnode
     79sudo /usr/bin/metric_plnode
    10480}}}
    10581   * This should produce no output
    … …  
    10985 3. Run the data reporting script by hand to make sure it works:
    11086{{{
    111 sudo /usr/local/bin/report_data_to_gmoc <site> <fqdn>
     87sudo /usr/bin/report_data_to_gmoc <site> <fqdn>
    11288}}}
    11389   * This should produce no output
    … …  
    124100and add the new lines:
    125101{{{
    126 */1 * * * * /usr/local/bin/metric_plnode
    127 */5 * * * * /usr/local/bin/report_data_to_gmoc <site> <fqdn>
     102*/1 * * * * /usr/bin/metric_plnode
     103*/5 * * * * /usr/bin/report_data_to_gmoc <site> <fqdn>
    128104}}}
    129105