SG-UAP_V3 0 0_使用手册_分册3 系统治理工具

SG-UAP系统治理工具使用手册国家电网公司应用系统统一开发平台（SG-UAP V3.0.0）系统治理工具使用手册国网信息通信产业集团研发中心2017年7月修订记录版本号修订说明修订人修订时间审核人1.0创建张乐、孟岩、卢炎炎、吴国宁20修改孟岩、张乐、卢炎炎2012.9.261.5修改3.9.4应用配置详情修改3.1登录治理工具修改3.2用户管理新增3.3配置模板管理新增3.4用户登录审计新增3.14数据源监视尉双梅2013.06.20吴海超1.5新增3.2找回密码修改3.4.4新增配置项修改3.15.1添加URL监视尉双梅2013.07.05吴海超2.5新增2.4 mongoDB配置新增2.5治理工具集中日志配置新增3.14集中日志收集,存储预警以及日志展示功能修改3.16.1多数据库监控功能吴海超2014.11.24吴海超目录一、 系统治理工具简介71.1 系统治理工具概述71.2 系统治理工具部署结构7二、 环境准备81.3 硬件准备81.4 软件准备8三、 安装步骤102.1 运行sguap-server102.1 设置平台服务路径112.2 初始化治理数据库112.3 配置治理数据源122.4 配置治理套件122.5 配置治理工具不需要启动模块132.6 配置初始化界面132.7 运行gov-client132.8 运行agent14四、 使用说明143.1 登录治理工具143.2 找回密码153.3 用户管理173.3.1 新增用户173.3.2 修改用户203.3.3 删除用户223.4 配置模板管理233.4.1 新增配置模板233.4.2 修改配置模板243.4.3 删除配置模板253.4.4 新增配置项253.4.5 修改配置项263.4.6 删除配置项273.5 预警阀值273.5.1 预警阀值设置273.6 用户登录审计283.6.1 用户登录审计283.6.2 用户操作审计293.7 应用系统管理303.7.1 新建应用系统313.7.2 修改应用系统313.7.3 删除应用系统323.8 应用域管理343.8.1 新建应用域343.8.2 删除应用域353.8.3 修改应用域363.9 应用管理373.9.1 添加应用373.9.2 删除应用383.9.3 修改应用383.10 通用配置393.10.1 数据源配置(JNDI)393.10.2 数据源配置(DBCP)393.10.3 DBCP数据源测试403.10.4 修改数据源配置413.10.5 删除数据源配置413.10.6 Appender设置423.10.7 修改Appender设置433.10.8 删除Appender设置433.11 应用配置443.11.1 新建配置443.11.2 删除配置453.11.3 修改配置463.11.4 应用配置详情463.12 部署管理503.12.1 新建服务器分组503.12.2 删除服务器分组513.12.3 修改服务器分组513.12.4 新建服务器523.12.5 删除服务器523.12.6 编辑服务器533.12.7 新建中间件543.12.8 查看服务器状态543.12.9 升级代理组件553.12.10 查看中间件应用详情563.12.11 应用详情-日志下载573.12.12 动态修改应用日志级别603.12.13 编辑中间件623.12.14 删除中间件633.12.15 启动中间件653.12.16 停止中间件663.12.17 中间件回滚663.12.18 中间件升级673.12.19 中间件-日志下载673.12.20 查看中间件JVM状态703.13 部署单元723.13.1 新建部署单元723.13.2 删除部署单元733.13.3 编辑部署单元743.13.4 添加应用到部署单元753.13.5 部署单元/部署分布设置763.13.6 启动部署单元763.13.7 升级部署单元773.13.8 回滚部署单元783.13.9 停止部署单元783.14 日志管理793.14.1 日志查询793.14.2 日志详情803.14.3 日志导出813.15 URL监视813.15.1 添加URL监视813.15.2 删除URL监视833.15.3 清空URL监视843.15.4 URL分析853.15.5 URL详情863.16 数据源监视873.16.1 添加新的数据源配置873.16.2 修改数据源配置883.16.3 测试数据源连接893.17 应用会话统计903.18 治理工具预警总览913.18.1 预警总览界面923.18.2 添加监控域923.18.3 删除系统933.18.4 切换到关心系统配置界面943.18.5 查看服务器信息943.18.6 查看中间件信息963.18.7 日志信息查看973.18.8 应用会话查看983.18.9 URL监控983.18.10 数据库监控993.18.11 部署单元监控1003.18.12 新建系统1013.18.13 关闭监控1023.18.14 系统、域以及服务器、中间件统计1023.18.15 控制台命令103系统治理工具用户使用手册一、 系统治理工具简介1.1 系统治理工具概述系统治理工具是基于SG-UAP平台的应用进行系统配置、发布与监视的集中式工具，它提供查看管理服务器、中间件、应用、配置，以及查询、存储日志，查看服务器、中间件性能，以及对中间件、服务器性能的预警功能。1.2 系统治理工具部署结构1) 由业务系统提供业务系统应用bundles（App Bundles），并将应用bundles发布到SG-UAP服务端（UAP Server Bundle Pool）。2) 将已有的SG-UAP服务端资源（UAP Server Bundle Pool）、数据库资源（DataBase Server）和F5注册到系统治理服务（Governance Server）。3) 初始化服务器（Servers）资源，为每台服务器配置并启动系统治理代理服务（Gov Agent），并将服务器资源注册到系统治理服务。4) 由业务系统提供业务系统配置，通过系统治理服务对业务系统的配置项进行配置（如perties、perties的配置等）。5) 由系统治理服务将业务系统应用程序包（SG-UAP项目）发布到已经配置好的每个服务器资源上，并对业务系统应用服务进行管理、监控。6) 用户通过F5发布的业务系统应用虚拟地址、服务器资源的地址或其他方式访问业务系统应用服务。二、 环境准备1.3 硬件准备1. 已安装数据库服务（如：oracle, sqlserver等）的服务器一台，本例中有一台安装了oracle的服务器，ip为112. 已安装web应用服务器（如：weblogic, tomcat等）的服务器若干台，本例中有两台安装了tomcat的服务器，端口号分别为7001和8080，ip分别为12, 21，还有一台安装了weblogic的服务器，端口号为7001，ip为931.4 软件准备1. 安装JDK1.6版本2. 平台服务端发布包sguap-server3. 治理工具服务端发布包gov-client；4. 治理工具客户端发布包agent；5. 治理工具数据库脚本，如本例需要oracle的数据库脚本；三、 安装步骤2.1 运行sguap-server本例将sguap-server部署在ip为12的服务器的tomcat中，端口号为7001，则服务仓库的地址为：12:7001/sguap-server/environment：2.1 设置平台服务路径打开gov-clientWebContentWEB-INFconfigurationconfig.ini，将dm.server.path设置为上述地址：2.2 初始化治理数据库执行sql脚本，初始化治理数据库，本例在ip为11的服务器上的oracle数据库实例orcl中完成初始化：2.3 配置治理数据源打开gov-clientWebContentWEB-INFconfigurationdatasource.xml，修改数据源配置，指向上述实例：2.4 配置MONGODB打开新建mongodb-win32-i386-2.6.0data、mongodb-win32-i386-2.6.0datalog，并在mongodb-win32-i386-2.6.0datalog中新建日志文件mongodb.log。以下命令括号内内容无需填写。启动mongodb：mongod -logpath mongodb-win32-i386-2.6.0datalogmongodb.log（mongo日志文件路径） dbpath mongodb-win32-i386-2.6.0data （mongo数据库路径）新开一个窗口，使用命令mongo.exe启动mongo数据库。启动成功后，连接mongo数据库，插入一条数据，查看是否能插入成功。如果mongo数据库出现问题，无法正常开启，请输入mongo数据库修复命令尝试。mongod -repair -dbpath mongodb-win32-i386-2.6.0data （mongo数据库路径）2.5 配置治理工具集中日志收集初始化参数在perties设置数据缓冲路径以及mongoDB参数服务器本地绝对路径MongoDB参数设置2.6 配置治理套件打开gov-clientWebContentWEB-INFrepositoryplatformmodulelistclient_include_perties，添加治理工具套件：2.7 配置治理工具不需要启动模块打开gov-clientWebContentWEB-INFrepositoryplatformmodulelistclient_exclude_perties，添加治理工具无需加载套件：2.8 配置初始化界面打开gov-clientWebContentWEB-INFweb.xml，添加治理工具初始化界面： 2.9 运行gov-client本例将其部署在ip为21的服务器的tomcat中，端口号为8080：2.10 运行agent将治理工具客户端发布包agent拷贝到待管理的服务器上，本例中是ip为93的服务器，分别运行start.cmd：四、 使用说明3.1 登录治理工具在浏览器地址栏中输入http:/ip:port/uap/gov/default.jsp：输入系统默认提供的admin管理员用户，密码：goV12345，登录后页面如下：3.2 找回密码使用“找回密码”功能前，需要设置邮箱服务器信息；使用管理员权限用户登录治理工具，选择密码找回邮箱配置，进行如下设置：smtp.host=mail.username=mail.password=uaptestmail.from=配置完成后，点击“注销”按钮，退出系统，返回登录界面，点击“找回密码”按钮，弹出“找回密码”对话框，如下图：输入“登录名”、“注册邮箱”，点击“找回密码”按钮，提示：新密码已发送到您注册邮箱。此时，登录注册邮箱，可看到一封发件人为uaptest的，标题为“重置治理工具用户密码”的新邮件。3.3 用户管理3.3.1 新增用户点击右上角当前登录用户（管理员才有该功能，普通用户没有），弹出如下菜单：点击“用户管理”按钮，出现用户管理界面：点击“新建”按钮，弹出如下的用户填写窗口，填写姓名、登录名、密码、邮箱等信息（*必填项），点击“保存”按钮，用户创建成功。系统默认新增的用户对域没有操作权力，需要对其授权后，使用该用户登录系统后才能在左侧看到域信息，选中左侧的某一个域，右键弹出如下的菜单：点击“授权按钮”，弹出授权窗口，页面左侧显示系统中的所有用户列表，右侧显示对所选域有操作权力的用户列表，如下图：若没有选中左边的授权用户，则提示：请选择授权用户页面左侧勾选需要授权的用户，点击“授权-”按钮，授权成功，如下图：页面右侧勾选需要取消对域操作权力的用户，点击“”按钮，即可以授予用户对所选域的操作权力，右边列表也会立即显示新添加的域，如下图：若没选中右侧系统域，则提示：请选择撤销的系统域选中右边列表中的域，点击“”按扭，弹出添加成功提示信息。操作如下图所示：3.13.5 部署单元/部署分布设置在系统左侧某一应用域中点击“部署单元”菜单，右侧默认显示部署单元对话信息，点击部署分布设置，选择要添加的服务器中间件，点击“-”按扭，弹出添加成功提示信息。操作如下图所示：3.13.6 启动部署单元在系统左侧某一应用域中点击“部署单元”菜单，右侧默认显示部署单元对话信息，在“部署单元”中选择有关联的应用和服务器的目标部署单元，右键单击选择“启动”菜单，提示部署单元已启动（部署单元关联的所有服务器的中间件高亮显示被启动成功、灰色为没有启动成功，应用被启动，可以正常访问应用页面）。操作如下图所示：3.13.7 升级部署单元在系统左侧某一应用域中点击“部署单元”菜单，右侧默认显示部署单元对话信息，在“部署单元”列表中选择目标部署单元单击，该部署单元所关联的应用的配置信息被修改过。右键单击选择“升级”菜单，提示部署单元已升级，部署单元关联的所有应用的配置信息均被更新到服务器上。操作如下图所示：3.13.8 回滚部署单元在系统左侧某一应用域中点击“部署单元”菜单，右侧默认显示部署单元对话信息，在“部署单元”列表中，选择目标部署单元单击，该部署单元有做过升级。右键单击选择“回滚”菜单，提示部署单元已回滚，部署单元关联的所有应用在服务器上的部署版本被回滚到上一个版本。操作如下图所示：3.13.9 停止部署单元在系统左侧某一应用域中点击“部署单元”菜单，右侧默认显示部署单元对话信息，在“部署单元”列表中选择目标部署单元单击，假如该部署单元下的所有服务器均处于启动状态。右键单击选择“停止”菜单，提示部署单元已停止，部署单元关联的所有服务器的中间件均被停止。操作如下图所示：3.14 日志管理3.14.1 日志查询在系统左侧某一应用域中点击“日志管理”菜单，右侧显示各个应用日志的警告总数、错误总数、致命总数。如下图：点击“应用名称”链接，显示该应用每天日志警告总数，错误总数，致命总数，如下图：(1):点击“日期”链接，显示该日期警告，错误，致命日志详细信息，如下图：点击“查询”按钮，如下图：(2)：点击下图中“详细”链接显示该天24小时内警告，错误，致命数，如下图：3.14.2 日志详情在查询到的日志中，选择一条日志，点击“日志内容”右边的按钮，日志详情内容展开。如下图所示：3.14.3 日志导出查询到日志后，点击“导出”按钮，导出所有满足查询条件的日志3.15 URL监视3.15.1 添加URL监视系统左侧某一应用域中点击“部署管理”菜单，右击中间件，选择“应用详情”，弹出应用详情窗口，选择中间件中的某一个应用标签页，点击“点击查看”链接，弹出运行监视配置窗口，如下图：选择“URL监视”标签页，页面列表显示当前应用中已添加的URL监视信息，在URL文本输入框中输入需要监视的URL地址（例如：模块名+REST服务名，/gov/rest/stfs/app，也可以使用*模糊匹配URL地址，如：/gov/rest/stfs/app/*），点击“添加”按钮，添加URL地址监视成功，如下图：3.15.2 删除URL监视打开URL监视窗口，选中待删除的URL，点击“删除”按钮，弹出删除URL监视确认窗口，点击“确定”按钮删除URL监视，如下图：3.15.3 清空URL监视打开URL监视窗口，选中待删除的URL，点击“清空”按钮，弹出清空URL监视确认窗口，点击“确定”按钮清空URL监视，如下图：3.15.4 URL分析在系统左侧某一应用域中点击“URL分析”菜单，页面右侧显示所有已添加监听URL的平均、最短、最长响应时间信息，如下图：3.15.5 URL详情选中某一个URL地址，右键弹出菜单中选择“详细”按钮，弹出URL的详细信息列表，如下图所示：3.16 数据源监视系统左侧某一应用域中点击“监视与分析”-“数据源监视”菜单，右侧区域显示数据源监视信息，如下图：3.16.1 添加新的数据源配置若在“通用配置”- “数据源配置”页配置了JNDI数据源，则进入数据源监视页面，会弹出请配置数据源的提示，如下图：点击“配置数据源”按钮，弹出“数据源配置”对话框，设置数据库类型、地址、端口、实例名等信息，点击“保存”按钮，新增数据源连接，如下图：3.16.2 修改数据源配置右击已配置好的数据源，点击“编辑数据源”菜单，弹出“数据源配置”对话框，可对数据源信息进行修改，点击“保存”按钮，保存对数据源信息的修改，如下图：3.16.3 测试数据源连接对于配置好的数据源，在数据源配置对话框中，点击“测试”按钮，系统会给出测试成功或失败的提示，如下图：3.17 应用会话统计当应用集成ISC接口，并且正常发布后。可以在治理工具应用会话统计查询当前应用回话数和在线用户数。下图为通过治理工具发布的集成ISC接口的应用app1。未有人访问。登录应用app1，并且输入用户名:uapuser/密码:novell,正常访问应用后。会话数和在线用户数分别为1和1。3.18 治理工具预警总览3.18.1 预警总览界面当点击页面右上角的切换按钮。进入预警总览界面3.18.2 添加监控域预警总览页面只监控“启用预警监控”域。3.18.3 删除系统点击系统左上角的X，可以删除系统3.18.4 切换到关心系统配置界面点击系统名，可以切换到该系统配置页面配置页面显示预警界面点击的系统详细信息。3.18.5 查看服务器信息点击图上红色标记位置，可以查看服务器静态信息点击图上位置，可以查看服务器动态信息3.18.6 查看中间件信息点击图上红色标记位置，可以查看中间件