安装 Developer for System z

安装任务摘要

下列各节提供安装 Developer for System z 时可以使用的各种安装方法的概述。

概述:从安装 CD 安装 Developer for System z

在此安装方案中,您使用包含安装文件的 CD-ROM 盘,并且,通常在您自己的工作站上安装 Developer for System z。

从安装 CD 进行安装的一般步骤如下所示:

  1. 完成安装前任务中列示的安装前步骤。
  2. IBM Rational Developer for System z 安装设置 CD 插入 CD-ROM 驱动器。
  3. 如果在系统上已启用自动运行功能,那么 Developer for System z 启动板程序将自动打开。如果未启用自动运行功能,那么请通过运行 CD 根目录中的 launchpad.exe 来运行启动板程序。有关详细信息,请参阅安装 Developer for System z
  4. 选择安装 Rational® Developer for System z®升级 Rational Developer for System z
  5. 根据您是要安装 Developer for System z 的新发行版还是要更新 Developer for System z 的现有发行版,此步骤有所不同。
  6. 按照 IBM® Installation Manager 的“安装软件包”向导或“更新软件包”向导(取决于您在启动板中作出的选择)中的屏幕指示信息执行操作,以便安装 Developer for System z 以及任何捆绑产品。有关详细信息,请参阅使用 Installation Manager
  7. 根据需要,为 Developer for System z 以及所安装的任何捆绑产品配置许可证。如果您具有试用许可证并需要配置短期或永久许可证,请立即执行此操作。例如,您可能想配置浮动许可证支持。有关详细信息,请参阅管理许可证
  8. 安装 Developer for System z 所附带的其他软件。有关更多信息,请参阅附录A. 安装其他软件

概述:从工作站上的电子映像安装 Developer for System z

从电子安装映像进行安装的一般步骤如下所示:

  1. 请确保工作站有足够的空间来存储必须从 IBM Passport Advantage® 下载的文件以及解压缩后的安装映像。请参考硬件要求
  2. 将 Developer for System z 的所有必需部件以及您希望安装的任何捆绑产品从 IBM Passport Advantage 下载到临时目录。
  3. 从下载的压缩文件中解压缩安装映像,并验证安装映像是否完整。有关详细信息,请参阅解压缩电子映像
  4. 继续执行下面从电子映像进行安装中的步骤。

从电子映像进行安装

执行下列步骤:

  1. 完成安装前任务中列示的安装前步骤。
  2. 通过从 RDz76Edition_Setup 目录的根位置运行 launchpad.exe 来运行启动板程序。有关详细信息,请参阅安装 Developer for System z
  3. 选择安装 Rational Developer for System z升级 Rational Developer for System z
  4. 根据您是要安装 Developer for System z 的新发行版还是要更新 Developer for System z 的现有发行版,此步骤有所不同。
  5. 按照 IBM Installation Manager 的“安装软件包”向导或“更新软件包”向导中的屏幕指示信息执行操作,以便安装 Developer for System z 以及任何捆绑产品。有关详细信息,请参阅使用 Installation Manager
  6. 根据需要,为 Developer for System z 以及所安装的任何捆绑产品配置许可证。如果您具有试用许可证并需要配置短期或永久许可证,请立即执行此操作。例如,您可能想配置浮动许可证支持。有关详细信息,请参阅管理许可证
  7. 安装 Developer for System z 所附带的其他软件。有关更多信息,请参阅附录A. 安装其他软件

概述:从共享驱动器上的电子映像安装 Developer for System z

在此方案中,您将电子映像存放在共享驱动器上,以使企业内的用户能够从单一位置访问 Developer for System z 以及任何捆绑产品的安装文件。如果您需要在大量用户系统上执行静默安装,那么此方案也很实用。下列步骤由负责在共享驱动器上存放安装映像的人员执行:

  1. 确保共享驱动器有足够的磁盘空间来存储必须从 IBM Passport Advantage 下载的文件以及解压缩后的安装映像。有关详细信息,请参阅硬件要求
  2. 将 Developer for System z 的所有必需部件以及任何捆绑产品从 IBM Passport Advantage 下载到共享驱动器上的临时目录。
    注:
    您也可以将这些部件下载到工作站,然后仅将解压缩后的安装映像复制到共享驱动器。
  3. 将安装映像从下载的文件解压缩到共享驱动器上的一个可访问目录中,然后验证该安装映像是否完整。有关详细信息,请参阅解压缩电子映像

