福建福諾移動(dòng)通信技術(shù)

無(wú)線城市系統(tǒng)維護(hù)手冊(cè)

（新浪微博）

版本號(hào)VI.0

日期2012-04-05

作者傅子文

審核

批準(zhǔn)

福建福諾移動(dòng)通信技術(shù)

修訂歷史記錄

版本號(hào)日期作者修訂要點(diǎn)

VI.0()2012-04-05傅子文新整理

目錄

1系統(tǒng)運(yùn)行環(huán)境.................................4

1.1硬件配置及系統(tǒng)軟件....................................................5

1.2網(wǎng)絡(luò)結(jié)構(gòu)圖............................................錯(cuò)誤!未定義書(shū)簽。

2系統(tǒng)功能說(shuō)明.................................8

3軟件模塊結(jié)構(gòu)圖...............................9

4軟件安裝說(shuō)明.........13

4.1模塊列表說(shuō)明..........................................................13

4.2XI模塊...............................................................13

4.3X2模塊...............................................................14

5配置文件說(shuō)明.................................14

6啟動(dòng)及停止說(shuō)明...............................15

6.1程序手工啟動(dòng)..........................................................15

6.2程序手工停止..........................................................15

6.3程序運(yùn)行狀態(tài)查看......................................................15

7周邊接口....................................15

7.1與XXX平臺(tái)接口.......................................................15

8維護(hù)說(shuō)明.....................................17

8.1日常維護(hù)監(jiān)控點(diǎn)..........................................................17

查看進(jìn)程是否運(yùn)行.................................................17

程序運(yùn)行日志巡查.................................................18

錯(cuò)誤日志表的監(jiān)控.................................................19

業(yè)務(wù)流程監(jiān)控.....................................................19

8.2定期的數(shù)據(jù)備份和清理....................................................19

表數(shù)據(jù)清理.......................................................19

程序日志清理.....................................................20

8.3數(shù)據(jù)庫(kù)相關(guān)維護(hù)說(shuō)明......................................................20

數(shù)據(jù)庫(kù)JOB的說(shuō)明................................................20

數(shù)據(jù)配置操作說(shuō)明.................................................21

9常見(jiàn)問(wèn)題分析和跟蹤..........................21

1系統(tǒng)運(yùn)行環(huán)境

【填寫(xiě)系統(tǒng)需要的硬件和軟件環(huán)境,如果不是單列系統(tǒng),此處可省略】

1.1硬件配置及系統(tǒng)軟件

＞硬件配置

系統(tǒng)軟件（操作數(shù)量運(yùn)行環(huán)境（編譯環(huán)境及第三

節(jié)點(diǎn)設(shè)備規(guī)格描述

系統(tǒng)及數(shù)據(jù)庫(kù)）方支持軟件）

CPU:8X

1.98GHzSolaris9?

數(shù)據(jù)庫(kù)效

PP650內(nèi)存:16GB0racle9i企業(yè)2

勞器

磁盤：2X版(2cpu)

73GB

10XI46GB

存儲(chǔ)設(shè)備磁盤陣列1

HDD

DCC運(yùn)行環(huán)境：

gcc(GCC)

boost_l_33_0

CPU:4Xopenssl-

3.0GHzRedheatAS3.0

業(yè)務(wù)處理xerces-c-src_2_7_0

DL38O內(nèi)存：4GB操作系統(tǒng)，2

效勞器

磁盤：3Xoracle客戶端ACE-5.5

73GB

Opendiameter-h

業(yè)務(wù)處理模塊運(yùn)行環(huán)境：

Interstagev7

JDK1.4

eclipse.exe

CPU:4XRedheatAS3.0WEBNMS7.0

3.0GHz操作系統(tǒng)，

網(wǎng)管效勞

DL380內(nèi)存:4GBoracle9i效勞1

器

磁盤：3X器，oracl?？?/p>

73GB戶端

一塊信令卡、

可編程交RedheatAS3.0

EXCEL一塊中繼卡、2

換機(jī)操作系統(tǒng)

兩塊DSP2卡

