


H3C iMC
维护手册


新华三技术有限公司 http://www.h3c.com 资料版本：5W101-20230210

未经本公司书面许可，任何单位和个人不得擅自摘抄、复制本书内容的部分或全部，并不得以任何形式传播。

除新华三技术有限公司的商标外，本手册中出现的其它公司的商标、产品标识及商品名称，由各自权利人拥有。

由于产品版本升级或其他原因，本手册内容有可能变更。H3C保留在没有任何通知或者提示的情况下对本手册的内容进行修改的权利。本手册仅作为使用指导，H3C尽全力在本手册中提供准确的信息，但是H3C并不确保手册内容完全没有错误，本手册中的所有陈述、信息和建议也不构成任何明示或暗示的担保。

1 维护入门··· 1

1.1 iMC PLAT(平台)基础知识·· 1

1.1.1 系统角色和操作员分组·· 1

1.1.2 iMC PLAT目录结构·· 2

1.1.3 iMC PLAT常用文件说明·· 3

1.1.4 iMC PLAT后台程序日志文件说明·· 4

1.1.5 iMC PLAT 相关数据库说明·· 6

1.1.6 iMC PLAT相关进程说明·· 7

1.2 iMC APM基础知识·· 9

1.2.1 iMC APM目录结构·· 9

1.2.2 iMC APM常用文件说明·· 9

1.2.3 iMC APM后台程序日志文件说明·· 10

1.2.4 iMC APM 相关数据库说明·· 11

1.2.5 iMC APM相关进程说明·· 11

1.3 iMC SSA（服务器存储自动化）基础知识·· 12

1.3.1 系统角色和操作员分组·· 12

1.3.2 iMC SSA目录结构·· 12

1.3.3 iMC SSA常用文件说明·· 13

1.3.4 iMC SSA 相关数据库说明·· 13

1.3.5 iMC SSA相关进程说明·· 13

2 iMC 服务器例行维护··· 15

2.1 操作系统维护·· 15

2.1.1 Windows操作系统·· 15

2.2 数据库维护·· 16

2.2.1 安全注意事项·· 16

2.3 iMC 监控管理代理·· 16

1 维护入门

1.1 iMC PLAT(平台)基础知识

1.1.1 系统角色和操作员分组

iMC系统包括三种角色，每种角色拥有不同的权限等级，具体描述请参见表1-1。

表1-1 iMC角色描述

角色	相关说明
管理员	拥有系统中除组件部署和License注册以外的所有权限，可以管理所有的设备资源和用户资源
维护员	拥有除了系统管理及参数设置以外的绝大部分权限可以定制维护员可管理的设备分组、用户分组，从而对维护员的资源访问权限进行控制
查看员	拥有除了系统管理及参数设置以外，其他各种功能的查看权限可以定制查看员可查看的设备分组、用户分组，从而对查看员的资源查看权限进行控制

在此三类角色的基础上，可以进一步细分权限，构成操作员分组。iMC的每个操作员都属于一个操作员分组，由此决定其操作权限。

操作员分组可以由用户进行定制。系统预定义三个缺省分组：“管理员分组”、“维护员分组”和“查看员分组”，缺省分组不允许修改。用户自定义的操作员分组在上述三个缺省分组之一的基础上进行创建，并根据需要缩减权限，如图1-1所示。

图1-1 增加操作员分组

1.1.2 iMC PLAT目录结构

本文中iMC服务器的安装根目录假设为$IMC_ROOT，服务器安装完成后目录结构请参见表1-2。

表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.1.3 iMC PLAT常用文件说明

表1-3提供了一些常用文件的存放路径和功能说明。

表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服务的运行日志配置文件

1.1.4 iMC PLAT后台程序日志文件说明

日志是记录了各种信息的文件或数据表，用于跟踪和定位问题。iMC系统提供了两种日志：运行日志和操作日志。其中操作日志是系统提供给最终用户使用的功能，可以通过界面进行查询，此处不做赘述，以下将对运行日志进行详细说明。

后台运行日志记录程序运行中的信息，例如程序启动过程中的数据加载情况、系统运行过程中产生的错误以及潜在错误等，存放在$IMC_ROOT\server\conf\log 目录下，分为iMC后台进程运行日志和iMF/iMG运行日志。

1. iMC后台进程运行日志

· iMC后台进程运行日志文件名称的格式

日志文件名称的格式如图1-2所示。

图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。

表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	日志描述信息

表1-5 日志级别说明表

日志级别	说明
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。

2. iMF/iMG运行日志

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号任务被删除掉了。

1.1.5 iMC PLAT 相关数据库说明

iMC各系统数据库的说明请参见表1-6。

表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	虚拟网络管理组件	存放虚拟网络相关配置数据

1.1.6 iMC PLAT相关进程说明

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服务，同时一些定时任务（如定时数据转储、周期性报表生成）也无法完成

1.2 iMC APM基础知识

1.2.1 iMC APM目录结构

本文中iMC服务器的安装根目录假设为$IMC_ROOT，服务器安装完成后目录结构请参见表1-8。

表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.2.2 iMC APM常用文件说明

表1-9提供了一些常用文件的存放路径和功能说明。

表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后台服务运行日志配置文件

1.2.3 iMC APM后台程序日志文件说明

后台运行日志记录程序运行中的信息，例如程序启动过程中的数据加载情况、系统运行过程中产生的错误以及潜在错误等，存放在$IMC_ROOT\server\conf\log 目录下。

1. iMC APM后台进程运行日志

· iMC后台进程运行日志文件名称的格式

日志文件名称的格式如图1-3所示。

图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。

表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	调试。用于跟踪模块的执行步骤，该级别信息面向开发人员

1.2.4 iMC APM 相关数据库说明

iMC各系统数据库的说明请参见表1-12。

表1-12 数据库说明表

数据库名	所属组件	说明
IMC_APM_CONFIG	iMC APM组件	存放应用配置数据
IMC_APME	iMC APM组件	存放监控应用采集数据

1.2.5 iMC APM相关进程说明

表1-13 iMC进程及端口号说明

进程名称	功能描述	协议/端口号	启动要求及依赖关系
imcpamedm.exe	APM后台处理进程
apmeserver.exe	APM前台处理进程	TCP/9048（接收agent数据端口）

1.3 iMC SSA（服务器存储自动化）基础知识

1.3.1 系统角色和操作员分组

iMC SSA系统包括三种角色，每种角色拥有不同的权限等级，具体描述请参见表1-14。

表1-14 iMC SSA角色描述

角色	相关说明
管理员	拥有系统中除组件部署和License注册以外的所有权限，可以管理所有的设备资源和用户资源
维护员	拥有除了系统管理及参数设置以外的绝大部分权限可以定制维护员可管理的设备分组、用户分组，从而对维护员的资源访问权限进行控制
查看员	拥有除了系统管理及参数设置以外，其他各种功能的查看权限可以定制查看员可查看的设备分组、用户分组，从而对查看员的资源查看权限进行控制

1.3.2 iMC SSA目录结构

本文中iMC SSA的安装根目录假设为$IMC_ROOT，SSA安装完成后目录结构请参见表1-15。

表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.3.3 iMC SSA常用文件说明

表1-16提供了一些常用文件的存放路径和功能说明。

表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前台日志

1.3.4 iMC SSA 相关数据库说明

iMC SSA系统数据库的说明请参见表1-17。

表1-17 数据库说明表

数据库名	所属组件	说明
ssa_db	iMC SSA	存放SSA基础数据

1.3.5 iMC 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