Skip to content

Inkscope installation (V0.3)

Alain Dechorgnat edited this page Jan 30, 2015 · 1 revision

prequisites

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

Installation

Installation of inkscopeViz

Apache V2 is already installed

  1. Choose a tcp port for inkScope

    in the following stages, we have chosen 8080

  2. Modify Apache conf file /etc/apache2/port.conf to add the following line

     Listen 8080
    
  3. 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

  4. Enable proxy module in Apache (if not already enabled)

     sudo a2enmod proxy_http
     sudo service apache2 restart
    
  5. Enable InkScope virtual host:

     sudo a2ensite inkScope
    

    No need to restart Apache at this time

Installation of inkscopeCtrl

  1. install mod-wgsi for Apache

     sudo apt-get install libapache2-mod-wsgi
    
  2. install python dependencies : pymongo, python-requests, and flask 0.10.1

    if pip is not installed,

     sudo apt-get install python-pip
    

    for pymongo:

     sudo easy_install pymongo or sudo pip install pymongo
    

    for flask:

     sudo easy_install flask or sudo pip install flask
    

    If 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.

  3. 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).

Installation of InkscopeProbe

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

Prerequisites

  • 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

Installation

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 configuration

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

CephProbe configuration

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

Clone this wiki locally