使用命令行安装产品供应项目

可以使用 Installation Manager imcl install 命令来安装任何产品供应项目。

1. 登录系统。

   确保使用具有 *ALLOBJ 和 *SECADM 特权的用户概要文件登录 IBM i 系统。

2. 选择单独的目录位置来存储产品二进制文件。 如果您是第一次从 Installation Manager 的这个实例进行安装，那么也可以选择共享数据位置。
3. 启动命令行。

   在 CL 命令行上，运行 STRQSH 命令以启动 Qshell 命令 shell。

4. 验证您是否具有在所选目录中安装产品需要的许可权。
5. 切换到安装了 Installation Manager的目录中的 eclipse/tools 子目录。
6. 验证产品存储库是否可用。

   listAvailablePackages 命令用于列出供应项目的一个或多个级别。

   

   imcl.exe listAvailablePackages -repositories source_repository

   

   ./imcl listAvailablePackages -repositories source_repository

7. 可选: 如果存储库需要用户名和密码，请创建主密码文件和凭证存储文件以访问此存储库。
   1. 可选: 创建主密码文件。

      主密码文件是包含口令的文本文件，例如 此文本是主密码。 此文件用于保护认证凭证。

      如果您创建主密码文件，并在创建凭证时使用该文件，那么必须始终指定主密码文件。

      提示: 要保护此文件，请根据您的操作系统设置许可权以限制对此文件的访问权。
   2. 通过运行 imutilsc saveCredential 命令创建凭证存储文件。
      

      imutilsc.exe saveCredential 
        -secureStorageFile storage_file
        -userName user_ID -userPassword user_password
        -url source_repository 

      

      ./imutilsc saveCredential 
        -secureStorageFile storage_file
        -userName user_ID -userPassword user_password
        -url source_repository 

      提示: 如果 imutilsc 命令无法找到创建凭证存储文件时指定的 URL ，请在存储库 URL 位置末尾追加 /repository.config 。

   有关更多信息，请参阅 IBM Installation Manager 文档。

