imcl 命令的命令行参数

使用此参考表来了解有关 Installation Manager 命令行 imcl的命令和选项的更多信息。

必须从 tools 目录运行 imcl 命令。
注:
  • 如果安装了较低版本的 Installation Manager ,那么无法使用 Installation Manager 安装程序中的 imcl 命令。
  • 包含空格的文件路径要用双引号括起。
表 1. 命令
命令 描述
deleteSavedFiles
除去系统上保存的还原到较早版本的已安装软件包所需的文件。 这些文件用于回滚。 有关回滚的更多信息,请参阅 回滚首选项
encryptString stringToEncrypt
对输入的字符串进行加密。 将 encryptString 命令与 -passwordKey 选项配合使用以提高加密安全性。
exportInstallData outputFileName
将安装数据以压缩文件格式导出到指定文件,其中 outputFileName 是生成的包含导出数据的文件的名称。
help, -h, ?, -? 
	help command
	help all
运行 help 命令以查看 Installation Manager的可用命令。

help 命令与另一个命令配合使用时,将显示该命令的简短描述。 将 help 命令与 all 选项配合使用时,将显示更多帮助命令。

import
添加使用 Installation Manager以外的安装工具安装的现有软件包。 通过导入这些软件包,您可以使用 Installation Manager 来管理软件包。 使用 -installationDirectory 选项来指定现有软件包的安装目录。

import 命令仅用于 IBM® WebSphere® Application Server 产品。 有关 WebSphere 产品的更多信息,请参阅: IBMDocumentation

import 命令与以下选项配合使用:
  • -eclipseLocation
  • -installationDirectory
  • -keyring: 不推荐使用此选项。
  • -masterPasswordFile: 与 -secureStorageFile 选项配合使用。
  • -password: 不推荐使用此选项。
  • -preferences
  • -prompt
  • -properties
  • -repositories
  • -secureStorageFile
  • -sharedResourcesDirector
请勿将 import 命令与以下命令配合使用:
  • input
  • install
  • modify
  • rollback
  • uninstall
  • uninstallAll
  • updateAll
input response_file
使用 input 命令指定用于静默安装的响应文件。
input 命令与以下选项配合使用:
  • -installationDirectory
  • -keyring: 不推荐使用此选项。
  • -masterPasswordFile: 与 -secureStorageFile storage_file -masterPasswordFile master_password_file 选项配合使用。
  • -password: 不推荐使用此选项。
  • -prompt
  • -secureStorageFile
  • -variables
请勿将 input 命令与以下命令配合使用:
  • import
  • install
  • modify
  • rollback
  • uninstall
  • uninstallAll
  • updateAll
install packageID[_version][,featureID]
安装软件包,更新,修订或功能部件。

程序包由程序包标识指定。 用空格分隔一列包。 您可以向软件包标识添加带有版本的下划线,并添加以逗号分隔的功能部件列表。

如果未指定版本,那么将安装软件包的最新版本。 如果未指定功能部件列表,那么将安装缺省功能部件。

install 命令与以下选项配合使用:
  • -acceptLicense
  • -connectPassportAdvantage
  • -eclipseLocation
  • -installationDirectory
  • -installFixes
  • -keyring: 不推荐使用此选项。
  • -masterPasswordFile: 与 -secureStorageFile 选项配合使用。
  • -password: 不推荐使用此选项。
  • -preferences
  • -prompt
  • -properties
  • -repositories
  • -secureStorageFile
  • -sharedResourcesDirectory
  • -useServiceRepository
请勿将 install 命令与以下命令配合使用:
  • import
  • input
  • modify
  • rollback
  • uninstall
  • uninstallAll
  • updateAll
listAvailableFixes packageID_version
将有关指定软件包的可用修订的信息打印到控制台。

listAvailableFixes 命令显示所有可用的修订,包括可能不适合在环境中使用的修订。

有关列出可用修订的更多信息,请参阅 使用 imcl 命令列出可用修订

listAvailableFixes 命令与以下选项配合使用:
  • -connectPassportAdvantage
  • -keyring: 不推荐使用此选项。
  • -long
  • -masterPasswordFile: 与 -secureStorageFile 选项配合使用。
  • -password: 不推荐使用此选项。
  • -prompt
  • -preferences
  • -repositories
  • -secureStorageFile
  • -showPlatforms
  • -useServiceRepository
