Copyright © 2023 新华三技术有限公司及其许可者 版权所有,保留一切权利。
未经本公司书面许可,任何单位和个人不得擅自摘抄、复制本书内容的部分或全部,并不得以任何形式传播。
除新华三技术有限公司的商标外,本手册中出现的其它公司的商标、产品标识及商品名称,由各自权利人拥有。
由于产品版本升级或其他原因,本手册内容有可能变更。H3C保留在没有任何通知或者提示的情况下对本手册的内容进行修改的权利。本手册仅作为使用指导,H3C尽全力在本手册中提供准确的信息,但是H3C并不确保手册内容完全没有错误,本手册中的所有陈述、信息和建议也不构成任何明示或暗示的担保。
目 录
iMC系统包括三种角色,每种角色拥有不同的权限等级,具体描述请参见表1-1。
表1-1 iMC角色描述
角色 |
相关说明 |
管理员 |
拥有系统中除组件部署和License注册以外的所有权限,可以管理所有的设备资源和用户资源 |
维护员 |
拥有除了系统管理及参数设置以外的绝大部分权限 可以定制维护员可管理的设备分组、用户分组,从而对维护员的资源访问权限进行控制 |
查看员 |
拥有除了系统管理及参数设置以外,其他各种功能的查看权限 可以定制查看员可查看的设备分组、用户分组,从而对查看员的资源查看权限进行控制 |
在此三类角色的基础上,可以进一步细分权限,构成操作员分组。iMC的每个操作员都属于一个操作员分组,由此决定其操作权限。
操作员分组可以由用户进行定制。系统预定义三个缺省分组:“管理员分组”、“维护员分组”和“查看员分组”,缺省分组不允许修改。用户自定义的操作员分组在上述三个缺省分组之一的基础上进行创建,并根据需要缩减权限,如图1-1所示。
本文中iMC服务器的安装根目录假设为$IMC_ROOT,服务器安装完成后目录结构请参见表1-2。
目录名 |
说明 |
$IMC_ROOT/server |
存放iMC后台相关的文件和子目录 |
$IMC_ROOT/server/bin |
存放iMC后台程序的可执行文件 |
$IMC_ROOT/server/conf |
存放iMC后台配置文件 |
$IMC_ROOT/server/conf/log |
存放iMC后台相关的运行日志文件 |
$IMC_ROOT/server/data |
存放iMC后台需要持久存放的数据,包括备份的设备配置文件、设备软件版本、任务相关信息等 |
$IMC_ROOT/server/locale |
存放与特定语言相关的文件和子目录,目前iMC只处理中文和英文两种语言文字 |
$IMC_ROOT/server/locale/C |
存放中文字符文件和子目录 |
$IMC_ROOT/server/locale/zh |
存放英文字符文件和子目录 |
$IMC_ROOT/server/tmp |
存放系统运行过程中的临时文件 |
$IMC_ROOT/client |
存放iMC前台Web服务使用的相关文件和文件夹 |
$IMC_ROOT/client/bin |
存放iMC前台Web服务的启动、停止脚本和工具 |
$IMC_ROOT/client/conf |
存放iMC前台Web服务的配置文件 |
$IMC_ROOT/client/log |
存放iMC前台Web服务相关的运行日志文件 |
$IMC_ROOT/client/repository |
存放iMC前台Web服务使用的公共类库 |
$IMC_ROOT/client/security |
存放iMC前台Web服务使用的与安全相关的证书文件等 |
$IMC_ROOT/client/web |
存放iMC前台Web服务的应用程序 |
表1-3提供了一些常用文件的存放路径和功能说明。
文件名 |
说明 |
$IMC_ROOT/server/conf/ imf.cfg |
iMC消息平台的系统配置文件,包括系统的通信环境参数等 iMC安装完成后,不要修改该文件,否则会导致系统异常 |
$IMC_ROOT/server/conf/ qvdm.conf |
iMC平台的基础配置文件,包括平台各个组件的数据库连接参数、设备软件存放目录、设备配置文件存放目录、告警运行参数、告警监听端口、运行日志的级别、运行日志的保留天数、系统当前语言环境等 通常情况下,不要修改该文件,否则可能会导致系统异常 |
$IMC_ROOT/server/conf/ QvProcessManager.xml |
iMC进程管理配置文件,包括CPU、内存、磁盘的告警阈值、进程启动方式、进程检查方式、轮询间隔等 |
$IMC_ROOT/server/conf/ imcsyslogdm.conf |
iMC Syslog管理组件使用的配置文件,包括Syslog管理组件使用的数据库连接参数等。 |
$IMC_ROOT/server/conf/ syslog.xml |
iMC Syslog管理组件接收日志的配置文件,包括监听端口、各个线程的数量、缓冲区的处理策略、Syslog日志模板定义等 |
$IMC_ROOT/client/conf/http.properties |
iMC前台Web服务的端口配置文件 |
$IMC_ROOT/client/conf/log4j.properties |
iMC前台Web服务的运行日志配置文件 |
日志是记录了各种信息的文件或数据表,用于跟踪和定位问题。iMC系统提供了两种日志:运行日志和操作日志。其中操作日志是系统提供给最终用户使用的功能,可以通过界面进行查询,此处不做赘述,以下将对运行日志进行详细说明。
后台运行日志记录程序运行中的信息,例如程序启动过程中的数据加载情况、系统运行过程中产生的错误以及潜在错误等,存放在$IMC_ROOT\server\conf\log 目录下,分为iMC后台进程运行日志和iMF/iMG运行日志。
· iMC后台进程运行日志文件名称的格式
日志文件名称的格式如图1-2所示。
举例:
日志文件“imcnetresdm_2008-08-16.log”,表示资源服务器端(imcnetresdm)2008年8月16日产生的运行日志。
· 系统运行日志的格式
每条运行日志的格式如下所示:
yyyy-mm-dd hh:mm:ss [Module Name] [log level (error code)] [thread id] [class name::method] description
各分段之间使用空格连接,log level与error code之间使用空格连接,class name与method之间使用“::”连接。
各分段含义请参见表1-4。
分段 |
说明 |
yyyy-mm-dd |
日志输出的年、月、日,如2006-08-22 |
hh:mm:ss |
日志输出的时、分、秒,如20:30:18 |
Module Name |
模块名,表示当前问题所属模块 |
log level |
日志级别,具体说明请参见表1-5 |
error code |
错误码,如0,1005 |
thread id |
线程标识 |
class name |
类名或名字空间 |
method |
方法名或函数名 |
description |
日志描述信息 |
日志级别 |
说明 |
FATAL |
致命错误 可能影响系统正常运行,一般无法自动恢复 |
ERROR |
普通错误 模块运行时出错,一般可以自动恢复;系统可以继续正常运行,但是某些处理过程数据或结果数据可能是错误的 |
WARNING |
警告 模块运行时出现异常,可能会引发某些错误,但不影响系统正常运行 |
INFO |
信息 提示用户发生特定事件以及描述一个业务流程的关键步骤,该级别的信息面向测试人员与维护人员 |
DEBUG |
调试 用于跟踪模块的执行步骤,该级别信息面向开发人员 |
举例:
日志文件中记录了运行日志“2008-02-21 19:59:04 [FaultDM] [DEBUG (0)] [1000] [CGlobalEncap::startThread] Total available memory is 511M”。日志信息表明,2008年2月21日 19:59:04,告警后台模块,线程ID=1000,CGlobalEncap类的startThread方法产生了一条DEBUG日志,日志的描述信息为:系统总可用内存是511M。
iMF/iMG是iMC后台进程的基础框架,由于iMF/iMG产生的日志量非常大,日志信息单独保存,且采用滚动方式记录——日志文件编号最小为0,最大为9,日志输出顺序为0 -> 1 -> 2 -> 3 ->4 ->5 -> 6 -> 7 -> 8-> 9 -> 0,并进行循环。
· iMF日志文件的命名格式
说明:
i. procid是进程ID,由iMC统一分配,比如资源后台是1,二层拓扑后台是16。
ii. prochandle是进程句柄,用于区分同一应用不同进程的情况。对于iMC后台进程,prochandle取值基本为0。
iii. n为文件序号,取值为0~9。
· iMG日志文件的命名格式
img_n.log,其中n为文件需要,取值为0~9。
· iMF/iMG输出日志格式
yyyy-mm-dd hh:mm:ss.ms [Module Name] description。yyyy-mm-dd为日志输出的年、月、日,如2006-08-22;hh:mm:ss.ms为日志输出的时、分、秒、毫秒,如20:30:18. 608;Module Name表示运行模块或函数,如CImfTaskMgr::delTask;description为日志描述信息。
举例:
2011-01-30 15:34:18.608 CImfTaskMgr::delTask taskmgr 254 task 35 has been deleted。这条日志信息说明在2011-01-30 15:34:18.608,在CImfTaskMgr::delTask函数中,254号任务管理器的35号任务被删除掉了。
iMC各系统数据库的说明请参见表1-6。
数据库名 |
所属组件 |
说明 |
config_db |
资源管理组件 |
存放用户资源数据、设备资源数据以及平台基础数据 |
monitor_db |
告警管理组件 |
存放告警配置数据、告警原始数据和告警统计数据 |
perf_db |
性能管理组件 |
存放性能配置数据、性能采集数据和性能统计分析数据 |
syslog_db |
Syslog管理组件 |
存放Syslog配置数据、原始Syslog日志等 |
icc_db |
iCC管理组件 |
存放设备配置文件相关数据、设备软件相关数据 |
aclm_db |
ACL管理组件 |
存放ACL相关配置数据 |
invent_db |
资产管理组件 |
存放资产管理的相关数据 |
vlanm_db |
VLAN管理组件 |
存放VLAN相关配置数据 |
vnm_db |
虚拟网络管理组件 |
存放虚拟网络相关配置数据 |
iMC进程会占用一定的内存和CPU资源。为了减少内存占用和降低CPU 负荷,提高iMC服务器的性能,可以停止一些不必要的iMC进程。iMC进程及端口号说明请参见表1-7。
表1-7 iMC进程及端口号说明
进程名称 |
功能描述 |
协议/端口号 |
启动要求及依赖关系 |
img.exe |
智能消息网关进程,负责各个进程之间消息的转发 |
TCP/8800 |
核心进程,必须启动,不能停止 |
imcsysdm.exe |
进程管理器进程,负责监控系统和各个进程的运行情况 被监控进程停止后能够自动启动被监控进程,能够实时产生告警报告系统和进程问题 |
无 |
核心进程,必须启动,不能停止 |
imcsysdm_shell.exe |
负责启动imcsysdm.exe进程 |
无 |
该进程只是在启动和停止系统时运行,完成启动/停止后立刻退出 |
tftpserver.exe |
TFTP服务器,用于传输文件 |
UDP/69 |
该进程占用系统资源很少,不建议停止 对于iCC所在的服务器,不能停止该进程 |
imcnetresdm.exe |
资源服务进程,负责设备基础配置信息管理以及公共拓扑管理 |
UDP/161 TCP/23 |
iMC基础进程,必须启动,不能停止 |
imcl2topodm.exe |
二层拓扑服务进程,负责二层拓扑的计算和管理 |
UDP/161 |
如果不需要管理二层设备,可以停止该进程 |
imcjobmgrdm.exe |
通用任务管理服务进程,负责任务的统一调度和管理 |
无 |
iMC基础进程,很多组件都使用该服务进程处理任务,如果关闭该服务进程将导致相关组件的任务无法创建和调度 |
imccmdmgrdm.exe |
通用命令执行服务进程,负责执行设备命令行 |
TCP/23 |
iMC基础进程,如果关闭该服务进程将导致部分组件无法向设备下发命令 |
imcfaultdm.exe |
告警管理服务进程,负责告警的接收和管理 |
UDP/161 UDP/162 |
iMC基础进程,如果不需要接收告警可以停止该进程 |
imcperfdm.exe |
告警采集服务进程,负责性能数据的采集和管理 |
UDP/161 |
iMC基础进程,如果不需要采集性能数据可以停止该进程 |
imcsyslogdm.exe |
Syslog日志服务进程,负责Syslog日志的接收和管理 |
UDP/514 UDP/515 |
iMC基础进程,如果不需要接收Syslog日志可以停止该进程 |
imccfgbakdm.exe |
配置文件管理服务进程,负责配置文件的备份、恢复和下发以及配置文件的其他管理 |
UDP/161 TCP/20 TCP/21 TCP/22 TCP/23 |
如果不需要管理配置文件可以停止该进程 |
imcupgdm.exe |
设备软件升级管理后台,负责维护设备软件版本以及设备软件版本的下发 |
UDP/161 TCP/20 TCP/21 TCP/22 TCP/23 |
如果不需要管理设备软件可以停止该进程 |
imcacldm.exe |
ACL管理组件的服务进程,负责ACL管理组件的配置轮询、下发等 |
TCP/23 |
如果不需要ACL管理可以停止该进程 |
imcinventorydm.exe |
资产管理组件的服务进程,负责轮询和审计网络资产、轮询和维护堆叠信息等。 |
UDP/161 |
如果不需要资产管理和堆叠设备管理可以停止该进程 |
imcvlandm.exe |
VLAN管理组件后台进程,负责VLAN数据的轮询和配置,并计算VLAN拓扑 |
UDP/161 TCP/23 |
如果不需要VLAN管理可以停止该进程 |
imcvnmdm.exe |
虚拟网络管理组件后台进程,负责虚拟网络数据的轮询和配置,并计算虚拟网络拓扑 |
TCP/135 TCP/443 TCP8100 |
如果不需要虚拟网络管理可以停止该进程 |
jserver |
iMC前台Web服务进程,负责对外提供Web服务 |
TCP/8080 TCP/8443(在部署平台组件时进行选择) |
启动该进程前,要求数据库及img.exe进程已经启动 如果该进程停止,则无法对外提供Web服务,同时一些定时任务(如定时数据转储、周期性报表生成)也无法完成 |
本文中iMC服务器的安装根目录假设为$IMC_ROOT,服务器安装完成后目录结构请参见表1-8。
目录名 |
说明 |
$IMC_ROOT/apmserver |
存放iMC APM前台相关的文件和子目录 |
$IMC_ROOT/apmserver/bin |
存放apmserver进程的启动/停止命令脚本 |
$IMC_ROOT/apmserver/log |
存放iMC APM 后台相关的运行日志文件 |
$IMC_ROOT/server/conf/apme |
存放iMC APM 应用配置文件 |
$IMC_ROOT/server/conf/apmother |
存放iMC APM转义文件 |
$IMC_ROOT/server/conf/log |
存放iMC APM后台相关的运行日志文件 |
表1-9提供了一些常用文件的存放路径和功能说明。
文件名 |
说明 |
$IMC_ROOT/server/conf/apme下xml文件 |
APM应用配置文件 |
$IMC_ROOT/server/conf/apmother/LocalStrings_zh_CN |
APM转义文件 |
$IMC_ROOT/server/conf/qvdm.conf |
APM后台服务运行日志配置文件 |
后台运行日志记录程序运行中的信息,例如程序启动过程中的数据加载情况、系统运行过程中产生的错误以及潜在错误等,存放在$IMC_ROOT\server\conf\log 目录下。
· iMC后台进程运行日志文件名称的格式
日志文件名称的格式如图1-3所示。
举例:
日志文件“imcapmedm.2022-11-02.log”,表示APM后台2022年11月02日产生的运行日志。
· 系统运行日志的格式
每条运行日志的格式如下所示:
yyyy-mm-dd hh:mm:ss [log level (error code)] [class name::method] description
各分段之间使用空格连接,log level与error code之间使用空格连接,class name与method之间使用“::”连接。
各分段含义请参见表1-10。
分段 |
说明 |
yyyy-mm-dd |
日志输出的年、月、日,如2006-08-22 |
hh:mm:ss |
日志输出的时、分、秒,如20:30:18 |
log level |
日志级别,具体说明请参见表1-5 |
error code |
错误码,如0,1005 |
class name |
类名或名字空间 |
method |
方法名或函数名 |
description |
日志描述信息 |
表1-11 日志级别说明表
日志级别 |
说明 |
FATAL |
致命错误。可能影响系统正常运行,一般无法自动恢复 |
ERROR |
普通错误。模块运行时出错,一般可以自动恢复;系统可以继续正常运行,但是某些处理过程数据或结果数据可能是错误的 |
WARNING |
警告。模块运行时出现异常,可能会引发某些错误,但不影响系统正常运行 |
INFO |
信息。提示用户发生特定事件以及描述一个业务流程的关键步骤,该级别的信息面向测试人员与维护人员 |
DEBUG |
调试。用于跟踪模块的执行步骤,该级别信息面向开发人员 |
iMC各系统数据库的说明请参见表1-12。
数据库名 |
所属组件 |
说明 |
IMC_APM_CONFIG |
iMC APM组件 |
存放应用配置数据 |
IMC_APME |
iMC APM组件 |
存放监控应用采集数据 |
表1-13 iMC进程及端口号说明
进程名称 |
功能描述 |
协议/端口号 |
启动要求及依赖关系 |
imcpamedm.exe |
APM后台处理进程 |
|
|
apmeserver.exe |
APM前台处理进程 |
TCP/9048(接收agent数据端口) |
|
iMC SSA系统包括三种角色,每种角色拥有不同的权限等级,具体描述请参见表1-14。
表1-14 iMC SSA角色描述
角色 |
相关说明 |
管理员 |
拥有系统中除组件部署和License注册以外的所有权限,可以管理所有的设备资源和用户资源 |
维护员 |
拥有除了系统管理及参数设置以外的绝大部分权限 可以定制维护员可管理的设备分组、用户分组,从而对维护员的资源访问权限进行控制 |
查看员 |
拥有除了系统管理及参数设置以外,其他各种功能的查看权限 可以定制查看员可查看的设备分组、用户分组,从而对查看员的资源查看权限进行控制 |
本文中iMC SSA的安装根目录假设为$IMC_ROOT,SSA安装完成后目录结构请参见表1-15。
目录名 |
说明 |
$IMC_ROOT/server |
存放iMC后台相关的文件和子目录 |
$IMC_ROOT/server/bin |
存放iMC后台程序的可执行文件 |
$IMC_ROOT/server/conf |
存放iMC 后台配置文件 |
$IMC_ROOT/server/conf/log |
存放iMC后台相关的运行日志文件 |
$IMC_ROOT/client |
存放iMC前台Web服务使用的相关文件和文件夹 |
$IMC_ROOT/client/bin |
存放iMC前台Web服务的启动、停止脚本和工具 |
$IMC_ROOT/client/conf |
存放iMC前台Web服务的配置文件 |
$IMC_ROOT/client/log |
存放iMC前台Web服务相关的运行日志文件 |
$IMC_ROOT/client/repository |
存放iMC前台Web服务使用的公共类库 |
$IMC_ROOT/client/web |
存放iMC前台Web服务的应用程序 |
表1-16提供了一些常用文件的存放路径和功能说明。
文件名 |
说明 |
$IMC_ROOT/server/conf/ cim.conf |
iMC SSA后台进程的配置文件 |
$IMC_ROOT/server/conf/ log/imccimdm.txt、imccimdm01.txt、imccimdm02.txt 、imccimdm03.txt、 imccimdm04.txt |
iMC SSA后台日志 |
$IMC_ROOT/client/conf/cim/serverinfo/vendor.xml |
iMC SSA开启自定义SNMP采集 |
$IMC_ROOT/client/conf/cim/rest/conf/ vendor.xml |
iMC SSA开启自定义REST采集 |
$IMC_ROOT/ client/log/ imcforeground.log |
iMC SSA前台日志 |
iMC SSA系统数据库的说明请参见表1-17。
数据库名 |
所属组件 |
说明 |
ssa_db |
iMC SSA |
存放SSA基础数据 |
iMC SSA进程及端口号说明请参见表1-18。
表1-18 iMC进程及端口号说明
进程名称 |
功能描述 |
协议/端口号 |
启动要求及依赖关系 |
jserver |
iMC前台Web服务进程,负责对外提供Web服务 |
TCP/8080 TCP/8443(在部署平台组件时进行选择) |
启动该进程前,要求数据库及img.exe进程已经启动 如果该进程停止,则无法对外提供Web服务,同时一些定时任务(如定时数据转储、周期性报表生成)也无法完成 |
imccimdm |
iMC SSA后台进程 |
TCP/99 |
|
imccimdm01 |
iMC SSA后台进程 |
TCP/1298 |
|
imccimdm02 |
iMC SSA后台进程 |
TCP/1299 |
|
imccimdm03 |
iMC SSA后台进程 |
TCP/1300 |
|
imccimdm04 |
iMC SSA后台进程 |
TCP/1301 |
|
Windows Server操作系统是图形界面,操作比较简单。因此这里仅介绍与iMC 相关的常用操作。
Windows Server的任务管理器可以监控当前Windows环境中程序的运行情况。
在Windows Server正常运行时,按下<Ctrl+Alt+Delete>键,屏幕上会弹出Windows 安全界面,在安全界面上单击<任务管理器>按钮,启动任务管理器,如图2-1所示。
在Windows任务管理器中选择“进程”页面,可以查看当前系统中所有进程的情况,如图2-2所示。
上图中显示了每个进程的名称、进程号、CPU 号、CPU 的占用时间、内存占用大小,单击相应的按钮可以对进程进行排序,方便对进程的监控。
安装SQL Server时不要使用Windows用户绑定模式,一定要使用混合模式,即给出sa单独的口令。
通过部署监控代理监控服务器的资源及进程情况。
在开始-程序-H3C 智能管理中心-H3C 部署监控代理,启用iMC部署监控管理代理,如图2-3所示。
在监控Tab页中检测iMC服务器的磁盘空间,CPU,内存的使用率是否正常,如图2-4所示。
在进程Tab页中检测iMC的相关进程是否运行正常,如图2-5所示。
在运行环境Tab页中检测iMC的数据库状态是否正常,如图2-6所示。