服務(wù)器遠(yuǎn)程監(jiān)視開發(fā)包說明與開發(fā)手冊

1、文檔可自由編輯打印服務(wù)器遠(yuǎn)程監(jiān)視開發(fā)包說明與開發(fā)手冊服務(wù)器遠(yuǎn)程監(jiān)視開發(fā)包說明與開發(fā)手冊項(xiàng)目名稱：項(xiàng)目名稱：N/A系統(tǒng)名稱：系統(tǒng)名稱：N/A子系統(tǒng)名稱：子系統(tǒng)名稱：N/A密級：密級：公司2001/09/19作者修改者版本修改原因時(shí)間聞怡洋Alpha 0.9首次創(chuàng)建文檔創(chuàng)建功能介紹2001/10/19聞怡洋Alpha 0.9添加 V1.0 功能介紹和開發(fā)手冊2001/10/23聞怡洋Alpha 0.9添加 V1.0 客戶端軟件功能介紹和使用手冊2001/10/24聞怡洋Alpha 0.9添加 V1.0 客戶端軟件顯示定制功能使用手冊2001/10/25聞怡洋Beta 0.9發(fā)布 Beta 0.9

2、版本2001/10/28相關(guān)文檔：其他說明：如果有任何問題和功能上的補(bǔ)充請聯(lián)系聞怡洋文檔可自由編輯打印目錄第第 1 章章介紹介紹.31.1解決的問題.31.2實(shí)現(xiàn)方法介紹.31.2.1版本規(guī)劃.3第第 2 章章基類功能介紹基類功能介紹.42.1CLASS CSRMBASE : PUBLIC CPARENTTHREAD.42.1.1構(gòu)造.42.1.2設(shè)置保存信息的最大數(shù)量.42.1.3得到保存信息的最大數(shù)量.42.1.4添加消息.42.2CLASS SRMCHILD : PUBLIC CCHILDTHREAD.4第第 3 章章版本版本 V1.0 功能介紹功能介紹.53.1文件.53.2功能介紹.

3、53.3可以完成的功能.53.4不能完成的功能.53.5通信包格式.53.5.1消息查詢包.53.6通信方式.6第第 4 章章版本版本 V1.0 服務(wù)器端開發(fā)說明服務(wù)器端開發(fā)說明.74.1服務(wù)器端開發(fā).74.2示例.7第第 5 章章版本版本 V1.0 客戶端使用說明客戶端使用說明.95.1客戶端.95.2配置.95.2.1基本信息.95.2.2顯示方式.105.3運(yùn)行.105.4故障.105.5示例.10文檔可自由編輯打印第第 1 章章介紹介紹1.1 解決的問題解決的問題由于服務(wù)器在后臺進(jìn)行運(yùn)行，并且在 Windows 平臺上服務(wù)器的監(jiān)視沒有什么常規(guī)的解決辦法。某些應(yīng)用通過將日志寫入數(shù)據(jù)庫的方

4、法來實(shí)現(xiàn)服務(wù)器的監(jiān)控，我一直認(rèn)為這樣的方法不可靠，而且這樣也不能夠?qū)崿F(xiàn)服務(wù)器的遠(yuǎn)程控制。而服務(wù)器遠(yuǎn)程監(jiān)視開發(fā)包的目的就是要實(shí)現(xiàn)服務(wù)器運(yùn)行狀態(tài)的遠(yuǎn)程監(jiān)視和控制。1.2 實(shí)現(xiàn)方法介紹實(shí)現(xiàn)方法介紹服務(wù)器與客戶端采用 TCP 協(xié)議進(jìn)行通信，在通信上采用了客戶查詢機(jī)制，服務(wù)器方不會(huì)主動(dòng)向客戶端發(fā)送數(shù)據(jù)。在服務(wù)器方每一條運(yùn)行狀態(tài)記錄由四部分組成：序列號：由系統(tǒng)生成。日志創(chuàng)建時(shí)間：由系統(tǒng)生成。消息類型：消息類型的文字說明，由用戶自己定義。消息內(nèi)容：由用戶自己定義，每條消息不能超過 512 個(gè)字節(jié)，服務(wù)器方最多保存 200 條消息記錄，多余的記錄會(huì)被自動(dòng)刪除。1.2.1 版本規(guī)劃版本規(guī)劃V1.0 提供面向 T

5、CP 套接口的連接方式的數(shù)據(jù)傳輸。提供服務(wù)器運(yùn)行狀態(tài)監(jiān)視功能。V1.5 在 V1.0 的基礎(chǔ)上增加身份驗(yàn)證和服務(wù)器控制功能。V2.0 創(chuàng)建可以支持自定義格式的遠(yuǎn)程日志監(jiān)視系統(tǒng)。文檔可自由編輯打印第第 2 章章基類功能介紹基類功能介紹參照了服務(wù)器模式 V1.0 版本，來實(shí)現(xiàn)服務(wù)器端的網(wǎng)絡(luò)連接管理。2.1 class CSRMBase : public CparentThread父線程。2.1.1 構(gòu)造構(gòu)造CSRMBase(LPCSTR pszSvrName,int iListenPort);pszSvrName 在構(gòu)造對象時(shí)必須提供一個(gè)服務(wù)器名，該名字在系統(tǒng)中唯一iListenPort 監(jiān)聽端口

