维护手册(模板).doc

福建福诺移动通信技术有限公司福建福诺移动通信技术有限公司 无线城市系统维护手册无线城市系统维护手册 新浪微博 版 本 号 V1 0 日 期 2012 04 05 作 者傅子文 审 核 批 准 福建福诺移动通信技术有限公司 2 22 福州派克斯网络科技有限公司 地 址 福州市台江区五一中路 57 号闽东大厦十一层 邮 编 350005 电 话 0591 87115625 87115671 87115627 传 真 0591 83339936 网 址 修订历史记录修订历史记录 版本号日期作者修订要点 V1 002012 04 05 傅子文新整理 3 22 福州派克斯网络科技有限公司 地 址 福州市台江区五一中路 57 号闽东大厦十一层 邮 编 350005 电 话 0591 87115625 87115671 87115627 传 真 0591 83339936 网 址 目目 录录 1系统运行环境系统运行环境 5 1 1硬件配置及系统软件硬件配置及系统软件 5 1 2网络结构图网络结构图 6 2系统功能说明系统功能说明 7 3软件模块结构图软件模块结构图 7 4软件安装说明软件安装说明 8 4 14 1模块列表说明模块列表说明 8 4 2X1 模块模块 9 4 3X2 模块模块 9 5配置文件说明配置文件说明 9 6启动及停止说明启动及停止说明 9 6 1程序手工启动程序手工启动 9 6 2程序手工停止程序手工停止 9 6 3程序运行状态查看程序运行状态查看 9 7周边接口周边接口 10 7 1与与 XXX 平台接口平台接口 10 8维护说明维护说明 10 8 1日常维护监控点日常维护监控点 10 8 1 1查看进程是否运行查看进程是否运行 10 8 1 2程序运行日志巡查程序运行日志巡查 10 8 1 3错误日志表的监控错误日志表的监控 10 8 1 4业务流程监控业务流程监控 11 8 2定期的数据备份和清理定期的数据备份和清理 11 8 2 1表数据清理表数据清理 11 8 2 2程序日志清理程序日志清理 11 8 3数据库相关维护说明数据库相关维护说明 12 4 22 福州派克斯网络科技有限公司 地 址 福州市台江区五一中路 57 号闽东大厦十一层 邮 编 350005 电 话 0591 87115625 87115671 87115627 传 真 0591 83339936 网 址 8 3 1数据库数据库 JOB 的说明的说明 12 8 3 2数据配置操作说明数据配置操作说明 12 9 9常见问题分析和跟踪常见问题分析和跟踪 13 5 22 福州派克斯网络科技有限公司 地 址 福州市台江区五一中路 57 号闽东大厦十一层 邮 编 350005 电 话 0591 87115625 87115671 87115627 传 真 0591 83339936 网 址 1 1 系统运行环境系统运行环境 填写系统需要的硬件和软件环境 如果不是单列系统 此处可省略填写系统需要的硬件和软件环境 如果不是单列系统 此处可省略 1 11 1 硬件配置及系统软件硬件配置及系统软件 硬件配置 节点节点设备设备规格描述规格描述 系统软件系统软件 操作操作 系统及数据库系统及数据库 数量数量运行环境运行环境 编译环境及第三编译环境及第三 方支持软件方支持软件 数据库服 务器 PP650 CPU 8 1 98 GHz 内存 16GB 磁盘 2 73GB Solaris9 Orac le9i 企业版 2cpu 2 存储设备磁盘阵列 10 146GB HDD 1 业务处理 服务器 DL380 CPU 4 3 0G Hz 内存 4GB 磁盘 3 73GB Redheat AS3 0 操作系统 oracle 客户端 2 DCC 运行环境 gcc GCC 3 4 3 boost 1 33 0 openssl 0 9 8 xerces c src 2 7 0 ACE 5 5 Opendiameter 1 0 7 h 业务处理模块运行环境 Interstage v7 JDK1 4 eclipse exe 网管服务 器 DL380 CPU 4 3 0G Hz 内存 4GB 磁盘 3 73GB Redheat AS3 0 操作系统 oracle 9i 服 务器 oracle 客户端 1 WEBNMS 7 0 可编程交 换机 EXCEL 一块信令卡 一块中继卡 两块 DSP2 卡 Redheat AS3 0 操作系统 2 IVR 接入 服务器 PC 服务器 Redheat AS3 0 操作系统 2 ACE 5 5 6 22 福州派克斯网络科技有限公司 地 址 福州市台江区五一中路 57 号闽东大厦十一层 邮 编 350005 电 话 0591 87115625 87115671 87115627 传 真 0591 83339936 网 址 防火墙NeTrust 8 个 100 兆以 太口 Redheat AS3 0 操作系统 2 第三方软件 软件名称软件名称说明说明数量数量备注备注 Oracle9i Oracle9i 企业版 2cpu 1 Fujitsu IAS Plus v7 For Linux Fujitsu Interstage Application Server Plus v7 2cpu 1 WebNMS runtimeWeb NMS 4 7 standard edition runtime1 Linux ASLinux AS 4 0 u57 Veritas VCSVCS for oracle9i for linux1 如需数据库主 备 Lifekeeper 用于业务处理服务器 HA 2 如需主备方案 7 22 福州派克斯网络科技有限公司 地 址 福州市台江区五一中路 57 号闽东大厦十一层 邮 编 350005 电 话 0591 87115625 87115671 87115627 传 真 0591 83339936 网 址 1 21 2 业务流程图业务流程图 未登录用户分享流程 新浪无线城市平台 显示分享成功 用户输入微博账号 密码登录 提示用户登录 并 显示登录框 用户单击 微博分 享 图标 是否需要用户 登录无线城市 平台 编辑分享内容 单 击 分享 进入已登录用户分 享流程 用户选择登录 无线城市 用户登录无线城市 平台 是 是 否 否否 8 22 福州派克斯网络科技有限公司 地 址 福州市台江区五一中路 57 号闽东大厦十一层 邮 编 350005 电 话 0591 87115625 87115671 87115627 传 真 0591 83339936 网 址 已登录用户分享流程 新浪无线城市平台 编辑分享内容 进 行分享 显示分享成功 保 存分享结果参数 用户单击 微博分 享 图标 是否已授权 用户授权绑定否 是 2 2 系统功能说明系统功能说明 功能描述功能描述 用户在 WAP 网站点击新浪微博分享按钮 可将无线城市平台相关的内容发布 至用户的新浪微博 与他们的微博好友共同分享 分享支持授权和微分享两种 模式 授权模式指的是用户在无线城市登录后与新浪账号授权绑定 此后用户 无需输入新浪账号和密码可直接进行分享 微分享模式针对的是游客 每次分 享都需要输入账号 密码 主要功能点如下 主要功能点如下 实现功能功能具体描述 增加分享按钮界面 各地市平台首页 应用首页 活动专区的活动介绍页面添加 分 享到微博 按钮或链接 登录或未登录用户分 享流程处理 1 已登录无线城市用户点击分享后 判断用户是 否已授权 未授权则授权处理 已授权则进入 编辑分享内容界面 2 未登陆用户让用户选择登陆或直接登陆新浪微 博进行分享 9 22 福州派克斯网络科技有限公司 地 址 福州市台江区五一中路 57 号闽东大厦十一层 邮 编 350005 电 话 0591 87115625 87115671 87115627 传 真 0591 83339936 网 址 注册用户授权绑定功 能 无线城市用户登录后可与新浪微博账号进行绑定 分享时不必登 录新浪微博 授权有效期为授权有效期为 7 天 失效后需重新申请授权并更新天 失效后需重新申请授权并更新 授权信息 授权信息 分享功能把应用或活动的分享内容提交至新浪微博 微分享功能登录新浪微博 并将分享参数传送至新浪分享界面 最后提交至 新浪微博 返回浏览原页面根据新浪接口返回的地址映射串获取保存的原分享的页面 url 并 跳转至该 url 所在页面 分享日志及地址映射 信息记录 分享提交至新浪微博时记录相关分享信息 分享次数统计对应的应用 资讯 首页等被分享的次数 与新浪的接口1 请求用户授权 Token 接口 2 发布一条微博信息接口 3 短链 接接口 4 分享次数接口 5 获取 Token 接口 详见 新浪微博分享 概要设计说明书 doc 3 3 软件模块结构图软件模块结构图 无无线线城城市市 WAP门门户户 WEB门门户户外外部部系系统统 新浪微博系统 新浪微博系统 微博授权 http 微微博博授授权权接接口口模模 块块 http 授权处理 取消授权处理 http 发布分享 分享次数查询 获取短连接 授权token查询 微博授权 发布分享 分享次数查询 获取短连接 授权token查询 http http 注 由于无线城市作为一个应用接入新浪微博 因此只能有一个授权回调地址供新浪微博调 用 为此独立出微博授权接口模块 具体业务说明 具体业务说明 10 22 福州派克斯网络科技有限公司 地 址 福州市台江区五一中路 57 号闽东大厦十一层 邮 编 350005 电 话 0591 87115625 87115671 87115627 传 真 0591 83339936 网 址 1 门户发起授权请求 并跳转到新浪授权页面 A 用户输入微博账号 验证成功 由新浪授权页面进入模块 并带回 state 参数和 微博 code B 用户取消授权 新浪授权页面直接进入模块 取消授权新浪不带参数 2 模块判断新浪回调是否带有 state 参数和微博 code A 如果没有参数 表明用户取消授权或其它非法访问 模块获取 UA 信息 根据 访问类型自动跳转到 web 门户或 wap 门户 B 有参数的情况 模块根据获得的 code 再次请求新浪获取微博用户 token 成功 得到 token 后关联 state 参数中传递的 userid 保存入库 3 授权信息保存成功后 模块将 token 信息放入 state 参数中 根据访问类型回传到 web 或 wap 门户 数据格式 数据格式 1 state 加密前的数据格式为 json 串 门户和模块解密后直接转换为 map 使用 2 门户跳转到新浪授权传递 state 参数 除了各自需要保持会话用到的参数 必须传递门 户用户的账户 ID 名称为 userid 用于授权成功后模块关联保存授权信息 3 模块授权保存成功后传递给门户 state 参数加入微博授权 token 和 token 的类型 名称 为access token 和 token type 4 其中 token type 的值对应数据库中 TB WEIBO OAUTH表的 WEIBO PARTNER字段 日志记录 日志记录 日志统一存入 H2 内存数据库 再进行日志迁移 1 错误日志记录 错误日志统一记录导门户 TB ERROR LOG 表中 错误编码参见 无线城市 错误编码 doc 具体如下 1600用户非法访问OAUTH ACCESS ERROR2微博授权接口 1601State 解析出错 OAUTH RET DATA DEC ODED ERROR2微博授权接口 1602Token 获取失败 OAUTH GET TOKEN ER ROR2微博授权接口 1603保存授权信息失败OAUTH SAVE ERROR2微博授权接口 时序图 时序图 1 用户授权 登录用户分享 11 22 福州派克斯网络科技有限公司 地 址 福州市台江区五一中路 57 号闽东大厦十一层 邮 编 350005 电 话 0591 87115625 87115671 87115627 传 真 0591 83339936 网 址 用户 手机门户新浪 1 用户点击分享至微博 2 判断用户是否已授权 发起用户授权请求 返回授权处理结果 未授权 3 提示用户编辑分享内容 4 用户编辑分享内容 并提交 6 返回分享结果 5 记录分享地址映射串并提交分享至新浪微博 7 记录分享日志 并提示分享结果及返回继续浏览 记录用户授权关系信息 判断授权是否失效 是否失效 未登录用户分享 12 22 福州派克斯网络科技有限公司 地 址 福州市台江区五一中路 57 号闽东大厦十一层 邮 编 350005 电 话 0591 87115625 87115671 87115627 传 真 0591 83339936 网 址 用户 手机门户新浪 1 用户点击分享至微博 用户选择登录无线城市 2 提示用户选择 a 登录无线城市 b 登录新浪微博 3 用户点击登录无线城市门户 4 提示输入无线城市用户名 密码 或点击登录新浪微博 5 用户输入用户 密码并提交 注 登录成功后 后续流程同登录用户分享流程 用户选择登录新浪微博 3 用户点击登录新浪微博 5 提示输入用户名 密码 6 用户输入用户名 密码 7 提示编辑分享内容 8 用户编辑并提交分享内容 9 提示分享成功 并返回继续浏览 10 用户点击 返回继续浏览 11 新浪微博重定向至无线城市门户 4 记录分享地址映射信息 重定向新浪微博并传送分享参数 12 记录分享日志 并返回原分享界面 用户若未返回继续浏 览 分享日志无法记 录 需通过接口实时查 询分享结果来记录分享 日志 2 授权取消 13 22 福州派克斯网络科技有限公司 地 址 福州市台江区五一中路 57 号闽东大厦十一层 邮 编 350005 电 话 0591 87115625 87115671 87115627 传 真 0591 83339936 网 址 4 4 软件安装说明软件安装说明 软件安装说明 不包括第三方软件的安装软件安装说明 不包括第三方软件的安装 4 14 1 模块列表说明模块列表说明 模块名模块名程序名程序名功能描述功能描述所处所处 主机主机 P1 X1 模块 P2 X2 模块 P3 14 22 福州派克斯网络科技有限公司 地 址 福州市台江区五一中路 57 号闽东大厦十一层 邮 编 350005 电 话 0591 87115625 87115671 87115627 传 真 0591 83339936 网 址 4 24 2 X1X1 模块模块 X1模块安装说明 包括安装详细步骤 4 34 3 X2X2 模块模块 X2模块安装说明 包括安装详细步骤 5 5 配置文件说明配置文件说明 XX模块配置说明 软件安装完成后的配置 包括数据库配置表的配置 程序 参数的配置等 wcity weibo properties sina微博相关配置 OAUTH URL Type 分享类型 1 应用 2 活动 3 页面 4 专栏 2 查询用户查询用户 select from tb portal user a where a mobile and a password 说明 微博分享时要先用手机号码登陆 根据手机号码和密码查询该用户是否存 在 3 微博授权微博授权 select from select from tb weibo oauth t where t user id 31364 and t weibo partner 1 and t update time sysdate 7 order by update time desc where rownum 2 说明 查询用户是否已授权 如果查询无数据说明用户还未授权 授权有效期超过七天 需重 新授权 user id 用户 ID weibo partner 1 表示支持新浪微博 8 1 3错误日志表的监控 数据库用户中应该有一个错误日志表 存储过程等异常处理 都要写错误日志 到此表 要经常监控 以及错误编码的含义 在此节体现 8 1 4业务流程监控 系统主要的业务流程 罗列出来 并写出对应监控方法 以及预期结果 20 22 福州派克斯网络科技有限公司 地 址 福州市台江区五一中路 57 号闽东大厦十一层 邮 编 350005 电 话 0591 87115625 87115671 87115627 传 真 0591 83339936 网 址 8 28 2 定期的数据备份和清理定期的数据备份和清理 数据的备份信息 以及数据清理信息 包括程序的数据和日志信息备份清理 以 及数据库表的备份和清理 数据没有备份的 只需要写明历史数据清理流程 8 2 1表数据清理 根据要求 T1 T2 表内存的信息保存一年 一年以前的数据将删除掉 每个月的月 底对数据清理一次 注 存储过程调用的时候参数为空默认为清理一年之前的数据 也可以输入一个固定的 时间 存储过程则会清理此时间之前的所有历史数据 调用 crontab 01 02 28 archlog11 code del history data sh del history data sh export ORACLE BASE home oracle export ORACLE HOME ORACLE BASE product 10 2 0 db 1 export ORA CRS HOME ORACLE BASE crs export ORACLE SID uvc1 export PATH PATH HOME bin ORACLE HOME bin ORA CRS HOME bin export TNS ADMIN ORACLE HOME network admin export NLS LANG American America ZHS16GBK export NLS DATE FORMAT yyyymmdd hh24 mi ss sqlplus s fjuvc fjuvc uvc execute p del cz history execute p del card info history execute p del card auth history execute p del sms history 8 2 2程序日志清理 21 22 福州派克斯网络科技有限公司 地 址 福州市台江区五一中路 57 号闽东大厦十一层