IBM Installation Manager 指令行引數

使用這個參照表格,可以進一步瞭解 Installation Manager 指令行引數。

引數 說明
-accessRights 定義 Installation Manager 要在管理者或非管理者模式中運作。若是非管理者模式,請使用 —accessRights 引數與 nonAdmin 參數搭配:-accessRights nonAdmin;若是管理者模式,請使用 —accessRightsadmin 參數搭配:-accessRights admin
如果未使用 —accessRights,則會根據現行使用者的權限設定預設值。
註:
若是 Administrator 群組成員的 Microsoft® Windows® XP 使用者,預設值一律是 -accessRights admin。若是在非管理者模式中執行的使用者,請明確傳遞 -accessRights nonAdmin 引數。

使用者沒有適當的系統權限時,Installation Manager 會報告錯誤。

小心: 安裝、修改、更新、回復或解除安裝 Installation Manager 的相同實例時,請勿變更此引數。例如,User1 會使用管理者存取權,將 Installation Manager 安裝在 C:\user1\InstallationManager 目錄中。當執行指令來修改 C:\user1\InstallationManager 目錄中的 Installation Manager 時,User1 不得使用 -accessRights nonAdmin 引數。

如需以管理者或非管理者身分進行安裝的相關資訊,請參閱以管理者或非管理者身分安裝

-dataLocation <agentDataLocation> 指定 Installation Manager 資料目錄的目錄位置。此位置可儲存已安裝套件的相關資訊。請在安裝 Installation Manager 時設定此位置。
小心: 請勿在安裝 Installation Manager 之後變更此引數。變更此引數會損壞安裝資料。此損壞會讓您無法修改、更新、回復或解除安裝已安裝的套件。

如需儲存在代理程式資料位置中的檔案類型及資訊等相關資訊,請參閱代理程式資料位置

-encryptString stringToEncrypt 加密輸入的字串。使用 -encryptString 搭配 -passwordKey,以增加加密安全性。

在使用者介面中,下列指令會開啟「字串加密公用程式」視窗:IBMIM -encryptString password,其中 password 是已加密的字串。在「字串加密公用程式」視窗中,「要加密的字串」欄位包含要加密的字串。字串的加密版本欄位包含要複製到回應檔的加密值。在「字串加密公用程式」中,您可以變更要加密的字串欄位,然後按一下確定以產生新的加密字串。

在指令行介面中,下列指令會傳回指令行上的已加密字串:IBMIM -silent -noSplash -encryptString password,其中 password 是已加密的字串。

當您錄製回應檔時,即會在回應檔中建立並儲存密碼的已加密字串。其中 value 包含已加密字串。

IBM Rational ClearCase 回應檔中已加密字串的範例:
<profile installLocation='C:Program Files\IBM\RationalSDLC' id="IBM Rational SDLC'>
<data key='user.CC_ServerProcessPassword,com.ibm.rational.clearcase.nt_i386' value='1ML/Coqkg33e5616BcUnYg=='
</profile>

錄製回應檔之後,請使用 -encryptString 來產生不同的已加密字串,並將這些字串貼入回應檔中。例如,您可以錄製回應檔。您有五部電腦要使用回應檔來安裝 IBM 產品。這五部電腦需要在回應檔中各自使用不同的資料金鑰密碼值。在其中一部電腦上執行安裝之前,請產生要在該電腦上使用之密碼的已加密字串。將已加密字串複製到回應檔。使用更新的回應檔,來啟動無聲自動安裝。

-exportInstallData <InstallDataFile> 將安裝資料以 .zip 檔案格式匯出到指定的檔案。
您可以使用此引數來產生包含問題分析用資料的 .zip 檔。
  • Windows:IBMIMc.exe --launcher.ini silent-install.ini -exportInstallData <installDataFile>
  • Linux 及 UNIX:IBMIM --launcher.ini silent-install.ini -exportInstallData <installDataFile>
其中 <installDataFile> 是所產生檔案的名稱,檔案中包含已匯出的資料。
-help 顯示 Installation Manager 指令行引數的簡要說明。
-ignoreRepositoryDigest 引導 Installation Manager 在存取儲存庫時,忽略儲存庫摘要檔 repository.xml
-input <responseFile> 指定 XML 回應檔作為 Installation ManagerInstallation Manager 安裝程式的輸入。回應檔包含 Installation ManagerInstallation Manager 安裝程式執行的指令。

您不能使用 -input 搭配 -installAll-updateAll

您可以對 <responsefile> 值使用檔案路徑或 URL。這些範例顯示檔案路徑及 URL 字串:
  • 檔案路徑:
    • Windows:-input C:\response_files\myresponsefile.xml
    • Linux 及 UNIX:-input /response_files/myresponsefile.xml
  • URL:-input http://server/response_files/myresponsefile.xml
記住: 您可以錄製回應檔、編輯範例回應檔,或手動建立回應檔。
-keyring <file> [-password <password>] 指定時,如果金鑰環檔案不存在,則會導致 Eclipse 建立金鑰環檔案。-password <password> 是選用引數。如果未指定密碼,Eclipse 會使用預設密碼。您可以指定密碼來開啟金鑰環檔,以提供更強的加密。

金鑰環檔的內容是加密的。您必須對金鑰環檔具有寫入權限。

Installation Manager 使用 Eclipse 基礎架構,將認證儲存至金鑰環檔。如需金鑰環檔的相關資訊,請參閱可從 http://www.eclipse.org 取得的《Eclipse 工作台使用手冊》。

