创建定制概要文件

创建一个自定义配置文件，以便您可以在其空节点中包含应用服务器、集群或其他 Java™ 进程（例如消息服务器）。 您可以使用“配置文件管理工具 ”来创建自定义配置文件。

1. 安装产品，以创建核心产品文件。
2. 启动配置文件管理工具以创建新的运行时环境。
   可以使用以下某种方法启动该工具。

   • 安装完成后，请勾选复选框以启动 “配置文件管理工具 ”。
   • 在命令提示符下直接输入命令以打开“ WebSphere ”自定义工具箱；然后，打开 “配置文件管理”工具。
   • 在“入门”控制台中选择“ WebSphere 自定义工具箱 ”选项；然后，打开 “配置文件管理工具 ”。
   • 通过 “开始 ”菜单访问 WebSphere 自定义工具箱；然后，打开 “配置文件管理工具 ”。
   • 使用 Linux 操作系统中用于启动程序的菜单来启动 WebSphere 自定义工具箱；然后，打开配置文件管理工具。
3. 在“配置文件”选项卡上单击 “创建 ”以创建一个新配置文件。

   “概要文件”选项卡包含机器上已创建的概要文件的列表。 除非可以扩充选择的概要文件，否则不能对该概要文件执行任何操作。 除非可以扩充您选择的概要文件，否则“扩充”按钮将会呈灰色显示。

   该工具将显示“环境选择”面板。

4. 选择自定义配置文件，然后单击 “下一步”。

   将显示“概要文件创建选项”面板。

5. 选择 “常规配置文件创建 ”或 “高级配置文件创建 ”，然后单击 “下一步 ”。

   创建典型概要文件选项将创建使用缺省配置设置的概要文件。 对于创建高级概要文件选项，您可以为概要文件指定自己的配置值。

6. 如果您选择了 “常规配置文件创建 ”，请转到节点联合的步骤。
7. 如果您选择了 “高级配置文件创建 ”，请在“配置文件名称和位置”面板中指定自定义配置文件名称和配置文件目录，或者接受默认设置，然后单击 “下一步 ”。
   概要文件命名准则：支持双字节字符。 概要文件名称可以是任何符合以下限制的唯一名称。 在对概要文件进行命名时，请不要使用下列任何字符：

   • 空格
   • 在操作系统上的目录名称中不支持的特殊字符，例如，*&?
   • 斜杠 (/) 或 (\)

   缺省概要文件

   在机器上创建的第一个概要文件是缺省概要文件。 缺省概要文件是从产品安装根目录下的 bin 目录中所发出命令的缺省目标。 当机器上只存在一个概要文件时，每个命令在配置中的单个服务器进程上运行。 在创建另一个概要文件时，可通过在创建高级概要文件路径的“概要文件名称和位置”面板上选中将此概要文件设为缺省概要文件，来将该概要文件设为缺省概要文件。 还可以在创建概要文件之后使用 manageprofiles 命令来使另一个概要文件成为缺省概要文件。

   在多概要文件环境中处理概要文件

   当一台机器上存在多个概要文件时，某些命令要求您指定该命令所应用于的概要文件（如果该概要文件不是缺省概要文件）。 这些命令使用 -profileName 参数来标识要处理的概要文件。 您会发现，使用每个概要文件的 bin 目录下的命令会更为方便。

   使用这些命令来查询命令 shell 以确定调用概要文件并将这些命令定向到调用概要文件。

   缺省概要文件信息

   缺省概要文件名称为 <profile_type><profile_number>：

   • <profile_type> 是值 AppSrv、Dmgr、Custom、AdminAgent、JobMgr 或 SecureProxySrv。
   • <profile_number> 是用于创建唯一概要文件名称的序号

   默认配置文件目录为 app_server_root/profiles，其中 app_server_root 表示安装根目录。

   默认配置文件目录为 app_server_root\profiles，其中 app_server_root 表示安装根目录。

   然后，工具将显示“节点名和主机名”面板。

