Installation Manager 命令行参数

使用下表了解有关 IBM Installation Manager 命令行参数的更多内容。

Installation Manager 命令

命令行参数包括命令和选项。可以使用命令,而无需指定选项。多数命令都不使用短划线。 有几个以短划线开头的命令,可兼容先前版本的 Installation Manager。 使用选项时,必须指定命令。选项以短划线开头。
注: 星号 (*) 不能用于 Installation Manager 命令行。输入星号后,Installation Manager 无法识别命令行参数,从而产生错误。

表 1 列出命令,表 2 列出选项。

表 1:Installation Manager 命令

命令 描述
encryptString stringToEncrypt
对输入的字符串进行加密。

在命令行界面上,打开 eclipse 目录,然后输入带有 -nosplash 选项的 encryptString 命令以及一个字符串,以返回加密的字符串。此时将打开“字符串加密实用程序”窗口中,并且要加密的字符串字段中将包含要加密的字符串。字符串的加密版本字段包含了复制到响应文件的加密值。在“字符串加密实用程序”中,您可以更改要加密的字符串字段,然后单击确定以生成一个新的已加密的字符串。

使用带有 -passwordKeyencryptString 可提高加密的安全性。

记录响应文件时,会在响应文件中创建并存储密码的已加密字符串。以下是 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 目录,然后输入带有 -noSplash-silent 选项的 exportInstallData 命令以及文件名, 以导出安装数据。

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
您可以使用文件路径或 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
凭证必须存储在密钥环文件中,不能存储在静默安装脚本中。
切记: 您可以记录响应文件,编辑样本响应文件或手工创建响应文件。

为与更低版本兼容,此命令可与短划线一起使用:-input

installAll
要点:Installation Manager V1.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:Installation Manager 选项

选项 描述
-acceptLicense
当要安装的软件包要求接受许可证协议时,请将 -acceptLicense 选项包含在命令中。
-accessRights, -aR mode

其中 mode=[admin, nonAdmin, group]

定义 Installation Manager 是以管理员方式、非管理员方式还是组方式运行。对于管理员方式,请将 -accessRightsadmin 参数配合使用:-accessRights admin。对于非管理员方式,请将 —accessRights 参数与 nonAdmin 参数配合使用:-accessRights nonAdmin。对于组方式,请将 -accessRightsgroup 参数配合使用:-accessRights group

只能安装一个 Installation Manager 管理员实例。对于非管理员,仅为各用户安装一个 Installation Manager 实例。

如果不使用 -accessRights,那么会根据当前的用户许可权设置缺省值。
注:
  • 对于属于 Administrator 组成员的 Microsoft WindowsXP Professional 用户,缺省值始终是 -accessRights admin。为使这些用户以非管理员方式运行,请显式传递 -accessRights nonAdmin 参数。

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

注意: 安装、修改、更新、回滚或移除同一个 Installation Manager 实例时,请勿更改此参数。例如,User1 使用管理员访问权在 C:\user1\InstallationManager 目录中安装 Installation Manager。当运行命令以修改 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 V1.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 V1.4.4 开始不推荐使用 -mode wizard
-mode wizard
使用指定的响应文件运行“安装”向导。使用 -mode wizard 时必须使用 input

对于 V1.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 Manager UI、命令行或控制台方式中的操作,生成响应文件,并指定响应文件的位置。
-showProgress, -sP
在控制台上显示进度条。
-showVerboseProgress, -sVP
在控制台上显示进度文本。例如,当需要重新启动计算机时,会显示 Reboot the machine to complete the install 文本。
注意: 从 V1.4.4 开始,不推荐使用 -silent
-silent, -s
  • -silent -installAll -nosplash --launcher.suppressErrors
  • -silent -updateAll -nosplash --launcher.suppressErrors
指定 Installation Manager 安装程序或 Installation Manager 以静默方式运行。
通过 IBMIMinstalluserinstgroupinst 命令:
  • 使用 -silent -installAll -nosplash --launcher.suppressErrors 以静默方式安装所有可用的软件包。
  • 使用 -silent -updateAll -nosplash --launcher.suppressErrors 以静默方式更新所有已安装的软件包。

请勿将 input 命令与 installAllupdateAll 命令一起使用。 如果使用 installAll,那么将安装软件包的缺省功能部件。 要指定安装的功能部件,必须使用 input responseFile。 响应文件包含有关要安装的功能部件的信息。
注: 记录响应文件时,可以选择要安装的功能部件。
要点:Installation Manager V1.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

反馈