使用命令行从 IBM i 操作系统中安装 Liberty 修订包

产品修订包中包含捆绑的服务,用于使 WebSphere® Application Server Liberty 达到新的产品级别。临时修订针对已知的特定问题提供校正服务。可以使用 IBM® Installation Manager 命令行功能,利用适用于 WebSphere Application Server Liberty 安装的服务级别的修订来更新产品。

开始之前

[17.0.0.3 and later]要点: 已于 2017 年 9 月终止对于 WebSphere Liberty 使用 Java™ SE 6 的支持。对于 17.0.0.3,Liberty 内核已重新编译。从 17.0.0.3 开始,Liberty 内核再也无法使用 Java SE 6 运行。如果您想要在终止支持日期之后继续使用先前发行版中的 Java SE 6,那么可能会给环境带来安全风险。

Java SE 8 是建议使用的 Java SDK,因为其提供了最新的功能部件和安全性更新。Java SE 8 的替代项是任何受支持的 Java SDK 版本。

有关 WebSphere Application Server for IBM i 更新的信息,请联系 IBM 软件支持中心。可以从 IBM 软件支持中心和 Fix Central 获取最新信息。

IBM Installation Manager V1.8.5 或更高版本用来将产品维护包应用于 WebSphere Application Server for IBM i。

如果要从基于本地目录的存储库或 Liberty Asset Repository Service 实例中安装 Liberty 资产,请配置这些存储库。有关 Liberty 资产存储库的更多信息,请参阅使用 Installation Manager 安装资产

提示: 作为本文中描述的过程的替代方法,Installation Manager 可让您在响应文件或命令行中使用 updateAll 命令来搜索和更新所有已安装的软件包。仅当您完全了解目标存储库中包含了哪些修订时才使用此命令。如果创建并指向的一组定制存储库仅包含要安装的特定修订,那么您可以放心地使用此命令。如果启用服务存储库搜索,或者直接从其他基于 Web 的实时存储库安装修订,那么您可能不想选择此选项,以便能够只选择您想要安装(在命令行上将 -installFixes 选项与 install 命令一起使用,或在响应文件中使用 installFixes 属性)的修订。

关于此任务

只要您想将新的修订包应用到系统,请执行此过程。
新增内容: 修订包 16.0.0.2 是 8.5.5.9 之后的后续 Liberty 修订包。有关 Liberty 修订包编号和交付更改的更多信息,请参阅 Liberty 的本发行版的新增内容

安装修订包时,如果安装的任何临时修订适用于更新的修订包级别,那么 Installation Manager 会自动重新应用这些临时修订。将卸载不适用的临时修订(例如,如果更新的修订包具有此修订)。在某些情况下,Installation Manager 必须卸载临时修订,需要时必须手动重新应用此临时修订。例如,可以更新为不包含修订且需要更新的临时修订级别的修订包。Installation Manager 会通知您是否必须手动重新应用任何临时修订。可以通过运行 productInfo version --ifixes 命令,验证安装了哪些临时修订。

提示: 您也可以将响应文件与 Installation Manager 一起使用来安装修订包。有关创建和使用响应文件的信息,请参阅使用响应文件在 IBM i 操作系统上安装 Liberty 修订包IBM Installation Manager 产品文档