8. 指定自定义配置文件的节点和主机属性，然后单击 “下一步”。

   如果您计划将之前的 WebSphere Application Server Network Deployment 安装迁移至 9.0 版本 ，请为 9.0 部署管理器使用与之前版本相同的单元名称。 如果该产品在同一物理机器或机器集群（例如综合系统）上运行，那么单元名必须是唯一的。 此外，如果需要在实体之间建立网络连接（在单元之间建立网络连接或者从必须与每个单元通信的客户机建立网络连接），那么单元名也必须是唯一的。 如果单元名的名称空间为联合名称空间，那么单元名也必须是唯一的。 否则，可能会出现诸如 javax.naming.NameNotFoundException 错误之类的症状，在这种情况下，请创建名称唯一的单元。

   迁移单元后，旧版本的托管节点现由 “Version 9.0 ”部署管理器在兼容模式下进行管理。 您可以将单元中的单个受管节点迁移至 9.0 版本。 为此，您必须创建一个与之前受管理的节点具有相同节点名称的 Version 9.0 配置文件。

   保留的名称：请避免将保留的文件夹名称用作字段值。 使用保留的文件夹名会导致不可预测的结果。 以下各项是保留的文件夹名：

   • cells
   • nodes
   • 服务器
   • 集群
   • 应用程序
   • deployments

   表 1. 自定义配置文件的特征。

   此表显示定制概要文件的特征。

   字段名称	缺省值	限制	描述
   节点名	shortHostName Node NodeNumber 其中： shortHostName 是简短主机名。 NodeNumber 是从 01 开始的序号	避免使用保留项。 使用 Deployment Manager 单元中的唯一名称。 如果您计划将一个托管节点从旧版本迁移过来，请在此 9.0 自定义配置文件中使用相同的节点名称。	该名称用于在要添加定制概要文件的 Deployment Manager 单元中进行管理。 使用 Deployment Manager 单元中的唯一名称。 将部署管理器单元（Deployment Manager Cell）的旧版本迁移到 Version 9.0 部署管理器后，您可以将旧版本中以兼容模式运行的自定义配置文件迁移到 Version 9.0 部署管理器中。
   主机名	域名系统（DNS）服务器名称的完整形式。	主机名必须是可通过网络进行寻址的。	请使用机器的实际 DNS 名称或 IP 地址，以便能够与您的机器进行通信。 请参阅此表下面关于主机名的其他信息。

   目录路径注意事项：

   profiles_directory_path\profile_name 目录下的文件名长度必须小于或等于 80 个字符。

   主机名注意事项：

   主机名是安装节点所在物理机器的网络名。 主机名必须解析为服务器上的物理网络节点。 当服务器中存在多块网卡时，主机名或 IP 地址必须解析为其中一块网卡。 远程节点使用主机名来连接到该节点，以及与其进行通信。 选择网络中其他机器可以访问的主机名很重要。 对于此值，请不要使用通用标识 localhost。 此外，请勿尝试在主机名中包含双字节字符集（DBCS）字符的计算机上安装 WebSphere Application Server 产品。 主机名不支持使用 DBCS 字符。

   如果要在同一台计算机上定义具有唯一 IP 地址的共存节点，请将每个 IP 地址添加到 DNS 服务器查找表中。 独立应用程序服务器的配置文件无法为机器上具有单一网络地址的多个 IP 地址提供域名解析。

   您为主机名指定的值将用作独立应用程序服务器配置文档中 hostName 属性的值。 请以下列其中一种格式指定主机名的值：

   • 完全合格的 DNS 服务器主机名字符串，例如 xmachine.manhattan.ibm.com
   • 缺省的短 DNS 主机名字符串，例如 xmachine
   • 数字 IP 地址，例如，127.1.255.3

   标准 DNS 主机名的优点是无歧义并且十分灵活。 您可以灵活更改主机系统的实际 IP 地址，而无需更改应用程序服务器配置。 在使用动态主机配置协议 (DHCP) 来分配 IP 地址，而且您打算频繁更改 IP 地址时，主机名值尤其有用。 此格式的缺点是依赖于 DNS。 如果 DNS 不可用，就无法建立连接。

   短主机名也可动态解析。 短名称格式有一项额外的功能，即可以在本地 hosts 文件中重新定义，因此即使与网络断开连接，系统仍可运行应用程序服务器。 要在与网络断开连接的情况下运行，请在 hosts 文件中将短名称定义为回送地址 127.0.0.1 以在与网络断开连接的情况下运行。 此格式的缺点是依赖于 DNS 进行远程访问。 如果 DNS 不可用，就无法建立连接。

   数字 IP 地址的优点是不需要通过 DNS 进行名称解析。 远程节点可连接到您使用数字 IP 地址命名的节点，而无需使用 DNS。 此格式的缺点是数字 IP 地址是固定的。

   指定定制概要文件特征后，工具将显示“联合”面板。