listAvailablePackages
将有关可用软件包的信息打印到控制台。

listAvailablePackages 命令显示可用的软件包,包括可能不适合在环境中使用的软件包。

有关列出可用修订的更多信息,请参阅 使用 imcl 命令列出可用软件包

listAvailablePackages 命令与以下选项配合使用:
  • -connectPassportAdvantage
  • -features
  • -keyring: 不推荐使用此选项。
  • -long
  • -masterPasswordFile: 与 -secureStorageFile 选项配合使用。
  • -password: 不推荐使用此选项。
  • -prompt
  • -preferences
  • -repositories
  • -secureStorageFile
  • -showPlatforms
  • -useServiceRepository
listInstallationDirectories
将有关安装目录,共享资源目录,软件包组的名称和已安装的翻译的信息打印到控制台。

有关列出可用修订的更多信息,请参阅 使用 imcl 命令列出有关安装目录的信息

listInstallationDirectories 命令与以下选项配合使用:
  • -long
  • -verbose
listInstalledFeatures packageID_version
将有关指定软件包的已安装功能部件的信息打印到控制台。

有关列出可用修订的更多信息,请参阅 使用 imcl 命令列出已安装的功能部件

listInstalledFeatures 命令与以下选项配合使用:
  • -installationDirectory
  • -long
.
listInstalledPackages
将有关已安装软件包的信息打印到控制台。

有关列出可用修订的更多信息,请参阅 使用 imcl 命令列出已安装的软件包

listInstalledPackages 命令与以下选项配合使用:
  • -features
  • -installationDirectory
  • -long
  • -rollbackVersions
  • -verbose
modify packageID[_version]
更改已安装的软件包。

程序包由程序包标识指定。 您可以使用软件包标识的版本添加下划线。

可以在软件包中添加或除去功能部件。 使用 -addFeatures 选项来指定要添加的功能部件。 使用 -removeFeatures 选项来指定要除去的功能部件。

modify 命令与以下选项配合使用:
  • -addFeatures
  • -connectPassportAdvantage
  • -installationDirectory
  • -keyring: 不推荐使用此选项。
  • -masterPasswordFile: 与 -secureStorageFile 选项配合使用。
  • -password: 不推荐使用此选项。
  • -prompt
  • -properties
  • -removeFeatures
  • -repositories
  • -secureStorageFile: 此选项可用。
  • -useServiceRepository
使用 modify 命令时,必须至少使用下列其中一个选项: -addFeatures-properties-removeFeatures
请勿将 modify 命令与以下命令配合使用:
  • import
  • input
  • install
  • rollback
  • uninstall
  • uninstallAll
  • updateAll
rollback packageID[_version]
还原为较早版本的已安装软件包。

程序包由程序包标识指定。 您可以使用要回滚到的软件包标识版本添加下划线。

如果未指定版本,那么软件包将回滚到先前版本。 指定多个软件包时,必须将所有软件包安装到同一安装目录中。

无法将 Installation Manager 回滚到较低版本。

rollback 命令与以下选项配合使用:
  • -connectPassportAdvantage
  • -installationDirectory
  • -keyring: 不推荐使用此选项。
  • -masterPasswordFile: 与 -secureStorageFile 选项配合使用。
  • -password: 不推荐使用此选项。
  • -prompt
  • -properties
  • -repositories
  • -secureStorageFile
请勿将 rollback 命令与以下命令配合使用:
  • import
  • input
  • install
  • modify
  • uninstall
  • uninstallAll
  • updateAll
uninstall packageID[_version][,featureID]
卸载软件包,更新,修订或功能部件。

程序包由程序包标识指定。 您可以向软件包标识添加带有版本的下划线,并添加以逗号分隔的功能部件列表。 如果未指定版本,那么将卸载软件包的最新版本。 如果未指定功能部件列表,那么将卸载缺省功能部件。

