《服务器远程监视开发包说明与开发手册》由会员分享，可在线阅读，更多相关《服务器远程监视开发包说明与开发手册（11页珍藏版）》请在金锄头文库上搜索。
1、服务器远程监视开发包说明与开发手册项目名称：N/A系统名称：N/A子系统名称：N/A密级：公司2001/09/19作者修改者版本修改原因时间闻怡洋Alpha 0.9首次创建文档创建功能介绍2001/10/19闻怡洋Alpha 0.9添加V1.0功能介绍和开发手册2001/10/23闻怡洋Alpha 0.9添加V1.0客户端软件功能介绍和使用手册2001/10/24闻怡洋Alpha 0.9添加V1.0客户端软件显示定制功能使用手册2001/10/25闻怡洋Beta 0.9发布Beta 0.9版本2001/10/28相关文档：其他说明：如果有任何问题和功能上的补充请联系闻怡洋目录第 1 章介绍31
2、.1解决的问题31.2实现方法介绍3版本规划3第 2 章基类功能介绍42.1class CSRMBase : public CparentThread4构造4设置保存信息的最大数量4得到保存信息的最大数量4添加消息42.2class SRMChild : public CChildThread4第 3 章版本V1.0功能介绍53.1文件53.2功能介绍53.3可以完成的功能53.4不能完成的功能53.5通信包格式5消息查询包53.6通信方式6第 4 章版本V1.0服务器端开发说明74.1服务器端开发74.2示例7第 5 章版本V1.0客户端使用说明95.1客户端95.2配置9基本信息9显示方式
3、105.3运行105.4故障105.5示例10第 1 章 介绍1.1 解决的问题由于服务器在后台进行运行，并且在Windows平台上服务器的监视没有什么常规的解决办法。某些应用通过将日志写入数据库的方法来实现服务器的监控，我一直认为这样的方法不可靠，而且这样也不能够实现服务器的远程控制。而服务器远程监视开发包的目的就是要实现服务器运行状态的远程监视和控制。1.2 实现方法介绍服务器与客户端采用TCP协议进行通信，在通信上采用了客户查询机制，服务器方不会主动向客户端发送数据。在服务器方每一条运行状态记录由四部分组成： 序列号：由系统生成。 日志创建时间：由系统生成。 消息类型：消息类型的文字说明
4、，由用户自己定义。 消息内容：由用户自己定义，每条消息不能超过512个字节，服务器方最多保存200条消息记录，多余的记录会被自动删除。1.2.1 版本规划 V1.0提供面向TCP套接口的连接方式的数据传输。提供服务器运行状态监视功能。 V1.5在V1.0的基础上增加身份验证和服务器控制功能。 V2.0创建可以支持自定义格式的远程日志监视系统。第 2 章 基类功能介绍参照了服务器模式V1.0版本，来实现服务器端的网络连接管理。2.1 class CSRMBase : public CparentThread父线程。2.1.1 构造CSRMBase(LPCSTR pszSvrName,int iL
5、istenPort);pszSvrName 在构造对象时必须提供一个服务器名，该名字在系统中唯一iListenPort 监听端口2.1.2 设置保存信息的最大数量void SetMaxMessageNum(UINT uNum=100);uNum 系统保存的信息数，该值最大值为2002.1.3 得到保存信息的最大数量UINT GetMaxMessageNum(void)return m_uMaxElement;返回：当前保存的信息的最大数量2.1.4 添加消息int AddMessage(LPCSTR pszMsg,LPCSTR pszFlag=msg);pszMsg 需要保存的信息内容pszF
6、lag 消息类型标记（有用户自定义）返回：当前添加的消息的ID2.2 class SRMChild : public CChildThread子线程，用于处理每个客户端的连接。使用者不需要直接使用。第 3 章 版本V1.0功能介绍3.1 文件commonServerRM.hcommonServerRM.cpp3.2 功能介绍V1.0版本主要是完成了基本的类定义，并且实现了服务器运行状态的监视功能。定义了基本的通信格式。提供了通用的监视客户端软件。3.3 可以完成的功能 实现了最基本的服务器状态监视功能（命令get）。 通信方式采用了非阻塞方式（检测）。 所有类中的数据存取都是线程安全的。 在客
7、户端支持对特定消息的选择不同的图标。3.4 不能完成的功能 没有实现服务子线程的监控。 无法查询当前子线程的具体信息。 不能对消息进行物理存储。 不支持口令检测命令。3.5 通信包格式3.5.1 消息查询包客户方：message numbermessage number：为消息序列号，服务器根据客户端上传的顺序号下发当前日志中学列号大于该序列号的日志。服务器方：ID time msg_type message0.n服务器方可以一次性返回多条记录，每条记录由来包含。ID：消息序列号Time：创建时间Msg_type：消息类型Message：消息内容3.6 通信方式双方采用请求应答的方式完成通信，
8、每次客户端发起一个查询请求后服务器端返回一次记录集。客户端在没有收取上次的应答就发送下一次的请求时可能会造成请求丢失。第 4 章 版本V1.0服务器端开发说明4.1 服务器端开发在服务器端只需要编写简单的代码。CSRMBase srm(test,9099);srm.CreateNewThread(TRUE);srm.AddMessage(“this is a message”,”type”);下面是一个简单的示范（代码见v09_server_rmt_demo）：/初始化WinSOCKETAfxSocketInit();/定义监视服务对象CSRMBase srm(test,9099);/创建监听
9、线程srm.CreateNewThread(TRUE);/定义几个消息类型char szType310=通知,警告,错误;while(1)char szMsg100;sprintf(szMsg,%06X - %06X - %06X,rand(),rand(),rand();/添加消息srm.AddMessage(szMsg,szTyperand()%3);Sleep(2000);/每2秒钟产生一条日志（消息）4.2 示例v09_server_rmt_demo：服务器端演示，定期产生随机的消息。v09_server_rmt_echo_demo：echo服务器，在ECHO服务器的基础上添加了远程监
10、视的功能。第 5 章 版本V1.0客户端使用说明5.1 客户端V1.0自带了一个客户端软件，SRMClient。界面如下：5.2 配置在运行客户端前需要创建一个srmClient.ini文件记录各类设置数据。5.2.1 基本信息基本信息格式如下：settingname=SRM Client Demo 显示的名称 服务器IP地址port=9099 服务器监听端口timer=2 刷新频率，以秒计row=400 保存的消息数量，最少20条，最多20000条。5.2.2 显示方式客户端提供下面五种图标用于显示不同消息时的提示，默认图标是最后一个。前三种图标分别代表：错误，警告和通知。格式如下：icon
11、1=:错误:2=:警告:3=:通知:4=:info5:info6:5=:info7:当你使用int AddMessage(LPCSTR pszMsg,LPCSTR pszFlag=msg);第二个参数就将会在客户端被匹配来确定使用的图标。在设置图标所对应的消息类型时需要将文字两端用冒号“:”包含起来，并且允许为同一图标指定多个消息类型。5.3 运行如果运行客户端时不带参数，则程序会使用运行目录下的srmClient.ini文件。如果带参数，则程序会使用第一个参数指定的INI文件。例如：srmClient c:setting.ini5.4 故障如果客户端软件在运行时无法连接服务器将无法启动，在中途如果连接断开客户端也会退出。5.5 示例v09_srm_client_full_demo，运行server_rmt.exe后再运行客户端程序。
