使用命令行在 IBM i 操作系统上安装 Liberty

可以使用 Installation Manager 命令行在 IBM® i 操作系统上安装 WebSphere® Application Server Liberty Core

开始之前

使用此过程之前,请准备安装。有关更多信息,请参阅准备操作系统以在 IBM i 上进行安装

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

要点: 安装 WebSphere Application Server Liberty Core 之前,必须阅读与产品文件一起提供的许可协议。如本主题中所述,通过在命令中指定 -acceptLicense 来表示您接受许可协议。
在要安装产品的系统上安装 Installation Manager
  • 如果您想要使用本产品随附的 Installation Manager,请执行下列操作:
    1. 获取必要的文件。
      可以通过三种基本选项来获取并安装 Installation Manager 和产品。
      • 访问物理介质并使用本地安装
        可以访问介质上的产品存储库。
        1. 在系统上安装 Installation Manager。

          可以使用介质、使用从 Passport Advantage® 站点获取的文件或使用 IBM Installation Manager 下载 Web 站点中包含最新版本的 Installation Manager 的文件来安装 Installation Manager。

        2. 使用 Installation Manager 从介质上的产品存储库安装产品。
      • 从 Passport Advantage 站点下载文件并使用本地安装
        具有 Passport Advantage 标识和密码的授权客户可以从 Passport Advantage 站点下载必需的产品存储库。
        1. 从 Passport Advantage 站点下载文件。
        2. 在系统上安装 Installation Manager。

          可以使用介质、使用从 Passport Advantage 站点获取的文件或使用 IBM Installation Manager 下载 Web 站点中包含最新版本的 Installation Manager 的文件来安装 Installation Manager。

        3. 使用 Installation Manager 从已下载的存储库安装产品。
      • 访问处于活动状态的存储库并使用基于 Web 的安装
        如果您具有 Passport Advantage 标识和密码,那么可以从基于 Web 的存储库安装产品。
        1. 在系统上安装 Installation Manager。

          可以使用介质、使用从 Passport Advantage 站点获取的文件或使用 IBM Installation Manager 下载 Web 站点中包含最新版本的 Installation Manager 的文件来安装 Installation Manager。

        2. 使用 Installation Manager 从基于 Web 的存储库安装产品,此存储库位于:
          http://www.ibm.com/software/repositorymanager/com.ibm.websphere.liberty.v85 
          注: 此位置不包含可以使用 Web 浏览器访问的 Web 页面。这是基于 Web 的远程存储库位置,您必须为 -repositories 参数的值指定此位置,以便 imcl 命令可以访问此存储库中的文件来安装产品。

        您应该尽可能地使用基于 Web 的远程存储库,以便访问最新的安装文件。

      注: 如果您没有 Passport Advantage 标识和密码,那么必须从介质上的产品存储库或从本地存储库安装产品。
    2. 为 Installation Manager 的二进制文件、运行时数据(代理程序数据)以及共享数据位置选择三个单独的位置。
    3. 使用 Installation Manager 命令行来安装 Installation Manager。
      1. 使用具有 *ALLOBJ 和 *SECADM 特权的用户概要文件登录 IBM i 系统。
      2. 在 CL 命令行上,运行 STRQSH 命令以启动 Qshell 命令 shell。
      3. 确保 umask 设置为 022。
        要验证 umask 设置,请发出以下命令:
        umask
        要将 umask 设置设置为 022,请发出以下命令:
        umask 022
      4. 切换到包含 Installation Manager 安装文件的位置,然后运行下列命令:
        installc -acceptLicense -log log_file_path_and_name
        注释:
  • 如果系统上已安装某个版本的 Installation Manager 并且您要使用它来安装和维护产品,请获取必需的产品文件。
    可以通过三种基本选项来安装产品。
    • 访问物理介质并使用本地安装

      可以访问介质上的产品存储库。使用 Installation Manager 从介质上的产品存储库安装产品。

    • 从 Passport Advantage 站点下载文件并使用本地安装
      具有 Passport Advantage 标识和密码的授权客户可以从 Passport Advantage 站点下载必需的产品存储库。
      1. 从 Passport Advantage 站点下载产品存储库。
      2. 使用 Installation Manager 从已下载的存储库安装产品。
    • 访问处于活动状态的存储库并使用基于 Web 的安装
      如果您具有 Passport Advantage 标识和密码,那么可以使用 Installation Manager 从基于 Web 的存储库安装产品。使用 Installation Manager 从基于 Web 的存储库安装产品,此存储库位于:
      http://www.ibm.com/software/repositorymanager/com.ibm.websphere.liberty.v85 
      注: 此位置不包含可以使用 Web 浏览器访问的 Web 页面。这是一个基于 Web 的远程存储库位置,您必须指定 -repositories 参数的值,以便 imcl 命令可以访问此存储库中的文件来安装该产品。

      您应该尽可能地使用基于 Web 的远程存储库,以便访问最新的安装文件。

    注: 如果您没有 Passport Advantage 标识和密码,那么必须从介质上的产品存储库或从本地存储库安装产品。

