使用响应文件在 IBM i 操作系统上安装 Application Client

可以使用 Installation Manager 响应文件来安装 Application Client。

准备工作

在安装应用程序客户机之前，请确保您的用户概要文件具有 *ALLOBJ 和 *SECADM 特权。

在要安装产品的系统上安装 Installation Manager。

如果您想要使用本产品随附的 Installation Manager，请执行下列操作：
1. 获取必要的文件。
  有三个基本选项用于获取并安装 Installation Manager 和产品。
  - 访问物理介质，并使用本地安装
    可以访问产品介质上的产品存储库。
    
    在系统上安装 Installation Manager。
    您可以使用产品介质，使用从 Passport Advantage® 站点获取的文件或从 IBM® Installation Manager 下载 Web 站点使用包含最新版本的 Installation Manager 的文件来安装 Installation Manager 。
    
    使用 Installation Manager 从介质上的产品存储库安装该产品。
  - 从 Passport Advantage 站点下载文件，并使用本地安装
    具有 Passport Advantage 标识和密码的授权客户可以从 Passport Advantage 站点下载必需的产品存储库。
    
    从 Passport Advantage 站点下载文件。
    
    在系统上安装 Installation Manager。
    您可以使用产品介质，从 Passport Advantage 站点获取的文件或从 IBM Installation Manager 下载 Web 站点使用包含最新版本的 Installation Manager 的文件来安装 Installation Manager 。
    
    使用 Installation Manager 从已下载的存储库安装该产品。
  - 访问活动存储库，并使用基于 Web 的安装
    如果您具有 Passport Advantage 标识和密码，那么可以从基于 Web 的存储库安装产品。
    
    在系统上安装 Installation Manager。
    您可以使用产品介质，从 Passport Advantage 站点获取的文件或从 IBM Installation Manager 下载 Web 站点使用包含最新版本的 Installation Manager 的文件来安装 Installation Manager 。
    
    使用 Installation Manager 从基于 Web 的存储库安装产品，此存储库位于：
    https://www.ibm.com/software/repositorymanager/com.ibm.websphere.APPCLIENT.v85
    注: 此位置不包含可使用 Web 浏览器访问的 Web 页面。这是一个基于 Web 的远程存储库位置，您必须在响应文件中指定此位置，以便安装可以访问此存储库中的文件。
    您应该尽可能地使用基于 Web 的远程存储库，以便访问最新的安装文件。
  注: 如果您没有 Passport Advantage 标识和密码，那么必须从介质或本地存储库上的产品存储库安装产品。
2. 安装 Installation Manager。
  1. 使用具有 *ALLOBJ 和 *SECADM 特权的用户概要文件登录 IBM i 系统。
  2. 在 CL 命令行上，运行 STRQSH 命令以启动 Qshell 命令 shell。
  3. 确保 umask 设置为 022。
    要验证 umask 设置，请发出以下命令：
```
umask
```
    要将 umask 设置设置为 022，请发出以下命令：
```
umask 022
```
  4. 切换到包含 Installation Manager 安装文件的位置。
  5. 运行以下命令：
```
installc -acceptLicense -log log_file_path_and_name
```
    注：
    - 有关安装 Installation Manager的更多信息，请参阅 IBM Installation Manager 文档。
    - 在 IBM i 操作系统上安装产品时，请仅使用 installc 命令来安装 Installation Manager。
3. 如果要使用本地存储库来安装和维护产品，请将包含此存储库的压缩文件解压缩到系统上的某个目录。
如果系统上已安装某个版本的 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 的存储库安装产品，此存储库位于：
```
https://www.ibm.com/software/repositorymanager/com.ibm.websphere.APPCLIENT.v85 
```
  注: 此位置不包含可使用 Web 浏览器访问的 Web 页面。这是一个基于 Web 的远程存储库位置，您必须在响应文件中指定此位置，以便安装可以访问此存储库中的文件。
  您应该尽可能地使用基于 Web 的远程存储库，以便访问最新的安装文件。
注: 如果您没有 Passport Advantage 标识和密码，那么必须从介质或本地存储库上的产品存储库安装产品。

有关此任务

通过 Installation Manager，您可以使用响应文件来安装产品。

过程

可选: 如果存储库需要用户名和密码，请创建密钥环文件以访问此存储库。

受支持的配置:
从 Installation Manager V1.6.2 开始，建议不要使用 -keyring 和 -password 选项（它们用于访问密钥环文件中的凭证）。对于 Installation Manager V1.6.2 和更高版本，请使用 -secureStorageFile 和 -masterPasswordFile 选项以将凭证存储在凭证存储文件中。

