09 OceanBase 0.4.2 配置中心 安装指南

OceanBase0.4.2配置中心安装指南文档版本：Beta02发布日期：2013.12.30支付宝（中国）网络技术有限公司·OceanBase团队前言概述本文档主要介绍OceanBase0.4.2配置中心的安装方法。读者对象本文档主要适用于：开发工程师。数据库管理工程师。通用约定在本文档中可能出现下列各式，它们所代表的含义如下。格式说明警告表示可能导致设备损坏、数据丢失或不可预知的结果。注意表示可能导致设备性能降低、服务不可用。小窍门可以帮助您解决某个问题或节省您的时间。说明表示正文的附加信息，是对正文的强调和补充。宋体表示正文。粗体表示命令行中的关键字（命令中保持不变、必须照输的部分）或者正文中强调的内容。斜体用于变量输入。{a|b|...}表示从两个或多个选项中选取一个。[]表示用“[]”括起来的部分在命令配置时是可选的。修订记录修改记录累积了每次文档更新的说明。最新版本的文档包含以前所有文档版本。版本和发布日期说明Beta02（2013-12-30）第一次发布Beta版本，适用于OceanBase0.4.2。联系我们如果您有任何疑问或是想了解OceanBase的最新开源动态消息，请联系我们：支付宝（中国）网络技术有限公司·OceanBase团队地址：杭州市万塘路18号黄龙时代广场B座；邮编：310099北京市朝阳区东三环中路1号环球金融中心西塔14层；邮编：100020邮箱：[e-mail]新浪微博：技术交流群（阿里旺旺）：853923637目录1安装前准备.......................................................................................................................-1-1.1概述...........................................................................................................................-1-1.2安装规划...................................................................................................................-3-1.3获取安装包...............................................................................................................-3-2生成war包......................................................................................................................-5-3在Windows下部署OBConfigure...............................................................................-6-3.1部署Tomcat..............................................................................................................-6-3.2配置MySQL数据库................................................................................................-7-3.3启动OBConfigure..................................................................................................-8-4在Linux下部署OBConfigure......................................................................................-9-4.1部署Tomcat.............................................................................................................-9-4.2配置MySQL数据库..............................................................................................-10-4.3启动OBConfigure................................................................................................-11-5基本操作.........................................................................................................................-12-5.1新增dataId.............................................................................................................-12-5.2配置升级选项.........................................................................................................-14-5.3配置数据源属性......................................................................................................-15--1-1安装前准备OBConfigure在Windows或者Linux环境中均可以部署。搭建OBConfigure环境前，请先进行安装规划并获取安装包。1.1概述OBConfigure是OceanBase配置管理中心，保存了所有的OceanBase客户端的配置参数，包括：数据库集群地址、用户名、密码以及数据源本身的配置项。其主要功能为：配置信息集中化管理和操作，简化DBA操作流程，同时方便OceanbBase客户端的升级。集群配置信息存储和管理系统，用于DBA集中化管理生产（或日常）环境中，各业务系统使用的集群配置信息。托管OceanBaseDatasource核心服务的各个版本jar包，同时控制业务系统使用的“oceanbase-core.jar”版本号。提供操作界面，便于完成业务系统使用的“oceanbase-core.jar”模块的版本升级。同时，提供业务系统使用的各个版本信息等。OBConfigure支持两种接口：HTTPGET：用于OceanBaseJava客户端获取OceanBase应用的Listener地址列表。HTTPPOST：用于修改OceanBase应用的listener地址列表。DBA可以通过curl之类的工具直接修改OceanBase应用的Listener地址。在OceanBase监控中心中提供了OBConfigure的WEB界面，可以直接通过该界面进行设置。OBConfigure统一管理了多个OceanBase的应用集群，以dataId作为主键进行应用集群的区分。不同应用的OBConfigure的URL地址，只需要修改为对应的集群名即可。OBConfigure对外提供统一的域名访问。客户端只需要配置一个OBConfigure服务的DNS地址，就会自动定位到某个机房的OBConfigure服务。OBConfigure选择DNS容错的方式，在两个机房部署OBConfigure服务。这种方式实现比较简单，但是，如果某个机房的OBConfigure服务长期不可用，DNS还是会查询到该地址。如果要修改DNS，则需要走一遍“DNS变更流程”，周期很长。另外，这种方式还有一个好处就是以后迁移OBConfigure到另外一个IP可以不需要客户端走重新发布流程。OBConfigure服务的功能如下：-2-管理OceanBase集群的Listener列表，提供查询和更改操作。管理客户端的升级。当有新版本的客户端出现时，通过配置百分比和允许升级的客户端机器IP白名单的方式，通知客户端自动进行版本的升级。在使用OceanBaseJava客户端时，提供上传和下载“oceanbase-core.jar”模块文件功能。将“oceanbase-core.jar”模块文件上传到OBConfigure服务器后，OBConfigure除了保存jar文件本身，还需要保存文件的md5值。另外，OBConfigure还需要存储最近上传的多个版本的jar文件（建议为5个），方便回滚。并提供读取最新版本的“oceanbase-core.jar”模块文件的元数据的功能。包括最后更新时间、版本号、md5值、百分比、允许升级的客户端机器IP白名单。说明：在第一次初始化Java应用程序时，通过“oceanbase.jar”模块的“本地缓存模块”从OBConfigure缓存到本地。而不需要手动导入“oceanbase-core-XXX.jar”包。OceanBaseJava客户端首先从OBConfigure读取元数据，并根据版本号信息构造HTTP请求下载相应的“oceanbase-core.jar”模块文件，检查“last_update_time_ms”是否比之前更新，执行md5校验。如果客户端需要升级，则替换自身依赖的“oceanbase-core.jar”模块文件。通过访问OBConfigure，获取的配置信息如下所示：#dataID名称。dataId=financial_history#OceanBase主集群主RootServer的IP地址和Listener端口。clusterAddress=10.209.144.30:2828#“oceanbase-core.jar”模块的版本。coreJarVersion=1.1.1#是否支持自动升级“oceanbase-core.jar”模块。enableUpdate=true#获取“oceanbase-core.jar”模块的IP地址。coreJarPath==#升级百分比。percentage=0#白名单列表。whiteList=10.209.11.122,10.209.15.103#连接OceanBase的用户名密码。密码以加密方式显示。username=adminpassword=73cad637e0e8b6e9#数据源属性配置信息，详细请参考“”。dsConfig=maxActive:8,minIdle:4,connectionProperties:emulateUnsupportedPstmt