Open-Falcon安装部署配置说明文档

@(架构师之路)

[TOC]

单机安装

Open-Falcon，为前后端分离的架构，包含backend 和 frontend两部分：

环境准备

1. 环境准备

安装redis
yum install -y redis
安装mysql
yum install -y mysql-server
注意，请确保 redis 和 MySQL 已启动。

初始化MySQL表结构
cd /tmp/ && git clone https://github.com/open-falcon/falcon-plus.git 
cd /tmp/falcon-plus/scripts/mysql/db_schema/
mysql -h 127.0.0.1 -u root -p < 1_uic-db-schema.sql
mysql -h 127.0.0.1 -u root -p < 2_portal-db-schema.sql
mysql -h 127.0.0.1 -u root -p < 3_dashboard-db-schema.sql
mysql -h 127.0.0.1 -u root -p < 4_graph-db-schema.sql
mysql -h 127.0.0.1 -u root -p < 5_alarms-db-schema.sql
rm -rf /tmp/falcon-plus/
如果你是从v0.1.0升级到当前版本v0.2.0，那么只需要执行如下命令：

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

2. 从源码编译

首先，请确保你已经安装好了golang环境，如果没有安装，请参考 https://golang.org/doc/install

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

# make all modules
make all

# pack all modules
make pack

这时候，你会在当前目录下面，得到open-falcon-v0.2.0.tar.gz的压缩包，就表示已经编译和打包成功了。

3. 下载编译好的二进制版本

如果你不想自己编译的话，那么可以下载官方编译好的二进制版本(x86 64位平台)。

到这一步，准备工作就完成了。 open-falcon-v0.2.0.tar.gz 这个二进制包，请大家解压到合适的位置，暂时保存，后续步骤需要使用。

启动后端

创建工作目录

export FALCON_HOME=/home/work
export WORKSPACE=$FALCON_HOME/open-falcon
mkdir -p $WORKSPACE

解压二进制包

tar -xzvf open-falcon-v0.2.1.tar.gz -C $WORKSPACE

在一台机器上启动所有的后端组件

1. 首先确认配置文件中数据库账号密码与实际相同，否则需要修改配置文件。

cd $WORKSPACE
grep -Ilr 3306  ./ | xargs -n1 -- sed -i 's/root:/real_user:real_password/g'

2. 启动

cd $WORKSPACE
./open-falcon start

# 检查所有模块的启动状况
./open-falcon check

更多的命令行 工具 用法

# ./open-falcon [start|stop|restart|check|monitor|reload] module
./open-falcon start agent

./open-falcon check
        falcon-graph         UP           53007
          falcon-hbs         UP           53014
        falcon-judge         UP           53020
     falcon-transfer         UP           53026
       falcon-nodata         UP           53032
   falcon-aggregator         UP           53038
        falcon-agent         UP           53044
      falcon-gateway         UP           53050
          falcon-api         UP           53056
        falcon-alarm         UP           53063

For debugging , You can check $WorkDir/$moduleName/log/logs/xxx.log

安装前端

创建工作目录

export HOME=/home/work
export WORKSPACE=$HOME/open-falcon
mkdir -p $WORKSPACE
cd $WORKSPACE

克隆前端组件代码

cd $WORKSPACE
git clone https://github.com/open-falcon/dashboard.git

安装依赖包

yum install -y python-virtualenv
yum install -y python-devel
yum install -y openldap-devel
yum install -y mysql-devel
yum groupinstall "Development tools"



cd $WORKSPACE/dashboard/
virtualenv ./env

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

初始化数据库

请参考环境准备

修改配置

dashboard的配置文件为： 'rrd/config.py'，请根据实际情况修改

## API_ADDR 表示后端api组件的地址
API_ADDR = "http://127.0.0.1:8080/api/v1" 

## 根据实际情况，修改PORTAL_DB_*, 默认用户名为root，默认密码为""
## 根据实际情况，修改ALARM_DB_*, 默认用户名为root，默认密码为""

以开发者模式启动

./env/bin/python wsgi.py

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

在生产环境启动

bash control start

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

停止dashboard运行

bash control stop

查看日志

bash control tail

dashbord用户管理

dashbord没有默认创建任何账号包括管理账号，需要你通过页面进行注册账号。
想拥有管理全局的超级管理员账号，需要手动注册用户名为root的账号（第一个帐号名称为root的用户会被自动设置为超级管理员）。
超级管理员可以给普通用户分配权限管理。

小提示：注册账号能够被任何打开dashboard页面的人注册，所以当给相关的人注册完账号后，需要去关闭注册账号功能。只需要去修改api组件的配置文件cfg.json，将signup_disable配置项修改为true，重启api即可。当需要给人开账号的时候，再将配置选项改回去，用完再关掉即可。

分布式安装

持续更新...

欢迎加入 Java 猿社区！

免费领取我历年收集的所有学习资料哦！

欢迎加入Java猿社区.png