Installation Manager 指令行引數

使用下表進一步瞭解 IBM Installation Manager 指令行引數。

指令行引數由指令和選項組成。使用指令時可以不指定選項。大部分指令都不使用橫線。為了與 Installation Manager 舊版相容,有些指令會以橫線開頭。使用選項時,則必須指定指令。選項會以橫線開頭。
註:Installation Manager 指令行中,不能使用星號 (*)。輸入星號時,Installation Manager 無法辨識指令行引數且會產生錯誤。

表 1 列出「指令」,表 2 列出「選項」。

表 1:指令

指令 說明
encryptString stringToEncrypt
加密輸入的字串。

在指令行介面中,開啟 eclipse 目錄,輸入 encryptString 指令及字串,並搭配 -nosplash 選項,以傳回已加密字串。這時會開啟「字串加密公用程式」視窗,其中的要加密的字串欄位包含要加密的字串。字串的加密版本欄位包含要複製到回應檔的加密值。在「字串加密公用程式」中,您可以變更要加密的字串欄位,然後按一下確定以產生新的加密字串。

encryptString-passwordKey 搭配使用時,可增加加密安全。

當您錄製回應檔時,即會在回應檔中建立並儲存密碼的已加密字串。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 outputFileName
將安裝資料匯出為 .zip 格式的指定檔案,其中 outputFileName 是所產生檔案的名稱,它包含匯出的資料。

在指令行介面中,開啟 eclipse 目錄,輸入 exportInstallData 指令及檔名,並搭配 -noSplash-silent 選項匯出安裝資料。

help, -help, -h, ?, -? 	help command 	help all
顯示 Installation Manager 指令行引數的簡要說明。

help 指令與另一個指令搭配使用時,會顯示該指令的簡要說明。與 all 選項搭配使用時,會顯示所有指令的說明。

為了舊版相容性,這個指令可加上橫線:-help

input responseFile
將 XML 回應檔指定為 Installation ManagerInstallation Manager 安裝程式的輸入。回應檔包含 Installation ManagerInstallation Manager 安裝程式執行的指令。
請不要對下列指令使用 input
  • installAll, -installAll
  • updateAll, -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
認證必須儲存在金鑰環檔案中,而不是儲存在無聲自動安裝 Script 中。
記住: 您可以錄製回應檔、編輯範例回應檔,或手動建立回應檔。

為了舊版相容性,這個指令可加上橫線:-input

installAll
重要:Installation Manager 1.4.4 版開始,已淘汰 installAll。建議您不要使用這個指令,因為同時安裝多個產品會有許多相關的潛在問題。例如:
  • 如果套件具有相同的預設安裝目錄,但套件無法安裝到相同的套件群組,則安裝會失敗。
  • 需要其他安裝資訊的套件,安裝可能有問題。使用者必須使用 -properties 選項提供必要資料,而這會造成套件之間發生資料衝突。
  • 您不能控制安裝延伸套件的位置。
  • 同時安裝許多套件可能需要大量磁碟空間,因此需要很長的時間才能完成。
在指定的儲存庫中安裝所有套件。

這個指令會將所有可存取儲存庫中的所有套件,安裝到其預設安裝目錄中。依預設套件特性,它可以只安裝已選取的套件。

請不要對下列指令使用 installAll
  • input, -input
  • updateAll, -updateAll
updateAll
從服務儲存庫及定義在 Installation Manager 喜好設定中的儲存庫,更新所有已安裝的套件。
請使用 updateAll 指令來搭配下列指令:
  • -installFixes:安裝修正程式。
  • -properties:定義套件群組設定檔內容。
  • -repositories:置換 Installation Manager 中的儲存庫清單,並指定套件所在位置。
請不要對下列指令使用 updateAll
  • input, -input
  • installAll, -installAll
version
顯示 Installation Manager 的版本及內部版本。

為了舊版相容性,這個指令可加上橫線:-version

表 2:選項

選項 說明
-acceptLicense
當所安裝的套件需要您接受授權合約時,請在指令中併入 -acceptLicense 選項。
-accessRights, -aR mode

其中 mode=[admin, nonAdmin, group]

定義 Installation Manager 要在管理者、非管理者或群組模式中運作。若為管理者模式,請使用 —accessRights 搭配 admin 參數:-accessRights Admin。若為非管理者模式,請使用 —accessRights 引數搭配 nonAdmin 參數:-accessRights nonAdmin。若為群組模式,請使用 —accessRights 搭配 group 參數:-accessRights group

只能安裝一個 Installation Manager 管理者實例。若為非管理者,只能為每一個使用者安裝一個 Installation Manager 實例。

如果未使用 —accessRights,則會根據現行使用者許可權設定預設值。
註:
  • 如果是本身為「管理者」群組成員的 Microsoft Windows XP Professional 使用者,預設值一律是 -accessRights admin。若是在非管理者模式中執行的使用者,請明確傳遞 -accessRights nonAdmin 引數。

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

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

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

-dataLocation, -dL dataLocation
指定 Installation Manager 資料目錄的目錄位置。此位置可儲存已安裝套件的相關資訊。請在安裝 Installation Manager 時設定此位置。-datalocation 設定的目錄位置不得是 Installation Manager 安裝目錄的子目錄。
小心:
  • 請勿在安裝 Installation Manager 之後變更此引數。變更此引數會損壞安裝資料。此損壞會讓您無法修改、更新、回復或解除安裝已安裝的套件。
  • 如果您對 -dataLocation 指定的目錄位置不是預設值,則每次您使用 Installation ManagerInstallation Manager 安裝程式時,都必須使用指定的位置。若為 Installation Manager 安裝程式,則每次啟動該安裝程式時,都必須使用 -dataLocation 選項指定相同的目錄位置。Installation Manager 的已安裝實例會自動使用指定的位置。