过程

  1. 要获取适用于 WebSphere Application Server Liberty 安装的修订的列表,以及每个修订的具体信息,请执行下列操作。
    1. 转至 Fix Central
    2. 单击查找产品
    3. 选择 WebSphere Liberty 作为产品组。
    4. 选择要更新的产品的版本。
    5. 选择 IBM i 作为平台,然后单击继续
    6. 选择浏览以查找修订,然后单击继续
    7. 选择修订包作为修订类型,并单击提交
    8. 单击每个修订下方的更多信息以查看有关修订的信息。
    9. 建议:记录您想要安装的修订包的名称。
  2. 执行下列其中一个过程以使用修订包来更新 WebSphere Application Server Liberty
    • 访问内含修订包的实时服务存储库,并使用基于 Web 的更新。
      使用本地系统上的 Installation Manager,利用基于 Web 的实时服务存储库中的临时修订,更新 WebSphere Application Server Liberty
      • 对于实时服务存储库,请使用安装期间公开发行产品存储库所使用的那些 URL。Liberty 产品的在线产品存储库中列出了这些 URL。
      • 这些位置不包含可以使用 Web 浏览器来访问的 Web 页面。它们是您对 Installation Manager 指定的基于 Web 的远程存储库位置,以便 Installation Manager 能维护产品。
      要安装来自服务存储库的修订,请执行下列操作:
      1. 如果尚不具有包含 IBM 软件用户标识和密码的 Installation Manager 凭证存储文件和主密码文件,请创建可让您访问该存储库的文件。
        注: 这些是您用来访问受保护 IBM 软件 Web 站点的凭证。
        有关为 Installation Manager 创建凭证存储文件和主密码文件的信息,请参阅 IBM Installation Manager 产品文档
        提示: 创建凭证存储文件时,如果 imutilsc 命令找不到指定的 URL,请在存储库 URL 位置的末尾追加 /repository.config
      2. 使用具有 *ALLOBJ 和 *SECADM 特权的用户概要文件登录 IBM i 系统。
      3. 停止要更新的 WebSphere Application Server Liberty 安装版本上的所有服务器和应用程序。
      4. 在 CL 命令行上,运行 STRQSH 命令以启动 Qshell 命令 Shell。
      5. 确保 umask 设置为 022。
        要验证 umask 设置,请发出以下命令:
        umask
        要将 umask 设置设置为 022,请发出以下命令:
        umask 022
      6. 切换到 Installation_Manager_binaries/eclipse/tools 目录,其中 Installation_Manager_binaries 是 Installation Manager 的安装根目录。

        在 IBM i 系统上,Installation Manager 的根目录是 /QIBM/ProdData/InstallationManager

      7. 安装修订包。
        ./imcl install offering_ID_offering_version,optional_feature_ID
          -repositories repository_URL_or_path 
          -installationDirectory offering_installation_location
          -secureStorageFile storage_file -masterPasswordFile master_password_file
          -acceptLicense
        提示:
        • 新增内容: 更新 Liberty 时,所有已安装的 Liberty 附加组件和功能部件也会更新。
          您可以通过在 user.addonuser.feature 属性中指定其他附加组件和功能部件来安装这些附加组件和功能部件,如以下示例所示。请注意,功能部件短名称或符号名称以双逗号进行分隔:
          ./imcl install com.ibm.websphere.liberty.ND,embeddablecontainer             
          -properties user.addon=extendedPackage-1.0,user.feature=portlet-2.0,,portletserving-2.0
          -installationDirectory /QIBM/ProdData/WebSphere/Liberty/ND -acceptLicense
          -repositories /QIBM/LibertyProductRepo,https://your_onprem_asset_repo_url,/QIBM/LocalAssetRepo,/QIBM/LocalAssetRepo2.zip
          -sharedResourcesDirectory /QIBM/UserData/InstallationManager/IMShared
          -showProgress
          无论您是否能够访问互联网,您都可以从 Liberty Asset Repository Service 实例或基于本地目录的存储库安装资产。在 -repositories 参数中添加存储库 URL、目录路径或归档文件路径。系统按指定这些存储库的顺序访问存储库。有关这些资产存储库的更多信息,请参阅使用 Installation Manager 安装资产。要从 IBM WebSphere Liberty Repository 安装资产,您必须可访问互联网。 要启用对 Liberty Repository 的访问,请将 -properties 参数上的 user.useLibertyRepository 选项设置为 true。Liberty Repository 是安装期间所访问的最后一个存储库。
        • offering_ID用于受支持操作系统的 Liberty 产品中列出的产品标识。
        • offering_version 是要安装的特定产品版本,可以选择性地使用下划线将其附加到产品标识(例如 16.0.2.20160503_0200)。
          • 如果指定 offering_version,那么将安装产品的最新版本以及该版本的所有临时修订。
          • 如果指定了 offering_version,那么将安装产品的指定版本,但不会安装该版本的临时修订。
          对存储库运行以下命令时,可以看到产品版本通过下划线附加到产品标识的末尾:
          ./imcl listAvailablePackages -repositories repository_URL_or_path
        • 您也可以通过 -installFixes 参数指定 nonerecommendedall,以指示要随产品一起安装的临时修订。
          • 如果指定产品版本,那么 -installFixes 选项缺省为 all
          • 如果指定了产品版本,那么 -installFixes 选项缺省为 none
        • 要安装可嵌入 EJB 容器和 JPA 客户机,请在产品标识后面指定可选 embeddablecontainer 功能部件,两者之间使用逗号进行分隔。

          可嵌入 EJB 容器是可用来在独立 Java Platform, Standard Edition (SE) 环境中运行企业 Bean 的 Java 归档 (JAR) 文件。您可以通过使用此可嵌入式容器来在应用程序服务器外部运行企业 Bean。可嵌入 EJB 容器是 EJB 3.1 规范的一部分,并且主要用于单元测试企业 Bean 业务逻辑。

          JPA 客户机可以与可嵌入 EJB 容器一起使用,以在 Java SE 环境中提供 Java Persistence API 功能。

        • 如果已通过安装 WebSphere Application Server 组 PTF 来获取了修订包,那么可以使用本地修订包存储库来安装修订包。

          有关本地修订包存储库的信息,请参阅文件 /QIBM/WAS/WASFixpacks/Readme.html/QIBM/WAS/WASFixpacks/Readme.txt

      8. 可选:列示所有已安装软件包以验证安装:
        ./imcl listInstalledPackages -long
    • 从 Fix Central 下载包含修订包的文件,然后使用本地更新。
      可以从 Fix Central 下载包含修订包的压缩文件。每个压缩修订文件都包含修订包的 Installation Manager 存储库,并且通常具有 .zip 扩展名。下载修订文件之后,请使用 Installation Manager,利用修订包来更新 WebSphere Application Server Liberty
      1. 要下载修订包,请执行下列操作:
        1. 转至 Fix Central
        2. 单击查找产品
        3. 选择 WebSphere Liberty 作为产品组。
        4. 选择已安装的版本。
        5. 选择您的操作系统作为平台,然后单击继续
        6. 选择浏览以查找修订,然后单击继续
        7. 选择要下载的修订包,然后单击继续
        8. 选择下载选项,然后单击继续
        9. 单击我同意以同意条款和条件。
        10. 单击立即下载以下载修订包。
        11. 将二进制格式的压缩修订文件传输到将安装该修订文件的 IBM i 系统。
        12. 将压缩的存储库文件解压到系统上的目录。
      2. 要安装来自所下载文件的修订包,请执行下列操作:
        1. 使用具有 *ALLOBJ 和 *SECADM 特权的用户概要文件登录 IBM i 系统。
        2. 停止要更新的 WebSphere Application Server Liberty 安装版本上的所有服务器和应用程序。
        3. 在 CL 命令行上,运行 STRQSH 命令以启动 Qshell 命令 Shell。
        4. 确保 umask 设置为 022。
          要验证 umask 设置,请发出以下命令:
          umask
          要将 umask 设置设置为 022,请发出以下命令:
          umask 022
        5. 切换到 Installation_Manager_binaries/eclipse/tools 目录,其中 Installation_Manager_binaries 是 Installation Manager 的安装根目录。

          在 IBM i 系统上,Installation Manager 的根目录是 /QIBM/ProdData/InstallationManager

        6. 安装修订包。
          ./imcl install offering_ID_offering_version,optional_feature_ID
            -repositories location_of_expanded_files
            -installationDirectory offering_installation_location
            -acceptLicense
          提示:
          • 新增内容: 更新 Liberty 时,所有已安装的 Liberty 附加组件和功能部件也会更新。
            您可以通过在 user.addonuser.feature 属性中指定其他附加组件和功能部件来安装这些附加组件和功能部件,如以下示例所示。请注意,功能部件短名称或符号名称以双逗号进行分隔:
            ./imcl install com.ibm.websphere.liberty.ND,embeddablecontainer             
            -properties user.addon=extendedPackage-1.0,user.feature=portlet-2.0,,portletserving-2.0
            -installationDirectory /QIBM/ProdData/WebSphere/Liberty/ND -acceptLicense
            -repositories /QIBM/LibertyProductRepo,https://your_onprem_asset_repo_url,/QIBM/LocalAssetRepo,/QIBM/LocalAssetRepo2.zip
            -sharedResourcesDirectory /QIBM/UserData/InstallationManager/IMShared
            -showProgress
            无论您是否能够访问互联网,您都可以从 Liberty Asset Repository Service 实例或基于本地目录的存储库安装资产。在 -repositories 参数中添加存储库 URL、目录路径或归档文件路径。系统按指定这些存储库的顺序访问存储库。有关这些资产存储库的更多信息,请参阅使用 Installation Manager 安装资产。要从 IBM WebSphere Liberty Repository 安装资产,您必须可访问互联网。 要启用对 Liberty Repository 的访问,请将 -properties 参数上的 user.useLibertyRepository 选项设置为 true。Liberty Repository 是安装期间所访问的最后一个存储库。
          • offering_ID用于受支持操作系统的 Liberty 产品中列出的产品标识。
          • offering_version 是要安装的特定产品版本,可以选择性地使用下划线将其附加到产品标识(例如 16.0.2.20160503_0200)。
            • 如果指定 offering_version,那么将安装产品的最新版本以及该版本的所有临时修订。
            • 如果指定了 offering_version,那么将安装产品的指定版本,但不会安装该版本的临时修订。
            对存储库运行以下命令时,可以看到产品版本通过下划线附加到产品标识的末尾:
            ./imcl listAvailablePackages -repositories repository_URL_or_path
          • 您也可以通过 -installFixes 参数指定 nonerecommendedall,以指示要随产品一起安装的临时修订。
            • 如果指定产品版本,那么 -installFixes 选项缺省为 all
            • 如果指定了产品版本,那么 -installFixes 选项缺省为 none
          • 要安装可嵌入 EJB 容器和 JPA 客户机,请在产品标识后面指定可选 embeddablecontainer 功能部件,两者之间使用逗号进行分隔。

            可嵌入 EJB 容器是可用来在独立 Java Platform, Standard Edition (SE) 环境中运行企业 Bean 的 Java 归档 (JAR) 文件。您可以通过使用此可嵌入式容器来在应用程序服务器外部运行企业 Bean。可嵌入 EJB 容器是 EJB 3.1 规范的一部分,并且主要用于单元测试企业 Bean 业务逻辑。

            JPA 客户机可以与可嵌入 EJB 容器一起使用,以在 Java SE 环境中提供 Java Persistence API 功能。

          • 如果已通过安装 WebSphere Application Server 组 PTF 来获取了修订包,那么可以使用本地修订包存储库来安装修订包。

            有关本地修订包存储库的信息,请参阅文件 /QIBM/WAS/WASFixpacks/Readme.html/QIBM/WAS/WASFixpacks/Readme.txt

        7. 可选:列示所有已安装软件包以验证安装:
          ./imcl listInstalledPackages -long

用于指示主题类型的图标 任务主题

文件名:twlp_ins_upgrade_is_cl.html