Added simplified ConfFile entry using myops_setup_sh
[myops.git] / README
diff --git a/README b/README
index e69de29..3403a81 100644 (file)
--- a/README
+++ b/README
@@ -0,0 +1,46 @@
+
+Install the RPM 
+
+# make rpm
+# yum install -y --nogpgcheck myops-getqueryview-1.0-0.i686.rpm
+
+Run a post install setup script that configures many of the scripts to run
+within the local environment.
+
+# cd /usr/share/myops/web/
+# bash ./setup.sh
+
+Create the client collection bootstrap files in /var/www/html/PlanetLabConf
+
+# cd /usr/share/myops/web/collect/server
+# ./build.sh
+
+If you wish to populate this service with data from a test PLC, then first
+copy the scripts and ConfFile settings to that test PLC.
+
+# cd /var/www/html/PlanetLabConf/
+# scp sar2graphite.py sysstat.cron bootstrap.tar myplc.example.eu:/var/www/html/PlanetLabConf
+# scp /usr/share/myops/web/db-config.d/030-conf_files_myops myplc.example.eu:/etc/planetlab/db-config.d
+
+To import the ConfFile() settings in 030-conf_files_myops
+# ssh myplc.example.edu 
+# service plc restart db
+
+Once the service is running, you can visit:
+
+    http://yourhost.planet-lab.eu/view
+
+After a few minutes, the LoadAvg graph should start to show local load on the
+server.  After a few hours, the MyOps graphs should begin to have data.
+
+To create new graphs from the data available, you can use the graphite
+composer:
+
+    http://yourhost.planet-lab.eu/graphite
+
+And, then copy the image url to /var/www/html/view/urllist.txt to have it
+displayed as part of the default /view/index.php 
+
+As well, to query some of the raw data you can look here:
+
+    http://yourhost.planet-lab.eu:5984/myops/_design/myops/index.html