IVR接入效RedheatAS3.0ACE-5.5

PC效勞器2

勞器操作系統(tǒng)

8個(gè)100兆以RedheatAS3.0

防火墻NeTrust2

太口操作系統(tǒng)

＞第三方軟件

軟件名稱說(shuō)明數(shù)量備注

0racle9i0racle9i企業(yè)版(2cpu)1

FujitsuIASPlusv7FujitsjInterstageApplicationServer

1

ForLinuxPlusv7(2cpu)

WebNMSruntimeWebMMS4.7standardeditionruntime1

LinuxASLinuxAS4.0u57

如需數(shù)據(jù)庫(kù)中

VeritasVCSVCSfororacle9iforlinux1

備

如需主備方案

Lifekeeper用于業(yè)務(wù)處理效勞器HA2

1.2業(yè)務(wù)流程圖

未登錄用戶分享流程

無(wú)線城市平臺(tái)新浪

用戶單擊“微博分

享”圖標(biāo)

是否需要用戶

驍錄無(wú)線城市否

T臺(tái)？.

提示用戶登錄，并

顯示登錄框

/用戶選擇登錄、、

否

、無(wú)線城市？，‘

是

用戶輸入微博賬號(hào)

密瑪?shù)卿?/p>

1T

編輯分享內(nèi)容，單

擊“分享”

顯示分享成功

2系統(tǒng)功能說(shuō)明

0功能描述：

?用戶在WAP網(wǎng)站點(diǎn)擊新浪微博分享按鈕，可將無(wú)線城市平臺(tái)相關(guān)的內(nèi)容發(fā)布至用戶的新

浪微博，與他們的微博好友共同分享。分享支持授權(quán)和微分享兩種模式。授權(quán)模式指的是

用戶在無(wú)線城市登錄后與新浪賬號(hào)授權(quán)綁定，此后用戶無(wú)需輸入新浪賬號(hào)和密碼可直接進(jìn)

行分享。微分享模式針對(duì)的是游客，每次分享都需要輸入賬號(hào)、密碼。

?主要功能點(diǎn)如下：

實(shí)現(xiàn)功能功能具體描述

各地市平臺(tái)首頁(yè)，應(yīng)用首頁(yè)，活動(dòng)專區(qū)的活動(dòng)介紹頁(yè)面添加“分享

增加分享按鈕界面

到微博”按鈕或鏈接

1、己登錄無(wú)線城市用戶點(diǎn)擊分享后，判斷用戶是否

已授權(quán)，未授權(quán)那么授權(quán)處理，己授權(quán)那么進(jìn)入

登錄或未登錄用戶分編輯分享內(nèi)容界面。

2、未登陸用戶讓用戶選擇登陸或直接登陸新浪微

享流程處理

博進(jìn)行分享。

注冊(cè)用戶授權(quán)綁定功無(wú)線城市用戶登錄后可與新浪微博賬號(hào)進(jìn)行綁定,分享時(shí)不必登錄

能新浪微博。授權(quán)有效期為7天，失效后需重新申請(qǐng)授權(quán)并更新授權(quán)

信息。

分享功能把應(yīng)用或活動(dòng)的分享內(nèi)容提交至新浪微博。

微分享功能登錄新浪微博，并將分享參數(shù)傳送至新浪分享界面，最后提交至新

浪微博。

返回瀏覽原頁(yè)面根據(jù)新浪接口返回的地址映射串獲取保存的原分享的頁(yè)面uH,并

跳轉(zhuǎn)至該url所在頁(yè)面。

分享口志及地址映射分享提交至新浪微博時(shí)記錄相關(guān)分享信息。

信息記錄

分享次數(shù)統(tǒng)計(jì)對(duì)應(yīng)的應(yīng)用、資訊、首頁(yè)等被分享的次數(shù)

與新浪的接口1.請(qǐng)求用戶授權(quán)Token接口。2.發(fā)布一條微博信息接口。3.短鏈

接接口。4.分享次數(shù)接口。5.獲取Token接口

詳見(jiàn)《新浪微博分享一概要設(shè)計(jì)說(shuō)明書(shū).doc》

