Skip to content

Latest commit

 

History

History
266 lines (153 loc) · 10.2 KB

install.md

File metadata and controls

266 lines (153 loc) · 10.2 KB

安装DCache

1. 依赖环境

DCache是基于Tars框架(版本v1.6.0以上)开发,所以编译之前请先安装Tars开发环境和管理平台,安装步骤请参考Tars的install文档。安装完Tars管理平台后,在浏览器中访问管理平台主页,如下图:

Tars管理平台主页

2. 准备工作

2.1 编译

在源码目录执行:mkdir build; cd build; cmake ..; make; make release,然后再分别进入以下目录:

  • src/OptServer/
  • src/ConfigServer/
  • src/PropertyServer/
  • src/Router/
  • src/Proxy/
  • src/KVCacheServer/
  • src/MKVCacheServer/

执行:

make tar

即可生成各服务的发布包。

2.2 创建模板

在Tars的Web平台创建DCache.Cache模板,后续部署DCache模块时会用到该模板。

创建模板

新增模板DCache.Cache,父模板选择tars.default,模板内容填入:

<tars>
    <application>
        <client>
            property=DCache.PropertyServer.PropertyObj
        </client>
    </application>
</tars>

3. 公共服务部署

在正式安装DCache应用前需要部署和安装公共服务:OptServer、ConfigServer和PropertyServer。

3.1 安装OptServer

step1: 创建OptServer所依赖的数据库,具体步骤可参考OptServer运行环境搭建

step2: 服务部署。在Tars管理平台主页点击“运维管理”,如下图:

部署OptServer

然后填写必要的信息,如下图:

填写OptServer信息

以上信息除“节点”、“OBJ绑定地址”和“端口号”外,其他必须和上图保持一致;“节点”填写欲安装OptServer服务的机器IP,“OBJ绑定地址”和“节点”一致,“端口号”可点击右下角“获取端口”按钮自动获取。一路点击“确定”,等待服务部署完成,最后回到Tars管理平台主页,可看到OptServer已经成功部署,如下图:

成功部署OptServer

step3: 上传发布包。

发布OptServer

根据上图数字序号,依次点击,得到如下提示框:

上传发布包

点击“上传发布包”,在新的提示页面上传DCacheOptServer.tgz发布包,得到如下页面:

真正发布OptServer

点击“发布版本”下的输入框,选择目标发布包,然后点击“发布”,如发布成功,会显示如下页面:

发布opt成功

step4: 添加配置文件。

添加配置文件

根据上图,依次点击,得到下图:

添加配置文件内容

其中文件名称填“DCacheOptServer.conf”,文件内容的填写请参考DCache服务配置说明

step5: 重启OptServer。

重启opt

根据上图,依次点击,重启OptServer,重启成功后,“当前状态”从“Off”变成“Active”,如下图所示:

重启成功

3.2 安装ConfigServer

安装ConfigServer的步骤和安装OptServer的步骤类似,除了不需要创建数据库外。

step1: 服务部署。服务部署所填信息如下图:

部署ConfigServer

以上信息除“节点”、“OBJ绑定地址”和“端口号”外,其他必须和上图保持一致;“节点”填写欲安装ConfigServer服务的机器IP,“OBJ绑定地址”和“节点”一致,“端口号”可点击右下角“获取端口”按钮自动获取。

step2: 上传发布包。

该步骤参考安装OptServer的step3即可。

step3: 添加配置文件。

该步骤参考安装OptServer的step4即可。其中配置文件的名称填“ConfigServer.conf”,文件内容的填写请参考DCache服务配置说明

step4: 重启ConfigServer。

该步骤参考安装OptServer的step5即可。

3.3 安装PropertyServer

安装PropertyServer的步骤和安装OptServer的步骤类似,除了不需要创建数据库外。

step1: 服务部署。服务部署所填信息如下图:

部署PropertyServer

以上信息除“节点”、“OBJ绑定地址”和“端口号”外,其他必须和上图保持一致;“节点”填写欲安装PropertyServer服务的机器IP,“OBJ绑定地址”和“节点”一致,“端口号”可点击右下角“获取端口”按钮自动获取。

