使用响应文件在 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
      注:

过程

  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 子目录,并安装产品。例如:
    ./imcl -acceptLicense 
      input $HOME/WASFiles/temp/install_response_file.xml 
      -log $HOME/WASFiles/temp/install_log.xml 
      -secureStorageFile $HOME/WASFiles/temp/credential.store -masterPasswordFile $HOME/WASFiles/master_password_file.txt
    注:
    • 在此产品的安装映像或存储库的 lafilesproduct_name/lafiles 子目录中的许可协议文件中提供了相关条款和条件、声明以及其他信息。
    • /QIBM/ProdData/InstallationManager 是 IBM i 系统上 Installation Manager 文件的缺省安装位置。
    • 程序可能会将重要的安装后指示信息写入标准输出。

    有关更多信息,请参阅 IBM Installation Manager 产品文档

示例

以下是响应文件的一个示例,此响应文件使用基于 Web 的存储库(位于 http://www.ibm.com/software/repositorymanager/com.ibm.websphere.liberty.CORE.ND),将不含任何可选功能部件的产品安装到 /QIBM/ProdData/WebSphere/Liberty/LibertyCore 目录。
<?xml version="1.0" encoding="UTF-8"?>
<agent-input>
<server>
  <repository location='http://www.ibm.com/software/repositorymanager/com.ibm.websphere.liberty.CORE.ND'/>
</server>
<profile id='WebSphere Liberty' installLocation='/QIBM/ProdData/WebSphere/Liberty/LibertyCore'>
  <data key='was.install.os400.profile.location' value='/QIBM/UserData/WebSphere/Liberty/LibertyCore'/>
  <data key='user.import.profile' value='false'/>
</profile>
<install modify='false'>
  <offering profile='WebSphere Liberty' 
    features='' id='com.ibm.websphere.liberty.CORE.ND'/>
</install>
<preference name='com.ibm.cic.common.core.preferences.eclipseCache' 
  value='/QIBM/UserData/InstallationManager/IMShared'/>
<preference name='com.ibm.cic.common.core.preferences.connectTimeout' value='30'/>
<preference name='com.ibm.cic.common.core.preferences.readTimeout' value='30'/>
<preference name='com.ibm.cic.common.core.preferences.downloadAutoRetryCount' value='0'/>
<preference name='offering.service.repositories.areUsed' value='true'/>
<preference name='com.ibm.cic.common.core.preferences.ssl.nonsecureMode' value='false'/>
<preference name='com.ibm.cic.common.core.preferences.http.disablePreemptiveAuthentication' value='false'/>
<preference name='http.ntlm.auth.kind' value='NTLM'/>
<preference name='http.ntlm.auth.enableIntegrated.win32' value='true'/>
<preference name='com.ibm.cic.common.core.preferences.preserveDownloadedArtifacts' value='true'/>
<preference name='com.ibm.cic.common.core.preferences.keepFetchedFiles' value='false'/>
<preference name='PassportAdvantageIsEnabled' value='false'/>
<preference name='com.ibm.cic.common.core.preferences.searchForUpdates' value='false'/>
</agent-input>
提示:
  • 新增内容: 缺省情况下,安装 Liberty 时,会安装所有适用于产品版本的 Liberty 功能部件。
    您可以通过在 user.addonuser.feature 属性中指定一组定制 Liberty 附加组件和功能部件来安装这些附加组件和功能部件,而无需安装所有功能部件,如以下示例所示。请注意,功能部件短名称或符号名称必须以双逗号进行分隔。
    以下示例安装“Portlet 容器”功能部件(通过使用符号名称)、“Portlet 服务”功能部件(通过使用短名称)和“扩展编程模型”附加组件。
    <data key='user.feature' value='com.ibm.websphere.appserver.portlet-2.0,,portletserving-2.0'/>
    <data key='user.addon' value='extendedPackage-1.0'/>
    <data key='user.accept.license' value='true'/>
    无论您是否能够访问互联网,您都可以从 Liberty Asset Repository Service 实例或基于本地目录的存储库安装资产。有关更多信息,请参阅使用 Installation Manager 安装资产。在 repository 元素中添加存储库 URL、目录路径或归档路径。如果 Installation Manager 不识别该存储库,请直接指向 repository.config 文件。安装资产时,将按您指定存储库的顺序来访问存储库。
    <server>
    <repository location="http://www.ibm.com/software/repositorymanager/com.ibm.websphere.liberty" />
    <repository location="https://your_onprem_asset_repo_url" />
    <repository location="/QIBM/LocalAssetRepo" />
    <repository location="/QIBM/LocalAssetRepo2.zip" />
    </server>
    要启用对 Liberty 存储库 的访问,请将 data 元素中的 user.useLibertyRepository 参数设置为 trueLiberty 存储库 是安装期间所访问的最后一个存储库。
    <data key='user.useLibertyRepository' value='true'/>
    要点: 如果您不希望安装 Liberty 附加组件或功能部件,请对 user.addonuser.feature 属性指定空值:
    <data key='user.feature' value=''/>
    <data key='user.addon' value=''/>
    有关更多信息,请参阅以下主题:
  • 确保存储库位置指向基于 Web 的存储库或本地产品存储库。例如:
    <repository location='https://downloads.mycorp.com:8080/WAS_Liberty_repository'/>
  • 示例中的以下行指定 IBM i 概要文件位置的缺省值:
    <data key='was.install.os400.profile.location' value='/QIBM/UserData/WebSphere/Liberty/LibertyCore'/>
    要覆盖此缺省位置,请指定其他位置
  • 示例中的以下行指定 IBM i 共享资源目录的缺省值:
    <preference name='com.ibm.cic.common.core.preferences.eclipseCache' value='/QIBM/UserData/InstallationManager/IMShared'/>
    要覆盖此缺省位置,请指定其他位置
    注: Installation Manager 只有一个共享资源目录。如果以前系统上有安装,那么将使用该共享资源目录,而不是响应文件中指定的目录。
  • 要在响应文件中禁止对更新进行远程搜索,请将以下首选项设为 false:
    • offering.service.repositories.areUsed

      用来在远程存储库中搜索对所安装产品的更新

    • com.ibm.cic.common.core.preferences.searchForUpdates

      用来搜索对 Installation Manager 的更新

    例如:
    <preference value='false' name='offering.service.repositories.areUsed'/>
    <preference value='false' name='com.ibm.cic.common.core.preferences.searchForUpdates'/>
    有关静默首选项键的更多详细信息,请参阅 IBM Installation Manager 产品文档
  • 要安装一个产品的多个实例,必须使每个附加实例的概要文件标识都是唯一的。例如:
    <offering profile='WebSphere Liberty - Another User's WAS Liberty CORE' 
        features='' id='com.ibm.websphere.liberty.CORE.ND'/>
    必须在响应文件中用来指定概要文件标识的两个位置进行此更改。
  • 要添加可选可嵌入 EJB 容器和 JPA 客户机功能部件 (embeddablecontainer),请在产品中添加该功能部件。例如:
    <offering id='com.ibm.websphere.liberty.CORE.ND' 
      profile='WebSphere Liberty'
      features='embeddablecontainer' installFixes='none'/>
以下是为了操控此响应文件以执行替代操作而作出更改的一些示例。
  • 要更改安装的位置,只需更改安装位置。例如:
    <profile id='WebSphere Liberty' installLocation='/QIBM/ProdData/WebSphere/Liberty/LibertyCore'>
    替换为
    <profile id='WebSphere Liberty' installLocation='/home/user/IBM/WebSphere/Liberty/Server'>
  • 要从本地存储库(而不是实时远程存储库)进行安装,请替换存储库位置。例如:
    <repository location='http://www.ibm.com/software/repositorymanager/com.ibm.websphere.liberty.CORE.ND'/>
    替换为
    <repository location='/home/user/repositories/WAS/local-repositories'/>

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

文件名:twlp_ins_installation_is_silent.html