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

可以使用 Installation Manager 命令行在 IBM® i 操作系统上安装所有 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 版本。

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

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

要点: 安装 Liberty 之前,您必须先阅读随产品文件一起提供的许可协议。如本主题中所述,通过在命令中指定 -acceptLicense 来表示您接受许可协议。

如果尚未安装 IBM Installation Manager V1.8.5 或更高版本,请将它安装在要安装产品的系统上:

  1. 下载 IBM Installation Manager。
    有三个基本选项用于访问 Installation Manager 安装文件。
    • IBM Installation Manager 下载 Web 站点下载最新版本的 Installation Manager。
    • 从介质上的产品存储库安装 Installation Manager。
    • 从 Passport Advantage® 站点下载文件并使用本地安装。

      具有 Passport Advantage 标识和密码的许可客户可以从 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
      注:

关于此任务

所有产品(包括 Liberty 产品和其他可用的软件)都使用相同的 Installation Manager 命令进行安装。要安装另一产品,请完成这些步骤,但将产品标识和任何可选功能部件替换为该产品的标识和功能部件。
新增内容: 缺省情况下,安装 Liberty 时,还会安装所有适用于 Liberty 产品版本的 Liberty 功能部件。 或者,您可以安装另一组功能部件,或者不安装任何功能部件。有关更多信息,请参阅提示一节。

过程

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

      主密码文件是一个文本文件,它包含“此文本是主密码”之类的口令。此文件用于保护认证凭证。

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

      提示: 要保护此文件,请根据您的操作系统相应设置许可权以限制对此文件的访问。
    2. 通过运行 imutilsc saveCredential 命令来创建凭证存储文件。
      For Windows platforms
      imutilsc.exe saveCredential 
        -secureStorageFile storage_file
        -userName user_ID -userPassword user_password
        -url repository_URL_or_path 
      For AIX platformsFor HP UNIX platformsFor LINUX platformsFor Solaris platforms
      ./imutilsc saveCredential 
        -secureStorageFile storage_file
        -userName user_ID -userPassword user_password
        -url repository_URL_or_path 
      提示: 创建凭证存储文件时,如果 imutilsc 命令找不到指定的 URL,请在存储库 URL 位置的末尾追加 /repository.config
  2. 使用具有 *ALLOBJ 和 *SECADM 特权的用户概要文件登录 IBM i 系统。
  3. 在 CL 命令行上,运行 STRQSH 命令以启动 Qshell 命令 shell。
  4. 确保 umask 设置为 022。
    要验证 umask 设置,请发出以下命令:
    umask
    要将 umask 设置设置为 022,请发出以下命令:
    umask 022
  5. 切换到 Installation Manager 的安装目录中的 eclipse/tools 子目录。
  6. 使用 imcl 命令来安装产品。
    ./imcl install com.ibm.websphere.liberty.ND_offering_version,optional_feature_ID
      -repositories repository_URL_or_path 
      -installationDirectory installation_directory
      -sharedResourcesDirectory shared_directory
      -preferences preference_key=value
      -properties property_key=value
      -secureStorageFile storage_file -masterPasswordFile master_password_file
      -acceptLicense
    提示:
    • 新增内容: 缺省情况下,安装 Liberty 时,还会安装所有适用于 Liberty 产品版本的 Liberty 功能部件。
      您可以通过在 user.addonuser.feature 属性中指定一组定制 Liberty 附加组件和功能部件来安装这些附加组件和功能部件,而无需安装所有功能部件,如以下示例所示。请注意,功能部件短名称或符号名称以双逗号进行分隔:
      ./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 是安装期间所访问的最后一个存储库。
      要点: 如果您不希望安装 Liberty 附加组件或功能部件,请指定 -properties user.addon="" user.feature="" 参数。
      有关更多信息,请参阅以下主题:
    • 在此产品的安装映像或存储库的 lafilesoffering_name/lafiles 子目录中的许可协议文件中提供了相关条款和条件、声明以及其他信息。
    • 首次使用 Installation Manager 来安装软件包时,可以指定共享资源目录。共享资源目录是放置可由一个或多个软件包组使用的安装工件的位置。它也用作执行安装操作期间产品有效内容的登台区域。缺省情况下,会高速缓存此内容以用于回滚。将最大的驱动器用于此安装。只有在卸载所有软件包之后才能更改目录位置。
    • 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 功能部件,两者之间使用逗号进行分隔:
      imcl install com.ibm.websphere.liberty.ND,embeddablecontainer

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

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

    • 对于初始安装,指定 user_data_root 是很好的做法;否则,将使用 user_data_root 的缺省值 /QIBM/UserData/WebSphere/Liberty/EDITION。使用 was.install.os400.profile.location 属性来指定 user_data_root
    • 程序可能会将重要的安装后指示信息写入标准输出。

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

示例

下面是使用 imcl 命令安装 WebSphere Application Server Liberty 的示例:
./imcl install com.ibm.websphere.liberty.ND
  -repositories https://downloads.mycorp.com:8080/WAS_Liberty_repository
  -installationDirectory /QIBM/ProdData/WebSphere/Liberty/ND
  -properties was.install.os400.profile.location=/QIBM/UserData/WebSphere/Liberty/ND
  -sharedResourcesDirectory /QIBM/UserData/InstallationManager/IMShared
  -secureStorageFile $HOME/WASFiles/temp/credential.store -masterPasswordFile $HOME/WASFiles/IM/master_password_file.txt
  -acceptLicense

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

文件名:twlp_ins_installation_is_cl.html