uninstall 命令与以下选项配合使用:
  • -installationDirectory
  • -keyring: 不推荐使用此选项。
  • -masterPasswordFile: 与 -secureStorageFile 选项配合使用。
  • -password: 不推荐使用此选项。
  • -preferences
  • -properties
  • -secureStorageFile
请勿将 uninstall 命令与以下命令配合使用:
  • import
  • input
  • install
  • modify
  • rollback
  • uninstallAll
  • updateAll
uninstallAll
卸载所有已安装的软件包。
uninstallAll 命令与以下选项配合使用:
  • -installationDirectory
  • -keyring: 不推荐使用此选项。
  • -masterPasswordFile: 与 -secureStorageFile 选项配合使用。
  • -password: 不推荐使用此选项。
  • -properties
  • -secureStorageFile

使用 -installationDirectory 选项仅卸载指定安装目录中的软件包。

请勿将 uninstallAll 命令与以下命令配合使用:
  • import
  • input
  • install
  • modify
  • rollback
  • uninstall
  • updateAll
updateAll
更新所有已安装的软件包。

使用 updateAll 命令可更新 Installation Manager 首选项中定义的服务存储库和存储库中的所有已安装软件包。

updateAll 命令与以下选项配合使用:
  • -connectPassportAdvantage
  • -installationDirectory
  • -installFixes
  • -masterPasswordFile: 与 -secureStorageFile 选项配合使用。
  • -prompt
  • -properties
  • -repositories
  • -secureStorageFile
  • -useServiceRepository

使用 -installationDirectory 选项仅更新指定安装目录中的软件包。

请勿将 updateAll 命令与以下命令配合使用:
  • import
  • input
  • install
  • modify
  • rollback
  • uninstall
  • uninstallAll
version
显示 Installation Manager的版本和内部版本。

对于 64 位操作系统,将显示有关体系结构的信息。 对于 32 位操作系统,不会显示体系结构信息。

viewLicense packageID_version
New in version 1.7:

从命令行查看许可证。

viewLicense 命令与以下选项配合使用:
  • -connectPassportAdvantage
  • -keyring: 不推荐使用此选项。
  • -masterPasswordFile: 与 -secureStorageFile 选项配合使用。
  • -password: 不推荐使用此选项。
  • -preferences
  • -prompt
  • -repositories
  • -secureStorageFile
  • -useServiceRepository
viewLog [logFile]
查看日志文件。 如果未指定 logFile ,那么将返回日志文件列表。 如果指定了 logFile ,那么将显示指定日志文件中的条目。
表 2. 命令选项
选项 描述
-acceptLicense
指示是否接受许可协议。

如果您安装的软件包要求您接受许可协议,那么必须在安装命令中包含 -acceptLicense 选项。

-addFeatures featureID1, featureID2
使用逗号分隔列表指定要添加的功能部件。
将此选项与以下命令配合使用:
  • modify

有关更多信息,请参阅 使用 imcl 命令修改软件包

-connectPassportAdvantage
IBM Passport Advantage® 存储库添加到存储库列表。

将此选项与以下命令配合使用:

  • install
  • listAvailableFixes
  • listAvailablePackages
  • modify
  • rollback
  • updateAll
-consoleMode, -c
以控制台方式启动 Installation Manager

使用此选项可通过交互式用户界面启动 Installation Manager

New in version 1.7:

可以将选项 -secureStorageFile-masterPasswordFile 与控制台方式 (-c-consoleMode) 配合使用。

-dataLocation, dL directory
指定 Installation Manager 数据目录的位置。 该位置用于存储有关已安装软件包的信息。 在安装 Installation Manager时设置此位置。 仅将此选项与 Installation Manager 安装程序配合使用。 启动 Installation Manager的已安装实例时,请勿使用此选项。
注:
  • 安装 Installation Manager 后,请勿更改此参数。 更改此参数可能会损坏安装数据。 此损坏可能会阻止您修改,更新,回滚或卸载已安装的软件包。
  • 如果为 -dataLocation 指定的目录位置不是缺省值,那么每次使用 Installation Manager 安装程序时,都必须使用相同的位置 (使用 -datalocation 选项)。 Installation Manager 的已安装实例会自动使用指定的位置。
  • -datalocation 选项设置的位置不得是 Installation Manager 安装目录的子目录。