关于此任务

[8.5.5.4 或更高版本]要安装 Liberty 概要文件 V8.5.5.4 及更高版本,必须具有 IBM Installation Manager V1.6.2 或更高版本。

过程

  1. 可选: 如果存储库需要用户名和密码,请创建凭证存储文件以访问此存储库。
    提示: 创建凭证存储文件时,如果 imutilsc 命令找不到指定的 URL,请在存储库 URL 位置的末尾追加 /repository.config
    注: 使用 Installation Manager V1.6.2 和更高版本时,您应该使用 -secureStorageFile-masterPasswordFile 选项将凭证存储在凭证存储文件中。对于版本低于 V1.6.2 的 Installation Manager,使用 -keyring-password 选项来访问密钥环文件中的凭证。V1.6.2 中不推荐使用这些选项。不存在从密钥环文件到存储文件的迁移路径,这是因为,这些文件的结构存在差异。有关使用 -secureStorageFile-masterPasswordFile 选项将凭证存储在凭证存储文件中的更多信息,请参阅 Installation Manager V1.6 信息中心。有关使用 -keyring-password 选项将凭证存储在密钥环文件中的更多信息,请参阅 Installation Manager V1.5 信息中心
  2. 为产品的二进制文件、运行时数据(代理程序数据)以及共享数据位置选择三个单独的位置。
  3. 使用具有 *ALLOBJ 和 *SECADM 特权的用户概要文件登录 IBM i 系统。
  4. 在 CL 命令行上,运行 STRQSH 命令以启动 Qshell 命令 shell。
  5. 确保 umask 设置为 022。
    要验证 umask 设置,请发出以下命令:
    umask
    要将 umask 设置设置为 022,请发出以下命令:
    umask 022
  6. 切换到 Installation Manager 的安装目录中的 eclipse/tools 子目录。
  7. 使用 imcl 命令来安装产品。
    ./imcl install com.ibm.websphere.liberty.v85_offering_version,optional_feature_ID
      -repositories source_repository 
      -installationDirectory installation_directory
      -sharedResourcesDirectory shared_directory
      -preferences preference_key=value
      -properties property_key=value
      -secureStorageFile storage_file -masterPasswordFile master_password_file
      -acceptLicense
    提示:
    • 在此产品的安装映像或存储库的 lafilesproduct_name/lafiles 子目录中的许可协议文件中提供了相关条款和条件、声明以及其他信息。
    • 可以安装用逗号分隔的功能部件列表。
      • 可嵌入 EJB 容器和 JPA 客户机 (embeddablecontainer)

        此选项会安装可嵌入 EJB 容器和 JPA 客户机。

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

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

      注释:
      • 如果未指定功能部件,那么安装缺省功能部件 (embeddablecontainer)
    • Liberty Repository[8.5.5.2 或更高版本]可以指定要从 Liberty Repository 安装的其他资产。有关 Liberty Repository 资产的列表,请参阅 WASdev.net 上的 Downloads 页面

      要从 IBM WebSphere Liberty Repository 中安装资产,您必须可访问因特网,且必须具有 IBM Installation Manager V1.6.2 或更高版本。

      如果要安装 Liberty Repository 功能部件,请在 -properties 参数的 user.feature 选项上指定短名称或符号名称。多个功能部件名称之间使用双逗号分隔。以下示例安装 Portlet 容器和 Portlet Serving 功能部件:
      -properties user.feature=portlet-2.0,,portletserving-2.0,user.accept.license=true
      [8.5.5.5 或更高版本]对于 V8.5.5.5 及更高版本,不需要 user.accept.license=true
      Liberty Repository[8.5.5.4 或更高版本]从 V8.5.5.4 开始,extprogmodels 功能部件不再可用。反而应安装 extendedPackage-1.0 附加组件,或从 Liberty Repository 安装您需要的各个功能部件。请参阅以下主题以获取更多信息:
      可通过指定 user.addon 选项来安装一组完整扩展编程模型功能部件:
      -properties user.addon=extendedPackage-1.0,user.accept.license=true
      如果升级包含 extprogmodels 功能部件的 WebSphere Application Server Liberty 概要文件 V8.5.5.3 或先前版本,那么 Installation Manager 会自动安装 extendedPackage-1.0 附加组件。必须指定 user.accept.license 选项:
      -properties user.accept.license=true
      Liberty Repository[8.5.5.6 或更高版本]还可从 Liberty Asset Repository Service 实例或基于本地目录的存储库中安装资产。有关这些资产存储库的更多信息,请参阅使用 Installation Manager 安装资产。在 -repositories 参数上添加存储库 URL 或目录。系统按指定存储库的顺序访问存储库。缺省情况下,Liberty Repository 是安装期间所访问的最后一个存储库。要禁用对 Liberty Repository 的访问,请将 -properties 参数上的 user.useLibertyRepository 选项设置为 false以下示例首先从 Liberty Asset Repository Service 的 https://your_onprem_asset_repo_url 实例中安装资产。如果这些资产不可用,那么系统会从基于本地目录的存储库 /QIBM/LocalAssetRepo 中安装资产。对 IBM WebSphere Liberty Repository 的访问被禁用:
      ./imcl install com.ibm.websphere.liberty.v85 
      -properties user.useLibertyRepository=false,user.addon=extendedPackage-1.0,user.feature=portlet-2.0
      -installationDirectory /QIBM/ProdData/Liberty -acceptLicense
      -repositories /QIBM/LibertyProductRepo,https://your_onprem_asset_repo_url,/QIBM/LocalAssetRepo
      -sharedResourcesDirectory /QIBM/UserData/InstallationManager/IMShared
      -showProgress
      要了解有关 Liberty Repository 及其包含的资产的更多信息,请参阅Liberty Repository
    • offering_version 是要安装的产品的特定版本,可以选择性地使用下划线将其附加到产品标识(例如 8.5.5.20110503_0200)。
      • 如果指定 offering_version,那么将安装产品的最新版本以及该版本的所有临时修订。
      • 如果指定了 offering_version,那么将安装产品的指定版本,但不会安装该版本的临时修订。
      对存储库运行以下命令时,可以看到产品版本通过下划线附加到产品标识的末尾:
      ./imcl listAvailablePackages -repositories source_repository
    • 您也可以通过 -installFixes 参数指定 nonerecommendedall,以指示要随产品一起安装的临时修订。
      • 如果指定产品版本,那么 -installFixes 选项缺省为 all
      • 如果指定了产品版本,那么 -installFixes 选项缺省为 none
    • 对于初始安装,指定 user_data_root 是很好的做法;否则,将使用 user_data_root 的缺省值 /QIBM/UserData/WebSphere/AppServer/V85/LibertyCore。使用 was.install.os400.profile.location 属性来指定 user_data_root。例如,如果 user_data_root 将为 /QIBM/UserData/WebSphere/AppServer/V85/Liberty,请在 imcl 安装命令上指定 -properties was.install.os400.profile.location=/QIBM/UserData/WebSphere/AppServer/V85/Liberty
    • 程序可能会将重要的安装后指示信息写入标准输出。

    有关使用 imcl 命令来安装产品的更多信息,请参阅 IBM Installation Manager 信息中心

示例

以下示例使用 imcl 命令来安装 Websphere Application Server Liberty Core
./imcl install com.ibm.websphere.liberty.v85 
  -repositories https://downloads.mycorp.com:8080/WAS_85_repository
  -installationDirectory /QIBM/ProdData/WebSphere/AppServer/V85/LibertyCore
  -properties was.install.os400.profile.location=/QIBM/UserData/WebSphere/AppServer/V85/LibertyCore
  -sharedResourcesDirectory /QIBM/UserData/InstallationManager/IMShared
  -secureStorageFile $HOME/WASFiles/temp/credential.store -masterPasswordFile $HOME/WASFiles/IM/master_password_file.txt
  -acceptLicense

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

信息中心的条款和条件 | 反馈


时间戳记图标 最近一次更新时间: Wednesday, 2 September 2015
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=phil&product=was-libcore-mp&topic=twlp_ins_installation_is_cl
文件名:twlp_ins_installation_is_cl.html