1、 福建福诺移动通信技术有限公司无线城市系统维护手册（新浪微博）版 本 号 V1.0日 期 2012-04-05作 者 傅子文审 核批 准福建福诺移动通信技术有限公司2/22福州派克斯网络科技有限公司 地 址:福州市台江区五一中路 57 号闽东大厦十一层 邮 编：350005电 话:0591-87115625 87115671 87115627 传 真:0591-83339936 网 址：修订历史记录版本号 日期 作者 修订要点V1.00 2012-04-05 傅子文 新整理3/22福州派克斯网络科技有限公司 地 址:福州市台江区五一中路 57 号闽东大厦十一层 邮 编：350005电 话:05
2、91-87115625 87115671 87115627 传 真:0591-83339936 网 址：目 录1 系统运行环境 51.1 硬件配置及系统软件 51.2 网络结构图 62 系统功能说明 73 软件模块结构图 74 软件安装说明 84.1 模块列表说明 84.2 X1 模块 94.3 X2 模块 95 配置文件说明 96 启动及停止说明 96.1 程序手工启动 96.2 程序手工停止 96.3 程序运行状态查看 97 周边接口 107.1 与 XXX 平台接口 .108 维护说明 108.1 日常维护监控点 108.1.1 查看进程是否运行 .108.1.2 程序运行日志巡查 .1
3、08.1.3 错误日志表的监控 .108.1.4 业务流程监控 .118.2 定期的数据备份和清理 118.2.1 表数据清理 .118.2.2 程序日志清理 .118.3 数据库相关维护说明 124/22福州派克斯网络科技有限公司 地 址:福州市台江区五一中路 57 号闽东大厦十一层 邮 编：350005电 话:0591-87115625 87115671 87115627 传 真:0591-83339936 网 址：8.3.1 数据库 JOB 的说明 .128.3.2 数据配置操作说明 .129 常见问题分析和跟踪 135/22福州派克斯网络科技有限公司 地 址:福州市台江区五一中路 57
4、 号闽东大厦十一层 邮 编：350005电 话:0591-87115625 87115671 87115627 传 真:0591-83339936 网 址：1 系统运行环境【 填写系统需要的硬件和软件环境，如果不是单列系统，此处可省略 】1.1 硬件配置及系统软件 硬件配置节点 设备 规格描述 系统软件(操作系统及数据库) 数量 运行环境(编译环境及第三方支持软件)数据库服务器 PP650CPU:81.98GHz内存:16GB磁盘:273GBSolaris9，Oracle9i 企业版 (2cpu)2存储设备 磁盘阵列 10146GB HDD 1业务处理服务器 DL380CPU:43.0GHz内
5、存:4GB磁盘:373GBRedheat AS3.0操作系统，oracle 客户端2DCC 运行环境:gcc(GCC)3.4.3boost_1_33_0openssl-0.9.8xerces-c-src_2_7_0ACE-5.5Opendiameter-1.0.7-h业务处理模块运行环境:Interstage v7JDK1.4eclipse.exe网管服务器 DL380CPU:43.0GHz内存:4GB磁盘:373GBRedheat AS3.0操作系统，oracle 9i 服务器，oracle客户端1WEBNMS 7.0可编程交换机 EXCEL一块信令卡、一块中继卡、两块 DSP2 卡 Red
6、heat AS3.0操作系统 2IVR 接入服务器 PC 服务器Redheat AS3.0操作系统 2ACE-5.56/22福州派克斯网络科技有限公司 地 址:福州市台江区五一中路 57 号闽东大厦十一层 邮 编：350005电 话:0591-87115625 87115671 87115627 传 真:0591-83339936 网 址：防火墙 NeTrust 8 个 100 兆以太口 Redheat AS3.0操作系统 2 第三方软件软件名称 说明 数量 备注Oracle9i Oracle9i 企业版 (2cpu) 1Fujitsu IAS Plus v7 For LinuxFujitsu
7、 Interstage Application Server Plus v7(2cpu） 1WebNMS runtime Web NMS 4.7 standard edition runtime 1Linux AS Linux AS 4.0 u5 7Veritas VCS VCS for oracle9i for linux 1 如需数据库主 备Lifekeeper 用于业务处理服务器 HA 2 如需主备方案7/22福州派克斯网络科技有限公司 地 址:福州市台江区五一中路 57 号闽东大厦十一层 邮 编：350005电 话:0591-87115625 87115671 87115627 传 真
8、:0591-83339936 网 址：1.2 业务流程图未登录用户分享流程新浪无线城市平台显示分享成功用户输入微博账号密码登录提示用户登录 ， 并显示登录框用户单击 “ 微博分享 ” 图标是否需要用户登录无线城市平台 ？编辑分享内容 ， 单击 “ 分享 ”进入已登录用户分享流程用户选择登录无线城市 ？用户登录无线城市平台是是否否8/22福州派克斯网络科技有限公司 地 址:福州市台江区五一中路 57 号闽东大厦十一层 邮 编：350005电 话:0591-87115625 87115671 87115627 传 真:0591-83339936 网 址：已登录用户分享流程新浪无线城市平台编辑分享内
9、容 ， 进行分享显示分享成功 ， 保存分享结果参数用户单击 “ 微博分享 ” 图标是否已授权 ？ 用户授权绑定否是2 系统功能说明 功能描述: 用户在 WAP 网站点击新浪微博分享按钮，可将无线城市平台相关的内容发布至用户的新浪微博，与他们的微博好友共同分享。分享支持授权和微分享两种模式。授权模式指的是用户在无线城市登录后与新浪账号授权绑定，此后用户无需输入新浪账号和密码可直接进行分享。微分享模式针对的是游客，每次分享都需要输入账号、密码。 主要功能点如下：实现功能 功能具体描述增加分享按钮界面各地市平台首页，应用首页，活动专区的活动介绍页面添加“分享到微博”按钮或链接登录或未登录用户分享流程
10、处理1、 已登录无线城市用户点击分享后，判断用户是否已授权，未授权则授权处理，已授权则进入编辑分享内容界面。2、 未登陆用户让用户选择登陆或直接登陆新浪微博进行分享。9/22福州派克斯网络科技有限公司 地 址:福州市台江区五一中路 57 号闽东大厦十一层 邮 编：350005电 话:0591-87115625 87115671 87115627 传 真:0591-83339936 网 址：注册用户授权绑定功能无线城市用户登录后可与新浪微博账号进行绑定，分享时不必登录新浪微博。授权有效期为 7 天，失效后需重新申请授权并更新授权信息。分享功能 把应用或活动的分享内容提交至新浪微博。微分享功能 登
11、录新浪微博，并将分享参数传送至新浪分享界面，最后提交至新浪微博。返回浏览原页面 根据新浪接口返回的地址映射串获取保存的原分享的页面 url，并跳转至该 url 所在页面。分享日志及地址映射信息记录分享提交至新浪微博时记录相关分享信息。分享次数统计 对应的应用、资讯、首页等被分享的次数与新浪的接口 1. 请求用户授权 Token 接口。2.发布一条微博信息接口。3.短链接接口。4.分享次数接口。5.获取 Token 接口详见新浪微博分享_概要设计说明书.doc3 软件模块结构图无 线 城 市W A P 门 户W E B 门 户 外 部 系 统新浪微博系统新浪微博系统微博授权ht tp微 博 授
12、权 接 口 模块http授权处理取消授权处理http发布分享分享次数查询获取短连接授权 t o k e n 查询微博授权发布分享分享次数查询获取短连接授权 t o k e n 查询h t t ph t t p注：由于无线城市作为一个应用接入新浪微博，因此只能有一个授权回调地址供新浪微博调用，为此独立出微博授权接口模块。具体业务说明：10/22福州派克斯网络科技有限公司 地 址:福州市台江区五一中路 57 号闽东大厦十一层 邮 编：350005电 话:0591-87115625 87115671 87115627 传 真:0591-83339936 网 址：1) 门户发起授权请求，并跳转到新浪授
13、权页面：A：用户输入微博账号，验证成功，由新浪授权页面进入模块，并带回 state 参数和微博 code；B：用户取消授权，新浪授权页面直接进入模块（取消授权新浪不带参数） ；2) 模块判断新浪回调是否带有 state 参数和微博 code：A：如果没有参数，表明用户取消授权或其它非法访问，模块获取 UA 信息，根据访问类型自动跳转到 web 门户或 wap 门户；B：有参数的情况，模块根据获得的 code 再次请求新浪获取微博用户 token。成功得到 token 后关联 state 参数中传递的 userid 保存入库；3) 授权信息保存成功后：模块将 token 信息放入 state 参
14、数中，根据访问类型回传到 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 字
15、段。日志记录：日志统一存入 H2 内存数据库，再进行日志迁移1.错误日志记录错误日志统一记录导门户 TB_ERROR_LOG 表中，错误编码参见无线城市- 错误编码.doc ，具体如下：1600 用户非法访问 OAUTH_ACCESS_ERROR 2 微博授权接口1601 State 解析出错OAUTH_RET_DATA_DECODED_ERROR 2 微博授权接口1602 Token 获取失败OAUTH_GET_TOKEN_ERROR 2 微博授权接口1603 保存授权信息失败 OAUTH_SAVE_ERROR 2 微博授权接口时序图：1) 用户授权：登录用户分享：11/22福州派克斯网络科
16、技有限公司 地 址:福州市台江区五一中路 57 号闽东大厦十一层 邮 编：350005电 话:0591-87115625 87115671 87115627 传 真:0591-83339936 网 址：用户 / 手机 门户新浪1 、 用户点击分享至微博2 、 判断用户是否已授权发起用户授权请求返回授权处理结果未授权3 、 提示用户编辑分享内容4 、 用户编辑分享内容 ， 并提交6 、 返回分享结果5 、 记录分享地址映射串并提交分享至新浪微博7 、 记录分享日志 ， 并提示分享结果及返回继续浏览记录用户授权关系信息判断授权是否失效是否失效未登录用户分享：12/22福州派克斯网络科技有限公司 地
17、 址:福州市台江区五一中路 57 号闽东大厦十一层 邮 编：350005电 话:0591-87115625 87115671 87115627 传 真:0591-83339936 网 址：用户 / 手机 门户新浪1 、 用户点击分享至微博用户选择登录无线城市2 、 提示用户选择 ： a 、 登录无线城市 b 、 登录新浪微博3 、 用户点击登录无线城市门户4 、 提示输入无线城市用户名 、 密码 ； 或点击登录新浪微博5 、 用户输入用户 、 密码并提交注 ： 登录成功后 ， 后续流程同登录用户分享流程用户选择登录新浪微博3 、 用户点击登录新浪微博5 、 提示输入用户名 、 密码6 、 用户
18、输入用户名 、 密码7 、 提示编辑分享内容8 、 用户编辑并提交分享内容9 、 提示分享成功 ， 并返回继续浏览1 0 、 用户点击 “ 返回继续浏览 ”1 1 、 新浪微博重定向至无线城市门户4 、 记录分享地址映射信息 ， 重定向新浪微博并传送分享参数1 2 、 记录分享日志 ， 并返回原分享界面用户若未返回继续浏览 ， 分享日志无法记录 。 需通过接口实时查询分享结果来记录分享日志 ？2) 授权取消：13/22福州派克斯网络科技有限公司 地 址:福州市台江区五一中路 57 号闽东大厦十一层 邮 编：350005电 话:0591-87115625 87115671 87115627 传
19、真:0591-83339936 网 址：4 软件安装说明【 软件安装说明，不包括第三方软件的安装 】4.1 模块列表说明模块名 程序名 功能描述 所处主机P1X1 模块P2X2 模块 P314/22福州派克斯网络科技有限公司 地 址:福州市台江区五一中路 57 号闽东大厦十一层 邮 编：350005电 话:0591-87115625 87115671 87115627 传 真:0591-83339936 网 址：4.2 X1 模块【 X1 模块安装说明，包括安装详细步骤 】4.3 X2 模块【 X2 模块安装说明，包括安装详细步骤 】5 配置文件说明【 XX 模块配置说明，软件安装完成后的配置
20、，包括数据库配置表的配置，程序参数的配置等 】wcity-weibo.properties#sina微博相关配置#OAUTH_URL=https:/ 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 twhere t.user_id = 31364and t.weibo_pa
21、rtner = 1and 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福州派克斯网络科技有
22、限公司 地 址:福州市台江区五一中路 57 号闽东大厦十一层 邮 编：350005电 话:0591-87115625 87115671 87115627 传 真:0591-83339936 网 址：8.2 定期的数据备份和清理【 数据的备份信息，以及数据清理信息 ,包括程序的数据和日志信息备份清理，以及数据库表的备份和清理，数据没有备份的，只需要写明历史数据清理流程 】8.2.1表数据清理根据要求，T1，T2,表内存的信息保存一年，一年以前的数据将删除掉。每个月的月底对数据清理一次。 注：存储过程调用的时候参数为空默认为清理一年之前的数据，也可以输入一个固定的时间，存储过程则会清理此时间之前的
23、所有历史数据。调用 crontab:01 02 28 * * /archlog11/code/del_history_data.shdel_history_data.sh:export ORACLE_BASE=/home/oracleexport ORACLE_HOME=$ORACLE_BASE/product/10.2.0/db_1export ORA_CRS_HOME=$ORACLE_BASE/crs export ORACLE_SID=uvc1 export PATH=.:$PATH:$HOME/bin:$ORACLE_HOME/bin:$ORA_CRS_HOME/bin export
24、TNS_ADMIN=$ORACLE_HOME/network/admin export NLS_LANG=“American_America.ZHS16GBK“export NLS_DATE_FORMAT=yyyymmdd hh24:mi:sssqlplus -s fjuvc/fjuvcuvc !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福州派克斯网络科技有限
25、公司 地 址:福州市台江区五一中路 57 号闽东大厦十一层 邮 编：350005电 话:0591-87115625 87115671 87115627 传 真:0591-83339936 网 址：8.3 数据库相关维护说明【 数据库中存储过程， job 的说明以及运行情况监控。不包含数据库系统级别的监控，比如表空间使用等，这部分内容在数据库维护手册里面体现 】8.3.1数据库 JOB 的说明JOB 编号 实现功能说明 调度时间 失败监控方法 失败处理方法100 完成表 T1 历史数据的清理每日 0:10 1) JOB 调用存储过程失败，会在日志表T_ERRLOG写错误记录。2) JOB 执行成
26、功，会把表T1，一周之前的数据清除。监控T1 表数据情况，也知道调度是否成功。JOB 运行失败，查找原因，手动再次执行即可。101 完成 XX 业务流程没 10 分钟运行一次1) JOB 调用存储过程失败，会在日志表T_ERRLOG写错误记录。JOB 失败，将影响业务逻辑，需要手动处理。及时联系开发人员。8.3.2数据配置操作说明微博授权表: tb_weibo_oauth 微博分享设置: Tb_Weibo_Setting 微博分享模板: tb_weibo_template 微博分享信息表:tb_weibo_share22/22福州派克斯网络科技有限公司 地 址:福州市台江区五一中路 57 号闽东大厦十一层 邮 编：350005电 话:0591-87115625 87115671 87115627 传 真:0591-83339936 网 址：门户用户:TB_PORTAL_USER9 常见问题分析和跟踪微博分享支持授权和微分享两种模式。如果是授权模式只能用手机号码登录，且用户名长度为 6-30 位，登录后与新浪账号绑定，此后用户无需输入新浪账号和密码可直接进行分享如果是微分享模式，可以不用登陆直接分享，每次分享都需要输入微博账号、密码
