ESb总线产品维护手册.docx

RES Infomatic Service Bus 企业效劳总线维护手册RES Infomatic Service Bus 企业效劳总线维护手册目录版权2声明2免责条款21 关于本手册31.1 本手册适合对象31.2 手册组织31.3 版本说明32 RES Infomatic Service Bus 产品简介42.1 主要功能43 RES Infomatic Registry and Repository 维护说明53.1 产品简介53.2 RR 产品维护手册54 RES Infomatic Configuration Manager 维护说明74.1 产品简介74.2 CM 产品维护手册75 RES Infomatic Service Monitor 维护说明135.1 产品简介135.2 SM 产品维护手册135.2.1. 维护要点136关于17关于本公司17关于产品及文档更171版权北京锐易特软件技术对RES Infomatic Service Bus 企业效劳总线产品拥有学问产权，受中华人民共和国著作权法、计算机软件保护条理、学问产权保护条例和相关版权条约、法律、法规，及其它学问产权法律和条约保护。声明本文件的版权和最终解释权归北京锐易特软件技术全部。未经北京锐易特软件技术事先书面许可，不得以任何方式对本文件及全部程序、图文内容做全部或局部复制、公布、转载或修改。北京锐易特软件技术保存不事先通知就可以自行更改本文件中信息的权利，并对由此造成的损失不担当任何责任。本文件所涉及的非北京锐易特软件技术软件产品和技术，仅作为学问传播使用，不涉及任何商业利益，北京锐易特软件技术对此不担当任何法律责任。免责条款北京锐易特软件技术保存不事先通知就可以自行更改本文件中信息的权利，保存对本文件的最终解释权，并对由此造成的损失不担当任何责任。本文件所涉及的非北京锐易特软件技术软件产品和技术，仅作为学问传播使用，不涉及任何商业利益。北京锐易特软件技术对此不担当任何法律责任。北京锐易特软件技术不保证本产品完全无误，或者能够在任何机器上不连续的运行。北京锐易特软件技术在任何状况下均不就因使用或不能使用本产品而发生的损失包括但不限于业务中断、业务信息、文档、数据丧失及其他经济损失担当赔偿责任。21 关于本手册1.1 本手册适合对象本手册主要面对以下集成团队成员：企业效劳总线治理人员 供给对企业效劳总线各治理工具日常维护手段及常见问题解决方法。1.2 手册组织本手册共四章。第一章是本手册的总体描述，包括手册使用对象，手册的组织构造和版本说明； 其次章简要介绍企业效劳总线功能第三章具体介绍RR的维护说明； 第四章具体介绍CM的维护说明； 第五章具体介绍SM的维护说明；1.3 版本说明RES Infomatic Service Bus企业效劳总线维护手册Version 1.0。32 RES Infomatic Service Bus 产品简介2.1 主要功能RES Infomatic Service Bus企业效劳总线承受基于分布式SOA架构的策略，通过注册/存储中心RES Infomatic Registry and Repository为分布在不同物理位置的效劳供给底层信息， 实现了投资小、支持渐进式部署以及使系统具备更强的适应性和可维护性等特点，从而帮助企业 更好地应对不断变化的技术方案与业务环境。这种生命力更为长久的架构体系，是指导信息系统 建设、实现信息共享、到达业务互通的重要原则和最正确支持手段。通过面对效劳架构，实现了可构建基于面对效劳的、松耦合的、敏捷拆分的信息交换平台， 完成了动态链接、智能路由、信息流转等效劳总线核心功能，并供给了协议转换、安全掌握等根底效劳。同时，企业效劳总线通过效劳配置治理中心完成对总线效劳的部署与治理，通过效劳注 册中心实现对总线效劳的注册与定位，并通过监控中心获得总线效劳性能的实时监控，为用户快 速便捷的完成SOA整合环境下总线的搭建工作供给了架构支持。企业效劳总线下包括适配器、消息代理、效劳代理三种类型的效劳。其中，适配器效劳、消息代理效劳支持可定制配置的并发、多实例运行，通过对一个或者多个效劳节点组成程序集进展 正确的配置，为企业效劳总线供给稳定的运行环境。企业效劳总线供给统一的治理掌握台，完成对效劳部署、治理、监控、注册、查找等功能的统一操作，为用户快速便捷的完成SOA整合环境下总线的搭建工作供给工具支持。企业效劳总线经由适配器体系连接各种数据源和应用系统，实现规章引擎、流程驱动等核心效劳到总线的挂接；效劳总线以代理的形式为总线客户供给效劳，具体完成特定业务流程下的信息流转任务；治理掌握台关心完成对效劳注册信息、配置信息等关键元数据的治理与监控。43 RES Infomatic Registry and Repository 维护说明3.1 产品简介企业效劳资源注册中心是适应分布式SOA与企业整合实际需要的效劳资源注册产品。通过参 与业务效劳在整个SOA生命周期的各个阶段，对企业级SOA架构的设计、开发、部署、运行提 供全方位支持。它既是RESInfomaticIntegrationSuite信息整合套件的重要组成局部，同时也可 以关心分布式RESInfomaticServiceBus企业效劳总线实现统一的效劳资源的注册、搜寻与治理。企业效劳资源注册中心基于J2EE的技术标准，支持多种关系数据库与多种效劳扩展，供给敏捷便利的效劳注册、查找等功能。它遵照UDDI标准实现，承受标准WSDLWebServiceDescriptionLanguage对效劳资源信息进展描述，供给基于SOAP的外部访问 接口，实现了访问的平台无关性和厂商无关性，从而使得在分布式企业效劳总线下效劳的可见性 得到了掌握、效劳版本得到了治理、效劳信息的变更得到了分析和传达、效劳使用状况得到了监视、效劳信息得到了共享，效劳资源的全都性得到了保证。3.2 RR 产品维护手册1. 在RR中添加编目信息，规划各企业、效劳、资源的分类和效劳的供给者编目。2. 例如：企业分类可为：呼叫中心厂商、彩玲厂商、计费厂商、i. 效劳分类可为：批量装载、批量分发、时实分发、ii. 资源分类可为：web资源、Socket资源、FTP资源、iii. 效劳节点可为：可以设置效劳标识，如：BatchDelivery、BatchLoading等3. 在RR中添加企业信息，将企业信息及分类添加全面，便利搜寻，5RES Infomatic Service Bus 企业效劳总线维护手册4. 例如：企业标识：NewLand( 大陆)可选择资源分类中web资源为企业分类。5. 在.isdl文件中确认效劳的标识<Name>MBSoapMB10</Name>6. 注册效劳时，假设提示模型重复，需要确认是否使用一样模型，直接确定即可。(不同 的效劳却可使用一样的模型，模型里的信息就是业务功能恳求代理等一些业务处理类信息)7. 注册效劳时，效劳的URI依据根本格式：域名企业名/工程标识/效劳标识 的格式来设置。8. 注册消息代理转发WebService效劳时，效劳URI格式建议为：/通道名/ webservice/ 效劳标识。9. 建议设置通道名为企业名_效劳供给者_效劳标识等名称组合，如：realesoft为企业名， 那么通道名可定义为realesoft_JDBCTech_Seleect等能表达出企业及效劳相关信息的 名称。而第三段中的效劳标识也是由用户自行定义的。这样做的目地是便利治理和查询。10. 注册MB公布订阅效劳时，效劳URI格式为:企业名/通道名效劳标识，建议将效劳标识设置为通道名。11. 效劳注册后，需要添加效劳的供给者。12. 假设效劳是临时不用了，可以将效劳禁用。13. 假设模型是临时不用了，可以将模型禁用，同时引用此模型的全部效劳都将不能使用。6RES Infomatic Service Bus 企业效劳总线维护手册14. 假设某企业下的全部模型和效劳都临时不用了，在企业治理中，将企业禁用就可以了。15. 假设效劳不再使用，想删除效劳，就在效劳治理列表，将效劳删除；然后确定效劳所用的模型是否需要同样删除，假设模型被别的效劳所用，就不需要删除。16. 效劳及模型的公布，保存之前版本，进展效劳治理。17. 查看系统日志，在日志中可查看肯定日期对企业、编目、效劳、模型、用户等的增、删、改操作的记录，查看是否有非预期的操作记录。18. 效劳要参加总线，在RR中进展规划，依据确定的效劳标识，查询效劳是否存在，如已经存在，则修改效劳为的标识，进展效劳注册，效劳的URI为“域名/工程标识/服务标识”，依据这个格式进展效劳URI确实定，进展效劳注册。4 RES Infomatic Configuration Manager 维护说明4.1 产品简介配置治理中心供给基于Web方式的治理界面，为分布式RESInfomaticServiceBus企业效劳总线供给了集中的可视化治理操作平台。通过域治理、主机治理以及效劳节点治理三级治理方式，配置治理中心对总线环境进展综合 治理，从而实现了在分布式总线环境下对效劳节点由全局到局部的快速索引、敏捷装载以及高效 治理。配置治理中心供给向导式创立、信息配置、远程部署、运行掌握、日志治理以及用户权限治理等一系列功能，借此用户可以对总线不同类型效劳适配器、消息代理、效劳访问代理进展传输协议、数据源连接、以及用户访问安全等共性治理。4.2 CM 产品维护手册1. 假设想在 CM 中让各厂家治理自己的效劳节点时，可分别给各个厂家创立一般用户，对各个7厂家的效劳节点分别授权，就可以让各厂家只看到自己的效劳节点了。2. 建用户的密码系统默认设置为“123456”，需用户登录 CM 系统在“密码修改”中自行修改。3. 假设用户将自己的密码遗忘了，可以找治理员，在用户治理中将他的密码进展重置。密码会被重置为“123456”。4. 环境变量设置：资源包的环境变量设置在主机下，则整个主机的全部节点都引入了资源包。资源包的环境变量设置在效劳节点下，则只有此效劳节点引入了资源包。效劳节点的环境变 量优先级高于主机环境变量。5. 主机和效劳节点下都有默认的 MQ_Lib_Path 变量名，是为 MQ 环境变量预先设置的，此变量的值只需引到 MQ 资源包的文件夹就可以，系统自动在文件夹中引用MQ 所需的十个资源包。而其它环境变量都需要引到变量名才可以。6. 环境变量的值是所需资源包的路径，一个变量可对应一个或多个变量值，在 Windows 环境变量值之前可通过“;”分割，在 Linux 环境变量值之前可通过英文半角的“:”分割。7. 在 CM 主机列表，查看各效劳节点的运行状态已启动、已停顿，8. 环境变量提交后，在环境变量列表还需要点击“保存”按钮。9. 效劳节点的运行掌握，在效劳节点的相关配置有转变时，如协议端口、队列名称、适配器配置、日志配置、主题配置、数据源配置等等有转变时，都应将效劳节点重启动，所做更改才能生效。10. 效劳节点启动后，可以手动点击刷按钮进展状态刷，也可以等一分钟系统自动刷。11. 假设效劳节点是 MQ 协议，且期望承受负载均衡方法，则可以设置效劳节点多实例，且将实例全部启动，就可以实现负载均衡。12. 当效劳节点已经调试完成，可以正常运行时，可以将效劳节点设置为自动启动，这样在ESB8Framework 启动时，效劳节点也会随其自动启动。13. 设置效劳监控时间，可以时间框中选择具体的时间，也可以手动输入时间，时间单位为分钟。14. 效劳节点的部署方式分两种方式，一种是文件对应其标签逐个进展上传，另一种是上传.deploy 文件包，可一次将全部文件上传到其对应的文件名目下。不同的是第一种方式不行以重复掩盖上传，其次种方式可以直接掩盖上传。15. 假设是添加已经有效劳节点，需将效劳节点名目拷到总线效劳节点名目下，如是效劳代理节点 放 到 .ServiceBusservicenodesmb 中 ， 如 是 适 配 器 节 点 放 到 . ServiceBusservicenodesua 中。确认效劳节点的 config 中的配置文件 environment.ini 中的 System Environment 中的 WorkPath 是否正确。messagebroker.ini或 uadapter.ini 中关于错误、调用、跟踪三个日志路径是否正确。16. 假设想在 SM 中监控各种特别状况，可以在效劳节点中配置文件中进展自定义特别代码和级别。在效劳节点名目中的 config 文件夹下的 application.ini 中下定义。SM 中错误级别正常警告次要主要严峻致命Application.ini 中定义级别UW I D C E17. 在 CM 中，日常检查效劳的错误日志、调试日志、或是跟踪日志，从日志中查看是否效劳有报错，效劳的恳求和返回内容是否正常。18. 日志查询：可以日志按日期段查询，也可以依据时间段进展区间查询，查询结果可下载到本9地，进展查看。19. 在日志的设置中的日志的切换策略是指日志文件到达肯定大小或周期就会生成日志文件。20. 在日志设置中的日志的保存策略是指：日志超过肯定天数或日志个数，最早的日志就依据策略被清理掉。21. 日志的跟踪信息级别：是指在调试日志中输出信息的具体程度。级别越高日志信息越具体。22. 在调试效劳过程中，效劳的错误日志有如下错误：unable to find FieldDescriptor for ”Id” in ClassDescriptor of SelectAllPersonResponse 此提示可能是 soafactoryconfig.xml 文件未设置 connectionPool 的值。23. 在调试效劳过程中，效劳的错误日志有如下错误： com.res.soa.message.SOAException: Whiletryingtogetaconnectionusingno DataSource model ，说明数据库配置不正确或环境变量中未添加数据库驱动包。24. 在调试消息代理效劳过程中，效劳的错误日志有如下错误：javax.jms.JMSException: Could not connect to broker URL: tcp:/:1414. Reason: java.lang.IllegalArgumentException: port out of range:-1 如是在 MB 调用 UA 时消灭的问题,可能是由于 MB 的 MessageOUT 通道名写错误的缘由。25. 在调试消息代理效劳过程中，效劳的错误日志有如下错误： java.lang.NumberFormatException: null可能是配置文件中的 connectionpoolname 写的不对了。26. 在调试消息代理效劳过程中，客户端调用公布到 Tomcat 中的 MB 代理转发 WS 效劳时客户端的报错如下：org.apache.axis2.AxisFault: First Element must contain the local name, Envelope , but found html 。 错误缘由可能是因是在 MB 的 soatopic 配置文件中的效劳 URI 不对，10可能缺少 Tomcat 效劳中的效劳名war 包名27. 用户端调用 MB 代理转发 WebService 效劳，假设客户端报错为：“Exceptioninthread“main“org.apache.axis2.AxisFault: com.ctc.wstx.exc.WstxEOFException:UnexpectedEOFinprologatrow,colunknown-source: 1,0” 时，MB 效劳节点里可有报错为找不到效劳描述中的URI， 解决方案为：查看 RR 是否启动，或是 RR 中效劳描述中 URI 是否正确。28. soap 方 式 的 UA 节 点 ， 正 常 调 用 成 功 。 服 务 访 问 点 为 ： :/192.168.4.100:9840/soaSoap/resWS 将效劳打为 war 包，部署到 Tomcat 中，启动 Tomcat。在 客 户 端 的 soafactoryconfig 中 ， 修 改 服 务 的 访 问 点 为 :/192.168.4.100:8081/JDBCTechSoapSelectAllUserByID/soaSoap/resWS 在 IE 中加上?wsdl 就可以看到?wsdl 文件。其中 JDBCTechSoapSelectAllUserByID 为打包后部署到 Tomcat 中的效劳名，效劳里的一些配置文件还可能是放在原来效劳节点中的。 D:apache-tomcat-6.0.18webappsJDBCTechSoapSelectAllUserByIDWEB-INF 中 的web.xml 文件中有记录客户端正常调用效劳，效劳可调用成功，这时原来的 soap 节点不需要启动，ServiceBus也可以不启动假设是效劳开启监控，但 SM 未开启，则 servicebus 下的 Monitor 文件夹下有报告文件。但 serviceBus 不启动，不会生成报告文件。29. 假设效劳节点消灭特别运行状况，通过 CM 页面不能将节点停顿重启动时，可在命令中执行 ps ef|grep java 查出全部的 java 进程，查到出问题的效劳节点的进展号，执行 kill -911进程号 将此进程杀掉，再重启动。30. 假设效劳节点里有报错：(java.lang.OutOfMemoryError: Java heap space)为内存溢出时，可调整效劳节点中环境变量当中的VM 的值，问号处调整具体内存值的大小-Xms?m-Xmx?m-XX:PermSize=?M-XX:MaxPermSize=?M31. 在做 MB 代理转发 WebService 效劳时，所用的业务为(1) Axis 框架为：<BrokerClassName> com.res.mb.framework.processor. NoChunkedMessageRequestBroker</BrokerClassName>(2) Axis2 框架、.net 框架、cxf 框架的业务类为：<BrokerClassName> com.res.mb.framework.processor. MessageRequestBroker</BrokerClassName>125 RES Infomatic Service Monitor 维护说明5.1 产品简介效劳监控中心为RESInfomaticServiceBus企业效劳总线供给了可视化的总线监控平台，能 够对分布于总线不同物理位置下的业务效劳供给实时、动态、敏捷的智能监控。通过丰富的图形展现界面，用户可以对总线效劳的运行状态以及各性能指标数据一目了然，从而快速的了解总线 各个环节运行状况。效劳监控中心实现了总线监控、效劳监控、消息报告这三个核心功能，以此不仅可以帮助用户从多种治理角度评估业务、环境的安康性与有效性，为治理团队与业务执行者供给高质的、有效的数据支持，同时它还供给了关心测量SLA承诺的手段，使得企业IT部门可以实时、有效地对IT根底设施进展治理。5.2 SM 产品维护手册5.2.1. 维护要点1. SM 的域、主机拓扑图中，效劳节点为红色是停顿状态，绿色是启动状态，有“黄叹号”是效劳节点有未处理的特别状况。2. 效劳主机上的黄叹号，说明主机下的效劳节点有未处理的特别。3. 将鼠标划到主机拓扑图中，可以查看主机监控，显示主机的CPU 使用率及内存使用量等。4. 效劳节点中的特别假设不点击查看处理一下，则效劳节点会始终显示黄叹号。所以效劳节点有黄叹号就需要将特别信息翻开看一下。5. 常规监控的参数配置：设置常规监控的开关及上报数据间隔时间，间隔时间意为着间隔多久生成一次报告的时间，间隔时间短，生成的报告就多，间隔时间长，生成的报告数就少。136. 常规监控页面显示的是当天全部交易的计数器表示的执行总数、成功数、失败数、仪表盘表 示的最大执行时间、最小执行时间、平均执行时间、比例图表示的成功比例、波形图表示的交易流量实时统计图等状况。7. 假设效劳节点里有多个效劳，想分别查看每个效劳的交易执行状况，在全局监控页面的分项指标中选择不同的效劳分项，就可查看每个效劳的交易执行状况了。8. 假设在 SM 中有交易失败：则在 CM 查看效劳节点的错误日志，会有相关错误的记录。9. 如 果FTP服 务 器 未 启 动 ， 调 用FTP适 配 器 服 务 时 ， 会 报 一 条 异 常 错 误 。SOAXMLMessageDispatchPolicy:process - an SOAException encounterd during dispatch/process of request soaMessage同时，还会有失败记录，查看错误日志：com.res.soa.message.SOAException: FTP-100: Not logged in。10. 在 MB 转发 Webservice 效劳工程中，假设 Webservice 效劳未启动，SM 中会有特别和一条失败。特别为：Connection refused: connect。11. SLA 监控参数配置，设置SLA 监控开关，提示历史显示的时间为在SLA 监控页面显示设置时间内的 SLA 报告记录，12. SLA 规章定义分两种执行方式，一种是规章满足条件每天报告一次，另一种是规章依据设置频率的时间持续轮询，这两种方式可依据实际状况选择使用。13. SLA 规章的生效日期为：生效日期应当大于等于当前日期，14. SLA 规章开头时间，即规章的生效时间，“生效日期+开头时间”需大于效劳器此刻时间。15. SLA 规章临时不用，可以将其设置为无效状态。16. 规章级别：设置规章的严峻级别，分为“正常、警告、次要、主要、严峻、致命”等六个级别。17. 在概要报告中，可以查询系统分析常规监控、SLA 分析、错误报告等历史记录信息。1418. 系统分析列表显示所查询时间段内的系统上报数据记录，而标签数据分析和性能分析都是依据系统分析列表中的数据进展性能及数据重分析显示。19. 系统分析列表中的数据假设已经分析完成，不需要保存时，可在列表中进展删除，此删除是完全删除，不行逆操作。20. SLA 分析查询列表：依据查询时间、规章级别、规章名称等条件显示查询结果。依据查询结果列表可以进展数据分析，图形化显示规章汇总信息等。21. SLA 分析查询列表中的数据假设不需要保存时，可以列表中进展删除，此删除也是完全删除， 不行逆操作。22. 在 SM 中的概要报告中，临时没有报告删除策略，可以随时将没有用的记录删除，则在报告列表及统计列表中及在相关统计报告将不再有此记录，。6 相关备份说明1. 数据库备份：将 res2023 与 res2023rr 两个总线所需的数据库定期备份。2. 效劳节点备份：将效劳节点调试调用完成后，配置不在修改后，将效劳节点名目打为 tar 包，备份到备份机器；假设需要使用备份的效劳节点时，将效劳节点在一样名目下解压即 可使用。3. 假设其它总线环境需要使用备份的效劳时，需要将效劳节点拷贝到效劳节点名目，确定效劳节点所在的工作及日志路是否同现在使用的名目全都，如不全都，改为全都，登录环境的 CM，通过添加效劳节点命令将效劳节点参加总线环境。4. 总线环境变量备份：定期将 ResSOA/ServiceBus/bin 下的文件 setclasspath.bat 备份到备份机器；假设需要使用备份的主机环境变量，将环境变量文件拷贝到目标下，或是在目 录下掩盖原来的环境变量。155. 将部署到 Tomcat 的产品的 CM.war，SM.war， RR.war 等 war 包备份到备份机器。6. 将/root/IntallESB 中的各安装文件备份到备份机器。161 关于关于本公司北京锐易特软件技术(简称锐易特软件)是中关村高科技园区认证的高技术企业 和软件企业。除北京公司外，还在沈阳成立了SOA 研发中心，并与东北大学软件学院合作成立了信息整合试验室。公司核心团队由多位海外归国的技术专家、十多年深厚行业背景的IT 专家以及治理阅历丰富的专家组成。核心团队成员包括曾任职于IBM 中国、IBM 研发中心、加拿大丰业银行、加拿大帝国商业银行、加拿大惠普等重要的国内外著名企业并在期间担当技术专家及其它重要职务。他们在电子商务、信息整合、应用系统架构以及专业技术效劳等领域技术扎实、功力深厚，同 时具有北美和中国金融、电信、政府等重要行业的丰富行业阅历。锐易特软件以“锐意创、诚信进展”作为经营理念，致力于成为领先的软件和询问效劳供给商。关于产品及文档更本产品最版本及升级信息将在公司网站 :/realesoft .cn 上准时推出，敬请留意。17