要以交互方式从共享驱动器上的安装文件安装 Developer for System z,请执行下列步骤:

  1. 切换到共享驱动器上包含安装映像的 RDz76Edition_Setup 目录。
  2. 执行从电子映像进行安装中的步骤,以便安装 Developer for System z 以及任何捆绑产品。

有关如何使用共享电子映像来执行静默安装的信息,请参阅静默安装

概述:从 HTTP Web 服务器上的存储库安装 Developer for System z

在此方案中,IBM Installation Manager 从 HTTP Web 服务器检索产品软件包。

这些步骤假定您已在 HTTP Web 服务器上创建了包含 Developer for System z 以及任何捆绑产品的软件包的存储库。关于将安装软件包复制到 HTTP Web 服务器的详细信息,请参阅概述:将 Developer for System z 放到 HTTP Web 服务器上

要从 HTTP Server 上的存储库安装 Developer for System z 软件包,请执行下列步骤:

  1. 完成安装前任务中列示的安装前步骤。
  2. 安装 IBM Installation Manager。请参阅安装 Installation Manager
  3. 启动 Installation Manager。有关详细信息,请参阅启动 Installation Manager
  4. 在 Installation Manager 的存储库首选项中,添加 Developer for System z 软件包所在存储库的 URL。请参阅在 Installation Manager 中设置存储库首选项
  5. 在 Installation Manager 中单击安装更新以启动“安装软件包”或“更新软件包”向导,然后按照“安装软件包”向导或“更新软件包”向导中的屏幕指示信息执行操作,以便完成安装过程。
  6. 根据需要,为 Developer for System z 以及所安装的任何捆绑产品配置许可证。如果您具有试用许可证并需要配置短期或永久许可证,请立即执行此操作。例如,您可能想配置浮动许可证支持。有关详细信息,请参阅管理许可证
  7. 安装 IBM Rational Developer for System z 所附带的其他软件。有关更多信息,请参阅附录A. 安装其他软件

概述:将 Developer for System z 放到 HTTP Web 服务器上

通过使用 IBM Packaging Utility 来创建安装库,可以将 Developer for System z 安装软件包以及其他产品软件包放到 HTTP Web 服务器上。如果除 Developer for System z 7.6.1 产品及其捆绑产品以外,您还想将许多不同的产品或服务更新放在单个存储库中,那么可能要将这些软件包放到 HTTP Web 服务器上。 此存储库可用于执行交互式安装或静默安装。

注:
从 HTTP Web 服务器上的存储库执行静默安装时,此步骤并非执行静默安装所必需的。

要将软件包放在 HTTP Web 服务器上,请使用 IBM Packaging Utility 来创建新安装库或者复制到现有存储库。有关如何使用 Packaging Utility 来创建安装库的详细信息,请参阅使用 Packaging Utility 将软件包复制到 HTTP Server。在创建存储库之后,您可以执行下列操作:

  1. 向企业中的用户提供安装库的 URL。这些用户可以指定该存储库并执行安装,而不需要在他们的系统上使用安装介质。
  2. 使用存储库来执行静默安装。有关运行静默安装的详细信息,请参阅静默安装

使用启动板程序

Developer for System z 启动板程序使您能够从单一位置查看发行版信息和启动安装过程。

在下列情况下,请使用启动板程序来启动 Developer for System z 安装过程:

从启动板程序启动安装过程时,将启动IBM Installation Manager 并自动为其配置必需的存储库位置信息。这使您不必以手动方式在 Installation Manager 首选项中设置存储库位置。

您可以执行 Developer for System z V7.6.1,也可以将现有的 Developer for System z V7.5 更新到 Developer for System z V7.6.1。

如果您正在执行 Developer for System z V7.6.1 的新安装,那么在启动板的安装 Rational Developer for System z 面板上,可以从一组用户角色中进行选择,每个用户角色都描述了您在企业中可能扮演的开发者角色。请选择与您的 Developer for System z 用户身份最为贴切的角色,以便启动安装过程并选中根据您的角色进行定制的一组功能部件和捆绑产品。下面列示了您可以选择的用户角色。根据您购买的 Developer for System z 版本的不同,您可能不会看到所有这些角色。在启动板面板上,提供了每个角色的描述。

下表显示用户角色和与每个角色相关联的对应 Developer for System z 功能部件。(有关每个功能部件的描述,请参阅表 2。)

表 3. 用户角色和相关联的功能部件
用户角色 相关联的功能部件
System z 传统开发者
  • System z Integrated Development Environment
  • System z Code Generators
  • BMS Screen Designer
  • MFS Screen Designer
  • Data Tools
  • System z Stored Procedures
  • System z Debugger
  • File Manager
  • Fault Analyzer
  • Plug-in Development Environment(PDE)
