开源ceph管理平台inkscope部署手册

一.前情提要

关于inkscope就不做过多介绍了，就是ceph的一个开源管理控制平台，跟ceph官方的calamary以及intel的VSM差不多一类，只是各自侧重点不一样。

相对而言，因为inkscope使用的是ceph自带的restapi，因此是比较轻量级的，ceph集群相关的信息直接从API调，系统层面的信息抓取是通过本地一个代理程序抓取，然后写入inkscope所在节点的mongodb里。

1.1 官方地址

github-inkscope

inkscope角色介绍

inkscope主要的角色有三种： 1. web管理控制台：这个角色需要安装flask和mongodb以提供接口，方便前端界面angular-js调用 2. cephprobe：这个一般是安装在mon节点，整个集群安装一个即可，主要是获取ceph的一些信息将其写入mongodb中；使用5000端口提供服务 3. sysprobe：这个主要是获取集群所有节点的硬件监控信息，如CPU、内存、硬盘灯，集群内所有节点都需要安装。 4. radosgw： 是ceph对外提供对象存储服务的服务，本例中用于对象存储相关的管理，会使用80端口提供http服务；

1.2 inkscope-packaging

最新的版本中，已经提供了ubuntu下的deb安装包，项目地址，deb包及作用介绍如下：

inkscope-common : 包含inkscope的默认配置文件以及其他进程(cephprobe,sysprobe)启动所需的依赖文件，所有相关节点都需要安装

inkscope-admviz : 包含inkscope的web控制台文件，含接口和界面，仅需要安装一个，该节点上同时需要按章flask和mongodb

inkscope-cephrestapi: 用于安装启动 ceph rest api 的脚本，仅需要安装在提供api接口的节点上

inkscope-cephprobe: 用于安装启动 cephprobe 的脚本(整个集群只需要一个)

inkscope-sysprobe : 安装用于所有mon和osd的sysprobe 所需要脚本

二.测试环境

本次测试ceph集群共有三个节点：ceph1(10.1.35.85),ceph2(10.1.35.86),ceph3(10.1.35.87)；

三个节点都是mon节点，也都是osd节点，每个节点3个osd。

根据前面的角色以及安装包的介绍，三个节点的分配及所需安装包如下（inkscope-common包所有节点都需要因此省略）：

角色	分配节点	需要安装的inkscope的包
web管理控制台	ceph3	inkscope-admviz
sysprobe	ceph1,ceph2,ceph3	inkscope-sysprobe
cephprobe	ceph2	inkscope-cephprobe,inkscope-cephrestapi
radosgw	ceph1	无需inkscope的包

三.安装

3.1 安装web管理控制台

3.1.1 按章软件包和依赖
该节点使用php以及wsgi实现界面，本地接收其他节点传过来的数据存入本地mongodb，同时会调用rados命令,

又使用flask框架构建接口，因此需要使用下面的命令安装依赖

apt-get install python-pip apache2 libapache2-mod-wsgi mongodb python-ceph
pip install flask requests simplejson -i http://pypi.mirrors.ustc.edu.cn/simple   #使用国内pip源安装
dpkg -i inkscope-admviz_1.2.0-0.deb  inkscope-common_1.2.0-0.deb inkscope-sysprobe_1.2.0-0.deb

3.1.2 配置apache2服务
安装完nkscope-admviz后默认虚拟主机配置文件位于/etc/httpd/conf.d/inkScope.conf，将其拷贝到/etc/apache2/sites-available 中。 修改32行为下面这句， 注释掉 33行

ProxyPass /ceph-rest-api/ http://10.1.35.86:5000/api/v0.1/ #ProxyPass /shell http://$IP:4200/

这里将 rest-api_srv 修改为ceph2的IP，规划中，ceph2的角色是cephprobe。

同时将25和35行的ErrorLog和CustomLog的值里面的httpd修改为apache2，因为apache2的工作路径已经换了

修改 /etc/apache2/ports.conf 文件，增加下面

Listen 8080
NameVirtualHost *:8080

完整inkScope.conf文件如下：

root@ceph3:/etc/apache2/sites-available# cat inkScope.conf
<VirtualHost *:8080>
ServerName  localhost
ServerAdmin webmaster@localhost

DocumentRoot /var/www/inkscope
<Directory "/var/www/inkscope">
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 /var/www/inkscope/inkscopeCtrl/inkscopeCtrl.wsgi
<Directory "/var/www/inkscope/inkScopeCtrl">
Order allow,deny
Allow from all
</Directory>

