EKP管理员手册

群集管理管理员手册文档控制/Document Control文档属性文档标题文档编号配置项密级用户文档模板模板修改记录日期作者版本备注2008年06月20日邓红云1.0初稿2009年05月12日邓红云1.1修改文档修改记录日期作者版本备注2012年5月9日王亮1.0全文编写2012年9月24日王亮1.1移除定时任务“所有节点” 运行类型2014年3月20日杨建宏1.2V11修订审阅记录日期审阅人版本备注分发日期分发人分发对象备注Landray 蓝凌目录第一章 引言 31.1 功能简介 3第二章 使用说明 32.1 群集应用环境准备 32.2 启用群集功能 32.3 群集管理 42.3.1 检查群集运行信息 42.3.2 设置调度服务运行地址 52.4 群集信息配置 72.5 常见问题参考 8第一章 引言为了帮助EKP系统管理员使用群集管理，特制定本文档1.1 功能简介群集管理主要包括群集功能启用、设置调度服务运行地址、群集信息配置等内容的详细 描述文档中2.1、2.2、2.3这3个章节，是以2个Tomcat节点为例，进行全新部署安装文档中 2.4 节主要从多个节点以及单机环境升级到群集的角度进行规划配置。

第二章 使用说明2.1 群集应用环境准备我们这里以Tomcat的2个节点的群集为例，准备好以下环境：＞节点1服务器名： wang-server1IP 地址：192.168.5.186＞节点2服务器名： wang-server2IP 地址：192.168. 5.108对于群集不同部署架构的选择，详见《EKP-J工程实施指引》2.2 启用群集功能通过本地Tomcat以安全模式启动EKP，进入http://localhost:8080/ekp/admin.do,勾选群集选项，进行群集配置，如下图：回群集迭顶群隼群组名称ekp_wang •例：landray_ekp节点标识wan g_server1朋务器节点的唯一标识，不同的节点应该设贵不同的值，例：ekp serverl,为了西t墨方便，建议在八、啲蚤数中通过：-DLandray.kmss.cluster.serverName=ekp serverl进行设羞通讯协谕'：：推荐)@UDP|M文若您使用了 TCPfc■仪，翟议您在八、啲启动参数中加上：-Pja^.net.pfefefIPv4Stack=tnje群集管理 图1)群集群组名称：整个群集统一标识，所有节点必须配置一样；节点标识：群集中每个节点的唯一标识，不同节点需设置不同的值；该参数还可以在JVM中设置，如-DLandray.kmss.cluster.serverName=wang_server1通讯协议：默认是UDP协议，推荐使用TCP；如果设置为TCP，在JVM启动参数中设置-D.preferIPv4Stack=trueUDP 协议要求所有群集节点处于同一网段，并能自动发现相关节点，缺点是稳定性 较差，建议在测试环境使用；TCP协议的稳定性相对要好很多，并不限制同一网段，但必须指定IP和起始端口,配置偏复杂，建议在生产环境使用。

