01-iMC Plat 配置举例

11-iMC Plat iMC工具命令使用指南

iMC工具命令使用指南

资料版本：5W110-20230427

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

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

本文档中的信息可能变动，恕不另行通知。

1 本文导读

iMC不仅设计了丰富的界面功能，还提供了一些如启动进程、停止进程等的命令工具。通过这些工具与界面操作的相互配合，可以实现更有效的网络管理。本文汇集了目前iMC中的所有配置命令，并对其使用方法进行了详细的介绍。

所有工具均存放在iMC安装路径下的“client\bin”和“deploy”文件夹下，如图1所示。

图1 命令文件

系统提供了“.bat”和“.sh”两类可执行文件，“.bat”适用于Windows操作系统，“.sh”适用于Linux操作系统。

本文均使用Windows作为演示环境，Linux系统下的操作方法类似，请参考使用。

2 命令Mapping

表1介绍了iMC中各配置命令的主要功能，点击命令链接即可进入相应的详细介绍，包括存放位置、操作方式、操作结果等信息。

表1 命令Mapping

系统维护		日志与监控		界面替代操作
命令	功能	命令	功能	命令	功能
hardwareinfoobtain	收集服务器硬件信息	logfiles	收集iMC日志	install	启动组件安装程序
resetpwd	重置admin用户密码	setloglevel	调整日志级别	startup	启动jserver进程
pwdmgr	查询、修改数据库密码	jmonitor	查看jserver进程运行情况	shutdown	停止jserver进程
setmem	设置jserver程序最大可用内存	tmonitor	启动测试监控
setsqlservermaxmem	设置SQL Server服务最大内存	cmonitor	启动Java线程CPU执行时间测试监控
setwebport	设置iMC的Web服务端口
snregen	重新生成一个的序列号（3Com版本）
ovtopodumpconverter	将OpenView拓扑导出文件格式转换为iMC使用的文件格式
svcinst.bat	双机环境下，在备机安装iMC服务等

3 命令详解

3.1 系统维护

3.1.1 hardwareinfoobtain.bat

【功能描述】用于收集系统的MAC地址、硬盘序列号等硬件信息，当申请的License无效时可将此文件和失效的License文件一同发给研发接口人处理。

【存放路径】[iMC安装路径]\client\bin\hardwareinfoobtain.bat

【执行方式】双击文件即可。

【执行效果】双击执行文件后，生成的硬件信息将以Log形式存放。具体路径为[iMC安装路径]\client\log\hardwareInfo.log”，如图2所示。

图2 硬件信息

3.1.2 resetpwd.bat

【功能描述】当忘记admin帐号的密码时，可以使用该命令将admin帐号的密码重置为“admin”。

【存放路径】[iMC安装路径]client\bin\resetpwd.bat

【执行方式】双击文件即可。

【执行效果】双击该文件后，密码会立即被重置。然后，使用admin帐号和默认密码即可成功登录iMC。

3.1.3 pwdmgr.bat

【功能描述】用于查询或修改iMC中保存的各组件使用的数据库用户密码。

· iMC中各组件使用的数据库用户名及密码信息以密文的方式保存在各服务器上[iMC安装路径]\common\conf\ server-addr.xml配置文件中。该工具仅用于从此文件中读取密码明文，或将修改后的密码加密后保存到此文件中。

· 如果iMC组件使用的数据库用户对应的密码被修改（通常使用数据库管理工具执行数据库用户密码的修改操作），则必须用此命令同步修改server-addr.xml配置文件中的密码，以确保iMC能够正常连接到数据库。如果iMC采用分布式方式部署，则必须在所有服务器上使用该命令修改对应数据库用户的密码。

【存放路径】[iMC安装路径]\deploy\pwdmgr.bat

【执行方式】

· 语法结构：pwdmgr.bat {-query|-modify} 数据库服务器IP地址数据库名数据库用户名

· 参数说明：query用于查询指定数据库的密码；modify用于修改指定数据库密码。

【执行效果】以查询config_db数据库的imc_config用户的密码为例，如图3所示，在命令行模式下执行该脚本，查询到用户密码为“iMC7_BLUm8ofaU7”。

图3 查询数据库config_db的imc_config用户的密码

iMC数据库信息可以在common\conf\server-addr.xml文件中找到。该文件中的password为经过加密后的数据库密码。查询数据库密码时，数据库地址、名称、用户名均可以从该文件中找到，如图4所示。

图4 数据库信息

3.1.4 setmem.bat

【功能描述】设置jserver程序最大可用内存。当遇到系统资源不足时，可以通过该命令调整Java heap内存。请参考表2和表3选择调整的数值。

表2 32位操作系统

节点数	采集单元	在线操作员数	Java Heap内存
0~200	0~5K	20	512M（Windows） 512M（Linux）
0~200	5K~50K	10	512M（Windows） 512M（Linux）
200~500	0~10K	30	1G（Windows） 1G（Linux）
200~500	10K~100K	10	1G（Windows） 1G（Linux）

表3 64位操作系统

节点数	采集单元	在线操作员数	Java Heap内存
0~200	0~5K	20	2G（Windows） 2G（Linux）
0~200	5K~50K	10	2G（Windows） 2G（Linux）
200~1K	0~10K	30	2G（Windows） 4G（Linux）
200~1K	10K~100K	10	2G（Windows） 4G（Linux）
1K~2K	0~20K	30	4G（Windows） 6G（Linux）
1K~2K	20K~200K	10	4G（Windows） 6G（Linux）
2K~5K	0~30K	40	8G（Windows） 8G（Linux）
2K~5K	30K~300K	20	8G（Windows） 8G（Linux）
5K~10K	0~40K	50	12G（Windows） 12G（Linux）
5K~10K	40K~400K	20	12G（Windows） 12G（Linux）
10K~15K	0~40K	50	16G（Windows） 16G（Linux）
10K~15K	40K~400K	20	16G（Windows） 16G（Linux）

