在 z/OS 操作系统上安装 Liberty 临时修订和修订包

修订包中包含捆绑的服务,用于将 WebSphere® Application Server for z/OS® Liberty 升级到新级别。临时修订针对已知的特定问题提供校正服务。您可以通过 IBM® Installation Manager,使用适用于 WebSphere Application Server for z/OS 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 Liberty for z/OS 的更新的信息,请联系 IBM 软件支持中心。有关升级的更多信息,请参阅“WebSphere Application Server for z/OS:程序目录”。可以从 IBM 软件支持中心和 Fix Central 获取最新信息。

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

您必须具有 IBM Installation Manager V1.8.5 或更高版本

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

过程

  1. 使用 Installation Manager 将必需的维护包应用到数据集和文件系统结构。
    1. 要获取适用于 WebSphere Application Server for z/OS Liberty 的修订列表以及有关每个修订的特定信息,请执行下列操作。
      1. 转至 Fix Central
      2. 单击查找产品
      3. 选择 WebSphere Liberty 作为产品组。
      4. 选择要更新的产品的版本。
      5. 选择 z/OS 作为平台,然后单击继续
      6. 选择浏览以查找修订,然后单击继续
      7. 单击每个修订下方的更多信息以查看有关修订的信息。
    2. 执行下列其中一个过程以使用修订来更新 WebSphere Application Server for z/OS Liberty
      • 访问内含修订的实时服务存储库,并使用基于 Web 的更新。
        使用本地系统上的 Installation Manager,利用基于 Web 的实时服务存储库中的临时修订,更新 WebSphere Application Server for z/OS Liberty
        • 对于实时服务存储库,请使用安装期间公开发行产品存储库所使用的那些 URL。Liberty 产品的在线产品存储库中列出了这些 URL。
        • 这些位置不包含可以使用 Web 浏览器来访问的 Web 页面。它们是您对 Installation Manager 指定的基于 Web 的远程存储库位置,以便 Installation Manager 能维护产品。
        要安装来自服务存储库的修订,请执行下列操作:
        1. 在最初使用 Installation Manager 来安装产品文件系统的路径处,以读写方式安装产品文件系统。
        2. 如果尚不具有包含 IBM 软件用户标识和密码的 Installation Manager 凭证存储文件和主密码文件,请创建可让您访问该存储库的文件。
          注: 这些是您用来访问受保护 IBM 软件 Web 站点的凭证。
          创建凭证存储文件和主密码文件:
          imutilsc saveCredential 
            -secureStorageFile storage_file -masterPasswordFile master_password_file
            -userName IBM_software_ID
            -userPassword IBM_software_password
            -url repository_URL_or_path
          提示: 创建凭证存储文件时,如果 imutilsc 命令找不到指定的 URL,请在存储库 URL 位置的末尾追加 /repository.config
        3. 从 Installation Manager 用户标识,执行下列操作:
          1. 切换到 Installation_Manager_binaries/eclipse/tools 目录,其中 Installation_Manager_binaries 是 Installation Manager 的安装根目录。
          2. 安装修订。
            要安装临时修订,请使用此命令:
            imcl install fix_name
              -installationDirectory offering_installation_location
              -repositories repository_URL_or_path
              -secureStorageFile storage_file -masterPasswordFile master_password_file
            要安装修订包,请使用此命令:
            imcl install offering_ID_offering_version,optional_feature_ID
              -installationDirectory offering_installation_location
              -properties user.useLibertyRepository=[true|false],user.addon=addon_shortOrSymbolicName,user.feature=feature_shortOrSymbolicName
              -repositories repository_URL_or_path,Liberty_asset_repository_URL_or_path
              -secureStorageFile storage_file -masterPasswordFile master_password_file
              -acceptLicense
            提示:
            • offering_ID用于受支持操作系统的 Liberty 产品中列出的产品标识。
            • offering_version 是要安装的特定产品版本,可以选择性地使用下划线将其附加到产品标识(例如 16.0.20160503_0200)。
              • 如果指定 offering_version,那么将安装产品的最新版本以及该版本的所有临时修订。
              • 如果指定了 offering_version,那么将安装产品的指定版本,但不会安装该版本的临时修订。
              对存储库运行以下命令时,可以看到产品版本通过下划线附加到产品标识的末尾:
              imcl listAvailablePackages -repositories repository_URL_or_path
            • 您也可以通过 -installFixes 参数指定 nonerecommendedall,以指示要随产品一起安装的临时修订。
              • 如果指定产品版本,那么 -installFixes 选项缺省为 all
              • 如果指定了产品版本,那么 -installFixes 选项缺省为 none
            • 对于修订包:
              • 新增内容: 使用修订包更新 Liberty 时,所有已安装的 Liberty 附加组件和功能部件也会更新。
                [17.0.0.3 and later]要点: 如果安装了 Java SE 6,那么更新将失败。您必须将 Java SE 6 迁移到 Java SE 8,然后重新启动更新。
                您可以通过在 user.addonuser.feature 属性中指定其他附加组件和功能部件来安装这些附加组件和功能部件,如以下示例所示。请注意,功能部件短名称或符号名称以双逗号进行分隔:
                ./imcl install com.ibm.websphere.liberty.zOS,embeddablecontainer             
                -properties user.addon=extendedPackage-1.0,user.feature=portlet-2.0,,portletserving-2.0
                -installationDirectory /InstallationManager/products/WebSphere/Liberty/level -acceptLicense
                -repositories http://www.ibm.com/software/repositorymanager/com.ibm.websphere.liberty.zOS,https://your_onprem_asset_repo_url,/usr/lpp/LocalAssetRepo,/usr/lpp/LocalAssetRepo2.zip
                -sharedResourcesDirectory /InstallationManager/sharedResources
                -showProgress
                无论您是否能够访问互联网,您都可以从 Liberty Asset Repository Service 实例或基于本地目录的存储库安装资产。在 -repositories 参数中添加存储库 URL、目录路径或归档文件路径。系统按指定这些存储库的顺序访问存储库。有关这些资产存储库的更多信息,请参阅使用 Installation Manager 安装资产。要从 IBM WebSphere Liberty Repository 安装资产,您必须可访问互联网。 要启用对 Liberty Repository 的访问,请将 -properties 参数上的 user.useLibertyRepository 选项设置为 true。Liberty Repository 是安装期间所访问的最后一个存储库。
              • 要安装可嵌入 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 功能。

          3. 可选:列示所有已安装软件包以验证安装:
            imcl listInstalledPackages -long
      • 从 Fix Central 下载包含修订的文件,并使用本地更新。
        可以从 Fix Central 下载包含修订的压缩文件。每个压缩修订文件都包含修订的 Installation Manager 存储库,并且通常具有 .zip 扩展名。下载修订文件之后,可以使用 Installation Manager,利用修订来更新 WebSphere Application Server for z/OS Liberty
        1. 要下载修订,请执行下列操作:
          1. 转至 Fix Central
          2. 单击查找产品
          3. 选择 WebSphere Liberty 作为产品组。
          4. 选择要更新的产品版本。
          5. 选择 z/OS 作为平台,然后单击继续
          6. 选择浏览以查找修订,然后单击继续
          7. 选择要下载的修订,然后单击继续
          8. 选择下载选项,然后单击继续
          9. 单击我同意以同意条款和条件。
          10. 单击立即下载以下载修订。
          11. 将二进制格式的压缩修订文件传输到将安装这些修订文件的 z/OS 系统。
          12. 如果正在安装修订包,请将压缩的存储库文件解压到系统上的目录。
        2. 要从所下载的文件安装修订,请执行下列操作:
          1. 在最初使用 Installation Manager 来安装产品文件系统的路径处,以读写方式安装产品文件系统。
          2. 从 Installation Manager 用户标识,执行下列操作:
            1. 切换到 Installation_Manager_binaries/eclipse/tools 目录,其中 Installation_Manager_binaries 是 Installation Manager 的安装根目录。
            2. 安装修订。
              要安装临时修订,请使用此命令:
              imcl install fix_name
                 -installationDirectory offering_installation_location
                 -repositories compressed_file
              要安装修订包,请使用此命令:
              imcl install offering_ID_offering_version,optional_feature_ID
                -installationDirectory offering_installation_location
                -repositories location_of_expanded_files
                -acceptLicense
              提示:
              • 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
              • 对于修订包:
                • 新增内容: 使用修订包更新 Liberty 时,所有已安装的 Liberty 附加组件和功能部件也会更新。
                  您可以通过在 user.addonuser.feature 属性中指定其他附加组件和功能部件来安装这些附加组件和功能部件,如以下示例所示。请注意,功能部件短名称或符号名称以双逗号进行分隔:
                  ./imcl install com.ibm.websphere.liberty.zOS,embeddablecontainer             
                  -properties user.addon=extendedPackage-1.0,user.feature=portlet-2.0,,portletserving-2.0
                  -installationDirectory /InstallationManager/products/WebSphere/Liberty/level -acceptLicense
                  -repositories http://www.ibm.com/software/repositorymanager/com.ibm.websphere.liberty.zOS,https://your_onprem_asset_repo_url,/usr/lpp/LocalAssetRepo,/usr/lpp/LocalAssetRepo2.zip
                  -sharedResourcesDirectory /InstallationManager/sharedResources
                  -showProgress
                  无论您是否能够访问互联网,您都可以从 Liberty Asset Repository Service 实例或基于本地目录的存储库安装资产。在 -repositories 参数中添加存储库 URL、目录路径或归档文件路径。系统按指定这些存储库的顺序访问存储库。有关这些资产存储库的更多信息,请参阅使用 Installation Manager 安装资产。要从 IBM WebSphere Liberty Repository 安装资产,您必须可访问互联网。 要启用对 Liberty Repository 的访问,请将 -properties 参数上的 user.useLibertyRepository 选项设置为 true。Liberty Repository 是安装期间所访问的最后一个存储库。
                • 要安装可嵌入 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 功能。

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

    有关更新 WebSphere Application Server for z/OS Liberty 的更多信息,请参阅在 z/OS 上更新和卸载 Liberty

  2. 在生产位置重新安装产品文件系统。

    通常,文件系统应该以只读方式安装。

  3. 根据修订或 APAR 说明信函中的指示信息来执行任何其他迁移操作。
  4. 启动服务器以完成任何必要的后置安装任务。

    服务器启动时,后置安装程序将自动地对每个节点运行,以便将配置文件系统更新到新的服务级别。

    注: 在 Network Deployment 单元中,Deployment Manager 节点的服务级别必须等于或高于单元的应用程序服务器节点的服务级别。必须确保将 Deployment Manager 节点升级到新的服务级别。

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

文件名:twlp_ins_install_fixes_z.html