特别注意：启动后，若IP不对也会导致该节点无法正常连接到其它节点，此时，请在JVM 的启动参数中添加：-Djgroups.bind_addr=192.168.5.186,以绑定节 点各自 IP此时，我们已经为节点 wang-server1 启用了群集功能，配置好数据库连接以及其他的 相关参数后，将其部署在节点 1然后，我们可以通过admin.do配置节点wang-server2，如下图:群集管理 图2)这里，只需将节点标识设置为wang_server2,其他参数和节点1保持一致，同样我们将EKP 部署到节点 22.3 群集管理2.3.1 检查群集运行信息群集节点启动后，进入参数置-> 系统配置 > 群集信息目录，如下图:羞数配羞设羞调度朋奔运行地址 新谨刪除 刷新申应用醸査当前路径：系纟克闻羞沙群集信息台逼系绒醸置s 名称标识运行状态进程号@腫努器消息通道连接状态启动时间刷新时间服务调度方式j-HJ门户管理H数据源j-E统一分类管理irang^serrerlwang^sercerl运行中25^2@WMig-serFerl191.168^.186:4^746当前节点2012』5-08 17:21:49382012-05-08 17:37:57^调度本地服务(wang_server2wang_server2运行中1 S36@wang-server2192.168.5.108:1086连通2012-05-08 17^328.342012-05-08 17:37:50.623调度本地朋劳(j-E流程引擎i -B表单自定义 j- 0订阅管理當见问軀(点击展开)(j-E关联管理 i-B定时任奔 -0 |群隼信息|j -in训阳服夯管理i时间设置（群集管理 图3）群集节点正常启动后，群集信息可以自动获取各个节点运行状况。

• 名称：群集节点名称，默认和各节点设置的标识一致，当然也可以进入编辑修改；• 标识：即admin.do中设置的节点标识；• 运行状态：系统中总共有三种运行状态：运行中、已关闭、心跳超时> 运行中：节点正常启动运行，显示为运行中；> 心跳超时：每个节点都设有心跳检测，心跳每15秒进行一次，其它节点若判断到某节点最后心跳时间超过了60秒，则认为该节点出现了异常关闭的现象，即：心跳超时另外，若发生强行关闭系统的情况，系统可能会发生来不及通 知自己是正常关闭的现象，此时其它系统也会认为该节点心跳超时了；> 已关闭：节点正常关闭或新建群集信息记录而节点未启动；• 进程号@服务器：该节点运行在操作系统的进程号及服务器名称• 消息通道：每个节点通讯的 IP 地址及端口• 连接状态：显示消息通道的运行状态• 启动时间：节点启动的时间• 刷新时间：群集信息显示的刷新时间点• 服务调度方式：正常情况下，在admin.do配置好后，每个节点调度本地服务若第一台启动的节点没有设置以群集的方式启动，则它将“抢占”了所有的后台服务，即便后续启动的节点启用了群集，那它也不会承担任何后台服务若第一台启动的节点以群集的方式启动，那后续启动的任何节点，不管是否启动群集，都按群集的方式进行启动。

此时，所有的实名节点将承担指派给它的后台服务，所有的匿名节点将不承担 任何后台服务2.3.2 设置调度服务运行地址在上图群集信息页面中，点击【设置调度服务运行地址】按钮，进入调度服务页面如下图：提交 关讯设置调度服务运疔地址调度朋务运行地址济程引擎事件执行朋务wang_server1 ▼定时任务调度服务wang_server1 ▼（群集管理 图4）我们可以看到，当前的服务都是在 wang_server1 这个节点上运行，默认运行在第一台 启动的节点上，当然我们可以根据需要将服务配置在不同的节点上运行如下图，【流程引擎事件执行服务】的运行地址，我们可以选择wang_server2,提交完成 后即可生效，则流程引擎事件则会在wang_server2执行提交 关讯设置调度服务运行地址调度服务运行地址济程引擎事件执行服务wang server1 ▼定时任务调度服务口青选择乂 wang_server1wan g_serve「2（群集管理 图5）对于【定时任务调度服务】的运行逻辑稍微复杂一些，我们可以在这里统一设置定时任 务调度服务运行地址，比如说我们设置成wang_server2除此之外，对于每一个定时任务项, 我们还可以还可以在系统任务中单独设置运行类型。

我们以【全系统搜索任务】为例来说明，进入系统配置-> 定时任务-> 系统任务, 然后找到【全系统搜索任务】，进入编辑页面，如下图群集管理 图6）默认情况下，定时任务的运行类型是【单个节点】，也就是此时定时任务会在群集调度 任务地址中设置的 wang_server2 节点上运行我们点击【运行类型】的下拉框，可以看到有2类运行方式，如下图（群集管理 图7）• 单个节点：默认设置，在群集调度任务地址中设置的节点上运行• 指定节点：可指定在群集信息中任一正常运行中的的节点上运行，而不受群集调度任务地址中设置的控制Landray 蓝凌特别注意：如果指定的群集节点状态不是在正常运行中，那么此时定时任务不会在任何 节点上运行2.4 群集信息配置通常情况下，我们准备好群集环境，在admin.do中设置好各节点的群集参数之后，就 可以分别启动各个节点服务器如果各节点启动正常的话，我们就可以看到如2.3.1节中图 3 的群集信息但是，如果是节点数比较多，或者原来单机环境升级到群集环境，这种情况我们最好是 在单机环境上先做好规划，设置好各节点的配置信息，然后按照规划好的信息去配置各个节 点的 admin.do 的参数。

下面我们来看一个实例：假设已经有1 个单机环境在运行，我们还要添加一个节点进来 形成群集环境，先做好规划配置，再启动节点进入 系统配置 -> 群集信息 页面，如下图设詈调度服务运行地址 新建 删踪 刷新当前路径：系统旣置》群集信息名称 标识 运行状态 迸程号@服务器 消息通道 连接状态 启动时间 刷新时屁 服务调度方式wang_sejrerl wang_serverl 运行中 2m^ang-serverl 192.168.5.186:55028 当前节点 2012-05-09 09:27:43.4 T1 2012-05-0915:12:40^47 谓度本地腫务群集管理 图8)此时，我们看到当前只有一个节点机器在运行中，点击右上角【新建】，进入群集节点页面，如下图群集节点保存保存并新建关诃名称* 标识URL样例：http:；/node 1 :8080. ekp(群集管理 图9)• 名称：即为群集信息页面显示的名称，我们设置为server2;• 标识：群集节点的标识，在admin.do设置节点的标识必须与这里保持一致，这里设置为 wang_server2；• URL：这里即为该节点的 EKP 登录 URL,设为 http://192.168.5.108:8080/ekp群集节点1保存1保存并新谨1关诃1名称server2* 标识wang server2URLhttp://192.168.5.108:8080/ekp样例：http:；/node 1 :SOSO, ekp群集管理 图10)设置好，保存成功后，回到群集信息页面，该节点还未启动，处于关闭状态，此时我们还可以先将调度服务运行地址设置到server2, —旦Server2启动，调度任务即切换到server2 上。

启动 Server2 之后，我们在原来的 wang_server1 节点上，可以看到 Server2 已经处于连 通状态了如下图设盡调庭服务运行筑址 新建 删除 刷新标识运行状态进程号@服劳器消息通道连接状态启动时间刷新时间阴劳调度方式wang_senerl运行中2184^wang-seiverl192.1$8.5.18€:55028|当前节点|2012-05-09 09:27:43.4772012-05-09 15:43:27.64调度本地服务wang_server2运行中3060@wang-server2192.168.5.108:1145连通2012-05-0915:37:41.6932012-05-09 15:43:16 847调度本地服务名称wang_serverl&erver2群集管理 图11)为了管理方便，我们刚才新建Server2群集信息的时候，设置了 server2的URL,在上 图中可以看到名称server2下面为超链接状态，此时点击到server2，即以Server2的角色进 入查看节点信息，server2已经是作为当前节点展示，如下图设養调度朋务运行地址 新建 刪除 刷新wang_serverlwan—serverl运行状态运行中进程号@册务器2184@wang-serverl消息通道192.168.5.186:55028连接状态连通启动时间2012-05-09 09^7:43.477刷新时间2012-05-0915:50:1286服务调度方式调度本地服务seirerlwang_senrer2运行中3060^irang-senrer2192.168.5.108:1145当前节点2012-05-09 15:37:41.6932012-05-09 15:50:02.057调度本葩服奔群集管理 图12)我们还可以点击节点行，进入重新编辑节点名称及URL。

