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!
Inkscope lite is a visualization only version of Inkscope.