服务开发者
  • System z Integrated Development Environment
  • System z Code Generators
  • Enterprise Service Tools for CICS
  • BMS Screen Designer
  • CICS Code Generators
  • CICS Service Component Architecture
  • Enterprise Service Tools for IMS
  • MFS Screen Designer
  • IMS Code Generators
  • Data Tools
  • System z Stored Procedures
  • System z Debugger
  • File Manager
  • Fault Analyzer
  • Plug-in Development Environment(PDE)
Web 开发者
  • System z Integrated Development Environment
  • System z Code Generators
  • Enterprise Service Tools for CICS
  • BMS Screen Designer
  • CICS Code Generators
  • CICS Service Component Architecture
  • Enterprise Service Tools for IMS
  • MFS Screen Designer
  • IMS Code Generators
  • Data Tools
  • System z Stored Procedures
  • System z Debugger
  • File Manager
  • Fault Analyzer
  • Plug-in Development Environment(PDE)

此用户角色还选择 IBM Rational Business Developer 和 IBM WebSphere® Application Server Test Environment 产品。

J2EE/WAS 开发者
  • System z Integrated Development Environment
  • System z Code Generators
  • Enterprise Service Tools for CICS
  • BMS Screen Designer
  • CICS Code Generators
  • CICS Service Component Architecture
  • Enterprise Service Tools for IMS
  • MFS Screen Designer
  • IMS Code Generators
  • Data Tools
  • System z Stored Procedures
  • System z Debugger
  • File Manager
  • Fault Analyzer
  • Plug-in Development Environment(PDE)

此用户角色还选择 IBM Rational Application Developer 和 IBM WebSphere Application Server Test Environment 产品。

或者,您可以选择执行定制安装,而不是选择用户角色。选择定制安装将启动 Developer for System z 安装过程并且在缺省情况下已选中所有功能部件和捆绑产品。

注:
无论您从启动板程序中选择哪个安装选项,都始终能够通过选择和取消选择其他功能部件对所要安装的功能部件集进行定制。

要以管理员身份通过启动板程序启动 Developer for System z 安装过程,请执行下列步骤:

  1. 如果您尚未完成安装前任务中描述的安装前任务,那么请完成那些任务。
  2. 如果正在从安装 CD 进行安装,那么请将 IBM Rational Developer for System z 安装设置 CD 插入 CD 驱动器。如果正在从电子映像进行安装,那么请打开 RDz76Edition_Setup 目录。
  3. 如果在系统上已启用自动运行功能,那么启动板程序将自动启动。如果在系统上未启用自动运行功能,或者正在从电子映像进行安装,那么请执行下列操作:
  4. 阅读欢迎面板上的欢迎信息,然后从左边选择产品文档选项卡以查看可用的文档。单击该面板上的链接,以查看产品文档。
  5. 如果您要升级现有 IBM Rational Developer for System z,请单击升级 IBM Rational Developer for System z 选项卡。然后,单击启动 IBM Installation Manager 以升级现有安装。(这仅适用于从 IBM Rational Developer for System z V7.5.x 升级到 V7.6.1。)在 IBM Installation Manager 启动后,请单击更新按钮并按照“安装软件包”向导的提示执行操作,以完成安装。有关更多详细信息,请参阅使用 Installation Manager
  6. 如果您要执行 IBM Rational Developer for System z 的新安装,请单击左边的安装 IBM Rational Developer for System z 选项卡。将显示“角色描述”选项卡。如果要了解可供您选择的角色,请单击此选项卡。然后单击安装 IBM Rational Developer for System z
  7. 从面板上的用户角色列表中选择您的用户角色。这将启动 Developer for System z 安装过程并选中根据您的角色进行定制的一组建议功能部件和捆绑产品。有关用户角色的更多信息,请参阅使用启动板程序。或者,您可以选择执行定制安装(缺省情况下,已选中所有功能部件和捆绑产品)。

    您还必须决定是以管理员身份还是以非管理员身份进行安装。如果您要以管理员身份进行安装,请确保选中“使用管理员访问权进行安装”框。(缺省情况下已选中此框。)如果您要以非管理员身份进行安装,那么必须取消选中此框。

  8. 此时 IBM Installation Manager 将启动以安装 Developer for System z 以及您选择要安装的任何捆绑产品。请按照“安装软件包”向导的提示执行操作,以便完成安装。有关更多详细信息,请参阅使用 Installation Manager