采集单元是指每5分钟对一个采集实例进行一次采集的过程。一个采集实例即一个性能采集指标的实例，采集实例计算的举例如表4所示，以一个设备为例。

表4 采集实例计算

监视对象	对象数量	性能采集指标	采集实例
设备CPU	1	CPU利用率	1
设备内存	1	内存利用率	1
设备接口	10	接收速率	10
设备接口	10	发送速率	10
设备整体	1	设备不可达率	1
设备整体	1	设备响应时间	1
总计	采集实例数：24

如果这24个采集实例的采集间隔都是5分钟，则采集单元为24个。如果这24个采集实例的采集间隔都是10分钟，则采集单元为12个。

· 若使用32位操作系统，堆内存设置建议不超过1024M，非堆内存设置建议不超过768M；若使用64位操作系统，则内存设置没有上限。

· 调整内存后，需重新启动jserver进程方可生效。

· 在32位操作系统中，不同环境支持的内存上限不同。如果调整内存后jserver无法启动，请将内存适当调小后再次尝试，直到能启动为止。对多组件部署的iMC环境，建议使用64位操作系统。

【存放路径】[iMC安装路径]\client\bin\setmem.bat

【执行方式】语法结构：setmem 堆内存数值非堆内存数值

【执行效果】进入文件所在路径，执行脚本文件，如图5所示。

图5 设置jserver程序最大可用内存

3.1.5 setsqlservermaxmem.bat

【功能描述】设置SQL Server服务的最大使用内存。在iMC使用本地数据库的情况下，设置SQL Server最大内存后，可能会影响iMC对数据库的访问性能。因此，若服务器性能较低时，建议考虑扩大物理内存，而不能仅通过设置允许SQL Server使用的内存最大值解决。

【存放路径】[iMC安装路径]\client\bin\setsqlservermaxmem.bat

【执行方式】

· 语法结构：setsqlservermaxmem.bat -server 数据库服务器IP地址 -saPwd “sa”用户的密码 -maxMem 最大内存数值

· 参数说明：saPwd指“sa”用户的密码；maxMem以MB为单位。

【执行效果】如图6所示，将“10.114.119.61”这台SQL Server服务器的最大使用内存设置为2048MB。

图6 设置数据库最大使用内存

3.1.6 setwebport.bat

【功能描述】用于设置iMC的Web服务端口。

【存放路径】[iMC安装路径]\client\bin\setwebport.bat

【执行方式】语法结构：在命令行模式下输入setwebport，然后根据提示完成设置。

【执行效果】根据提示信息修改HTTP和HTTPS端口号（括号内为目前使用的端口号），如图7所示。此外，修改后请重新启动jserver进程，配置方可生效。

图7 修改iMC的Web服务端口号

3.1.7 snregen.bat

【功能描述】当生成的序列号发生重复时，可以用这个工具重新生成一个新的序列号。该功能仅对3Com版本和非亚太区的H3C版本iMC有效。

【存放路径】[iMC安装路径]\client\bin\snregen.bat

【执行方式】语法结构：在命令行模式下输入snregen.bat。

【执行效果】在命令行模式下执行该命令，如图8所示。

图8 生成序列号

3.1.8 ovtopodumpconverter.bat

【功能描述】将OpenView拓扑导出的文件格式转换为iMC设备导入时使用的文件格式。

【存放路径】[iMC安装路径]\client\bin\ovtopodumpconverter.bat

【执行方式】

· 语法结构：ovtopodumpconverter.bat 源文件所在路径\源文件名目标文件所在路径\目标文件名

· 参数说明：源文件为从OpenView中导出的拓扑文件；目标文件参数为欲将转换后的文件保存的位置和文件名称。

【执行效果】在命令行模式下执行该命令，如图9所示。

图9 文件格式转换

格式转换后生成的文件会以输入的文件名和存放路径进行保存。

3.1.9 svcinst.bat

【功能描述】用于双机热备环境，在备机安装iMC服务、快捷方式等。

在部署iMC双机热备时，将iMC安装部署在主机服务器上，备机不用重复安装部署，只需切换到备机上执行安装目录下的几个命令即可。欲详细了解iMC双机热备方案，请参考《Windows2008版本iMC双机热备功能开局配置指导(V1.06)》。

图10 双网卡双机热备组网方案

【存放路径】[iMC安装路径]\deploy\svcinst.bat

【执行方式】语法结构：svcinst.bat [-install] [-uninstall]，其中install包含诸多参数，如图11所示。

图11 svcinst.bat相关参数

【执行效果】以常规的安装方式为例，iMC安装目录为“H:\Program Files\iMC”；iMC数据文件目录为“H:\Program Files\imcdata”；服务类型为“master”；语言为“中文”；国家为“中国”；使用SQL Server数据库；数据库管理员密码为“sa”；数据库地址为“192.168.0.1”。对应执行的命令是：

svcinst.bat -instdir H:\Program Files\iMC -datadir H:\Program Files\imcdata -servertype master -language zh -country CN -dbtype SQLServer -dbadminpasswd sa -dbaddress 192.168.0.1

若需卸载iMC服务，则需要在备机上执行svcinst.bat –uninstall。