对于已经停止或者移除不用 的群集节点信息，我们还可以选中删除2.5 常见问题参考在群集信息页面左下角，点击【常见问题】即可展开参考，如下图设盖调度脈奔运行地址 新建 刪除 刷新当前路径：系统酉!置》群隼信息名称 标识 运行状态 进程号@服务署 消息通道 连接状态 启动时间 刷新时间 脸务调度方式wang_serverlwang_serverl运行中2184^wang-serverl192.168.5.186:55028当前节点2012-05-09 09:27:43.4772012-05-09 15:52:12.98调度本葩脈务| server?wang_server2运行中3060@wang-server2192.168.5.108:11452012-05-09 1537:41.6932012-05-09 15:52:17.16调度本地朋务常见问题(点击展开)•如何辫别几个节点处于同一群隼环境？若几个节点连到同一个数据库上，则视为这些节点都处于同一群集坏境•为什么要为每个节点蜡定节点标识学由于系统中许多后台朋务只允许在单个节点上运行，为了方便安排每个节点的后台服务，我们需要对每个节点都进行标识。

您可以在admm.do中为该节点设畫节点标识，但这样导致群隼中每个节点的酉监不一致，给系统部署帯来麻烦，因此崖议您在口、啲启动秦数中设定节点名，如：-DLandray.kmss.cluster.serverName=serverl 对于没有指定节点标识的节点，或者产生节点标识重名的情况，那该节点将以匿名的方式启动，启动后，您可以在上面的列表中岌现这些节点，匿名节点的标识为一个丈位的随机字符串匿名节点不允许指派任何后台服务；若匿名节点关闭后，匿名节点的信息将会在下一个节点启动的时假自定刪除群集管理 图13)全文完】。