创建定制概要文件以便您可以将应用程序服务器、集群或其他 Java™ 进程(例如消息传递服务器)包含在它的空节点中。可使用 Profile Management Tool 来创建定制概要文件。
开始之前
使用Profile Management Tool前,请安装产品文件。
支持的配置: Profile Management Tool 是
manageprofiles 命令的图形用户界面,并且只在 AIX®、Linux 和 Windows 上受支持。但在 HP-UX 上,IBM® i 和 Solaris 却使用
manageprofiles 命令。
sptcfg
必须提供足够的系统临时空间来创建概要文件。有关信息,请参阅概要文件的文件系统需求。
注意: 启动Profile Management Tool时,在以下情况下,对于非 root 用户可能会锁定该工具:以 root 用户身份登录机器,使用 SetPermissions 实用程序将用户从 x 更改为 y。假设您是用户
x,并重新登录该机器。启动Profile Management Tool,单击Profile Management Tool,然后单击创建。单击创建后的下一次单击可能会锁定该工具。
关于此任务
安装 WebSphere® Application Server Network Deployment 产品的核心产品文件后,必须创建概要文件。本文描述使用 Profile Management Tool 来创建定制概要文件。定制概要文件是一个空节点,您可以将它定制为包括应用程序服务器、集群或其他 Java 进程(如消息传递服务器)。
也可以使用
manageprofiles 命令来创建定制概要文件。请参阅
manageprofiles 命令的描述以了解更多信息。
每个概要文件的模板位于
app_server_root/profileTemplates 目录中。
此目录中存在多个目录,它们与不同概要文件类型相对应并随所安装产品的不同而不同。这些目录是您在使用带有
-templatePath 选项的 manageprofiles 命令时指示的路径。也可以指定 profileTemplates 目录以外的概要文件模板(如果有)。
可在 manageprofiles
命令上指定 -templatePath 参数以获取可用模板的描述。概要文件概念主题中也描述了这些模板。
缺省情况下,当您创建定制概要文件时,Profile Management Tool 将联合定制节点。通过联合该节点,就使该节点可以正常运行。您必须有权访问运行中的 Deployment Manager 才能联合该节点。否则,将显示连接错误。如果您无权访问运行中的 Deployment Manager,或者由于任何其他原因,那么可以在以后联合节点。
如果该定制概要文件在不带 Deployment Manager 的机器上,那么 Deployment Manager 必须可通过网络访问以支持对该节点进行联合。
您可以使用典型概要文件创建过程或高级概要文件创建过程,通过Profile Management Tool创建概要文件。典型概要文件创建过程使用缺省设置并分配唯一的端口值。如果允许,可以选择设置这些值。对于高级概要文件创建过程,可以接受缺省值,也可以指定您自己的值。
过程
- 安装产品,以创建核心产品文件。
- 启动Profile Management Tool,以创建新的运行时环境。
可以使用以下某种方法启动该工具。
- 安装结束时,选中用于启动Profile Management Tool的复选框。
- 直接从命令提示符发出命令以打开 WebSphere Customization Toolbox;然后打开Profile Management Tool。
- 从“第一步”控制台中选择 WebSphere Customization Toolbox 选项;然后打开Profile Management Tool。
使用开始菜单访问 WebSphere Customization Toolbox;然后打开Profile Management Tool。
使用用于启动程序的 Linux 操作系统菜单来启动 WebSphere Customization Toolbox;然后打开Profile Management Tool。
- 在“概要文件”选项卡上单击创建以创建新概要文件。
“概要文件”选项卡包含机器上已创建的概要文件的列表。除非可以扩充选择的概要文件,否则不能对该概要文件执行任何操作。除非可以扩充您选择的概要文件,否则“扩充”按钮将会呈灰色显示。
该工具将显示“环境选择”面板。
- 选择定制概要文件,然后单击下一步。
将显示“概要文件创建选项”面板。
- 选择典型概要文件创建或高级概要文件创建,然后单击下一步。
典型概要文件创建选项将创建使用缺省配置设置的概要文件。对于高级概要文件创建选项,您可以为概要文件指定自己的配置值。
- 如果选择了典型概要文件创建,那么请转至有关联合节点的步骤。
- 如果选择了高级概要文件创建,那么请在“概要文件名称和位置”面板中指定定制概要文件名称和概要文件目录,也可以接受缺省值,然后单击下一步。
概要文件命名准则:支持双字节字符。概要文件名称可以是任何符合以下限制的唯一名称。在对概要文件进行命名时,请不要使用下列任何字符:
- 空格
- 在操作系统上的目录名中不受支持的特殊字符,例如 *&?
- 斜杠 (/) 或 (\)
缺省概要文件
在机器上创建的第一个概要文件是缺省概要文件。缺省概要文件是从产品安装根目录下的 bin 目录中所发出命令的缺省目标。当机器上只存在一个概要文件时,每个命令在配置中的单个服务器进程上运行。创建另一个概要文件时,可通过在高级概要文件创建路径的“概要文件名称和位置”面板上选中将此概要文件设为缺省概要文件,来将该概要文件设为缺省概要文件。还可以在创建概要文件之后使用 manageprofiles 命令来使另一个概要文件成为缺省概要文件。
在多概要文件环境中处理概要文件
当一台机器上存在多个概要文件时,某些命令要求您指定命令适用于的概要文件(如果该概要文件不是缺省概要文件)。这些命令使用 -profileName 参数来标识要处理的概要文件。您会发现,使用每个概要文件的 bin 目录下的命令会更为方便。
使用这些命令来查询命令 shell 以确定调用概要文件并将这些命令定向到调用概要文件。
缺省概要文件信息
缺省概要文件名称为
<profile_type><profile_number>:
- <profile_type> 是值 AppSrv、Dmgr、Custom、AdminAgent、JobMgr 或 SecureProxySrv。
- <profile_number> 是用于创建唯一概要文件名称的序号
![[AIX]](../images/aixlogo.gif)
缺省概要文件目录是 app_server_root/profiles,其中 app_server_root 是安装根目录。
缺省概要文件目录是 app_server_root\profiles,其中 app_server_root 是安装根目录。
然后,工具将显示“节点名和主机名”面板。
- 指定定制概要文件的节点特征和主机特征,然后单击下一步。
如果您打算将先前的 WebSphere Application Server Network Deployment 安装版本迁移到 V9.0,请对
V9.0 Deployment Manager 使用与先前版本的单元相同的单元名称。如果该产品在同一物理机器或机器集群(例如综合系统)上运行,那么单元名必须是唯一的。此外,如果需要在实体之间建立网络连接(在单元之间建立网络连接或者从必须与每个单元通信的客户机建立网络连接),那么单元名也必须是唯一的。如果单元名的名称空间为联合名称空间,那么单元名也必须是唯一的。否则,可能会出现诸如
javax.naming.NameNotFoundException 错误之类的症状,在这种情况下,请创建名称唯一的单元。
迁移单元后,先前版本的受管节点现在由 V9.0 Deployment Manager 以兼容性方式管理。可以将单元中的个别受管节点迁移到
V9.0。为此,您必须创建节点名与先前版本受管节点相同的 V9.0 概要文件。
保留的名称:请避免将保留的文件夹名称用作字段值。使用保留的文件夹名会导致不可预测的结果。以下各项是保留的文件夹名:
- cells
- nodes
- servers
- clusters
- applications
- deployments
表 1. 定制概要文件的特征. 此表显示定制概要文件的特征。
字段名称 |
缺省值 |
限制 |
描述 |
节点名 |
shortHostName
Node
NodeNumber
其中: - shortHostName 是短主机名
- NodeNumber 是从 01 开始的序号
|
避免使用保留项。 使用 Deployment Manager 单元中的唯一名称。
如果您打算从先前版本迁移受管节点,请对此
V9.0 定制概要文件使用相同的节点名称。
|
该名称用于在要添加定制概要文件的 Deployment Manager 单元中进行管理。使用 Deployment Manager 单元中的唯一名称。 将先前版本的 Deployment Manager 单元迁移至
V9.0 Deployment Manager 之后,您可以迁移 V9.0 Deployment Manager 中以兼容性方式运行的先前版本的定制概要文件。
|
主机名 |
长格式的域名服务器 (DNS) 名称。
|
主机名必须可通过网络进行寻址。 |
请使用机器的实际 DNS 名称或 IP 地址,以便能够与您的机器进行通信。请参阅此表下面关于主机名的其他信息。 |
- 目录路径注意事项:
profiles_directory_path\profile_name 目录中的字符数必须小于或等于 80 个字符。
- 主机名注意事项:
主机名是用于安装节点的物理机器的网络名。主机名必须解析为服务器上的物理网络节点。当服务器中存在多个网卡时,主机名或 IP 地址必须解析为其中一个网卡。远程节点使用主机名来连接到此节点并与其进行通信。选择网络中其他机器可以访问的主机名很重要。对于此值,请不要使用通用标识 localhost。另外,对于主机名使用双字节字符集 (DBCS) 中字符的机器,不要尝试在该机器上安装 WebSphere Application Server 产品。主机名不支持使用
DBCS 字符。
如果在同一计算机上用唯一的 IP 地址定义共存节点,那么应在域名服务器 (DNS) 查找表中定义每个 IP 地址。独立应用程序服务器的配置文件不会向具有单一网络地址的机器上的多个 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 地址是固定的。
指定定制概要文件特征后,工具将显示“联合”面板。
- 如果对 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 的可用性时联合节点。
可能会将 Deployment Manager 重新配置为将非缺省远程方法调用 (RMI) 用作首选 Java 管理扩展 (JMX) 连接器。单击 Deployment Manager 的管理控制台中的系统管理 > Deployment Manager > 管理服务以验证首选连接器类型。
如果 RMI 是首选 JMX 连接器,那么稍后必须使用 addNode 命令来联合定制概要文件。使用 addNode 命令以便可以指定 JMX 连接器类型和 RMI 端口。
如果 Deployment Manager 使用缺省 SOAP JMX 连接器类型,那么指定主机名和
SOAP 端口并现在就联合节点以创建您可以定制的功能性节点。
当 Deployment Manager 不可用时联合
如果在 Deployment Manager 未在运行或不可访问时联合定制节点,那么将显示错误消息。如果 Deployment Manager 在概要文件创建过程中变为不可用,那么日志中的安装指示符是 INSTCONFFAIL,指示完全失败。得到的定制概要文件将不可用。您必须删除该概要文件。请参阅有关删除概要文件的内容,以获取更多信息。
如果您选择了立即联合,而且您先前选择了高级概要文件创建,那么下一步将显示“安全证书”面板。转至有关创建和导入证书的步骤。
否则,将显示“概要文件创建摘要”面板以选择创建典型概要文件选项。转至有关创建定制概要文件的步骤。
- 创建缺省个人证书和根签署证书,或者从密钥库文件导入个人证书和根签署证书,然后单击下一步。
可以同时创建或导入这两个证书,也可以创建其中一个证书,导入另一个证书。
最佳实践: 将个人证书导入为缺省个人证书时,请导入签署该个人证书的根证书。否则,
Profile Management Tool会将该个人证书的签署者添加到 trust.p12 文件中。
bprac
如果导入缺省个人证书或根签署证书,请为导入的每个证书指定路径和密码,并选择密钥库类型和密钥库别名。
- 验证证书信息是否正确,然后单击下一步。
如果创建证书,那么可以使用缺省值或者修改缺省值以创建新证书。缺省情况下,缺省个人证书的有效期为一年,并由根签署证书签署。缺省情况下,根签署证书是有效期为 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 文件包含添加至您在安装并运行服务器之后创建的任何新密钥库文件的签署者证书。缺省情况下,缺省根证书签署者和 DataPower® 签署者证书位于 default-signer.p12 密钥库文件中。deleted.p12 密钥库文件用于存放通过 deleteKeyStore 任务删除的证书,以便可以在需要时恢复这些证书。ltpa.jceks 文件包含您环境中的服务器用于互相通信的服务器缺省轻量级第三方认证 (LTPA) 密钥。
导入的证书会添加至 key.p12 文件或 root-key.p12 文件。
如果导入任何证书并且这些证书不包含所需的信息,请单击返回以导入其他证书。
如果您先前选择了高级概要文件创建,那么在显示“安全证书”面板后,该工具将显示“端口”面板。
- 验证定制概要文件中的端口是否唯一或者有意冲突,然后单击下一步。
解决端口冲突
如果您怀疑某个端口冲突,那么可以在创建概要文件之后检查该端口是否冲突。通过检查以下文件来确定创建概要文件期间使用的端口。
![[AIX]](../images/aixlogo.gif)
profile_root/properties/portdef.props 文件
profile_root\properties\portdef.props 文件
此文件包含设置端口时使用的密钥和值。如果您发现端口冲突,那么可以手动重新分配端口。要重新分配端口,请使用 ws_ant 脚本来运行 updatePorts.ant 文件。
将显示“概要文件创建摘要”面板。
- 单击创建以创建定制概要文件,或者单击上一步以更改定制概要文件的特征。
如果先前在“联合”面板上选择了联合节点,那么 Deployment Manager 必须在运行中并且可访问。单击创建时,Deployment Manager 必须在运行中并且可访问。如果您认为 Deployment Manager 可能不再运行或者不可访问,那么请启动 Deployment Manager 并使它可访问,或者如果它已在运行,请使它可访问。
将显示“概要文件创建进度”面板,该面板显示了正在运行的配置命令。
概要文件创建完成后,该工具将显示“概要文件创建完成”面板。
- (可选)选择启动“第一步”控制台。单击完成以退出。
通过使用“第一步”控制台,您可以创建其他概要文件以及启动应用程序服务器。
结果
您创建了定制概要文件。在联合该概要文件中的节点并使用 Deployment Manager 来定制该节点之前,该节点是空的。
目录结构将在概要文件目录中显示新的概要文件文件夹。概要文件文件夹与您创建的概要文件同名。
请参阅 manageprofiles 命令的描述,请了解使用命令而非Profile Management Tool创建概要文件的信息。
Profile Management Tool将在概要文件创建期间创建日志。这些日志位于 install_dir/logs/manageprofiles 目录下。日志文件使用以下模式命名:manageprofiles_create_profile_name.log。
下一步做什么
如果创建节点时未将该节点联合到 Deployment Manager 单元中,那么执行此操作。然后,使用 Deployment Manager 在该节点上创建应用程序服务器。
部署应用程序以便开始使用。
请参阅有关产品的快速路径的内容,以便开始部署应用程序。