IBM Installation Manager 命令行参数

您可以使用以下参考表来了解有关 Installation Manager 命令行参数的更多信息

参数 描述
-accessRights 定义 Installation Manager 是以管理员方式还是非管理员方式运行。对于非管理员方式,请使用带有 nonAdmin 参数的 —accessRights-accessRights nonAdmin;对于管理员方式,请使用带有 admin 参数的 —accessRights-accessRights admin
如果不使用 —accessRights,那么会根据当前的用户许可权设置缺省值。
注:
对于属于 Microsoft® Windows® XP Administrator 组的成员,缺省值始终为 -accessRights admin。 对于以非管理员方式运行的用户,应显示传递 -accessRights nonAdmin 参数。

如果用户不具备相应的系统许可权,Installation Manager 会报告错误。

注意: 安装、修改、更新、回滚或卸载 Installation Manager 的同一实例时,请勿更改此参数。 例如,User1 使用管理员访问权在 C:\user1\InstallationManager 目录中安装 Installation Manager。当运行命令以修改 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 一起使用。

您可以使用文件路径或 URL 作为 <responsefile> 的值。以下示例显示了文件路径和 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 基础结构来保存密钥环的凭证。有关密钥环文件的其他信息,请参阅 Eclipse workbench user's guide(可从 http://www.eclipse.org 获取)。

--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.iniinstallc.exe 文件位于同一目录下,且该文件必须存在。

user-silent-install.ini 文件用于非管理员安装。

user-silent-uninstall.ini 文件用于非管理员卸载过程。

要点: Installation Manager 安装文件中提供的 silent-install.iniuser-silent-install.ini 文件版本使用 -input 命令行参数。要对这些 .ini 文件使用 -installAll-updateAll,您必须除去以下两行的内容:-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 在控制台上显示进度文本。例如,如果需要重新引导,会显示 Reboot the machine to complete the install 字样的文本。
-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

反馈