3軟件模塊結(jié)構(gòu)圖

1/

J\

V

0D000D

注：由于無(wú)線城市作為一個(gè)應(yīng)用接入新浪微博，因此只能有一個(gè)授權(quán)回調(diào)地址供新浪微博調(diào)用，為此獨(dú)

立出微博授權(quán)接口模塊。

具體業(yè)務(wù)說(shuō)明：

1）門戶發(fā)起授權(quán)請(qǐng)求，并跳轉(zhuǎn)到新浪授權(quán)頁(yè)面：

A：用戶輸入微博賬號(hào)，驗(yàn)證成功，由新浪授權(quán)頁(yè)面進(jìn)入模塊，并帶回stale參數(shù)和微博code；

B：用戶取消授權(quán)，新浪授權(quán)頁(yè)面直接進(jìn)入模塊（取消授權(quán)新浪不帶參數(shù)）；

2）模塊判斷新浪回調(diào)是否帶有state參數(shù)和微博code：

A：如果沒(méi)有參數(shù),說(shuō)明用戶取消授權(quán)或其它非法訪問(wèn),模塊獲取UA信息，根據(jù)訪問(wèn)類型白

動(dòng)跳轉(zhuǎn)到web門戶或wap門戶；

B：有參數(shù)的情況，模塊根據(jù)獲得的code再次請(qǐng)求新浪獲取微博用戶token。成功得到token

后關(guān)聯(lián)state參數(shù)中傳遞的userid保存入庫(kù)；

3）授權(quán)信息保存成功后：

模塊將token信息放入state參數(shù)中，根據(jù)訪問(wèn)類型回傳到web或wap門戶。

數(shù)據(jù)格式：

1.state加密前的數(shù)據(jù)格式為json串，門戶和模塊解密后直接轉(zhuǎn)換為map使用；

2.門戶跳轉(zhuǎn)到新浪授權(quán)傳遞suite參數(shù)，除了各自需要保持會(huì)話用到的參數(shù)，必須傳遞門戶用戶的

賬戶ID,名稱為userid,用于授權(quán)成功后模塊關(guān)聯(lián)保存授權(quán)信息；

3.模塊授權(quán)保存成功后傳遞給門戶state參數(shù)參加微博授權(quán)token和token的類型，名稱為

access_token和token_type；

4.其中tokcn」ypc的值對(duì)應(yīng)數(shù)據(jù)庫(kù)中TB_WEIBO_OAUTHWE1：BO_PARTNER字段。

日志記錄：

日志統(tǒng)一存入H2內(nèi)存數(shù)據(jù)庫(kù)，再進(jìn)行日志遷移

1.錯(cuò)誤日志記錄

錯(cuò)誤H志統(tǒng)一記錄導(dǎo)門戶TB_ERROR_LOG表中,錯(cuò)誤編碼參見(jiàn)《尢線城市-錯(cuò)誤編碼.d。?！罚?/p>

體如下：

1600用戶非法訪問(wèn)OAUTH_ACCESS_ERROR2微博授權(quán)接口

OAUTH_RET_DATA_DEC

1601State解析出錯(cuò)ODED_ERROR2微博授權(quán)接口

OAUTH_GET_TOKEN_ER

1602Token獲取失敗ROR2微博授權(quán)接口

1603保存授權(quán)信息失敗OAUTH_SAVE_ERROR2微博授權(quán)接口

時(shí)序圖：

1）用戶授權(quán):

登錄用戶分享:

未登錄用戶分享:

4軟件安裝說(shuō)明

【軟件安裝說(shuō)明,不包括第三方軟件的安裝】

4.1模塊列表說(shuō)明

模塊名程序名功能描述所處

主機(jī)

PI

XI模塊

P2

X2模塊P3

4.2XI模塊

【XI模塊安裝說(shuō)明,包括安裝詳細(xì)步驟】

4.3X2模塊

【X2模塊安裝說(shuō)明,包括安裝詳細(xì)步驟】

5配置文件說(shuō)明