使用 Installation Manager

从启动板程序启动 Developer for System z 安装过程时(请参阅使用启动板程序),IBM Installation Manager 将启动并打开“安装软件包”向导。下列步骤指导您使用 Installation Manager 的“安装软件包”向导来安装 Developer for System z:

  1. 此向导的第一个面板显示一组可供安装的软件包。可用的软件包将包括 Developer for System z 以及根据您在启动板上选择的用户角色而建议您安装的任何捆绑产品。有关启动板程序和用户角色的更多详细信息,请参阅使用启动板程序。可用的捆绑产品随您购买的 Developer for System z 版本不同而有所变化。

    准备好继续进行安装后,请单击下一步。Installation Manager 将收集有关所选软件包的信息并转到“许可证”面板。

  2. 向导可能会提示您将 IBM Installation Manager 更新到更新版本(如果有更新版本的话)。看到此提示时,请单击以安装更新,如果要在以后安装该更新版本,请单击。如果您单击,那么 Installation Manager 将更新自身并指示必须重新启动它才能完成更新。

    单击确定以重新启动 Installation Manager。

  3. 许可证面板上,阅读所选软件包的许可证协议。您选择安装的每个软件包都有许可证协议。在许可证面板左侧单击每个软件包名称可显示相应的许可证协议。
    1. 如果您同意所有许可证协议的条款,那么请单击我接受许可证协议的条款
    2. 单击下一步继续。
  4. 位置面板上,Installation Manager 将允许您选择是创建新软件包组以包含 Developer for System z 软件包还是使用系统上的现有软件包组。如果将软件包安装到同一个软件包组,那么它们将共享公共工作台,并且不同软件包所提供的功能将组合到该工作台中。这称为 shell 共享。安装到不同软件包组的软件包不共享工作台,它们相互之间保持独立。

    要为 Developer for System z 创建新的软件包组,请执行下列操作:

    1. 选择标有创建新的软件包组的单选按钮。
    2. 输入要用于新软件包组的安装目录。此目录是该软件包组中安装的软件包所特有资源的存储位置。您在系统上创建的每个软件包组都有各自的安装目录。此目录不同于共享资源目录,后者是已安装的可以由不同软件包组中软件包共享的资源的安装位置。
    3. 如果在系统上未安装任何其他软件包,那么向导还将要求您选择用于共享资源目录的位置。建议您选择可用空间量最大的驱动器上的位置用于共享资源目录,这是因为,此目录将由您使用 Installation Manager 安装的每个软件包使用,并且您安装第一个软件包后将无法更改此目录。如果已在系统上安装了一个或多个软件包,那么 Installation Manager 将显示共享资源目录的位置,但您无法选择该位置或者对其进行更改。
      注:
      以后,要更改共享资源目录的位置,必须卸载所有软件包,然后重新安装这些软件包并指定新的共享资源目录。

    要将 Developer for System z 安装到现有的软件包组,请执行下列操作:

    1. 选择标有使用现有的软件包组的单选按钮。
    2. Installation Manager 将显示系统上可用软件包组的列表。请选择要将 Developer for System z 安装到的软件包组。Installation Manager 将验证所选软件包组是否与 Developer for System z 兼容。如果不兼容,那么 Installation Manager 将显示一条错误消息以指出发生问题,并且,您必须先选择兼容的软件包组或选择创建新软件包组,然后才能继续进行安装。

    完成选择后,请单击下一步继续。

  5. 在接着显示的位置面板上,您可以选择对系统上已安装的现有 Eclipse IDE 进行扩展,从而添加正在安装的软件包中的功能。必须运行使用 IBM Java Development Kit(JDK)V1.6 或更高版本的 Eclipse V3.4 才能选择此选项。建议您使用随 Developer for System z 封装的 Eclipse IDE 和 JDK,而不要扩展现有的 Eclipse IDE。
  6. 在接着显示的位置页面上,从语言中选择要为此软件包组安装的语言。将安装 Developer for System z 的用户界面和文档的相应本地语言翻译版本。
    注:
    您所作的选择将应用于所有安装在此软件包组中的软件包。
    注:
    在此发行版的 Developer for System z 中,选择任何可用语言都将安装所有语言的本地语言翻译版本。
  7. 功能部件面板上,选择要为 Developer for System z 以及任何所安装捆绑产品安装的功能部件。您可以单击任何功能部件的名称以查看该功能部件的描述。功能部件描述将显示在面板底部的详细信息部分。有关 Developer for System z 的可用功能部件的更多信息,请参阅安装功能部件。有关与 Developer for System z 捆绑在一起的产品的可用功能部件信息,请参阅那些产品的文档。

    选择要安装的功能部件完成后,单击下一步

  8. 在帮助系统配置页面中,请选择下列其中一个选项,然后单击下一步
  9. 开始进行安装前,请在摘要面板上查看您所作的选择。如果您想更改先前面板上所作的选择,请单击上一步并进行更改。对安装选项感到满意后,请单击安装以安装软件包。这将开始进行安装,进度指示器将显示安装完成百分比。
  10. 安装过程完成时,将出现一条消息以确认安装成功完成。

    要查看当前会话的安装日志文件,请单击查看日志文件以便在新窗口中打开安装日志。

  11. 必要时,通过 Installation Manager 中的管理许可证面板为 Developer for System z 以及所安装的其他捆绑产品配置许可证发放方式。这可能包括配置浮动许可证支持或者安装产品激活套件以安装永久或短期许可证密钥。有关更多详细信息,请参阅管理许可证

