福建福诺移动通信技术有限公司无线城市系统维护手册(新浪微博)福建福诺移动通信技术有限公司修订历史记录目录1.1............................. 硬件配置及系统软件1.2..................................... 网络结构图2系统功能说明..................................................... 3软件模块结构图................................................... 4软件安装说明.....................................................4.1................................... 模块列表说明4.2......................................... X1模块4.3......................................... X2模块5配置文件说明..................................................... 6启动及停止说明...................................................6.1................................... 程序手工启动6.2................................... 程序手工停止6.3............................... 程序运行状态查看7周边接口.........................................................7.1................................. 与XXX平台接口8维护说明.........................................................8.1................................. 日常维护监控点8.1.1.......................... 查看进程是否运行8.1.2.......................... 程序运行日志巡查8.1.3.......................... 错误日志表的监控8.1.4.............................. 业务流程监控8.2........................... 定期的数据备份和清理8.2.1................................ 表数据清理8.2.2.............................. 程序日志清理8.3............................. 数据库相关维护说明8.3.1.......................... 数据库JOB的说明8.3.2.......................... 数据配置操作说明9常见问题分析和跟踪 ............................................... 1系统运行环境【填写系统需要的硬件和软件环境,如果不是单列系统,此处可省略】1.1硬件配置及系统软件➢硬件配置节点设备规格描述系统软件(操作系统及数据库)数量运行环境(编译环境及第三方支持软件)数据库服务器PP650CPU:8×1.98GHz内存:16GB磁盘:2×73GBSolaris9,Oracle9i企业版(2cpu)2存储设磁盘阵10× 1备列146GBHDD 业务处理服务器DL380CPU:4×3.0GHz内存:4GB磁盘:3×73GBRedheatAS3.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业务处理模块运行环境:Interstagev7JDK1.4eclipse.exe网管服务器DL380CPU:4×3.0GHz内存:4GB磁盘:3×73GBRedheatAS3.0操作系统,oracle9i服务器,oracle客户端1WEBNMS7.0可编程交换机EXCEL一块信令卡、一块中继卡、两块RedheatAS3.0操作系统2DSP2卡IVR接入服务器PC服务器RedheatAS3.0操作系统2ACE-5.5防火墙NeTrust8个100兆以太口RedheatAS3.0操作系统2➢第三方软件1.2业务流程图2系统功能说明✧功能描述:◆用户在WAP网站点击新浪微博分享按钮,可将无线城市平台相关的内容发布至用户的新浪微博,与他们的微博好友共同分享。
分享支持授权和微分享两种模式。
授权模式指的是用户在无线城市登录后与新浪账号授权绑定,此后用户无需输入新浪账号和密码可直接进行分享。
微分享模式针对的是游客,每次分享都需要输入账号、密码。
✧主要功能点如下:3软件模块结构图注:由于无线城市作为一个应用接入新浪微博,因此只能有一个授权回调地址供新浪微博调用,为此独立出微博授权接口模块。
具体业务说明: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》,具体如下:时序图:1)用户授权:登录用户分享:未登录用户分享:2)授权取消:4软件安装说明【软件安装说明,不包括第三方软件的安装】4.1模块列表说明4.2X1模块【X1模块安装说明,包括安装详细步骤】4.3X2模块【X2模块安装说明,包括安装详细步骤】5配置文件说明【XX模块配置说明,软件安装完成后的配置,包括数据库配置表的配置,程序参数的配置等】6启动及停止说明【程序的手动启动和停止步骤,】6.1程序手工启动【程序的手动启动的步骤,】6.2程序手工停止【程序的手动停止步骤,】6.3程序运行状态查看【程序的运行状态的查看,包括正常情况下的状态是什么,包括系统进程等。
,】7周边接口7.1与新浪平台接口7.1.1请求用户授权Token✧接口描述:用户在无线城市登陆后与新浪账号绑定,此后用户无需输入新浪账号和密码可直接进行分享,授权有效期为7天,失效后需重新申请授权并更新授权信息。
✧请求参数7.1.2发布一条微博信息✧接口描述:用户在WAP网站点击新浪微博分享按钮,可将无线城市平台相关的内容发布至用户的新浪微博✧请求参数7.1.3短链接✧接口描述:将一个或多个长链接转成短链接✧请求参数7.1.4分享转发次数✧接口描述:取得一个短链接在微博上的微博分享数✧请求参数7.1.5获取Token✧接口描述:获取授权过的AccessToken✧请求参数grant_type为authorization_code时grant_type为password时8维护说明8.1日常维护监控点【系统的日常监控点,监控方法。
下面罗列几点,如有更多的监控点,都需要依次罗列】8.1.1查看进程是否运行【查看程序的主要后台进程】登录平台各个服务器,运行命令行命令查看。
若是unix服务器,命令为:ps–ef|grep进程名若是windows服务器,通过任务管理器查看相应进程是否存在。
8.1.2程序运行日志巡查在。
3.微博授权说明:查询用户是否已授权,如果查询无数据说明用户还未授权,授权有效期超过七天,需重新授权user_id:用户ID,weibo_partner=1:表示支持新浪微博8.1.3错误日志表的监控【数据库用户中应该有一个错误日志表,存储过程等异常处理,都要写错误日志到此表,要经常监控,以及错误编码的含义,在此节体现。
】8.1.4业务流程监控【系统主要的业务流程,罗列出来,并写出对应监控方法,以及预期结果】8.2定期的数据备份和清理【数据的备份信息,以及数据清理信息,包括程序的数据和日志信息备份清理,以及数据库表的备份和清理,数据没有备份的,只需要写明历史数据清理流程】8.2.1表数据清理根据要求,T1,T2,…表内存的信息保存一年,一年以前的数据将删除掉。
每个月的月底对数据清理一次。
注:存储过程调用的时候参数为空默认为清理一年之前的数据,也可以输入一个固定的时间,存储过程则会清理此时间之前的所有历史数据。
调用crontab:010228**/archlog11/code/del_history_data.shdel_history_data.sh:exportORACLE_BASE=/home/oracleexportORACLE_HOME=$ORACLE_BASE/product/10.2.0/db_1exportORA_CRS_HOME=$ORACLE_BASE/crsexportORACLE_SID=uvc1exportPATH=.:${PATH}:$HOME/bin:$ORACLE_HOME/bin:$ORA_CRS_HOME/binexportTNS_ADMIN=$ORACLE_HOME/network/adminexportNLS_LANG="American_America.ZHS16GBK"exportNLS_DATE_FORMAT='yyyymmddhh24:mi:ss'sqlplus-sfjuvc/fjuvc@uvc<<!executep_del_cz_history('');executep_del_card_info_history('');executep_del_card_auth_history('');executep_del_sms_history('');!8.2.2程序日志清理8.3数据库相关维护说明【数据库中存储过程,job的说明以及运行情况监控。