安装DCache

1. 依赖环境

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

2. 准备工作

2.1 下载第三方依赖代码

进入src/thirdParty目录，执行 chmod +x thirdparty.sh; ./thirdparty.sh下载第三方依赖代码。

2.2 编译

在src/目录下执行：make release，然后再分别进入以下目录：

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

执行:

make; make tar

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

3. 公共服务部署

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

3.1 安装OptServer

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

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

然后填写必要的信息，如下图：

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

step3： 上传发布包。

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

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

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

step4： 添加配置文件。

根据上图，依次点击，得到下图：

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

step5： 重启OptServer。

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

3.2 安装ConfigServer

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

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

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

step2： 上传发布包。

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

step3： 添加配置文件。

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

step4： 重启ConfigServer。

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

3.3 安装PropertyServer

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

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

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

step2： 上传发布包。

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

step3： 添加配置文件。

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

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）的发布包，在“上传提示框”页面要注意类型匹配，如下图：

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

5.2 部署和发布Proxy和Router服务

根据上图，依次点击“DCache”和“运维管理”，其中“应用”和“管理员”必填，可自定义，然后点击“创建应用”，得到下图：

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

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

5.3 上线一个KVCache模块

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

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

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

必要信息填写完毕，点击“下一步”进入“安装发布”步骤，如下图：

再次确认信息填写无误，点击“安装发布”，等待服务发布完成。刷新管理平台主页，左侧目录树出现此模块信息，如下图：

5.4 上线一个MKVCache模块

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

5.5 Cache配置管理

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

模块和单节点的配置管理

按照上图箭头依次点击，可在该页面上修改和添加配置。该页面的配置管理分两种类型：针对模块所有节点的配置管理和针对模块特定节点的配置管理。