9. 如果对 Deployment Manager 启用了管理安全性，那么指定 Deployment Manager 的主机名和 SOAP 端口，并指定 Deployment Manager 的用户名和密码。 单击下一步。
   在联合后，定制概要文件中的进程是 Node Agent 进程。 Node Agent 进程是定制节点的 Deployment Manager 的代理进程。 Node Agent 对来自 Deployment Manager 的命令进行响应，以执行包括以下操作在内的任务：

   • 创建应用程序服务器进程、集群和集群成员
   • 启动和停止应用程序服务器进程
   • 在 Deployment Manager 上的当前修订版与节点上存在的副本之间进行配置同步
   • 删除应用程序服务器进程

   请参阅文档中的系统管理部分，以获取有关 Node Agent 及其任务的更多信息。

   应该联合节点吗？

   建议您现在联合定制节点。 当您在“联合”面板上单击下一步时，Deployment Manager 必须正在运行并且可访问，才能联合定制节点。 如果定制概要文件位于没有 Deployment Manager 的机器上，那么 Deployment Manager 必须正在运行并且可通过网络访问，才能联合节点。 如果在您单击下一步之前，Deployment Manager 未在运行或者不可访问，但您现在可以启动并使其可访问，请执行此操作。 否则，请选中稍后联合节点复选框。

   如果您未确定 Deployment Manager 是否正在运行或可访问，请不要立即联合节点。 当您可以验证 Deployment Manager 的可用性时联合节点。

   存在一种可能性，即部署管理器已被重新配置，以使用非默认的远程方法调用（RMI）作为首选的 Java Management Extensions （ JMX ）连接器。 在部署管理器的管理控制台中，单击 “系统管理”>“部署管理器”>“管理服务”， 以验证首选的连接器类型。

   如果 RMI 是首选 JMX 连接器，那么稍后必须使用 addNode 命令来联合定制概要文件。 使用 addNode 命令以便可以指定 JMX 连接器类型和 RMI 端口。

   如果 Deployment Manager 使用缺省 SOAP JMX 连接器类型，那么指定主机名和 SOAP 端口并现在就联合节点以创建您可以定制的功能性节点。

   当 Deployment Manager 不可用时联合

   如果在 Deployment Manager 未在运行或不可访问时联合定制节点，那么将显示错误消息。 如果 Deployment Manager 在概要文件创建过程中变为不可用，那么日志中的安装指示符是 INSTCONFFAIL，指示完全失败。 得到的定制概要文件将不可用。 您必须删除该概要文件。 请阅读有关删除概要文件的内容，以获取更多信息。

   如果您选择了立即联合，而且您先前选择了创建高级概要文件，那么下一步将显示“安全证书”面板。 转到 “创建和导入证书 ”这一步。

   否则，将显示“概要文件创建摘要”面板以选择创建典型概要文件选项。 转到创建自定义配置文件的步骤。