--launcher.ini <.ini file>
範例:
  • --launcher.ini silent-install.ini
  • --launcher.ini silent-uninstall.ini
  • --launcher.ini user-silent-install.ini
  • --launcher.ini user-silent-uninstall.ini
指定要使用的產品 .ini 檔的位置。如果未指定此引數,Installation Manager 會在啟動程式所在的同一個目錄中,檢查是否有相同名稱且副檔名為 ".ini" 的檔案。比方說,如果 installc.exe 是啟動程式,則 Installation Manager 會檢查是否有 installc.ini

silent-install.ini 檔案包含用於無聲自動安裝的起始設定參數。silent-install.ini 檔案與 installc.exe 檔案位於同一個目錄中,而且必須存在。

user-silent-install.ini 檔案用於非管理者安裝。

user-silent-uninstall.ini 檔案用於非管理者解除安裝程序。

重要:Installation Manager 安裝檔案中提供的 silent-install.iniuser-silent-install.ini 檔案版本,會使用 -input 指令行引數。若要使用 -installAll-updateAll 與這些 .ini 檔案搭配,您必須移除兩行:-input 行及指向回應檔的那一行。要移除的兩行範例:
-input
@osgi.install.area\install.xml
如果未移除 -input 及回應檔行,則 -installAll-updateAll 指令行引數不會運作。

Installation Manager 安裝目錄中的 .ini 檔案不會使用 -input 指令行引數。

來自 Installation Manager 安裝檔案的 silent-install.ini 檔案範例:
-accessRightsadmin
-vmjre_5.0.2.sr8a_20080811b\jre\bin\java.exe
-nosplash--launcher.suppressErrors-silent-input
@osgi.install.area\install.xml
-vmargs
-Xquickstart
-Xgcpolicy: gencon
來自 Installation Manager 安裝目錄的 silent-install.ini 檔案範例:
-accessRightsadmin
-vmC:\Program Files\IBM\Installation Manager\eclipse\jre_5.0.2.sr8a_20080811b\jre\bin\java.exe
-nosplash--launcher.suppressErrors-silent-vmargs
-Xquickstart
-Xgcpolicy: gencon

如果您執行一個使用 -input 引數的指令,而且您使用的 .ini 檔也包含 -input 引數,則會使用指令中的 -input 引數指定的回應檔。會忽略 .ini 檔案中的 -input 引數指定的回應檔。使用 -input 引數的指令範例:./install --launcher.ini silent-install.ini -input <input file path and name>

--launcher.suppressErrors 隱藏 Java™ 虛擬機器 (JVM) 錯誤對話框。
-log (選用)指定日誌檔來記錄無聲自動安裝的結果。日誌檔是一個 XML 檔。

無聲自動安裝完成時,此日誌檔會包含 <result> </result> 的根元素。安裝期間發生錯誤時,無聲自動安裝日誌檔會包含錯誤元素及訊息。

錄製回應檔時,請勿使用 -log

-mode wizard 使用指定的回應檔執行「安裝」精靈。使用 -mode wizard 時,必須使用 -input
-nosplash 隱藏啟動畫面。
-passwordKey

開啟視窗,讓使用者輸入密碼金鑰。密碼金鑰可用來加密或解密需要加密的欄位。

只有 GUI 模式支援使用 -passwordKey 而不指定 <passwordKey>。若為無聲自動安裝,您必須使用 -passwordKey <passwordKey>
-passwordKey <passwordKey> 使用 <passwordKey> 來加密或解密密碼。
-record <responseFile> 指定回應檔的位置。
-showProgress 在主控台顯示進度列。
-ShowVerboseProgress 在主控台顯示進度文字。例如,在需要重新啟動電腦時,會顯示文字重新啟動機器以完成安裝。
-silent
  • -silent -installAll
  • -silent -updateAll
指定在無聲自動模式中執行 Installation Manager 安裝程式或 Installation Manager

使用 -silent -installAll,以無聲自動安裝所有可用的套件。

使用 -silent -updateAll,以無聲自動更新所有已安裝的套件。

您無法使用 -input 搭配 -installAll-updateAll。使用 -installAll,會安裝套件的預設功能。若要指定要安裝哪些功能,必須使用 -input <responseFile>。回應檔包含要安裝功能的相關資訊。
註: 錄製回應檔時,您可以選取要安裝的功能。
-skipInstall <agentDataLocation> 錄製回應檔但不安裝 IBM 產品。agentDataLocation 值指定安裝資料夾及檔案的目錄位置。雖然未安裝 IBM 產品,但是會建立安裝所需的檔案及資料夾,並將它們儲存在指定的目錄中。此目錄必須是可寫入的目錄。

驗證引數中的檔案路徑是否存在。Installation Manager 不會建立回應檔的目錄。

小心: 請不要對新的 agentDataLocation 位置值指定現有的 agentDataLocation 目錄。請參閱代理程式資料位置,以取得 agentDataLocation 目錄的預設位置。
重要: 使用 -skipInstall 引數錄製回應檔時,您必須保留所建立的目錄、資料夾及檔案。保留 agentDataLocation 目錄,您才可以在稍後修改安裝。當錄製新的回應檔來修改安裝時,請對 agentDataLocation 指定相同的目錄。

對您安裝的每一個 IBM 產品版本,使用不同的 agentDataLocation 值。

您必須先使用 -skipInstall 錄製 IBM 產品安裝,然後才能錄製更新。

-version 列印應用程式的版本,然後結束。
-vm 指定 Java 啟動程式。在無聲自動模式中,於 Windows 上一律使用 java.exe:而於 Linux® 及 UNIX® 上,則一律使用 java

意見