open-falcon(v0.2)部署手册

---注：本文中出现的账号，IP信息均为个人搭建的虚拟机IP，非生产IP。

一、部署资源

二、环境搭建准备工作

1.安装系统centOs6.8

详细步骤参见：http://oldboy.blog.51cto.com/2561410/1564620

2.创建用户以及组并授权

groupaddopen –--创建组

useradd-g open open -b /open-falcon -s /bin/bash –--创建用户

usermod-G open open ---修改用户归属组

chown-R open /open-falcon ---修改目录归属用户

chgrp–R open /open-falcon---修改目录归属组

3.配置系统yum源为网络源

详细步骤见链接：http://mirrors.163.com/.help/centos.html

或者http://www.cnblogs.com/zoulongbin/p/5773330.html

4.安装git

下载linux版git：https://www.kernel.org/pub/software/scm/git/

执行命令：wget https://www.kernel.org/pub/software/scm/git/git-1.9.5.tar.gz

安装依赖包(需要root账号安装)：

yum install curl-devel expat-devel gettext-devel openssl-develzlib-devel gcc perl-ExtUtils-MakeMaker

切换程序账号：su –open

解压下载的文件：tar –zxvfgit-1.9.5.tar.gz

编译安装

make prefix=/open-falcon/Paasapplications/git all

make prefix=/open-falcon/Paasapplications/git install

--设置环境变量

echo "export PATH=$PATH:/open-falcon/Paasapplications/git/bin"

>> /open-falcon/.bash_profile

注:如果系统自带了git版本低于1.7.5，建议备份建立软链接；

mv /usr/bin/git /usr/bin/git171

ln -s /open-falcon/Paasapplications/git/bin/git /usr/bin/git

操作后结果如下：

5.安装go

下载安装包：wget http://www.golangtc.com/static/go/1.8/go1.8.linux-amd64.tar.gz

或者https://storage.googleapis.com/golang/go1.8.1.linux-amd64.tar.gz

解压到指定文件夹下面，然后配置环境变量GOROOT和GOPATH

tar –zxvf ./go1.8.linux-amd64.tar.gz /open-falcon/Paasapplications/

在程序账号的HOME目录下编译文件.bash_profile，添加：

export GOROOT=/open-falcon/Paasapplications/go

export PATH=****:/open-falcon/Paasapplications/go/bin---红色为添加内容

生效配置文件并测试：

6.安装mysql数据库

通过yum安装相关依赖包后安装mysql，详细见链接：

https://my.oschina.net/zijian1315/blog/192662

--建议安装mycat分布式数据库，避免单节点问题，或者安装mysql集群

7.安装redis

下载安装包：wget http://download.redis.io/releases/redis-3.2.8.tar.gz

---版本自己选择，我选择的是最新版本

---简单安装可以参考：http://www.cnblogs.com/silent2012/p/3499654.html

---集群安装参考：http://www.cnblogs.com/wuxl360/p/5920330.html

解压安装：

tar –zxvf ./redis-3.2.8.tar.gz

cd redis-3.2.8

make && makePREFIX=/open-falcon/Paasapplications/redisinstall

cd /open-falcon/Paasapplications/redis

mkdir shell logs conf data

cp /open-falcon/software/redis-3.2.8/redis.conf./conf/redis16001.conf

修改配置文件redis16001.conf

配置启停脚本

设置访问密码(open-falcon代码中没有考虑到密码访问的方式，建议不要设置)

--修改配置文件redis.conf中的Requirepass设置登录时需要使用的密码

Redis日常使用命令：

详细参考：http://blog.csdn.net/chuangrain/article/details/8099882

三、安装open-falcon（后台）

1.获取二进制安装文件

方法一：直接从open-falcon提供的编译好的二进制安装包安装，链接：

https://pan.baidu.com/s/1bprgdLd

方法二：通过安装git,go,编译生成的文件来安装，注意，如果都是linux OS的话，两种方式生成的文件是一样的；如果是其他OS,则需要你自己编译安装(方法一中链接中提供的安装包也是linux系统的，严格来说是centOS)。

方法二中的编译详细步骤见正文“5.编译open-falcon源码生成二进制部署文件”

2.初始化DB

使用navcat连接远程数据库并执行源码中的SQL