step2: 上传发布包。

该步骤参考安装OptServer的step3即可。

step3: 添加配置文件。

该步骤参考安装OptServer的step4即可。其中配置文件的名称填“PropertyServer.conf”,文件内容的填写请参考DCache服务配置说明。PropertyServer需要将特性监控数据存储到db中,请自行创建db_dcache_property,并将db信息填入配置文件。

step4: 重启PropertyServer。

该步骤参考安装OptServer的step5即可。

4. DCache管理平台安装

DCache管理界面是以模块的形式加载到Tars管理平台,最终会和Tars管理平台使用同一个地址,具体的模块安装步骤请参考DCache管理平台安装

5. 创建一个DCache应用

本节描述如何创建一个DCache应用,如何上传发布包,如何上线一个模块,并对模块进行配置。

名词解释

  • 模块:类似于mysql中table的概念,使用者创建一个模块来存储数据。模块分为KVCache和MKVCache两种,如果要存储key-value数据则创建KVCache模块,如果要使用k-k-row,list,set,zset则创建MKVCache模块。
  • 应用:应用是多个模块的集合,应用下所有模块共享Proxy和Router服务,类似于mysql中db的概念。

5.1 发布包上传

部署Router、Cache、Proxy服务前必须上传相应的发布包

Proxy发布包上传

如下图:

上传发布包

依次点击,然后在弹出的提示框页面选择Proxy服务的发布包,上传。点击“默认”,将该发布包设置为Proxy服务的默认发布包,如下图:

设为默认

Router发布包上传

Router发布包的上传和Proxy发布包的上传步骤相同。

Cache发布包上传

Cache发布包的上传和Proxy发布包上传步骤类似,只不过Cache有两种不同类型(KVCache和MKVCache)的发布包,在“上传提示框”页面要注意类型匹配,如下图:

Cache发布包上传

上传完两种不同类型的发布包并分别设置为默认,得到下图:

Cache发布包上传成功

5.2 部署和发布Proxy和Router服务

安装DCache应用

根据上图,依次点击“服务创建”,自定义“应用”名称,然后点击“创建应用”,得到下图:

创建proxy和router服务

在输入框填写相关信息,其余保持不变,点击“创建router、proxy服务”,得到下图:

确认信息

确认填写无误后,点击“安装发布”,等待安装完成,结果如下图所示:

成功安装proxy和router

5.3 上线一个KVCache模块

创建KVCache模块

按照上图箭头依次点击,“应用”选择在部署和发布Proxy和Router服务创建的应用名称,“cache类型”选择KVCache,所填信息确认无误后,点击“下一步”进入“模块配置”步骤,如下图:

模块配置

填写必要信息之后,点击“下一步”,进入“服务配置”步骤,如下图:

服务配置

注意: 共享内存key必须是唯一的,不能在服务部署机器上已存在,否则会造成服务拉起失败,可使用ipcs命令确认。

Cache服务的模板默认会选择DCache.Cache,如果模板DCache.Cache不存在,可创建该模板或者选择其他可用的模板,模板中必须配置property,这样才能查看服务的特性监控数据。

<tars>
    <application>
        <client>
            property=DCache.PropertyServer.PropertyObj
        </client>
    </application>
</tars>

必要信息填写完毕,点击“下一步”进入“安装发布”步骤,等待服务发布完成。刷新管理平台主页,左侧目录树出现此模块信息,如下图:

安装成功

5.4 上线一个MKVCache模块

步骤和部署和发布KVCache类似,参考即可。

5.5 Cache配置管理

Cache配置管理

按照上图箭头依次点击,可添加配置项。

模块和单节点的配置管理

模块配置管理

按照上图箭头依次点击,可在该页面上修改和添加配置。该页面的配置管理分两种类型:针对模块所有节点的配置管理和针对模块特定节点的配置管理。如果节点配置和模块配置有重叠的配置项,那么节点配置将覆盖模块配置。 注意: 修改配置后,需要重启服务才能生效。