-eclipseLocation eclipse_directory
指示用于安装到现有 Eclipse 位置的 Eclipse 目标目录。
将此选项与以下命令配合使用:
  • import
  • install
-features
在软件包列表中包含有关功能部件的信息。
将此选项与以下命令配合使用:
  • listAvailablePackages
  • listInstalledPackages
请勿将 -features 选项与此选项配合使用:
  • -verbose
-installationDirectory installation_directory
指定安装位置的目录路径。

同一软件包可能安装在多个位置。 使用此选项来指定安装位置。

将此选项与以下命令配合使用:
  • import
  • input
  • install
  • listInstalledFeatures
  • listInstalledPackages
  • modify
  • rollback
  • uninstall
  • uninstallAll
  • updateAll
-installFixes none|recommended|all
选择是否随产品一起安装修订。 有效值为 nonerecommendedall
将此选项与以下命令配合使用:
  • install: 如果指定了产品版本,那么 -installFixes 选项缺省为 none。 如果未指定产品版本,那么 -installFixes 选项缺省为 all
  • updateAll: 如果未指定 -installFixes 选项,那么 -installFixes 选项缺省为 all
-keyring keyring_file [ -password password ]
不推荐使用 -keyring-password 选项。 使用 -secureStorageFile-masterPasswordFile 选项来存储凭证。 有关更多信息,请参阅 从密钥环文件迁移到存储文件

指定包含用于向受保护存储库 (例如 Passport Advantage) 进行认证的凭证的密钥环文件。 如果密钥环文件受保护,请包括 -password 选项和密钥环文件的密码。

有关密钥环文件的更多信息,请参阅 Installation Manager 用于静默方式的命令行参数

-log, -l log_file
指定记录 Installation Manager 操作结果的日志文件。 该日志文件是 XML 文件。
如果安装,更新,修改,回滚或卸载过程成功完成,那么日志文件不包含任何条目。 当进程不成功时,日志文件包含错误条目。 已完成安装的日志文件的示例:
<?xml version="1.0" encoding="UTF-8"?>
<result>
</result>

记录响应文件时,请勿使用 -log 选项。

-long
包含有关存储库路径,软件包标识和版本,显示名称和版本以及功能部件标识的信息。
将此选项与以下命令配合使用:
  • listAvailableFixes
  • listAvailablePackages
  • listInstallationDirectories
  • listInstalledFeatures
  • listInstalledPackages
请勿将 -long 选项与以下选项配合使用:
  • -verbose
-nl value
指定要使用的语言。

当您使用 imcl 命令包含 nl 选项和语言代码时,命令行的行为将根据指定语言的设置进行调整。 例如:-nl es。 语言的选择将应用于已在软件包组中安装的所有软件包。

可以在国会图书馆站点 用于表示语言名称的代码中找到语言代码列表。 Installation Manager 仅支持列出的某些语言。 在这些语言中, Installation Manager 使用 ISO 639-1 代码来指定两个字母的代码。 Installation Manager 不使用指定三字母代码的 ISO 639-2 代码。

某些语言仅支持部分翻译。 当语言部分翻译时,非翻译内容将以英语呈现。

有关 Installation Manager 支持的语言的列表,请参阅 启动 Installation Manager。 有关软件包支持的语言的列表,请参阅该软件包的文档。

-passwordKey, -pK string
加密或解密密码。
-portable
如果产品支持,请使用此选项来安装或管理产品的可移植安装。

如果将产品的可移植安装移至其他位置,那么该安装仍有效。

-preferences key_1=value_1,
	key_2=value_2
使用首选项键来定制软件包安装。

您可以通过使用逗号分隔每个首选项来包含首选项列表。

请参阅 静默安装首选项键 以获取可用首选项的列表。

-prompt
必须输入凭证才能访问服务器时,请包含 -prompt 选项。

-prompt 选项与以下命令配合使用:

  • import
  • input
  • install
  • listAvailableFixes
  • listAvailablePackages
  • modify
  • rollback
  • updateAll

不能将 -prompt 与控制台方式 (-c-consoleMode) 配合使用。

