安装CacheEasy

获取CacheEasy

通过CacheEasy在GitHub上面的项目获取发布的二进制版本。

安装请求

系统要求

推荐以下Linux发行版：

• CentOS 6.0（或对应的RedHat）及以上
• Ubuntu 12.04及以上

其它的Linux发行版没有经过测试，理论上也是可行的

软件依赖

CacheEasy已经尽可能将依赖包打到发行版本里面，但是还是会有一些额外的请求

• ssh CacheEasy需要通过ssh登录到目标机器上部署客户端服务，因此目标机器必须支持ssh登录，端口为22
• wget 目标机器上的CacheEasy客户端需要用wget从CacheEasy的服务机器上下载资源，因此目标机器上必须有wget
• cron CacheEasy用cron守护机制来确保服务异常退出后的拉起

安装CacheEasy

解压

获取到CacheEasy二进制发行包以后，直接在工作目录解压发行包即可：

tar jxvf cacheeasy-x.x.x.tar.bz2

修改配置

CacheEasy的主配置文件是conf/cacheeasy.conf文件，大致内容如下：

[cacheeasy]
# mysql://user:password@host:port/dbname
db = sqlite:///data/cacheeasy.db
admin_init_password = admin
secret_key = 2cc14caf1dc2400f
# default_lang choices: en zh
default_lang = en
default_install_path =
default_log_path =
default_data_path =
default_agent_port = 7830
default_exporter_port = 7840

[nginx]
server_name =
listen = 7800
worker_processes = 4
logs = logs

[uwsgi]
processes = 16

[prometheus]
port = 7810

[grafana]
port = 7820
db = sqlite3:///grafana.db

[alertd]
command = tools/alert.sh
command_timeout = 5
check_interval = 300
newbie_block_time = 600

里面绝大多数配置都有默认值，唯一必须要用户提供的配置只有一个

server_name

server_name表示运行CacheEasy服务的机器名，一般就是当前运行CacheEasy服务的这台机器的ip地址。 提供这个配置后就可以启动服务了，具体的配置详情，请参看详细配置。

服务控制

CacheEasy服务的控制都是通过control.sh这个脚本来进行的。直接运行它可以看到使用帮助：

./control.sh
Usage:
------------------------------------------------------------------
./control.sh <status|start|stop|restart|reload|check> [target]...
target is: nginx, uwsgi, prometheus, grafana, alertd
------------------------------------------------------------------
./control.sh manage <cmd>
cmd:
    init                  init cacheeasy database
    import_grafana_data   import grafana datasource and dashboards
------------------------------------------------------------------
./control.sh crond

CacheEasy服务包含以下几个功能模块：

• nginx
• uwsgi
• prometheus
• grafana
• alertd

只有它们都正常运行整个CacheEasy服务才能完整服务。针对上面几个模块control.sh可以单独控制，如果命令行参数不提供的话默认就是对它们都执行某种操作。

启动服务

执行下面的命令

./control.sh start

这样就会启动上面提到的几个模块，第一次启动的话因为要做一些初始化的工作，时间可能需要几分钟，耐心等待直到命令结束。 如果想单独启动某个模块，以单独启动nginx模块为例：

./control.sh start nginx

查看服务状态

服务启动后一般再通过运行查看服务状态命令检查一下启动时候正常，当然，任何时候都可以运行该命令来查看服务的运行状态。

./control.sh status

如果上面几个功能模块都在运行的话就表示服务已经启动正在运行，如果有一个或多个模块没有运行，那么服务就不正常，需要启动相应缺失的模块。

重启服务

./control.sh restart

停止服务

./control.sh stop

服务管理

control.sh的manage命令用于服务内部操作，用户一般不需要直接执行该命令，

cron守护

CacheEasy服务启动以后，一旦服务因为某种原因退出，或者机器重启之类的问题，如果没有服务守护的话那么就必须要手工再次启动，因此control.sh提供了通过cron来守护服务的方式来确保服务可靠运行。执行以下命令即可:

./control.sh crond

访问服务

CacheEasy服务成功启动以后就可以通过浏览器来访问和管理了，默认情况下，浏览器打开以下地址即可：

http://server_name:7800

详细介绍请参见访问CacheEasy