10. 创建一个默认的个人证书和一个根签名证书，或者从密钥库文件中导入个人证书和根签名证书，然后单击 “下一步”。

    可以同时创建或导入这两个证书，也可以创建其中一个证书，导入另一个证书。

    最佳实践： 当您将个人证书导入为默认个人证书时，请同时导入对该个人证书进行签名的根证书。 否则， 配置文件管理工具会将个人证书的签名者添加到 trust.p12 文件中。

    如果导入缺省个人证书或根签署证书，请为导入的每个证书指定路径和密码，并选择密钥库类型和密钥库别名。

11. 请确认证书信息无误，然后单击 “下一步 ”。

    如果创建证书，那么可以使用缺省值或者修改缺省值以创建新证书。 缺省情况下，缺省个人证书的有效期为一年，并由根签署证书签署。 缺省情况下，根签署证书是有效期为 15 年的自签名证书。 根签署证书的缺省密钥库密码为 WebAS。 您应该更改该密码。 密码不能包含任何双字节字符集 (DBCS) 字符，因为某些密钥库类型（包括 PKCS12）不支持这些字符。 受支持的密钥库类型取决于 java.security 文件中的提供程序。

    创建或导入任一或全部两个证书时，所创建的密钥库文件是 key.p12、trust.p12、root-key.p12、default-signers.p12、deleted.p12 和 ltpa.jceks。 创建或导入证书时，这些文件全都具有相同的密码，该密码是缺省密码或您指定的密码。 key.p12 文件包含缺省个人证书。 trust.p12 文件包含缺省根证书中的签署者证书。 root-key.p12 文件包含根签署证书。 default-signer.p12 文件包含添加至在安装并运行服务器后创建的任何新密钥库文件的签署者证书。 默认情况下，默认的根证书签名者位于 default-signer.p12 密钥库文件中。 deleted.p12 密钥库文件用于存放通过 deleteKeyStore 任务删除的证书，以便可以在需要时恢复这些证书。 该 ltpa.jceks 文件包含服务器默认的轻量级第三方身份验证（LTPA）密钥，您环境中的服务器会使用这些密钥进行相互通信。

    导入的证书会添加至 key.p12 文件或 root-key.p12 文件。

    如果导入任何证书并且这些证书不包含所需的信息，请单击返回以导入其他证书。

    如果您先前选择了创建高级概要文件，那么在显示“安全证书”面板后，该工具将显示“端口”面板。

12. 请确认自定义配置文件中的端口是唯一的，或者是有意设置为冲突的，然后单击 “下一步”。

    解决端口冲突

    如果您怀疑某个端口冲突，那么可以在创建概要文件之后检查该端口是否冲突。 通过检查以下文件来确定创建概要文件期间使用的端口。

    • profile_root/properties/portdef.props 文件
    • profile_root\properties\portdef.props 文件

    此文件包含设置端口时使用的密钥和值。 如果您发现端口冲突，那么可以手动重新分配端口。 要重新分配端口，请使用 ws_ant 脚本来运行 updatePorts.ant 文件。

    将显示“概要文件创建摘要”面板。

13. 点击 “创建 ”以创建自定义配置文件，或点击 “返回 ”以修改自定义配置文件的属性。

    如果先前在“联合”面板上选择了联合节点，那么 Deployment Manager 必须在运行中并且可访问。 单击创建时，Deployment Manager 必须在运行中并且可访问。 如果您认为 Deployment Manager 可能不再运行或者不可访问，请启动 Deployment Manager 并使它可访问，或者如果它已在运行，请使它可访问。

    将显示“概要文件创建进度”面板，该面板显示了正在运行的配置命令。

    概要文件创建完成后，该工具将显示“概要文件创建完成”面板。

14. 如果需要，请选择 “启动入门向导”。 单击完成以退出。

    使用“第一步”控制台，可以创建其他概要文件以及启动应用程序服务器。