静默安装

您可以通过静默方式来安装 Developer for System z。以静默方式运行 Installation Manager 时,其用户界面不可用;您将使用响应文件,而不是输入安装软件包时所需的命令。

以静默方式运行 Installation Manager 很实用,这是因为它允许您使用批处理过程来通过脚本安装、更新、修改和卸载软件包。

静默安装由下面这三个主要任务组成:

  1. 如果您计划在多个系统上执行静默安装,那么请将安装映像复制到共享驱动器或服务器上的某个位置。
  2. 创建响应文件。
  3. 以静默安装方式运行 Installation Manager。

将安装映像复制到共享驱动器或服务器

如果您计划在多个系统上执行静默安装,那么应该将安装映像复制到共享驱动器上可供内部网中其他系统访问的位置。

要将安装映像从物理安装 CD 复制到共享位置,请执行下列步骤:

  1. 在要用于存储安装映像的共享位置中,创建名为 RDz_Setup 的目录。
  2. IBM Rational Developer for System z 安装设置 CD 插入 CD-ROM 驱动器。
  3. IBM Rational Developer for System z 安装设置 CD 的内容复制到您在共享位置中创建的 RDz_Setup 目录。
  4. 在共享位置中创建另一个目录,用于存储产品安装文件。您可以为此文件夹选择任何名称,例如 RDz
  5. 在所创建的用于存储产品安装文件的目录中创建名为 disk1 的目录,例如 RDz\disk1。此目录必须名为 disk1,这样才能成功完成静默安装。
  6. IBM Rational Developer for System z 安装 CD 1 插入 CD-ROM 驱动器。
  7. IBM Rational Developer for System z 安装 CD 1 的内容复制到已创建的 disk1 目录。
  8. 再次重复步骤 5-7,这一次创建名为 disk2 的目录并将 IBM Rational Developer for System z 安装 CD 2 的内容复制到 disk2 目录。
  9. 如果要使其他与 Developer for System z 捆绑在一起的产品(例如 IBM Rational Business Developer 和 IBM Rational Application Developer)可用于静默安装,需要为这些产品执行本过程中的步骤 4-8。
    1. 在共享位置中创建一个新目录,用于存储捆绑产品的产品安装文件。您可以为此目录选择任何名称。
    2. 在所创建的用于存储产品安装文件的目录中,为每张安装 CD 创建一个 diskN 目录,其中 N 与安装 CD 的编号相对应。然后,将每张安装 CD 的内容复制到为该 CD 创建的相应 diskN 目录中。
  10. 将安装 CD 的内容复制到共享位置完成后,就可以创建响应文件和执行静默安装。

要将安装映像从电子映像复制到共享位置,请执行下列步骤:

  1. 对于 Developer for System z 以及任何要用于静默安装的捆绑产品,将您为它们下载的压缩文件解压缩到用于存储映像的共享位置。此外,也可以在本地机器上将压缩文件解压缩,然后将解压缩后的文件和目录复制到共享位置。
  2. 在共享位置中,验证现在是否有下列各项:
    1. 在共享目录的根位置,应该有下列目录:
      • RDz76Edition_Setup,其中 Edition 随所下载的 Developer for System z 版本不同而有所变化。
      • RDz76
      • 每个可用于静默安装的捆绑产品(例如 IBM Rational Business Developer 和 IBM Rational Application Developer)的相应目录。可用的捆绑产品随您购买的 Developer for System z 版本不同而有所变化。
    2. RDz76 目录以及您复制到共享位置的每个捆绑产品的目录中,应该有多个 diskN 目录,即,产品的每张安装盘都有对应的目录。
  3. 在验证共享安装映像的目录结构之后,就可以创建响应文件和执行静默安装。