6、2.1.2 設(shè)置保存信息的最大數(shù)量設(shè)置保存信息的最大數(shù)量void SetMaxMessageNum(UINT uNum=100);uNum 系統(tǒng)保存的信息數(shù)，該值最大值為 2002.1.3 得到保存信息的最大數(shù)量得到保存信息的最大數(shù)量UINT GetMaxMessageNum(void)return m_uMaxElement;返回：當(dāng)前保存的信息的最大數(shù)量2.1.4 添加消息添加消息int AddMessage(LPCSTR pszMsg,LPCSTR pszFlag=msg);pszMsg 需要保存的信息內(nèi)容pszFlag 消息類型標(biāo)記（有用戶自定義）返回：當(dāng)前添加的消息的 ID2.2 c

7、lass SRMChild : public CChildThread子線程，用于處理每個(gè)客戶端的連接。使用者不需要直接使用。文檔可自由編輯打印第第 3 章章版本版本 V1.0 功能介紹功能介紹3.1 文件文件commonServerRM.hcommonServerRM.cpp3.2 功能介紹功能介紹V1.0 版本主要是完成了基本的類定義，并且實(shí)現(xiàn)了服務(wù)器運(yùn)行狀態(tài)的監(jiān)視功能。定義了基本的通信格式。提供了通用的監(jiān)視客戶端軟件。3.3 可以完成的功能可以完成的功能實(shí)現(xiàn)了最基本的服務(wù)器狀態(tài)監(jiān)視功能（命令 get）。通信方式采用了非阻塞方式（檢測）。所有類中的數(shù)據(jù)存取都是線程安全的。在客戶端支持對特定

8、消息的選擇不同的圖標(biāo)。3.4 不能完成的功能不能完成的功能沒有實(shí)現(xiàn)服務(wù)子線程的監(jiān)控。無法查詢當(dāng)前子線程的具體信息。不能對消息進(jìn)行物理存儲(chǔ)。不支持口令檢測命令。3.5 通信包格式通信包格式3.5.1 消息查詢包消息查詢包客戶方：message number文檔可自由編輯打印message number：為消息序列號，服務(wù)器根據(jù)客戶端上傳的順序號下發(fā)當(dāng)前日志中學(xué)列號大于該序列號的日志。服務(wù)器方：ID time msg_type message0.n服務(wù)器方可以一次性返回多條記錄，每條記錄由來包含。ID：消息序列號Time：創(chuàng)建時(shí)間Msg_type：消息類型Message：消息內(nèi)容3.6 通信方式通

9、信方式雙方采用請求應(yīng)答的方式完成通信，每次客戶端發(fā)起一個(gè)查詢請求后服務(wù)器端返回一次記錄集。客戶端在沒有收取上次的應(yīng)答就發(fā)送下一次的請求時(shí)可能會(huì)造成請求丟失。文檔可自由編輯打印第第 4 章章版本版本 V1.0 服務(wù)器端開發(fā)說明服務(wù)器端開發(fā)說明4.1 服務(wù)器端開發(fā)服務(wù)器端開發(fā)在服務(wù)器端只需要編寫簡單的代碼。CSRMBase srm(test,9099);srm.CreateNewThread(TRUE);srm.AddMessage(“this is a message”,”type”);下面是一個(gè)簡單的示范（代碼見 v09_server_rmt_demo）：/初始化 WinSOCKETAfxSo

10、cketInit();/定義監(jiān)視服務(wù)對象CSRMBase srm(test,9099);/創(chuàng)建監(jiān)聽線程srm.CreateNewThread(TRUE);/定義幾個(gè)消息類型char szType310=通知,警告,錯(cuò)誤;while(1)char szMsg100;sprintf(szMsg,%06X - %06X - %06X,rand(),rand(),rand();/添加消息srm.AddMessage(szMsg,szTyperand()%3);Sleep(2000);/每 2 秒鐘產(chǎn)生一條日志（消息）4.2 示例示例v09_server_rmt_demo：服務(wù)器端演示，定期產(chǎn)生隨機(jī)的消

11、息。v09_server_rmt_echo_demo：echo 服務(wù)器，在 ECHO 服務(wù)器的基礎(chǔ)上添加了文檔可自由編輯打印遠(yuǎn)程監(jiān)視的功能。文檔可自由編輯打印第第 5 章章版本版本 V1.0 客戶端使用說明客戶端使用說明5.1 客戶端客戶端V1.0 自帶了一個(gè)客戶端軟件，SRMClient。界面如下：5.2 配置配置在運(yùn)行客戶端前需要?jiǎng)?chuàng)建一個(gè) srmClient.ini 文件記錄各類設(shè)置數(shù)據(jù)。5.2.1 基本信息基本信息基本信息格式如下：settingname=SRM Client Demo 顯示的名稱ip=127.0.0.1 服務(wù)器 IP 地址port=9099 服務(wù)器監(jiān)聽端口timer=2

12、 刷新頻率，以秒計(jì)文檔可自由編輯打印row=400 保存的消息數(shù)量，最少 20 條，最多 20000 條。5.2.2 顯示方式顯示方式客戶端提供下面五種圖標(biāo)用于顯示不同消息時(shí)的提示，默認(rèn)圖標(biāo)是最后一個(gè)。前三種圖標(biāo)分別代表：錯(cuò)誤，警告和通知。格式如下：icon1=:錯(cuò)誤:2=:警告:3=:通知:4=:info5:info6:5=:info7:當(dāng)你使用 int AddMessage(LPCSTR pszMsg,LPCSTR pszFlag=msg);第二個(gè)參數(shù)就將會(huì)在客戶端被匹配來確定使用的圖標(biāo)。在設(shè)置圖標(biāo)所對應(yīng)的消息類型時(shí)需要將文字兩端用冒號“:”包含起來，并且允許為同一圖標(biāo)指定多個(gè)消息類型。5.3 運(yùn)行運(yùn)行如果運(yùn)行客戶端時(shí)不帶參數(shù)，則程序會(huì)使用運(yùn)行目錄下的