-properties key_1=value_1a,,value_1b, 
	key_2=value_2
定义包组概要文件属性,例如语言。

您可以通过用逗号分隔各个属性来包含属性列表。 对于具有多个值的属性,必须在值之间使用两个逗号: key_1=value_1a,,value_1b

该列表包含预定义的属性键和相关值:
  • eclipseLocation: 指定现有 Eclipse 位置值,例如 c:\myeclipse\eclipse
  • cic.selector.arch: 指定要安装的体系结构: 32 位或 64 位。
  • cic.selector.os: 指定操作系统。
  • cic.selector.ws: 指定窗口系统的类型。
  • cic.selector.nl: 指定要使用 ISO-639 语言代码 (例如 zhjaen) 安装的语言包。 如果安装产品的翻译,那么必须在命令中包含 cic.selector.nl 属性键。 示例: -properties cic.selector.nl=en,,fr,,pt_BR。 语言的选择将应用于已在软件包组中安装的所有软件包。
有关 cic.selector.key 键的受支持值的更多信息,请参阅 cic.selector.key的值

您可以在安装的产品的文档中找到更多属性键。

将此选项与以下命令配合使用:
  • import
  • install
  • modify
  • rollback
  • uninstall
  • uninstallAll
  • updateAll
-record responseFile
根据 Installation Manager UI ,命令行或控制台方式中的操作生成响应文件,并指定响应文件的位置。
-reinstallIM
Installation Manager的当前安装存在问题时,请安装相同版本或更高版本的 Installation Manager

必须指定当前安装的位置; 否则,会将 Installation Manager 安装到缺省安装位置。 如果当前安装不在缺省目录中,那么可以使用 -installationDirectory 选项来指定当前安装的目录。 如果不使用 -installationDirectory 选项,并且当前安装位于非缺省目录中,那么 -reinstallIM 选项会将新安装放在缺省目录中。 您在计算机上具有两个不同的安装,而不是更新当前安装。

Installation Manager 已卸载,然后在使用此选项时安装。 您不必卸载任何已安装的软件包。

-reinstallIM 选项与 install 命令配合使用时,必须在命令中指定 Installation Manager 软件包 com.ibm.cic.agent

-reinstallIM 选项与 input 命令配合使用时,响应文件必须指定要安装的 Installation Manager 版本。 有关使用响应文件来安装 Installation Manager的更多信息,请参阅 修改响应文件以安装软件包和 Installation Manager

将此选项与以下命令配合使用:
  • install
  • input
-removeFeatures featureID1,featureID2
使用逗号分隔列表指定要除去的功能部件。
将此选项与以下命令配合使用:
  • modify

有关 -removeFeatures 选项的更多信息,请参阅 使用 imcl 命令修改软件包

-rollbackVersions
New in version 1.7:

列出可回滚到的软件包版本。

将此选项与以下命令配合使用:
  • listInstalledPackages
请勿将 -rollbackVersions 选项与以下选项配合使用:
  • -verbose
-repositories source_repository_1,
	source_repository_2
指示包含可用软件包的安装文件的位置。

您可以通过使用逗号分隔每个存储库来包含存储库列表。

您可以为 -repositories 值使用文件路径或 URL。

将此选项与以下命令配合使用:
  • import
  • install
  • listAvailableFixes
  • listAvailablePackages
  • modify
  • rollback
  • updateAll
-secureStorageFile storage_file 
-masterPasswordFile master_password_file
使用这些选项来存储用于存储库认证的凭证。

-secureStorageFile 选项指定存储文件的文件和路径。

-masterPasswordFile 选项指定主密码文件的文件和路径。 主密码文件是包含口令的文本文件,用于加密存储文件中的敏感内容。

有关更多信息,请参阅 存储凭证

将此选项与以下命令配合使用:

  • import
  • input
  • install
  • listAvailableFixes
  • listAvailablePackages
  • modify
  • rollback
  • uninstall
  • uninstallAll
  • updateAll
请勿将 -secureStorageFile 选项或 -masterPasswordFile 与此选项配合使用:
  • -password

New in version 1.7:

