SugarNMS智和网管开发平台入门指南.doc

北京智和信通技术有限公司 SugarNMS网管开发平台入门指南 适用人员：Java工程师 公司地址：北京市朝阳区望京科技园锐创国际中心B座5层 公司网站：010 技术支持电话：010 (SugarNMS开发平台试用版仅用于快速体验和进行入门级的开发。正式版提供了客户端全套源代码、服务端和插件开发代码、更多的文档和培训，如有需要，请联系我们。) 目 录 一、 软件环境准备 2 1. sugarnms目录 2 2. 客户端开发 3 二、 网管软件整体架构介绍 6 1. 整体架构 6 2. 服务端整体设计 7 3. 客户端整体设计 9 4. 数据库整体设计 12 5. 系统整体运行流程 15 6. 客户端与服务端交换模式 17 三、 基础组件介绍 17 1. 数据库API 18 2. ObjectSNMP组件 20 3. itopoview组件 23 4. 事件分发 26 四、 Client模块介绍 27  软件环境准备 下载的SugarNMS开发平台软件，已经包含了完整的SugarNMS网管软件、源代码和Eclipse工程文件。只要客户具备了Java开发环境，即可利用SugarNMS平台进行开发、运行、发布软件的工作。 sugarnms目录 bin目录 快速启动sugarnms的各个服务以及jar包的签名。 1. bin\StartMySQL.bat 启用MySQL数据库服务； 2. bin\StartServer.bat 启动sugarnms网管服务； 3. bin\StartClient.bat启动客户端界面。 (默认帐号和密码都是admin) 4. bin\CN-Init.cmd初始化中文版 5. bin\EN-Init.cmd初始化英文版 6. bin\SNMPMIBBorwser.cmd MIB浏览器 7. bin\StartSNMPProxyServer.bat SNMP代理 8. bin\ GenKey.cmd 生成zhtelecom.keystore文件 9. bin\ SignJar.cmd为config/lib下的jar签名(密码: zhtelecom) 10. bin\ SignLibJar.cmd 为sugarnms自己开发的jar签名 java目录 完整的Jre1.7目录。 java/bin、java/lib对应jre/bin、jre/lib javalib目录 第三方开源或免费的jar包。仅被服务端使用 mysql目录 mysql数据库 服务端口为：33066 帐号：sugarnms 密码：sugarnms 数据库名：sugarnms 数据库自带客户端工具：mysqlcc.exe，可以建表和查看数据。 为保证数据完整性，停止数据库应用stop.bat或NT服务控制。 config目录 系统配置文件，以及sugarnms自己开发的jar包都在此目录下 webserver目录 裁剪后的tomcat，服务端使用。 wrapper目录 将sugarnms服务端和客户端作为NT服务的包装工具。 log目录 日志文件目录 FileServerHome目录 ftp和tftp服务目录 根目录 单独启动各种服务和程序的批处理。 WindowsXP和Windows Server平台上，通过AllInstallAndRun.cmd快速安装Mysql、sugarnms Server作为NT服务。 客户端开发 平台文件中已经包含有客户端工程(sugarnms_client)，可以根据自身需求进行客户端的开发体验，工程需要引用到其他jar包，这些jar都能在sugarnms软件中找到，除这些jar引用外，不在需要其他配置文件。确保开发工具Eclipse中JRE系统库为6.0以上、文本编码格式为GBK。 编译环境 我们可以根据以下任何一种方式获得客户端的编译环境： 选择workspace_sugarnms作为eclispe工作区间，客户端可直接获得编译环境，进行客户端的开发工作。 workspace_sugarnms的目录结构如下图： 如果需要使用自己的工作区间，导入工程后，需要重新引入jar包，来获得编译环境。 需要的jar包如下图所示： JRE系统库报错 项目右键-构建路径-配置构建路径 删除错误的JRE系统库 添加执行环境中匹配的JRE系统库 客户端运行 确保数据库和sugarnms服务端启动后，运行com\zhtelecom\nms\client\ client.java的main()方法，即可进入登录界面，登录用户名和密码:admin。 客户端发布 第一步：sugarnms_client客户端代码编译生成的jar包发布到：sugarnms/config/sugarnm