【XX模塊配置說(shuō)明,軟件安裝完成后的配置,包括數(shù)據(jù)庫(kù)配置表的配置,程序參數(shù)的配置

等7

weibo.properties

#3ina微博相關(guān)配置

/oauth2/authorize?client_id=44345334l&redirect_jri=://3:10076/we

b-frame/callback.do?&response_type=code&display=mobile

#---------

#公共環(huán)境

WZIBO_WM=58153002

baseURL=s:

accessTokenURL=s:

ajthorizeURL=s:

WZIBO_SINA_URL=://weibo/dpool/ttt/share.php

#客戶端下載URL

downclienLURL=/pLdownclienL.do

#WEIBO_UID=2126827321

#線上環(huán)境

#

#client_ID=443453341

#client_SERCRET=0dca9e30d23e9e8el460aelf7df352ba

#redirect_URI=://3:10043/callback.do?

#

#138測(cè)試環(huán)境

#

client_ID=2930250776

client_SERCRET=43edb9686eb79f62b27f7b76994e041e

redirect_URI=://3:10097/callback.do?

6啟動(dòng)及停止說(shuō)明

【程序的手動(dòng)啟動(dòng)和停止步驟,1

6.1程序手工啟動(dòng)

【程序的手動(dòng)啟動(dòng)的步驟,]

6.2程序手工停止

【程序的手動(dòng)停止步驟,1

6.3程序運(yùn)行狀態(tài)查看

【程序的運(yùn)行狀態(tài)的查看,包括正常情況下的狀態(tài)是什么,包括系統(tǒng)進(jìn)程等。，]

7周邊接口

7.1與新浪平臺(tái)接口

7.1.1請(qǐng)求用戶授權(quán)Token

0接口描述：用戶在無(wú)線城市登陸后與新浪賬號(hào)綁定，此后用戶無(wú)需輸入新浪賬號(hào)和密碼可直接進(jìn)行

分享，授權(quán)有效期為7天，失效后需重新申請(qǐng)授權(quán)并更新授權(quán)信息。

?請(qǐng)求參數(shù)

接入地址

接收參數(shù)必選類型及范圍說(shuō)明

clicnt_idtrueString申請(qǐng)應(yīng)用時(shí)分配的AppKcy。