Installation Manager 使用 Equinox 安全存储机制 (而不是密钥环机制)。 如果未指定 -secureStorageFile 选项,那么 Installation Manager 将在 user_home_directory/.eclipse/org.eclipse.equinox.security/secure_storage 文件夹中生成缺省存储文件。 如果未指定 -masterPasswordFile\ 选项,那么 Installation Manager 将使用预定义的密码。

要在命令行上指定密码,请使用 -prompt 选项。

-sharedResourcesDirectory shared_directory
设置共享资源目录。

首次安装软件包时,将创建共享资源目录。 安装其他软件包时,不必使用此选项。

如果存在共享资源目录,那么必须使用该位置。 如果要更改共享资源目录,那么必须卸载所有软件包,然后安装软件包并使用新的共享资源位置。

将此选项与以下命令配合使用:
  • import
  • install
-showPlatforms
列出软件包支持的操作系统和体系结构值。
-showPlatforms 选项与以下命令配合使用:
  • listAvailableFixes
  • listAvailablePackages
-showPlatforms 选项返回有关操作系统 os和体系结构 arch的信息。 对于修订,如果修订支持与修订所应用于的软件包相同的平台,那么将显示 SAME_AS_PACKAGE 关键字而不是 os.arch 值。 有关此选项返回的 osarch 值的更多信息,请参阅 cic.selector.key 键的值。

请检查软件包文档以确定该软件包的受支持操作系统和体系结构。

-showProgress, -sP
在控制台上显示进度条。
-showVerboseProgress, -sVP
在控制台上显示进度文本。 例如,必须重新启动计算机时,将显示以下文本:Reboot the machine to complete the install.
-stopBlockingProcesses
在 Windows 上,停止运行锁定程序包文件的进程。 Installation Manager 必须能够访问或修改这些锁定文件。

仅当软件包启用对此选项的支持时, -stopBlockingProcesses 选项才有效。

-useServiceRepository
搜索服务存储库。

如果源存储库包含使用标识和版本指定的软件包,那么不会搜索服务存储库。

将此选项与以下命令配合使用:
  • install
  • listAvailableFixes
  • listAvailablePackages
  • modify
  • updateAll

-useServiceRepository 选项将覆盖 -preferences offering.service.repositories.areUsed=false 选项。

有关服务存储库的更多信息,请参阅 搜索服务存储库
-variables name1=value1,name2=value2
在命令行上设置或覆盖响应文件变量值。

如果变量的值包含逗号 (,) ,请使用两个逗号。

-variables name1=value1partA,,value1partB

将此选项与以下命令配合使用:
  • input response_file

有关变量的更多信息,请参阅 响应文件变量

-verbose
运行命令时显示更多信息。
将此选项与以下命令配合使用:
  • listInstallationDirectories
  • listInstalledPackages
请勿将 -verbose 选项与以下选项配合使用:
  • -long
  • -features
  • -rollbackVersions
注意:Installation Manager 版本 1.10 开始,HP-UX 和 Solaris 不再受 Installation Manager 支持。
表 3. cic.selector.key 的值
平台 cic.selector.os cic.selector.arch cic.selector.ws cic.selector.nl
32 位 64 位
AIX® aix ppc ppc64 motif

gtk

您可以在美国国会图书馆网站 Codes for the Representation of Names of Languages 上查阅语言代码列表。 Installation Manager 仅支持列出的某些语言。 在这些语言中, Installation Manager 使用 ISO 639-1 代码,后者使用两个字母的代码,而不使用 ISO 639-2 代码,后者使用三个字母的代码。

某些语言仅支持部分翻译。 当语言部分翻译时,非翻译内容将以英语呈现。

有关 Installation Manager 支持的语言的列表,请参阅 启动 Installation Manager。 有关软件包支持的语言的列表,请参阅该软件包的文档。

HP-UX hpux ia64_32 ia64 motif

gtk

IBM i os400 ppc ppc64 motif
Linux® linux ppc

s390

x86

ppc64

s390x

x86_64

gtk
OS X 操作系统 macosx x86 x86_64 cocoa
Solaris solaris sparc

x86

sparc64

x86_64

gtk
窗户 win32 x86 x86_64 win32
IBM z/OS® zos s390 s390x motif