ErrorLog /var/log/apache2/error_inkscope.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/ http://10.1.35.86:5000/api/v0.1/ #ProxyPass /shell http://$IP:4200/
CustomLog /var/log/apache2/access.log combined
</VirtualHost>

运行下面的命令，启用apache2的proxy模块和inkScope.conf虚拟主机

sudo a2enmod proxy_http
sudo a2ensite inkScope.conf
sudo service apache2 restart

现在打开浏览器访问 10.1.35.87:8080/ 应该就可以看到首页，只是暂时没有ceph集群的相关数据而已。

3.1.3 开启mongodb远程连接
修改 /etc/mongodb.conf ，将bind_ip 修改为 0.0.0.0，取消 port = 27017 依据前面的注释，如下：

bind_ip = 0.0.0.0
port = 27017

3.2 安装cephprobe

在cephprobe节点主要是提供ceph-rest-api并抓取ceph的信息存入mongodb中。 所需软件包及依赖安装如下：

apt-get install python-dev
pip install pymongo psutil -i http://pypi.mirrors.ustc.edu.cn/simple dpkg -i inkscope-common_1.2.0-0.deb inkscope-sysprobe_1.2.0-0.deb inkscope-cephrestapi_1.2.0-0.deb inkscope-cephprobe_1.2.0-0.deb

启动ceph-rest-api服务： /etc/init.d/ceph-rest-api start

3.3 radosgw服务配置

在ceph1提供radosgw服务，具体radosgw的安装在这里不做详述，请参见ceph官方文档或者内部手册。 这里需要新建一个管理用户，并赋予相关权限，以便在界面上直接操作radosgw。

radosgw-admin user create --uid=inkscope --display-name="Inkscope admin" \
--access-key=accesskey --secret=secretkey \
--caps="users=*;metadata=*;buckets=*"

这里sccess和secret的具体的值可以根据喜好自行修改。

3.4安装sysprobe

在其他没有承担特殊任务的节点上安装sysprobe

apt-get install python-dev
pip install pymongo psutil -i http://pypi.mirrors.ustc.edu.cn/simple dpkg -i inkscope-common_1.2.0-0.deb inkscope-sysprobe_1.2.0-0.deb

3.5修改inkscope配置文件并启动服务

inkscope的配置文件就一个，位于 /opt/inkscope/etc/inkscope.conf ，

这里面需要修改的主要有： 1. ceph_rest_api：在本例中即为ceph2的ip 2. mongodb_host：即为ceph3所在节点，管理节点 3. radosgw_url：即为ceph1所在节点 4. radosgw_key和radosgw_secret：在ceph1上新建管理用户时指定的两个key

最终版如下：

{
"ceph_conf": "/etc/ceph/ceph.conf",
"ceph_rest_api": "10.1.35.86:5000",
"mongodb_host" : "10.1.35.87",
"ceph_rest_api_subfolder": "",
"mongodb_set" : "mongodb0:27017,mongodb1:27017,mongodb2:27017",
"mongodb_replicaSet" : "replmongo0",
"mongodb_read_preference" : "ReadPreference.SECONDARY_PREFERRED",
"mongodb_port" : 27017,
"mongodb_user":"ceph",
"mongodb_passwd":"monpassword",
"is_mongo_authenticate" : 0,
"is_mongo_replicat" : 0,
"cluster": "ceph",
"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,
"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,
"radosgw_url": "http://10.1.35.85:80",
"radosgw_admin": "admin",
"radosgw_key": "ainkscope",
"radosgw_secret": "sinkscope"
}

将该文件拷贝到所有节点的/opt/inkscope/etc/ 目录中，然后重启对应服务：

/etc/init.d/sysprobe start
/etc/init.d/cephprobe start
/etc/init.d/ceph-rest-api start

对应节点上启动对用服务。

四.安装web console

如果你是ubuntu14.04，直接安装：

sudo apt-get install shellinabox

如果不是，点击这里下载deb包安装。

或者点击这里下载其他对应发行版的包。

修改配置文件， /etc/default/shellinabox :

SHELLINABOX_ARGS="--no-beep -t"

不适用SSL协议，然后重启服务

service shellinabox restart

修改apache2虚拟主机配置文件，添加代理 /etc/apache2/site-available/inkScope.conf

在 ProxyPass /ceph-rest-api/ ... 这一行后添加下面的：

ProxyPass /shell http://<hostname>:4200/

这里的 hostname 就是安装shellinabox的主机地址

重启apache2

service apache2 restart

注意：貌似需要谷歌浏览器，否则输入没反应。