= Installing Operation Monitoring on GRAM =

Most of the dependencies and code for monitoring have been installed on existing racks.   However, some configuration may still need to be done by hand.

== Configuring opsmon_config.json ==
Configure /home/gram/gram/opsmon/opsmon_config.json

Replace the three fields in this section with the correct information.
{{{

        "base_address" : "https://128.89.118.100",
        "aggregate_id" : "gram-bbncam",
        "aggregate_urn" : "urn:publicid:IDN+bbn-cam-ctrl-1.bbn.com+authority+am"

}}}

Edit Hosts Information:  You must find the '''control''' ethernet interface, i.e. the interface with 10.10.8 prefix and find the IP address and also find the '''data''' ethernet, i.e the interface with 10.10.5 prefix and its corresponding MAC address.   The correct urn for the compute nodes must also be replaced with the correct ones for your installation.
{{{

 "hosts" : [
                {"id" : "bbn-cam-cmpe-1", "address" : "10.10.8.101",
                "urn" : "urn:publicid:IDN+bbn-cam-ctrl-1.bbn.com+node+bbn-cam-cmpe-1",
                "interfaces" : {"eth3" : {"address" : "10.10.8.101",
                                 "type" : "IPv4", "role" : "CONTROL", "max_bps" : "1000000000"},
                                "eth2" : {"address" : "a0:36:9f:11:0d:60",
                                 "type" : "MAC", "role" : "DATA", "max_bps" : "1000000000"}}},
                {"id" : "bbn-cam-cmpe-2", "address" : "10.10.8.102",
                "urn" : "urn:publicid:IDN+bbn-cam-ctrl-1.bbn.com+node+bbn-cam-cmpe-2",
                "interfaces" : {"eth3" : {"address" : "10.10.8.102",
                                 "type" : "IPv4", "role" : "CONTROL", "max_bps" : "1000000000"},
                                "eth2" : {"address" : "a0:36:9f:20:74:cc",
                                 "type" : "MAC", "role" : "DATA", "max_bps" : "1000000000"}}}
        ],
}}}

== Configuring mysql for monitoring ==
Run the following sequence of commands:
 1. cd /home/gram/ops-monitoring/local/unit-tests
 1. python ./local_table_reset.py


== Configuring Apache ==

   1. Fetch the GENI clearinghouse CA root certificate here:
      -http://groups.geni.net/geni/raw-attachment/wiki/GeniTrustAnchors/ch.geni.net-ca.pem and copy it to /etc/ssl/certs.

   2. In /etc/apache2/sites-available/default-ssl, make sure the following SSL settings are in place.  Some of these are commented out by default, so be sure to remove the initial "#".
{{{
        SSLEngine on
        SSLCACertificateFile /etc/ssl/certs/ch.geni.net-ca.pem
        SSLVerifyClient require
        SSLVerifyDepth  3
        SSLOptions +ExportCertData
}}}

    3. Add text to an appropriate !VirtualHost directive in your apache configuration.  Put this inside the <!VirtualHost _default_:443> block of /etc/apache2/sites-available/default-ssl, right below the SSL settings and above the ending </!VirtualHost>. 
{{{
        WSGIDaemonProcess localstore threads=5
        WSGIScriptAlias / /home/gram/ops-monitoring/local/wsgi/localstore.wsgi

        <Directory /home/gram/ops-monitoring/local/wsgi>
            WSGIProcessGroup localstore
            WSGIApplicationGroup %{GLOBAL}
            Order deny,allow
            Allow from all
        </Directory>
}}}

    4. In order to see WSGI errors if any occur, modify that same !VirtualHost block and set:
{{{
  LogLevel info
}}}

    5. Make sure you haven't introduced any syntax errors in default-ssl:  Type ''sudo apache2ctl configtest''

    6. Start or restart Apache:  Type ''sudo service apache2 [start|restart]''

    7.  Use the certificate attached [attachment:collector-gpo-withnpkey.pem collector-gpo-withnpkey.pem] to this page to verify that you can connect to Apache:
    Type ''curl -k --cert path-to/your-tool-cert.pem !https://your-apache-host/info/opsconfig/geni-prod''

    Output should look like:
{{{
curl -k --cert ./collector-gpo-withnpkey.pem https://128.89.118.100/info/opsconfig/geni-prod
{"info": [{"db_schema": [["$schema", "varchar"], ["id", "varchar"], ["selfRef", "varchar"], 
["urn", "varchar"], ["ts", "int8"], ["measRef", "varchar"]], "name": "aggregate"}, 
{"db_schema": [["$schema", "varchar"], ["id", "varchar"], ["selfRef", "varchar"], ["urn", "varchar"], ["ts", "int8"], ["properties$mem_total_kb", "int8"]], "name": "node"}, 
{"db_schema": [["$schema", "varchar"], ["id", "varchar"], ["selfRef", "varchar"], ["urn", "varchar"], ["ts", "int8"]], "name": "link"}, 
{"db_schema": [["$schema", "varchar"], ["id", "varchar"], ...
}}}