在 V1.7 中，已修改安全存储文件的格式，并且不再与 V1.7 之前的 Installation Manager 版本兼容。请将 Installation Manager 更新为 V1.7 或更高版本，然后重新创建并替换您使用较低版本创建的任何安全存储文件。

由于文件结构存在差异，因此不存在从密钥环文件迁移到存储文件的迁移路径。您必须创建一个存储文件来替换密钥环文件。有关使用 -secureStorageFile 和 -masterPasswordFile 选项在凭证存储文件中存储凭证的更多信息，请参阅 IBM Installation Manager 文档。
使用具有 *ALLOBJ 和 *SECADM 特权的用户概要文件登录 IBM i 系统。
在 CL 命令行上，运行 STRQSH 命令以启动 Qshell 命令 shell。
确保 umask 设置为 022。
要验证 umask 设置，请发出以下命令：
```
umask
```
要将 umask 设置设置为 022，请发出以下命令：
```
umask 022
```
使用响应文件来安装产品。
切换到 Installation Manager 的安装目录中的 eclipse/tools 子目录，并安装产品。例如：
```
./imcl -acceptLicense 
  input $HOME/AppClientFiles/temp/install_response_file.xml 
  -log $HOME/AppClientFiles/temp/install_log.xml 
  -keyring $HOME/AppclientFiles/temp/im.keyring
```
注：
- 相关的条款和条件、声明和其他信息在产品安装映像或存储库的 lafiles 或 product_name/lafiles 子目录中的许可协议文件中提供。
- 程序可能会将重要的安装后指示信息写入标准输出。

示例

以下是响应文件的示例，用于使用位于 https://www.ibm.com/software/repositorymanager/com.ibm.websphere.APPCLIENT.v85的基于 Web 的存储库将没有可选功能部件的产品安装到 /QIBM/ProdData/WebSphere/AppClient/V85/client 目录中。

<?xml version="1.0" encoding="UTF-8"?>
<agent-input>
<server>
  <repository location='https://www.ibm.com/software/repositorymanager/com.ibm.websphere.APPCLIENT.v85'/>
</server>
<profile id='Application Client for IBM WebSphere Application Server V8.5' 
  installLocation='/QIBM/ProdData/WebSphere/AppClient/V85/client'>
  <data key='eclipseLocation' value='/QIBM/ProdData/WebSphere/AppClient/V85/client'/>
  <data key='was.install.os400.profile.location' value='/QIBM/UserData/WebSphere/AppClient/V85/client'/>
  <data key='user.appclient.serverHostname' value='localhost'/>
  <data key='user.appclient.serverPort' value='2809'/>
  <data key='user.import.profile' value='false'/>
  <data key='cic.selector.nl' value='en'/>
</profile>
<install modify='false'>
  <offering profile='Application Client for IBM WebSphere Application Server V8.5' 
     features='javaee.thinclient.core.feature' id='com.ibm.websphere.APPCLIENT.v85'/>
</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>

以下是用于安装产品 ILAN 版本的响应文件的示例。

<?xml version="1.0" encoding="UTF-8"?>
<agent-input>
<server>
  <repository location='https://www.ibm.com/software/repositorymanager/com.ibm.websphere.APPCLIENTILAN.v85'/>
</server>
<profile id='Application Client for IBM WebSphere Application Server (ILAN) V8.5' 
  installLocation='/QIBM/ProdData/WebSphere/AppClient/V85/client'>
  <data key='eclipseLocation' value='/QIBM/ProdData/WebSphere/AppClient/V85/client'/>
  <data key='was.install.os400.profile.location' value='/QIBM/UserData/WebSphere/AppClient/V85/client'/>
  <data key='user.appclient.serverHostname' value='localhost'/>
  <data key='user.appclient.serverPort' value='2809'/>
  <data key='user.import.profile' value='false'/>
  <data key='cic.selector.nl' value='en'/>
</profile>
<install modify='false'>
  <offering profile='Application Client for IBM WebSphere Application Server (ILAN) V8.5' 
    features='javaee.thinclient.core.feature' id='com.ibm.websphere.APPCLIENTILAN.v85'/>
</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>

提示：

确保存储库位置指向基于 Web 的存储库或本地存储库。例如：

<repository location='https://www.ibm.com/software/repositorymanager/com.ibm.websphere.APPCLIENT.v85'/>