rcdircct_uri(rueString授權(quán)回調(diào)地址。

rcsponsc_(ypcfalseString返回類型，支持code、token,默認(rèn)值為code。

statefalseString用于保持請(qǐng)求和回調(diào)的狀態(tài)，在回調(diào)時(shí)，會(huì)在

QueryParameter中【可傳該參數(shù)。

displayfalseString授權(quán)頁(yè)面的終端類型

7.1.2發(fā)布一條微博信息

?接口描述：用戶在WAP網(wǎng)站點(diǎn)擊新浪微博分享按鈕，可將無(wú)線城市平臺(tái)相關(guān)的內(nèi)容發(fā)布至用戶的

新浪微博

弋請(qǐng)求參數(shù)

接入地址

接收參數(shù)必選類型及范圍說(shuō)明

sourcefalsestring采用OAuth授權(quán)方式不需要此參數(shù)，其他授權(quán)方

式為必填參數(shù)，數(shù)值為應(yīng)用的AppKey。

access_tokenfalsesiring采用OAulh授權(quán)方式為必填參數(shù)，其他授權(quán)方式

不需要此參數(shù)，OAuth授權(quán)后獲得。

statustruestring要發(fā)布的微博文本內(nèi)容，必須做URLcncodc,內(nèi)容

不超過(guò)140個(gè)漢字。

latfalsefloat緯度，有效范圍：?90.0到+90.0,+表示北緯，默

認(rèn)為0.0。

longfalsefloat經(jīng)度,有效范圍：-180.0到+180.0,+表示東經(jīng),

默認(rèn)為0.0。

annotationsfalsestring元數(shù)據(jù)，主要是為了方便第三方應(yīng)用記錄一些適合

于自己使用的信息，每條微博可以包含一個(gè)或者多

個(gè)元數(shù)據(jù)，必須以json字串的形式提交，字串長(zhǎng)

度不超過(guò)512個(gè)字符，具體內(nèi)容可以自定。

7.1.3短鏈接

?接口描述：將?個(gè)或多個(gè)長(zhǎng)鏈接轉(zhuǎn)成短鏈接

?請(qǐng)求參數(shù)

接入地址

.json

接收參數(shù)必選類型及范圍說(shuō)明

sourcetruestring申請(qǐng)應(yīng)用時(shí)分配的AppKey,調(diào)用接口時(shí)候代表應(yīng)用的唯

一身份。（采用OAuth授權(quán)方式不需要此參數(shù)〕

url_longtruestring需要轉(zhuǎn)換的長(zhǎng)鏈接，需要URLcncodcd,最多不超過(guò)20個(gè)。

7.1.4分享轉(zhuǎn)發(fā)次數(shù)

?接口描述：取得一個(gè)短鏈接在微博上的微博分享數(shù)

?請(qǐng)求參數(shù)

接入地址

json

接收參數(shù)必選類型及范圍說(shuō)明

sourcetruestring申請(qǐng)應(yīng)用時(shí)分配的AppKey,調(diào)用接口時(shí)候代表應(yīng)用的唯

一身份。（采用OAuth授權(quán)方式不需要此參數(shù)）

url_shorttruestring需要取得分享數(shù)的短鏈接，需要URLencodcd。

7.1.5獲取Token

<接口描述：獲取授權(quán)過(guò)的AccessToken

<請(qǐng)求參數(shù)

接入地址

接收參數(shù)必選類型及范圍說(shuō)明

client_idtruestring申請(qǐng)應(yīng)用時(shí)分配的AppKeyo

client_secrettruestring申請(qǐng)應(yīng)用時(shí)分配的AppSecreto

grant_typctruestring請(qǐng)求的類型，可以為authorization_codc、password、

refrcsh_tokcn。

grant_type為authorization_code時(shí)

接收參數(shù)必選類型及范圍說(shuō)明

codetruestring調(diào)用authorize獲得的code值。

redirect_uritruestring1可調(diào)地址，需需與注冊(cè)應(yīng)用里的回調(diào)地址一致。

grant_type為password時(shí)

接收參數(shù)必選類型及范圍說(shuō)明

usernametruestring授權(quán)用戶的用戶名。

password(ruestring授權(quán)用戶的密碼。

8維護(hù)說(shuō)明

8.1日常維護(hù)監(jiān)控點(diǎn)

【系統(tǒng)的門常監(jiān)控點(diǎn),監(jiān)控方法。下而羅列幾點(diǎn)，如有更多的監(jiān)控點(diǎn),都需要依次羅列】

8.L1查看進(jìn)程是否運(yùn)行

【查看程序的主要后臺(tái)進(jìn)程】

登錄平臺(tái)各個(gè)效勞器，運(yùn)行命令行命令查看。

假設(shè)是unix效勞器，命令為：

ps-cflgrup進(jìn)程名

假設(shè)是windows效勞器，通過(guò)任務(wù)管理器查看相應(yīng)進(jìn)程是否存在。

8.1.2程序運(yùn)行日志巡查

1.查詢微博分享設(shè)置

selectc.id,

t.type,

t.type_valuez

t.url,

t.city_idz

t.login_flag,

t.login_reasonz

t.content_flag,

decode(t.content_flag,0,p.content_editzt.content_edit)

content_editz

decode(t.content_flag,0,p.content_notedit,t.content_notedit)

content_notedit,

t.pic_url,

t.access_type

fromTb_Weibo_Settingt,tb_weibo_templatep

wheret.type=3

andt.city_id=591

andt.type=p.id(+)

andt.access_type=2

說(shuō)明：access/ype：接入平臺(tái)類型(1：WEB；2：WAP了

Type:分享類墊:1應(yīng)用、2活動(dòng)、3頁(yè)面、4專欄

2查詢用戶

select*fromtb_portal_aserawherea.mobile=?anda.password=?

說(shuō)明：微博分享時(shí)叁先用一號(hào)碼登陸，根據(jù)~~號(hào)碼和密碼查詢?cè)撚脩羰欠翊嬖凇?/p>

3.微博授權(quán)

select★

from(select:*

fromtb_weibo_oautht

wheret.user_id=31364

andt.weibo_partner=1

andt.update_time>(sysdate-7)

orderbyupdate_tim@desc)

whererownum<2

說(shuō)明：查詢用戶是否已授權(quán),圻果查詢無(wú)數(shù)據(jù)說(shuō)明用戶還未授權(quán)，授權(quán)有效期超過(guò)七天，需重新授權(quán)

uscr_id：用戶ID,wcibo_partner=l：表示支持新浪微博

8.1.3錯(cuò)誤日志表的監(jiān)控

【數(shù)據(jù)庫(kù)用戶中應(yīng)該有一個(gè)錯(cuò)誤H志表,存儲(chǔ)過(guò)程等異常處理,都要寫(xiě)錯(cuò)誤H志到此表,

要經(jīng)常監(jiān)控,以及錯(cuò)誤編碼的含義,在此節(jié)表達(dá)。］

8.1.4業(yè)務(wù)流程監(jiān)控

r系統(tǒng)主要的業(yè)務(wù)流程，羅列出來(lái),并寫(xiě)出對(duì)應(yīng)監(jiān)控方法,以及預(yù)期結(jié)果】

8.2定期的數(shù)據(jù)備份和清理

【數(shù)據(jù)的備份信息,以及數(shù)據(jù)清理信息，包括程序的數(shù)據(jù)和日志信息備份清理,以及數(shù)據(jù)而

表的備份和清理,數(shù)據(jù)沒(méi)有備份的,只需要寫(xiě)明歷史數(shù)據(jù)清理流程】

8.2.1表數(shù)據(jù)清理

根據(jù)要求，TI,T2,…表內(nèi)存的信息保存一年，一年以前的數(shù)據(jù)將刪除掉。每個(gè)月的月底對(duì)數(shù)據(jù)清

理一次。

注：存儲(chǔ)過(guò)程調(diào)用的時(shí)候參數(shù)為空默認(rèn)為清理一年之前的數(shù)據(jù)，也可以輸入一個(gè)固定的時(shí)間，存儲(chǔ)

過(guò)程那么會(huì)清理此時(shí)間之前的所有歷史數(shù)據(jù)。

調(diào)用crontab:

010228**/archlog11/code/del_history_data.sh

del_history_data.sh:

exportORACLE_BASE=/home/oracle

exportORACLE_HOME=$ORACLE_BASE/product//db_l

exportORA_CRS_HOME=$ORACLE_BA3E/crs

exportORACLE_SID=uvcl

exportPATH-.:${PATH}:$H0ME/bin:$ORACLE_HOME/bin:$ORA_CRS_HOME/bin

exportTNS_ADMIN=$ORACLE_HOME/network/admin

exportNLSLANG-,,American_America.ZHS16GBK"

exportNLS_DATE_FORMAT-'yyyymmddhh24:mi:ss'

sqlplus-sfjuvc/fjuvcQuvc?!

executep_del_cz_history(1');

executep_del_card_info_history('');

executep_del_card_auth_history(*');

executep_del_sms_history('');

8.2.2程序日志清理

8.3數(shù)據(jù)庫(kù)相關(guān)維護(hù)說(shuō)明

【數(shù)據(jù)庫(kù)中存儲(chǔ)過(guò)程，job的說(shuō)明以及運(yùn)行情況監(jiān)控。不包含數(shù)據(jù)庫(kù)系統(tǒng)級(jí)別的監(jiān)控,比方

表空間使用等,這局部?jī)?nèi)容在數(shù)據(jù)庫(kù)維護(hù)手冊(cè)里面表達(dá)】

8.3.1數(shù)據(jù)庫(kù)JOB的說(shuō)明

JOB編號(hào)實(shí)現(xiàn)功能說(shuō)明調(diào)度時(shí)間失敗監(jiān)控方法失敗處理方法

100完成表T1歷史每日0:101)JOB調(diào)用存JOB運(yùn)行失敗，