01-iMC Plat 配置舉例

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

iMC工具命令使用指南

資料版本：5W110-20230427

非經本公司書麵許可，任何單位和個人不得擅自摘抄、複製本文檔內容的部分或全部，並不得以任何形式傳播。

除bobty下载软件的商標外，本手冊中出現的其它公司的商標、產品標識及商品名稱，由各自權利人擁有。

本文檔中的信息可能變動，恕不另行通知。

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。