或者,可以将安装映像复制到 HTTP Web 服务器上的存储库并使用该存储库来执行静默安装。要创建存储库,您需要使用 IBM Packaging Utility。有关更多详细信息,请参阅概述:将 Developer for System z 放到 HTTP Web 服务器上

创建响应文件

可以通过记录您使用 Installation Manager 安装 Developer for System z 软件包时执行的操作来创建响应文件。记录响应文件时,您在 Installation Manager GUI 中所作的所有选择都将存储到一个 XML 文件中。然后,可以使用该响应文件在其他系统上执行静默安装。以静默方式运行 Installation Manager 时,Installation Manager 将使用该 XML 响应文件来查找包含软件包的存储库以及选择要安装的功能部件,等等。

要记录用于执行安装或卸载的响应文件,请执行下列步骤:

  1. 在命令行上,切换到 Installation Manager 安装目录中的 Eclipse 子目录。例如:cd C:\Program Files\IBM\Installation Manager\eclipse
  2. 在命令行上,通过输入以下命令来启动 Installation Manager(请将响应文件和可选日志文件替换为您自己的名称和位置):
    IBMIMC.exe -record <响应文件路径和名称>.xml -log
    					<日志文件路径和名称>.xml

    例如,

    IBMIMC.exe -record C:\my_response_file.xml -log 
    					C:\install_log.xml
    注:
    确保要用于存储响应文件和日志文件的目录已存在。Installation Manager 不会为响应文件和日志文件创建目录。
  3. 安装 Developer for System z 以及任何其他要通过 Installation Manager GUI 安装的捆绑产品。有关更多详细信息,请参阅使用 Installation Manager
  4. 必要时,为 Developer for System z 以及所安装的其他捆绑产品配置许可证发放方式。这可能包括配置浮动许可证支持或者安装产品激活套件以安装永久许可证密钥。有关更多详细信息,请参阅管理许可证
  5. 退出 Installation Manager。

退出 Installation Manager 后,系统将创建一个 XML 响应文件,并且该文件将保存在用于启动 Installation Manager 的命令所指定的位置。

IBM Rational Developer for System z 安装设置 CD 上的 SilentInstall 目录中,提供了可用于安装 Developer for System z 的样本响应文件。从电子映像安装时,您还可以在 RDz76Edition_Setup 目录中找到样本响应文件。您可以按原样使用此文件以便以静默方式安装 Developer for System z,也可以根据自己的情况对其进行修改。有关定制响应文件的信息,请参阅静默安装命令

以静默安装方式运行 Installation Manager

您可以从命令行以静默安装方式运行 Installation Manager。

请参阅 Installation Manager 联机帮助以获取其他有关如何以静默方式运行 Installation Manager 的文档。

可以通过从 Installation Manager 安装目录中运行以下命令以静默方式运行 Installation Manager:

IBMIMc.exe --launcher.ini silent-install.ini -silent [arguments]

下表描述与静默安装命令配合使用的参数:

表 4. 与静默安装命令配合使用的参数
参数 描述
-input 此参数指定一个 XML 响应文件作为 Installation Manager 的输入。响应文件包含 Installation Manager 所运行的命令。
-log (可选)此参数指定用于记录静默安装结果的日志文件。该日志文件是 XML 文件。

要以静默安装方式运行 Installation Manager,请执行下列操作:

  1. 在命令行上,切换到 Installation Manager 安装目录中的 Eclipse 子目录。例如:cd "C:\Program Files\IBM\Installation Manager\eclipse"
  2. 输入并运行以下命令(请将响应文件和可选的日志文件替换为您自己的位置)。例如,IBMIMc.exe --launcher.ini silent-install.ini -silent -input c:\mylog\responsefile.xml -log c:\mylog\silent_install_log.xml

Installation Manager 将以静默安装方式运行。它将读取响应文件并将日志文件写入指定的目录。以静默安装方式运行时,您必须要有响应文件,但日志文件是可选的。如果安装成功,那么返回码为 0。如果安装以非零数字结束,那么表明安装失败。如果您接收到非零返回码,那么请在响应文件和日志文件中查找可能导致失败的原因。有关日志文件的更多信息,请参阅静默安装日志文件。如果您输入静默安装命令时指定了日志文件,那么所有错误都将被记录到指定的日志文件中。如果安装成功,那么日志文件仅包含以下内容:<result></result>