8. 运行 imcl 命令以安装产品。

   imcl 命令具有以下示例所示的格式和选项。

   重要信息: 由于 IBM SDK Java Technology Edition 不再与产品一起嵌入，因此您必须同时指定产品产品标识和 IBM Java SDK 产品标识 (com.ibm.java.jdk.v8)。 如果没有 Java SDK ，那么无法安装产品供应项目。

   

   imcl.exe install offering_ID_offering_version,optional_feature_ID com.ibm.java.jdk.v8
     -repositories source_repository 
     -installationDirectory installation_directory 
     -sharedResourcesDirectory shared_directory
     -accessRights access_mode
     -preferences preference_key=value
     -properties property_key=value
     -secureStorageFile storage_file -masterPasswordFile master_password_file
     -acceptLicense
   

   

   ./imcl install offering_ID_offering_version,optional_feature_ID com.ibm.java.jdk.v8
     -repositories source_repository 
     -installationDirectory installation_directory 
     -sharedResourcesDirectory shared_directory
     -accessRights access_mode
     -preferences preference_key=value
     -properties property_key=value
     -secureStorageFile storage_file -masterPasswordFile master_password_file
     -acceptLicense
   

   

   重要信息: IBM i 上的所有应用程序都使用操作系统随附的 Java SDK ，因此无法在 IBM i上随任何产品一起安装 IBM SDK Java Technology Edition。

   ./imcl install offering_ID_offering_version,optional_feature_ID
     -repositories source_repository 
     -installationDirectory installation_directory 
     -sharedResourcesDirectory shared_directory
     -accessRights access_mode
     -preferences preference_key=value
     -properties property_key=value
     -secureStorageFile storage_file -masterPasswordFile master_password_file
     -acceptLicense
   

   1. 安装供应项目和可选功能部件。

      对于某些供应项目，您可以逗号分隔列表形式添加要安装的可选功能部件。 如果未指定可选功能部件，那么会安装一组缺省功能部件。 要只安装您想要的功能部件，请显式指定功能部件的列表。

      下表显示了供应项目标识、每个供应项目的可选功能部件和缺省功能部件：

      表 1. 供应项目标识和可选功能部件

      产品标识	可选功能部件标识	缺省功能部件
      WebSphere Application Server（基本） com.ibm.websphere.BASE.v90	core.feature: WebSphere Application Server 必须指定此功能部件才能指定下列可选的子功能部件： samples：样本应用程序 thinclient：独立瘦客户机和资源适配器 embeddablecontainer：可嵌入式 EJB 容器 ejbdeploy：适用于 EJB 3.0 以前的模块的 EJBDeploy 工具 注: 不能使用 Installation Manager 来修改，更新或回滚功能以稍后添加或除去 core.feature。 只能添加或移除子功能部件。	core.feature thinclient embeddablecontainer ejbdeploy
      Application Client for WebSphere Application Server com.ibm.websphere.APPCLIENT.v90	samples：样本 standalonethinclient.resourceadapter.runtime：独立瘦客户机运行时 standalonethinclient.resourceadapter.samples：独立瘦客户机样本 embeddablecontainer：可嵌入式 EJB 容器	embeddablecontainer
      DMZ Secure Proxy Server for IBM WebSphere Application Server com.ibm.websphere.NDDMZ.v90	core.feature: DMZ Secure Proxy Server for IBM WebSphere Application Server 必须指定此功能部件才能指定下列可选的子功能部件： thinclient：独立瘦客户机和资源适配器	无缺省功能部件
      Web Server Plug-ins com.ibm.websphere.PLG.v90	无可选功能部件	不适用
      WebSphere Customization Toolbox com.ibm.websphere.WCT.v90	zpmt：Profile Management Tool（仅限 z/OS） zmmt：z/OS 迁移管理工具 pct：Web Server Plug-ins Configuration Tool	缺省情况下，将安装所有可选功能部件

   2. 指定供应项目版本。

      offering_version 是要安装的特定供应项目版本，可以选择性地使用下划线将其附加到供应项目标识（例如 9.0.0.x_0200）。

      • 如果 未 指定 offering_version ，那么将安装产品的最新版本以及该版本的 所有 临时修订。
      • 如果指定了 offering_version，那么将安装产品的指定版本，但不会安装该版本的临时修订。

      对存储库运行以下命令时，可以看到产品版本通过下划线附加到产品标识的末尾：

      imcl listAvailablePackages -repositories source_repository

   3. 设置 user_data_root。
      最佳实践: 对于初始安装，请指定 user_data_root; 否则， user_data_root 的缺省值为 /QIBM/UserData/WebSphere/AppServer/V9/BASE。

      要指定 user_data_root，请运行带有 was.install.os400.profile.location 属性上指定的 user_data_root 文件路径的 imcl 命令。 例如：-properties was.install.os400.profile.location=/QIBM/UserData/WebSphere/AppServer/V9/BASE。

   4. 安装临时修订。

      要指示您想要随供应项目一起安装哪些临时修订，请随 -installFixes 自变量一起指定 none、recommended 或 all。

      • 如果未指定产品版本，那么 -installFixes 选项缺省为 all。
      • 如果指定了产品版本，那么 -installFixes 选项缺省为 none。
   5. 指定访问权。

      如果先前指定了 Installation Manager 的安装方式，那么 -accessRights 参数不是必需的。

   6. 选择是否保存软件包版本以用于回滚。

      Installation Manager 可以保存软件包的较早版本，以便您稍后遇到问题时可以回滚。 Installation Manager 将软件包回滚到先前版本时，会卸载当前版本的文件并重新安装较早版本。

      如果您选择不针对回滚保存文件，那么可通过在命令规范中使用以下首选项来阻止保存文件：

      -preference com.ibm.cic.common.core.preferences.preserveDownloadedArtifacts=False

      提示: 即使您选择不保留本地文件以使用此选项进行回滚，您仍可以通过访问相应的产品存储库来回滚到先前安装的任何级别。

      有关设置 Installation Manager 首选项的更多信息，请参阅 IBM Installation Manager 文档。

示例

以下示例说明如何在 Windows 操作系统上安装最新版本的 WebSphere Application Server :

imcl install com.ibm.websphere.BASE.v90 com.ibm.java.jdk.8
 -installationDirectory "C:\Program Files\IBM\WebSphere\AppServer"
 -sharedResourcesDirectory "C:\Program Files\IBM\IMShared" 
 -repositories C:\IBM\REP\WSAS9ENT 
 -acceptLicense 
 -showProgress 
 -log installv9.xml
 -preferences com.ibm.cic.common.core.preferences.keepFetchedFiles=false,com.ibm.cic.common.core.preferences.preserveDownloadedArtifacts=false

以下示例说明如何在 IBM i 操作系统上安装最新版本的 WebSphere Application Server:

./imcl install com.ibm.websphere.BASE.v90
  -repositories https://downloads.mycorp.com:8080/WAS_90_repository
  -installationDirectory /QIBM/ProdData/WebSphere/AppServer/V9/BASE
  -properties was.install.os400.profile.location=/QIBM/UserData/WebSphere/AppServer/V9/BASE
  -sharedResourcesDirectory /QIBM/UserData/InstallationManager/IMShared
  -secureStorageFile $HOME/WASFiles/temp/credential.store
  -acceptLicense