Repository navigation
Inkscope installation (V0.3)
Inkscope needs severals other products:
Download all the directories of the inkScope project to a folder of your choice
in the following stages, we have chosen /var/www/inkscope
Apache V2 is already installed
-
Choose a tcp port for inkScope
in the following stages, we have chosen 8080
-
Modify Apache conf file /etc/apache2/port.conf to add the following line
Listen 8080 -
Create a virtual host named inkScope
in the folder /etc/apache2/sites-available , create a file inkScope.conf with this content:
<VirtualHost *:8080> ServerName localhost ServerAdmin webmaster@localhost DocumentRoot {inkScope_folder} <Directory "{inkScope_folder}"> Options All AllowOverride All </Directory> ScriptAlias /cgi-bin/ /usr/lib/cgi-bin/ <Directory "/usr/lib/cgi-bin"> AllowOverride None Options +ExecCGI -MultiViews +SymLinksIfOwnerMatch Order allow,deny Allow from all </Directory> WSGIScriptAlias /inkscopeCtrl {inkScope_folder}/inkscopeCtrl/inkscopeCtrl.wsgi <Directory "{inkScope_folder}/inkScopeCtrl"> Order allow,deny Allow from all </Directory> ErrorLog ${APACHE_LOG_DIR}/error.log # Possible values include: debug, info, notice, warn, error, crit, # alert, emerg. LogLevel warn ProxyRequests Off # we don't want a "forward proxy", but only a "Reverse proxy" ProxyPass /ceph-rest-api/ {ceph_rest_api_url} CustomLog ${APACHE_LOG_DIR}/access.log combined </VirtualHost>Be sure to modify {inkScope_folder} and {ceph_rest_api_url} with the appropriate values
-
Enable proxy module in Apache (if not already enabled)
sudo a2enmod proxy_http sudo service apache2 restart -
Enable InkScope virtual host:
sudo a2ensite inkScopeNo need to restart Apache at this time
-
install mod-wgsi for Apache
sudo apt-get install libapache2-mod-wsgi -
install python dependencies : pymongo, python-requests, and flask 0.10.1
if pip is not installed,
sudo apt-get install python-pipfor pymongo:
sudo easy_install pymongo or sudo pip install pymongofor flask:
sudo easy_install flask or sudo pip install flaskIf you are running Ubuntu 12.04 or an earlier version, you need to get your python-requests module updated to a version >= 1.1.0.
-
run install.sh in inkscopeCtrl directory to copy conf files in /opt/inkscope/etc
modify /opt/inkscope/etc/inkscopeCtrl.conf to change:
- mongoDB parameters (mainly mongodb_host)
- radosgw parameters ( Do not forget to grant the required capabilities [usage, users, metadata, buckets] to the admin-user).
InkscopeProbe collects Ceph cluster metrics and host metrics and put them in a database named as the cluster and put the data in dedicated mongodb collection. The datamodel is described in datamodel.txt and datamodeloverview.odp
-
needs a mongodb database
-
needs a ceph-rest-api active on a machine
-
needs package python-dev (on every host)
sudo apt-get install python-dev
-
needs psutil python module (on every host)
sudo easy_install psutil
-
needs pymongo python module (on every host)
sudo easy_install pymongo
run install.sh in inkscopeProbe directory to copy conf files in /opt/inkscope/etc and scripts in/opt/inkscope/bin
You could make a link in /etc/init.d
Two daemons are defined:
- sysprobe to collect system information; it must be installed on each machine running Ceph nodes (mon, mds, osd...)
- cephprobe to collect ceph cluster information; it must be installed on only one machine running a Ceph node
Sysprobe collect and push the informations into a mongodb. The config file should be stored at /opt/inkscope/etc/sysprobe.conf and should look like this (json format). The unit of the refresh times is second.
You must adapt the values to your environment (mainly mongodb_host).
{
"mongodb_host" : "10.10.10.10",
"is_mongo_replicat" : 0,
"mongodb_set" : "mongodb0:27017,mongodb1:27017,mongodb2:27017",
"mongodb_replicaSet" : "replmongo0",
"mongodb_read_preference" : "ReadPreference.SECONDARY_PREFERRED",
"mongodb_port" : 27017,
"is_mongo_authenticate" : 0,
"mongodb_user":"ceph",
"mongodb_passwd":"monpassword",
"cluster": "ceph",
"mem_refresh": 60,
"swap_refresh": 600,
"disk_refresh": 60,
"partition_refresh": 60,
"cpu_refresh": 30,
"net_refresh": 30,
"mem_window": 1200,
"swap_window": 3600,
"disk_window": 1200,
"partition_window": 1200,
"cpu_window": 1200,
"net_window": 1200
}
Sysprobe is defined as a daemon:
sysprobe.py start|stop|restart
A Ceph info collector (cephprobe.py) should be run on a node thant can access to ceph-rest-api and the mongodb.
The config file be stored at /opt/inkscope/etc/cephprobe.conf and should look like this (json format). The unit of the refresh times is second.
You must adapt the values to your environment (mainly mongodb_host and ceph_rest_api).
{
"mongodb_host" : "10.10.10.10",
"is_mongo_replicat" : 0,
"mongodb_set" : "mongodb0:27017,mongodb1:27017,mongodb2:27017",
"mongodb_replicaSet" : "replmongo0",
"mongodb_read_preference" : "ReadPreference.SECONDARY_PREFERRED",
"mongodb_port" : 27017,
"is_mongo_authenticate" : 0,
"mongodb_user":"ceph",
"mongodb_passwd":"monpasswd",
"cluster" : "ceph",
"ceph_conf": "/etc/ceph/ceph.conf",
"ceph_rest_api": "10.10.10.11:5000",
"status_refresh": 3,
"osd_dump_refresh": 3,
"pg_dump_refresh": 60,
"crushmap_refresh": 60,
"df_refresh": 60,
"cluster_window": 1200,
"osd_window": 1200,
"pool_window": 1200
}
Cephprobe is defined as a daemon:
cephprobe.py start|stop|restart