响应文件命令

如果要使用 Installation Manager 的静默安装功能,那么需要创建包含 Installation Manager 必须运行的所有命令的响应文件。建议您通过记录安装 Developer for System z 时的操作来创建响应文件。但是,您也可以通过手动方式创建或编辑响应文件。

响应文件的命令分为两类:

静默安装首选项命令

虽然您通常使用“首选项”窗口来指定首选项,但也可以在用于执行静默安装的响应文件中指定首选项(标识为键)。

注:
可以在响应文件中指定多个首选项。

在响应文件中定义首选项时,XML 代码看起来类似于以下示例:

<preference>
	name = "the key of the preference"
	value = "the value of the preference to be set"
	</preferences>

请使用下表来确定静默安装首选项的键以及相关联的值:

表 5. 静默安装首选项的键
Notes®
com.ibm.cic.common.core.preferences.logLocation 指定 Installation Manager 日志文件的位置。 要点:此键是可选的,用于进行测试和调试。如果未指定日志文件的位置,那么静默安装与 Installation Manager 的 UI 版本将使用同一个位置。
com.ibm.cic.license.policy.location 指定用于定义远程许可证策略文件位置的 URL。
com.ibm.cic.common.core.preferences.http.proxyEnabled True 或 False 缺省值为 False。
com.ibm.cic.common.core.preferences.http.proxyHost 主机名或 IP 地址
com.ibm.cic.common.core.preferences.http.proxyPort 端口号
com.ibm.cic.common.core.preferences.http.proxyUseSocks True 或 False 缺省值为 False。
com.ibm.cic.common.core.preferences.SOCKS.proxyHost 主机名或 IP 地址
com.ibm.cic.common.core.preferences.SOCKS.proxyPort 端口号
com.ibm.cic.common.core.preferences.ftp.proxyEnabled True 或 False 缺省值为 False。
com.ibm.cic.common.core.preferences.ftp.proxyHost 主机名或 IP 地址
com.ibm.cic.common.core.preferences.ftp.proxyPort 端口号
com.ibm.cic.common.core.preferences.eclipseCache c:\IBM\common
注:
以上路径是此首选项的缺省值;通常,安装软件包将为此首选项提供它们自己的值。
如果已安装软件包,那么无法更改此位置。
com.ibm.cic.agent.core.pref.offering.service.repositories.areUsed
True 或 False
将此首选项更改为“False”可将其禁用。设置为“True”时,在安装或更新产品时将搜索所链接的所有存储库。
com.ibm.cic.common.core.preferences.preserveDownloadedArtifacts
True 或 False
将此首选项更改为“False”可将其禁用。设置为“True”时,将在您的系统上存储将软件包回滚到先前版本所需的文件。设置为“False”时,不存储这些文件。如果未存储这些文件,那么必须连接到原始存储库或介质才能进行回滚。

静默安装命令

您可以使用此参考表来了解更多有关在静默安装期间使用的响应文件命令的信息。

表 6. 静默安装期间使用的文件命令
响应文件命令 描述
设置概要文件
<profile id="the profile (package group) id" 
installLocation="the install location of the profile">
<data key="key1" value="value1"/>
<data key="key2" value="value2"/>
</profile>
使用此命令来创建软件包组(即安装位置)。如果指定的软件包组已存在,那么此命令没有任何效果。目前,在创建概要文件时,静默安装过程还将创建两个安装上下文;一个用于 Eclipse,另一个用于本机。概要文件是安装位置。

您可以使用 <data> 元素来设置概要文件属性。

以下列表包含当前受支持的键以及相关的值:

  • eclipseLocation 键指定现有的 Eclipse 位置值,例如 c:\myeclipse\eclipse
  • cic.selector.nl 键指定自然语言(NL)语言环境选项,例如 zhjaen
    注:
    使用逗号来分隔多个 NL 值。

以下列表包含当前受支持的语言代码:

  • 英语(en)
  • 法语(fr)
  • 简体中文(zh)
  • 繁体中文(台湾)(zh_TW)
  • 德语(de)
  • 日语(ja)
  • 西班牙语(es)
  • 韩国语(ko)
  • 葡萄牙语(pt_BR)
设置存储库
<server>
<repository location="http:/xxx/repository/">
<repository location="file:/C:/repository/">
<!--add more repositories below>
<...>