示例中的以下行指定 IBM i 概要文件位置的缺省值：
```
<data key='was.install.os400.profile.location' value='/QIBM/UserData/WebSphere/AppClient/V85/client'/>
```
要覆盖此缺省位置，请指定其他位置
该示例中的以下行指定 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'/>
```
您可以在 Installation Manager 文档中找到有关静默首选项键的更多详细信息。
要安装一个产品的多个实例，必须使每个附加实例的概要文件标识都是唯一的。例如：
```
<offering profile='Application Client for IBM WebSphere Application Server V8.5 - Another User's AppClient' 
  features='javaee.thinclient.core.feature' id='com.ibm.websphere.APPCLIENT.v85'/>
```
必须在响应文件中用来指定概要文件标识的两个位置进行此更改。

以下是为了操控此响应文件以执行替代操作而作出更改的一些示例。

要更改安装的位置，只需更改安装位置。例如：

将

<profile id='Application Client for IBM WebSphere Application Server V8.5' 
  installLocation='/QIBM/ProdData/WebSphere/AppClient/V85/client'>

替换为

<profile id='Application Client for IBM WebSphere Application Server V8.5' 
  installLocation='/home/user/IBM/WebSphere/AppClient/Server'>

要从本地存储库（而不是实时远程存储库）进行安装，请替换存储库位置。例如：

将

<repository location='https://www.ibm.com/software/repositorymanager/com.ibm.websphere.APPCLIENT.v85'/>

替换为

<repository location='/home/user/repositories/AppClient/local-repositories'/>

要添加可选功能部件，请在产品中将每个所需功能部件添加为逗号分隔的列表中的条目。
在以下可选功能部件的列表中，要在响应文件中使用的产品标识会使用括号括起来：
- 独立瘦客户机、资源适配器和可嵌入容器
  IBM 瘦客户机和资源适配器提供了一组适用于多种技术（例如 JAX-WS、JAX-RPC、JAX-RS、XML、EJB、JPA 和 JMS 等等）的客户机和资源适配器。可嵌入容器在独立 Java Platform, Standard Edition 环境中运行。例如，您可使用可嵌入式 EJB 容器在应用程序服务器外部运行企业 Bean。
  - 独立瘦客户机运行时 (standalonethinclient.resourceadapter.runtime)
    此选项将安装适用于独立瘦客户机的运行时。
  - 可嵌入式 EJB 容器 (embeddablecontainer)
    此选项会安装可嵌入式 EJB 容器。
    
    可嵌入 EJB 容器是一个 Java 归档 (JAR) 文件，此文件可用于在独立 Java Platform, Standard Edition 环境中运行企业 Bean。可以在应用程序服务器外部使用此可嵌入容器来运行企业 Bean。可嵌入 EJB 容器是 EJB 3.1 规范的一部分，并且主要用于单元测试企业 Bean 业务逻辑。
例如，要安装可嵌入 EJB 容器，请执行下列操作：
将
```
<offering profile='Application Client for IBM WebSphere Application Server V8.5' 
  features='javaee.thinclient.core.feature' id='com.ibm.websphere.APPCLIENT.v85'/>
```
替换为
```
<offering profile='Application Client for IBM WebSphere Application Server V8.5' 
  features='javaee.thinclient.core.feature,embeddablecontainer' id='com.ibm.websphere.APPCLIENT.v85'/>
```
其中，embeddablecontainer 指示可嵌入 EJB 容器功能部件。

提示: 如果未指定任何功能部件，那么将安装必需功能部件以及缺省情况下选择的可选功能部件 (embeddablecontainer)。要只安装您所需的功能部件，请显式指定功能部件列表。

下一步做什么？

您可以使用 manageprofiles 命令来创建客户机概要文件。

以下是使用 manageprofiles 命令来创建缺省客户机概要文件的示例。该示例基于以下假设：

客户机将连接至的应用程序服务器的系统主机名为 myhost.abc.com。
该应用程序服务器的引导端口为 2809。
app_client_root 为 /QIBM/ProdData/WebSphere/AppClient/V85/client。

manageprofiles -create
  -templatePath /QIBM/ProdData/WebSphere/AppClient/V85/client/profileTemplates/client 
  -serverHostname myhost.abc.com 
  -serverPort 2809 
  -profileName client

注: 成功创建概要文件后，控制台将打印一条指示成功的消息，并建议您检查 AboutThisProfile.txt 文件。但是，在 IBM i 上创建客户机概要文件时，不会生成 AboutThisProfile.txt 文件。