使用命令行在分布式操作系统上安装 Liberty

您可以使用 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 版本。

按照安装 Installation Manager 并准备安装 Liberty中的描述,准备要安装 Liberty 的系统。

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

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

关于此任务

所有产品(包括 Liberty 产品、Java SDK 产品和其他可用的软件)都使用相同 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. 登录系统。
  3. 切换到 Installation Manager 的安装目录中的 eclipse/tools 子目录。
  4. 验证产品存储库是否可用。
    For Windows platforms
    imcl.exe listAvailablePackages -repositories repository_URL_or_path
    For AIX platformsFor HP UNIX platformsFor LINUX platformsFor Solaris platforms
    ./imcl listAvailablePackages -repositories repository_URL_or_path
    您应该看到一个或多个级别的产品。
  5. 使用 imcl 命令来安装产品。
    For Windows platforms
    imcl.exe install com.ibm.websphere.liberty.CORE.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
    For AIX platformsFor HP UNIX platformsFor LINUX platformsFor Solaris platforms
    ./imcl install com.ibm.websphere.liberty.CORE.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.exe install com.ibm.websphere.liberty.CORE.ND,embeddablecontainer             
      -properties user.addon=extendedPackage-1.0,user.feature=portlet-2.0,,portletserving-2.0
      -installationDirectory "C:\Program Files\IBM\WebSphere\Liberty" -acceptLicense
      -repositories D:\IBM\LibertyRepo,https://your_onprem_asset_repo_url,D:\IBM\LocalAssetRepo,D:\IBM\LocalAssetRepo2.zip
      -sharedResourcesDirectory D:\IBM\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="" 参数。
      有关更多信息,请参阅以下主题:
    • 首次使用 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 功能部件,两者之间使用逗号进行分隔。
      注: 自 16.0.0.2 修订包起,发布了针对可嵌入 EJB 容器及 JPA 客户机功能部件的移除通知,因此后续发行版中可能会移除此功能部件。有关更多信息,请参阅移除通知

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

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

    • Installation Manager 可以保存软件包的较早版本,以便您稍后遇到问题时可以回滚。Installation Manager 将软件包回滚到先前版本时,将会卸载文件的当前版本并重新安装较早版本。如果您选择不针对回滚保存文件,那么可通过在命令规范中使用以下首选项来阻止保存文件:
      -preference com.ibm.cic.common.core.preferences.preserveDownloadedArtifacts=False
      更改为以下内容来阻止保存文件:
      提示: 即使您选择不在本地保留用于回滚的文件,也仍可以通过访问相应的产品存储库来回滚到先前安装的级别。
    • Installation Manager 会根据操作系统体系结构自动选择安装包的体系结构。在 64 位系统上,可以通过将以下首选项设置为 32 位操作系统体系结构值来指定 32 位安装:
      -properties cic.selector.arch=x86

      要获取 cic.selector.arch 的体系结构值的列表,请参阅 Installation Manager 产品文档中的 imcl 命令的命令行自变量表。

    • 在此产品的安装映像或存储库的 lafilesoffering_name/lafiles 子目录中的许可协议文件中提供了相关条款和条件、声明以及其他信息。
    • 程序可能会将重要的安装后指示信息写入标准输出。

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


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

文件名:twlp_ins_installation_dist_cl.html