</server>
使用此命令来指定静默安装期间使用的存储库。每个存储库位置都可以是 URL 或文件路径。
安装
<install>
<offering profile= "profile id"
features= "feature ids"
id= "offering id"
version= "offering version">
</offering>

<!--add more offerings below>
<...>

</install>
使用此命令来指定将要安装的安装软件包。

概要文件标识必须与现有概要文件或“设置概要文件”命令创建的概要文件匹配。

功能部件标识可由以逗号分隔的列表指定,例如“feature1, feature2”等等。如果未指定功能部件标识,那么将安装所指定产品中的所有缺省功能部件。

注:
即使未在以逗号分隔的列表中显式指定必需的功能部件,也将安装这些功能部件。
<install modify="true"><uninstall modify="true">(可选属性)
<uninstall modify="true">
<offering
     profile="profileID"id="Id"
     version="Version"
     features="-"/>
</uninstall>
在安装和卸载命令中使用 <install modify="true"> 属性来指示要修改现有安装。如果未将此属性设置为 true,那么值将缺省为 false。如果只想让修改操作安装其他语言包,那么应该在产品功能部件标识列表中使用连字符“-”来指示不添加任何新功能部件。

要点:必须按示例所示方式指定“modify=true”和连字符“-”功能部件列表;否则,安装命令将安装产品的缺省功能部件,而卸载命令将除去所有功能部件。

卸载
<uninstall>
<offering profile= "profile id"
features= "feature ids"
id= "offering id"
version= "offering version">
</offering>

<!--add more offerings below>
<...>

</uninstall>
使用此命令来指定将要卸载的安装软件包。

概要文件标识必须与现有概要文件或概要文件命令中指定的概要文件匹配。此外,如果未指定功能部件标识,那么将卸载所指定产品中的所有功能部件;如果未指定产品标识,那么将卸载所指定概要文件中的所有已安装产品。

回滚
<rollback>
<offering profile= "profile id"
id= "offering id"
version= "offering version">
</offering>

<!--add more offerings below>
<...>

</rollback>
使用此命令从所指定概要文件中当前安装的版本回滚到指定的产品。不能在回滚命令中指定功能部件。
全部安装
<installALL/>
注:
此命令等同于使用
-silent -installAll
使用此命令以静默方式搜索并安装所有可用的可安装软件包。
全部更新
<updateALL/>
注:
此命令等同于使用
-silent -updateAll
使用此命令以静默方式搜索并更新所有可用的可安装软件包。

参考:样本响应文件

您可以使用基于 XML 的响应文件来指定预定义的信息,例如静默安装首选项、存储库位置和软件包组等等。对于要以静默方式安装软件包并使安装软件包的位置和首选项趋于标准化的团队和公司而言,最好使用响应文件。

样本响应文件

<agent-input >
<!-- add preferences -->
<preference name="com.ibm.cic.common.core.preferences.http.proxyEnabled"
  value="c:/temp"/>
<!-- create the profile if it doesn't exist yet -->
<profile id="my_profile" installLocation="c:/temp/my_profile"></profile>
<server>
<repository
  location=
    "http://a.site.com/local/products/sample/20060615_1542/repository/">
</repository>/server>

<install>
	<offering profile= "my_profile" features= "core" id= "ies"
       version= "3.2.0.20060615">	</offering>
</install>
</agent-input>

静默安装日志文件

您可以使用静默安装日志文件来检查静默安装会话的结果。

如果使用 -log <your log file path>.xml 指定了日志文件路径,那么静默安装功能将创建一个基于 XML 的日志文件来记录静默安装执行结果。如果静默安装会话成功,那么该日志文件将仅包含根元素 <result> </result>。但是,如果安装期间发生错误,那么静默安装日志文件将包含带有消息的错误元素,如下所示:

<result>
 	<error> Cannot find profile: profile id</error>
 	<error> some other errors</error>
</result> 

要进行详细分析,您可以查看 Installation Manager 数据区中生成的日志。通过使用首选项命令,您可以选择将该数据区设置到您的首选位置,如响应文件主题所示。

以向导方式运行 Installation Manager

已根据所指定响应文件设置首选项和安装或卸载选项的情况下,向导方式将以安装向导或卸载向导方式启动 Installation Manager。响应文件只能包含首选项命令以及安装或卸载命令。以向导方式运行 Installation Manager 时,不能在同一个响应文件中同时指定安装命令和卸载命令。

请在命令行上输入以下命令,以便以向导方式启动 Installation Manager:

IBMIM.exe -mode wizard -input <response file>