必須對 -datalocation 選項使用相同目錄位置的範例:
  • 未安裝 Installation Manager,且您使用 Installation Manager 安裝程式。每次您啟動安裝程式時,都必須對 -dataLocation 指定相同的目錄位置。如果未使用相同的位置,會建立多個 dataLocation 位置而發生毀損。
  • Installation Manager 已使用指定的目錄位置安裝。如果您使用 Installation Manager 安裝程式,則必須使用 -dataLocation 選項指定相同的目錄位置。

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

-keyring file [-password password]
指定時,如果金鑰環檔案不存在,則會導致 Eclipse 建立金鑰環檔案。-password password 是選用引數。如果未指定密碼,Eclipse 會使用預設密碼。您可以指定開啟金鑰環檔案的密碼,來提供更強的加密。

金鑰環檔案的內容已加密。您必須對金鑰環檔具有寫入許可權。

Installation Manager 使用 Eclipse 基礎架構,將認證儲存在金鑰環檔案中。如需金鑰環檔案的相關資訊,請參閱 Eclipse 工作台使用手冊

小心:Installation Manager 1.4.3 版開始,已淘汰 --launcher.ini .ini file。您可以使用下列指令而不指定 .ini 檔:installinstallcuserinstuserinstcgroupinstgroupinstcuninstallcuninstall
--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 是啟動程式,則 Installation Manager 會檢查 installc.ini

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

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

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

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

來自 Installation Manager 安裝檔案的 silent-install.ini 檔案範例:

-toolId isilentInstall -accessRights admin -vm jre_5.0.4.sr11_20091106a\jre\bin\java.exe -nosplash --launcher.suppressErrors -silent -input @osgi.install.area\install.xml -vmargs -Xquickstart -Xgcpolicy:gencon

Installation Manager 目錄中 silent-install.ini 檔範例:

-accessRights admin -vm C:\Program Files\IBM\Installation Manager\eclipse\jre_5.0.3.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, -l log_file
指定記錄無聲自動安裝結果的日誌檔。日誌檔是一個 XML 檔。

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

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

小心:Installation Manager 1.4.4 版開始,已淘汰 -mode wizard
-mode wizard
使用指定的回應檔執行「安裝」精靈。使用 -mode wizard 時,必須使用 input

若為 1.4.4 版,請使用 IBMIM input response_file -acceptlicense 來啟動「安裝」精靈。

-nl value
當您在指令中包括 nl 選項及語言碼時,指令行的行為會根據所指定語言的設定來進行調整。
下列清單包含目前支援的語言碼,其可列為語言環境值:
  • 阿拉伯文 (ar)
  • 捷克文 (cs)
  • 丹麥文 (da)
  • 英文 (en)
  • 法文 (fr)
  • 德文 (de)
  • 希臘文 (el)
  • 匈牙利文 (hu)
  • 義大利文 (it)
  • 日文 (ja)
  • 韓文 (ko)
  • 立陶宛文 (li)
  • 波蘭文 (pl)
  • 葡萄牙文 (pt_BR)
  • 俄文 (ru)
  • 簡體中文 (zh_CN)
  • 斯洛維尼亞文 (sl)
  • 西班牙文 (es)
  • 繁體中文 (台灣) (zh_TW)
  • 土耳其文 (tr)
註: 有些語言只支援局部翻譯。當語言局部翻譯時,未翻譯的內容則預設為英文。
-nosplash
隱藏啟動畫面。
-passwordKey, -pK passwordKey
使用 passwordKey 來加密或解密密碼。
-record responseFile
會從 Installation Manger 使用者介面、指令行或主控台模式中的動作產生回應檔,並指定回應檔的位置。
-showProgress, -sP
在主控台顯示進度列。
-showVerboseProgress, -sVP
在主控台顯示進度文字。例如,在需要重新啟動電腦時,會顯示重新啟動機器以完成安裝。文字。
小心: 從 1.4.4 版開始,已淘汰 -silent
-silent, -s
  • -silent -installAll -nosplash --launcher.suppressErrors
  • -silent -updateAll -nosplash --launcher.suppressErrors
指定在無聲自動模式中執行 Installation Manager 安裝程式或 Installation Manager
搭配 IBMIM 使用 installuserinstgroupinst 指令:
  • 使用 -silent -installAll -nosplash --launcher.suppressErrors,以無聲自動安裝所有可用的套件。
  • 使用 -silent -updateAll -nosplash --launcher.suppressErrors,以無聲自動更新所有已安裝的套件。

不能將 input 指令與 installAll 以及 updateAll 指令搭配使用。使用 installAll 時,會安裝套件的預設特性。若要指定要安裝的特性,必須使用 input responseFile。回應檔包含要安裝的特性的相關資訊。
註: 錄製回應檔時,您可以選取要安裝的特性。
重要:Installation Manager 1.4.4 版開始,已淘汰 installAll。建議您不要使用這個指令,因為同時安裝多個產品會有許多相關的潛在問題。如需相關資訊,請參閱 installAll
-skipInstall, -sI dataLocation
錄製回應檔但不安裝 IBM 產品。dataLocation 值會指定安裝資料夾和檔案的目錄位置。雖然未安裝 IBM 產品,但是會建立安裝所需的檔案及資料夾,並將它們儲存在指定的目錄中。此目錄必須是可寫入的目錄。

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

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

您所安裝的每一個 IBM 產品版本,都應該使用不同的 dataLocation 值。

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

-vm
指定 Java 啟動程式。在無聲自動模式中,於 Windows 上一律使用 java.exe:而於 Linux 及 UNIX 上,則一律使用 java

意見反應