或者mysql命令导入sql创建表空间和表

cd $GOPATH/src/github.com/open-falcon/falcon-plus/scripts/mysql/db_schema/

mysql -h 127.0.0.1 -u root -p < uic-db-schema.sql

mysql -h 127.0.0.1 -u root -p < portal-db-schema.sql

mysql -h 127.0.0.1 -u root -p < graph-db-schema.sql

mysql -h 127.0.0.1 -u root -p < dashboard-db-schema.sql

mysql -h 127.0.0.1 -u root -p < alarms-db-schema.sql

导入后结果：

3.解压安装

安装步骤：

创建安装文件的存放目录

mkdir –p$HOME/open-falcon

tar –zxvf ./open-falcon-v0.2.0.tar.gz$HOME/

cd$HOME/open-falcon/

修改各个module的配置文件

---mysql数据库连接信息

--redis连接信息

--其他的相互各个module相互间的IP地址配置信息需要根据实际部署情况进行配置

4.启动openfalcon

建议启动顺序：redis,mysql具备的条件下:

judge,graph,transfer,agent,alarm,api,aggregator,nodata,gateway

启动命令（以judge为例）：./open-falconstart judge

5.编译open-falcon源码生成二进制部署文件

环境检查GOPATH

GOROOT环境变量设置(建议GOPATH和GOROOT不要在同一个目录)

Clone源代码

mkdir -p $GOPATH/src/github.com/open-falcon

cd $GOPATH/src/github.com/open-falcon

git clone https://github.com/open-falcon/falcon-plus.git

cd $GOPATH/src/github.com/open-falcon/falcon-plus/

make all ---显示如下则成功

make agent

make pack ---打包后在当前目录下生成open-falcon-v0.2.0.tar.gz文件（安装文件）：

---到此，编译生成安装文件完成

注：根据github提示的，可以在make pac之前先配置好各个module的config/cfg.json配置文件

当然也可以在编译好后的二进制安装包中进行配置；

----部署方案来源于：https://github.com/open-falcon/falcon-plus

四、安装dashboard(前台)

---以下部署方案来自：https://github.com/open-falcon/dashboard

1.获取安装代码

clone源代码到$HOME/open-falcon下面

cd $HOME/open-falcon

git clonehttps://github.com/open-falcon/dashboard.git

2.安装依赖包(root用户)

yum install -y python-virtualenv---yum无法安装，使用源码安装

yum install -y python-devel---yum可以安装

yum install -y openldap-devel---yum可以安装

yum install -y mysql-devel---yum可以安装

yum groupinstall "Development tools"

python-virtualenv源码安装

下载安装包：wget https://pypi.python.org/packages/d4/0c/9840c08189e030873387a73b90ada981885010dd9aea134d6de30cd24cb8/virtualenv-15.1.0.tar.gz#md5=44e19f4134906fe2d75124427dc9b716

下载好安装包以后解压安装：

---为了所有用户可用，使用root安装，python版本要求大于2.6

tar –zxvf ./virtualenv-15.1.0.tar.gz

cd virtualenv-15.1.0

python setup.py install

切换回程序账号后

cd $HOME/open-falcon/dashboard/

virtualenv./env---创建dashboard运行的虚拟环境

安装dashboard运行依赖的python包

./env/bin/pip

install -r pip_requirements.txt -i https://pypi.douban.com/simple

---如果报错，使用命令单个安装

--指定版本安装：

./env/bin/pip install requests==2.3.0

注：安装pip install mysql-python 可能会报错:

请使用root安装yum install mysql-devel libmysqlclient-dev 然后再安装

3.配置dashboard接口

3.1.配置后台api接口

如果api和dashboard为同一台主机，则不需要修改

3.2.配置数据库接口

3.3.启动dashboard

start in debug mode

cd $HOME/open-falcon/dashboard

$ ./env/bin/python wsgi.py

open http://127.0.0.1:8081 in your browser.

run with gunicorn in production mode

cd $HOME/open-falcon/dashboard

$ ./control start

open http://127.0.0.1:8081 in your browser.

Stop gunicorn

$ bash control stop

Check log

$ bash control tail

Dashboard展示，登陆

3.4.注册用户登陆使用