Page tree
Skip to end of metadata
Go to start of metadata


1. 安装准备

开源移动统计分析系统Cobub Razor安装需要以下条件:

(1) PHP 5.2.6及以上 (5.3及以上更佳) Mysqli扩展支持

(2) MySQL 5.0及以上,MySQL需支持InnoDB引擎,

mysql帐号需要有以下访问权限:SELECT, INSERT, UPDATE, DELETE, CREATE, INDEX, CREATE TEMPORARY TABLES,CREATE ROUTINE, EXECUTE等

(3) Web服务器 (Apache或Nginx)

注:mysql最佳版本是5.6,MYSQL5.7版本存在sql_mode=only_full_group_by报错问题

2. 安装步骤

安装前,请先下载开源移动统计分析系统Cobub Razor的最新0.8.0版本将下载的.zip文件解压缩,然后把解压的目录放至web服务器的根目录下。

打开浏览器,输入url (例如http://localhost/razor/web/):

2.1 语言选择

第一步,选择开源移动统计分析系统Cobub Razor的安装语言。

首次使用开源移动统计分析系统Cobub Razor,界面会显示安装步骤,首页默认为英文。在“语言”框内,用户可以选择系统所使用的语言。

目前,系统支持四种语言:简体中文、英文、德语以及日语。用户如果需要自定义语言包,可以参见这里。选择所需语言类型后,点击“Start Installation”开始安装。

 

2.2 接受协议

第二步,确认接受开源移动统计分析系统Cobub Razor系统许可证协议。

目前Cobub Razor的web端使用GPL v3,SDK端使用LGPL v3的许可协议(关于协议的更多信息,可以参见这里)。

如果接受协议,选择“我接受Cobub Razor所附带的软件许可证协议”,点击下一步,开始安装。如果不接受,可返回退出系统

2.3 系统检查

第三步,进行系统检查。开源移动统计分析系统Cobub Razor 安装时,需检查环境是否满足其安装要求。

主要有以下的系统要求:

PHP版本需5.2.6及以上,必须安装MySqli扩展,相关目录及目录内文件需要有写权限。

尤其是Linux系统下,系统需要对列出的4个目录及包括的所有文件赋于读、写和执行权限。

如无法通过检查,请参见常见问题;如果所有条件均满足,则每一项后面均会显示满足条件,用户则可以点击“下一步”继续

 

2.4 创建数据库

第四步,创建数据库的操作。

在此之前,请先确保已经在Mysql中创建了新的数据库,分别用作Cobub Razor的原始数据库和数据仓库(备注:推荐使用不同的数据库,原始数据与统计数据分开)。

同时,需注意以下事项:

请确定Mysql支持InnoDB,如未启动:请修改my.ini文件,将skip-innodb改为#skip-innodb;

在创建数据库和数据仓库的时候,密码是必须的,否则无法通过检验;

为了增加安全性,建议使用Cobub Razor专用的Mysql帐号,而非root帐号;

按照要求,输入原始数据库和数据仓库的相关帐号信息,点击“下一步”按钮。

2.5 创建站点与超级用户

第五步,创建站点与超级用户。

输入web站点的url根地址(例如http://localhost/razor/web),同时一定要选择时区(比如中国用户选择UTC+8区)
请打开文件application/config/config.php确认$config['timezones']是否有值。例如,UTC +8:00会将$config['timezones'] = ‘UP8′。

超级用户是Cobub Razor安装时创建的管理员帐号。点击“下一步”按钮。

2.6 完成站点安装

第六步,系统显示开源移动统计分析系统Cobub Razor安装完成。

(1)用户可以点击“登录站点”,进入Cobub Razor的登录界面。

(2)输入Cobub Razor的超级用户帐号,可以成功登录。

 

(3)成功登录后,代表Cobub Razor的Web系统已成功安装。

 注:如果想让客户端SDK与Web服务器工作配合正常,还需要进行下列工作:(1)集成SDK(2)定时任务配置  请继续完成集成文档和定时任务文档配置工作。

3. 系统配置

3.1 邮件配置

为了能正常接受到系统通知邮件,需要在web\application\config\email.php中设置SMTP信息:

$config['smtp_host'] = ''; // SMTP server address
$config['smtp_user'] = ''; // SMTP server account name
$config['smtp_pass'] = ''; // SMTP server account password
$config['smtp_port'] = ''; // SMTP server port

3.2 地域配置

重要:仅针对Cobub Razor 0.5和0.6版本;0.7及之后版本可跳过此步骤

Cobub Razor-开源的、移动应用分析系统提供了两种通过GPS/IP获得国家、省(地区)、市的方法:

(1)如果有GPS数据,则通过Google的接口进行转换,获得国家、省(地区)、市的信息,如果有没有则通过IP地址调用IpInfo的在线接口,以获取需要的信息;

(2)通过提供GeoIP的调用接口,可以读取GeoIP的本地IP数据库,进行数据的转换。

目前版本安装后的默认为第1种方法。如果想切换至第2种方法,则:

(1)下载GeoIP的本地数据库文件

(2)将解压后的GeoLiteCity.dat文件放至/web/目录下

(3)将/web/application/config/config.php文件中的$config['get_geographical']的值改为1.

(4)GeoLiteCity使用英文,所有$config['default_country']的值要改为英文,如China.

This product includes GeoLite data created by MaxMind, available from http://www.maxmind.com

 3.3 配置redis(不是必选)

 从0.7版本开始,强烈建议启用Redis,以便可以启动Cobub Razor中的实时报表功能。

 配置Redis的步骤:

 3.3.1 安装Redis服务器:

 (1)下载、解压和编译Redis;

$ wget http://redis.googlecode.com/files/redis-2.4.17.tar.gz
$ tar xzf redis-2.4.14.tar.gz
$ cd redis-2.4.14
$ make

(2) 运行Redis

编译好的文件位于src目录下。

$ src/redis-server

(3) Redis启动成功后,您可以通过下述命令进行交互测试:  

编译好的文件位于src目录下。

$ src/redis-cli
redis> set foo bar
OK
redis> get foo 
"bar"

更多信息参照 :  http://redis.io/

3.3.2 在开源移动应用分析-Cobub Razor系统中配置Redis服务:

(1) Redis 服务器端配置

配置文件/application/config/redis.php 下配置Redis:

$config['redis_host'] = 'localhost';        // IP address or host
$config['redis_port'] = '6379';                // Default Redis port is 6379
$config['redis_password'] = '';                // Can be left empty when the server does not require AUTH

(2) 在开源移动应用分析-Cobub Razor系统中启用Redis:

配置文件application/config/config.php启用Redis:

/*
| Redis Settings
| If you want to use Redis to improve the performance. Config redis to 1
|    0 = Disable Redis
|    1 = Enable Redis
*/
$config['redis'] = 1;

(3) 设置Redis处理队列的时间间隔

启用Redis的情况下,Cobub Razor首先将SDK提交的数据缓存到Redis队列中,然后在根据设置的时间间隔来处理队列中的数据,以减轻并发对数据库产生的压力。

配置文件/application/config/config.php里设置处理数据队列的时间间隔:

/*
| Redis Processing intervals
| System will pop data from redis queue and insert to database according to interval
| Interval unit : Seconds
*/
$config['redis_interval'] = 10;

基本结构

 

4. 关于二次开发

如果您想二次开发Cobub Razor,您可能关心的是:

4.1 编写的语言

开源移动应用统计分析Cobub Razor 的WEB端使用的是PHP语言,并使用了CodeIgnitor的框架。

对于SDK:

    • Android SDK  使用了Java语言
    • iOS SDK使用了 Objective-C语言
    • Windows Phone SDK使用了 C# 语言

4.2 修改的权利

Q:我是否有权利对开源的Cobub Razor 移动统计分析系统进行修改,如:添加功能,修改已有功能或者删除已有功能?对此我应该承担什么样的责任?

A:可以修改。Cobub Razor的开源版服务端代码使用GPL许可,SDK使用LGPL许可。

简单说来对于源码的修改需满足如下条件:

(1)服务端的所有修改具有传染性,必须开源所有连接系统的代码

(2)SDK的修改只需要开源SDK的代码即可

注:如果不想开源,请购买商业许可。

4.3 修改的提交

我如何提交对于Cobub Razor的更改?

Cobub Razor的代码存放于Github,所有的更修需要通过Github的Pull Requests。

提示:在使用Cobub Razor进行数据统计之前,您必须设置系统的定时任务,使其可以定时自动地将数据从原始数据库抽取到数据仓库,并生成统计分析报表。详细内容请查看 定时任务的设置


  • No labels