Wednesday, March 4, 2015

Inkscope installation on debian servers

Typical installation of Inkscope

Inkscope  and its mongoDB database should be installed on an independent server from ceph.
Inkscope provides probes to fetch metrics from the ceph cluster and its machines:
  • Sysprobe is used to fetch system informations on each machine of the cluster.
  • Cephprobe fetches information on the cluster itself. It is intended to be installed on a machine accessing the ceph-rest-api.
Before installing Inkscope, you'll need to install a mongoDB database.

Add the Inkscope debian repository in your source list

Create /etc/apt/sources.list.d/inkscope.list and add line:
deb https://raw.githubusercontent.com/inkscope/inkscope-packaging/master/DEBS ./ 
Then
apt-get update 

Packages for Inkscope are:
  • inkscope-common : install the configuration file for probes and web interface.
    inkscope-sysprobe : installs sysprobe
  • inkscope-cephrestapi: installs all script to start a ceph-rest-api 
  • inkscope-cephprobe: installs the cephprobe
  • inkscope-admviz : installs inskcope web interface 

Install Inkscope server on one server :

sudo apt-get install inkscope-admviz 

Then you'll have to provide a running ceph-rest-api. "Inkscope and ceph-rest-api" describes how to provide access to the ceph-rest-api as an Apache WSGI application or a standalone server.

Edit /opt/inkscope/etc/inkscope.conf  for mongoDB, ceph-rest-api and radosgw parameters.

The configuration file is the same for every module and can be deployed on every machine.

Edit /etc/apache2/sites-available/inkScope.conf to fill parameters concerning ceph-rest-api
Edit /etc/apache2/ports.conf to add
Listen 8080 

Enable apache proxy or rewrite module according to your choice of access to ceph-rest-api (see "Inkscope and ceph-rest-api")
sudo a2enmod proxy_http  (for standalone server)
sudo a2enmod rewrite (for WSGI application)

Enable inkscope
sudo a2ensite inkscope 

Restart apache
sudo service apache2 restart 

 Now you can access inkscope in your browser
http://<inkscope-server>:8080/
At this stage, Inkscope is not fully operationnal and needs the mongoDB database to be feed. For this, you'll have to install Inkscope probes.

Install sysprobe on each server:

sudo apt-get install inkscope-sysprobe 

Edit /opt/inkscope/etc/inkscope.conf  for mongoDB, ceph-rest-api and radosgw parameters or retrieve the one modified on the previous step.

Start sysprobe:
/etc/init.d/sysprobe start

Install cephprobe on one server:


sudo apt-get install inkscope-cephprobe 
Edit /opt/inkscope/etc/inkscope.conf  for mongoDB, ceph-rest-api and radosgw parameters or retrieve the one modified on the previous step.

Start cephprobe:
/etc/init.d/cephprobe start

If your cluster is healthy, you'll have a first page like this:


Et voila!

Tuesday, March 3, 2015

Packages are now available for inkscope

inspired by Crystal Project Icons

We are proud to announce the availability of installation packages for Inkscope.

You'll find RPM or DEB files on the project repository on Github.

An article describes how to install Inkscope on Debian servers.