技术开发 频道

概要(Profile)理解入门,第 2 部分:如何创建和管理概要

3.3.4 创建一个自定义概要

自定义概要会在系统中定义一个空白的节点。这一概要的目的是在系统中定义一个节点,该节点会与某个单元联合,以实现中央管理。

当您创建概要时,您可以选择在运行向导时将节点与单元联合,或者只创建概要,以后再进行联合。在您将自定义概要与某个单元联合之前,您必须有一个正在运行的部署管理器。

注意:利用其他概要,您可以将进程注册为 Windows 服务。当您创建自定义概要时,这个选项并不会显示出来。如果您以后要将节点代理注册为 Windows 服务,请参阅第 130 页的 3.6.3 "启用失败时进程重启"。

表 3-4 总结了您在为某个自定义节点创建概要时拥有的选项。

表 3-4 自定义概要选项

典型高级
概要的名称为 Customxx。该概要存储在 <was_home>/profiles/Customxx。默认情况下,它不会被当作缺省概要。 您可以指定概要的名称和位置。您还可以指定是否要将它设置为缺省概要。
节点的名称为 <host>Nodexx。主机名称已经用系统的 DNS 主机名预先填好。 您可以指定节点名称和主机名称。
您可以选择以后联合这个节点,也可以在概要的创建过程中进行联合。如果您想现在这样做,您必须指定部署管理器的主机和 SOAP 端口(缺省情况下为 localhost:8879)。如果在部署管理器上启用了安全性,您需要指定一个用户 ID 和密码。
TCP/IP 端口将缺省采用这个 WebSphere 实例中的任何概要都未使用的一组端口。 您可以使用每个概要的推荐端口(对于这一安装是唯一的),使用基本的缺省值,或手动选择端口号。


本节将带您了解创建自定义概要的步骤。

1. 启动 Profile Management 工具。在"Welcome"页面上,单击 Next。

2. 选择 Custom profile 选项。单击 Next。

3. 选择您要运行的创建过程(Typical 或 Advanced)。单击 Next。如果选择了"Typical",您将直接转至用于联合的选项(第 82 页的图 3-23)。如果选择了"Advanced",您将看到下一个步骤。

4. 为概要输入一个唯一的名称,或接受缺省名称。概要名称将成为放置概要文件的目录名。请参见图 3-21。
如果您希望这个目录成为接收命令的缺省概要,请单击选中此复选框。单击 Next。
图 3-21 创建一个自定义概要:输入名称和位置

5. 输入新的节点名称和系统主机名称。请参见图 3-22。该节点名称会被缺省设置为您的系统主机名称。向导会识别安装中是否有现有的节点,并在创建缺省的节点名称时将这一点考虑在内。单击 Next。

图 3-22 创建一个自定义概要:输入主机和节点名称

6. 如果您希望在运行向导时,将概要定义的新节点联合或添加到某个单元,请使"Federate this node later"复选框保持未选中状态,然后为部署管理器输入主机名和 SOAP 连接器端口(第 63 页的图3-8)。请参见图 3-23。

注意:如果您选择现在进行联合,请确保部署管理器已经启动。

图 3-23 创建一个自定义概要:现在或以后进行联合

7. 检查您已经选择的选项。请参见图 3-24。

图 3-24 创建一个自定义概要:总结

单击 Next,创建概要。

这个最终的窗口将显示自定义概要创建成功还是失败。

如果出现了错误,请检查下列位置的日志:<was_home>/logs/manageprofiles/<profile_name>_create.log

注意,您必须在窗口中单击 Finish,以解除对该日志的锁定。您还可以找到单个操作的日志,它们存储在: <profile_home>/logs

8. 在向导完成之后,您将看到一个屏幕,含有说明这一过程是否成功的消息。如果您愿意,或要创建另一个概要,可以启动"First Steps"。如果出现了错误,请检查下列位置的日志: <was_home>/logs/manageprofiles/<profile_name>_create.log
注意,您必须在窗口中单击 Finish,以解除对该日志的锁定。您还可以找到单个操作的日志,它们存储在: <profile_home>/logs

9. 单击 Finish,关闭向导,如果您愿意,还可以启动"First Steps"应用程序。请参见第 84 页的图 3-25。

图 3-25 自定义概要的"First Steps"窗口

检查结果

如果创建成功,请按下列方法熟悉概要和它的使用方法:

1. 查看 <profile_home> 目录结构,找出新的概要。在这个位置,您可以在众多项目中找到包含节点配置文件的 config 目录。

2. 如果您已经对自定义概要进行了联合,请打开部署管理器的管理控制台,查看节点和节点代理:

- 选择 System Administration > Nodes。您应当看到新的节点。

- 选择 System Administration > Node agents。您应当看到新的节点代理。

- 选择 System administration > Cell。单击 Topology tab,然后展开此视图。在此处,您会看到单元的一个树状示意图,如第 85 页的图 3-26 所示

图 3-26 某一单元的 Topology 视图

3. 联合过程将为新节点创建一个节点代理,将其与单元联合,然后启动节点代理。

您可以用从控制台停止新的节点代理,也可以在节点系统中执行下列命令:

cd <profile_home>\bin stopNode

虽然您可以在管理控制台中重新启动节点代理,但您不能启动某个已经停止的节点。要启动一个新的节点代理,请在节点系统中使用下列命令。

cd <profile_home>\bin startNode

如果您没有对节点进行联合,您就无法启动它。请继续阅读第 86 页的 3.3.5,"将一个自定义节点与某个单元联合"。否则,您可以继续操作,在新节点上定义一个应用程序服务器。要完成此操作,请参阅 3.3.6,"在现有的节点上创建一个新的应用程序服务器"。

3.3.5 将一个自定义节点与某个单元联合

注意:只有当您在创建一个自定义概要时没有选择对它进行联合的情况下,您才有这样做的必要。这需要您拥有一个部署管理器概要,且这个部署管理器正在运行。

自定义概要用于定义某个可被添加到单元的节点。要将该节点与某个单元联合,请按下列方法操作:

1. 启动部署管理器。

2. 在您为新节点创建自定义概要的那个系统中,打开一个命令窗口。切换至 <profile_home>/bin 目录(如 cd C:\myWAS61Profiles\cstmProfiles\CstmProfile1)。

3. 运行 addNode 命令。在此处您需要部署管理器的主机名称和 SOAP 连接器地址(参见第 62 页的图 3-7 和第 63 页的图 3-8): addNode <dmgrhost> <dmgr_soap_port> 示例 3-1 显示了在 Windows 系统中使用 addNode 命令的一个例子,用 8879 作为 SOAP 连接器地址,将 Node06 添加到配置管理器。

示例 3-1 addNode 命令

C:\WebSphere\ND\profiles\Node06\bin>addnode localhost 8879 ADMU0116I: Tool information is being logged in file c:\WebSphere\ND\profiles\Node06\logs\addNode.log ADMU0128I: Starting tool with the Node06 profile CWPKI0308I: Adding signer alias "dummyclientsigner" to local keystore "ClientDefaultTrustStore" with the following SHA digest: 0B:3F:C9:E0:70:54:58:F7:FD:81:80:70:83:A6:D0:92:38:7A:54:CD CWPKI0308I: Adding signer alias "dummyserversigner" to local keystore "ClientDefaultTrustStore" with the following SHA digest: FB:38:FE:E6:CF:89:BA:01:67:8F:C2:30:74:84:E2:40:2C:B4:B5:65 CWPKI0308I: Adding signer alias "default_2" to local keystore "ClientDefaultTrustStore" with the following SHA digest: CC:60:A6:33:99:B0:D9:34:B2:6A:89:5F:A7:5F:C8:C1:9E:CC:8C:2A CWPKI0308I: Adding signer alias "default_1" to local keystore "ClientDefaultTrustStore" with the following SHA digest: 20:83:69:46:D9:B9:95:51:00:99:3C:D9:3B:EF:E4:1B:C1:9A:C1:84 CWPKI0308I: Adding signer alias "default" to local keystore "ClientDefaultTrustStore" with the following SHA digest: DA:29:33:E3:61:67:91:79:B4:54:EA:95:04:D0:47:8A:14:70:DF:90 ADMU0001I: Begin federation of node Node06 with Deployment Manager at

 

localhost:8879. ADMU0001I: Begin federation of node Node06 with Deployment Manager at localhost:8879. ADMU0009I: Successfully connected to Deployment Manager Server: localhost:8879 ADMU0507I: No servers found in configuration under: c:\WebSphere\ND\profiles\Node06\config/cells/kadw028Node04Cell/nodes Node06/servers ADMU2010I: Stopping all server processes for node Node06 ADMU0024I: Deleting the old backup directory. ADMU0015I: Backing up the original cell repository. ADMU0012I: Creating Node Agent configuration for node: Node06 ADMU0014I: Adding node Node06 configuration to cell: kadw028Cell01 ADMU0016I: Synchronizing configuration between node and cell. ADMU0018I: Launching Node Agent process for node: Node06 ADMU0020I: Reading configuration for Node Agent process: nodeagent ADMU0022I: Node Agent launched. Waiting for initialization status. ADMU0030I: Node Agent initialization completed successfully. Process id is: 2120 ADMU0505I: Servers found in configuration: ADMU0506I: Server name: nodeagent ADMU9990I: ADMU0300I: The node Node06 was successfully added to the kadw028Cell01 cell. ADMU9990I: ADMU0306I: Note: ADMU0302I: Any cell-level documents from the standalone kadw028Cell01 configuration have not been migrated to the new cell. ADMU0307I: You might want to: ADMU0303I: Update the configuration on the kadw028Cell01 Deployment Manager with values from the old cell-level documents. ADMU9990I: ADMU0306I: Note: ADMU0304I: Because -includeapps was not specified, applications installed on the standalone node were not installed on the new cell. ADMU0307I: You might want to: ADMU0305I: Install applications onto the kadw028Cell01 cell using wsadmin $AdminApp or the Administrative Console. ADMU9990I: ADMU0003I: Node Node06 has been successfully federated. C:\WebSphere\ND\profiles\Node06\bin>


4. 打开部署管理器和管理控制台,查看节点和节点代理:

- 选择 System Administration > Nodes。您应当看到新的节点。

- 选择 System Administration > Node agents。您应当看到新的节点代理及其状态。它应该已经启动。如果没有,请在自定义节点系统的命令窗口中检查状态。
cd <profile_home>\bin serverStatus -all

如果您发现它还没有启动,请用这个命令启动它: cd <profile_home>\bin startNode

3.3.6 在现有的节点上创建一个新的应用程序服务器

自定义概要并不会使您自动获得一个应用程序服务器。一旦自定义概要与某个单元联合,您可以按照这些步骤创建一个新的服务器。

注意:本主题将简要描述创建和启动一个应用程序服务器的过程。关于创建和自定义应用程序服务器的详细信息,请参阅第 170 页的 4.4,""使用应用程序服务器"。

如果您计划使用集群,可以在创建集群的时候创建应用程序服务器。关于使用集群的详细信息,请参阅第 222 页的 4.6,"使用集群"。

1. 确保自定义概要节点代理已经启动。

2. 打开部署管理器管理控制台。

3. 选择 Servers > Application Servers

4. 单击 New。

5. 选择自定义概要节点,并为服务器输入一个新名称(图 3-27)。单击 Next。

图 3-27 创建一个新的服务器:输入一个节点和名称

6. 选择一个模板,作为新应用程序服务器的基础配置。请参见图 3-28

图 3-28 创建一个新的服务器:选择一个模板

DeveloperServer 和缺省模板已经为您创建好了。缺省模板被用来创建一个典型的服务器,以用于生产。

V6.1 中的新特性:DeveloperServer 模板被用来创建一个针对开发作了优化的服务器。它关闭了 PMI,将 JVM 设置成一种禁用了类验证的模式,这使它能通过-Xqui ckstart 命令更快地启动。注意,它并没启用"developmentMode"配置属性(在应用程序服务器窗口中以开发模式的设置运行)。如果您想如此设置以加快应用程序服务器的启动速度,您在使用管理控制台创建服务器之后,必须对其进行配置。

您还可以根据现有的服务器创建模板。

如果您先前没有根据某个现有的服务器创建一个模板,请选择缺省模板。单击 Next。

7. 一个节点上的每个应用程序服务器所分配的各个端口必须是唯一的。下一个窗口提供的选项可以让您为该应用程序服务器生成唯一的端口,而不是使用缺省的端口组。单击 Next。请参见第 90 页的图 3-29。

图 3-29 创建一个新的服务器:生成唯一端口

8. 最后一个窗口对您的各项选择进行总结。请参见图 3-30。单击 Finish,创建概要。

图 3-30 创建一个新的服务器:总结和完成

9. 在消息对话框中,单击 Save,保存对主配置的更改。

10. 从管理控制台中启动应用程序服务器。

- 选择 Servers > Application Servers。

- 选中服务器左边的复选框,然后单击 Start。

注意:您可以用 WebSphere Application Server 提供的示例应用程序来熟悉 WebSphere 应用程序。您可以在创建应用程序服务器概要时安装这些示例(可选)。如果您是利用管理工具创建应用程序服务器的,这些示例将不会自动安装。关于示例的可用性及安装方法的详细信息,请参阅 Information Center 中,Learn about WebSphere Applications 下的 Accessing the Samples 主题。

3.3.7 将一个应用程序服务器概要与某个单元联合

如果您创建了一个应用程序服务器概要,现在想将节点和服务器添加到单元,请执行下列操作:

1. 启动应用程序服务器。

2. 启动部署管理器。

3. 打开部署管理器管理控制台。

4. 选择 System Administration > Nodes

5. 单击 Add Node。

6. 选择 Managed node,然后单击 Next。

7. 输入您在创建应用程序服务器概要时指定的主机名和 SOAP 连接器端口。请参见第 70 页的图 3-13 和第 71 页的图 3-14。
如果您想保留示例应用程序和您安装的任何其他程序,请选中 Include applications 复选框。如果这是一个新创建的应用程序服务器概要,它将包括示例应用程序,所以,如果您希望保留这些示例,请务必选中此复选框。

如果您已经在服务器上创建了一条服务集成总线,您可以选择让它也包含在托管服务器中。在缺省情况下,一个新创建的应用程序概要不会含有服务集成总线。如果您已经创建了一条总线,并选择包含它,则该名称在单元内必须是唯一的。
请参见图 3-32。

图 3-31 向单元中添加一个独立式应用程序概要

单击 OK。

8. 如果该节点是一个 Windows 节点,您可以将新的节点代理注册成一个 Windows 服务,如图 3-32 所示。请做出选择,然后单击 OK。

图 3-32 将节点代理作为 Windows 服务运行

联合过程将停止应用程序服务器。它会为节点创建一个新的节点代理,然后将节点添加到单元中。应用程序服务器成为单元中的一个托管服务器。之后节点代理将会启动(而不是服务器)。

9. 您现在可以从控制台中显示新节点、节点代理和应用程序服务器。您还可以从控制台中启动服务器。

当这一过程完成时:

应用程序服务器的概要目录仍然存在,供该应用程序服务器使用。

应用程序服务器旧的单元名称已经被一个以部署管理器的单元名称命名的概要目录所取代。

<profile_home>/config/cells/<dmgr_celname>/


一个针对新建节点的新条目将被添加到部署管理器概要目录中。

<dmgr_profile_home>/config/cells/<dmgr_celname>/nodes/<federated node>

单元中每个节点的相应条目被添加到应用程序服务器概要的配置中。每个节点条目都包括该节点的 serverindex.xml 文件。

<profile_home>/config/cells/<dmgr_celname>/nodes/<federated node>


新节点的相应条目连同该节点的 serverindex.xml 文件,将被添加到单元中各节点的节点目录中。


3.5 管理概要

您创建的每个概要都会在概要注册中心注册:

<was_home>/properties/profileRegistry.xml


您已经看到如何用 Profile Management 工具创建概要。这个向导的核心是 manageprofi les 命令。这个命令为您提供了对概要进行普通的维护活动的方法。例如,您可以调用这个命令,创建(采用本机方式或静默方式)、列出、删除概要,验证概要注册中心,和完成其他功能。

3.5.1 使用 manageprofiles 命令

manageprofi les 命令可以在 <was_home>/bin 目录下找到。
语法

manageprofi les 命令使用下列语法:

对于 Windows,使用 manageprofi les.bat -模式 -参数

对于 UNIX,使用 manageprofiles.sh -模式 -参数

可以使用表 3-5 中的下列模式。

表 3-5 manageprofiles 的模式

模式用途
-create: 创建一个新的概要。
-augment 使用给定的概要模板,扩充某个特定的概要。
-delete 删除一个概要。
-unaugment: 取消对概要的扩充。
-deleteAll 删除所有已注册的概要。
-listProfile 列出概要注册中心中的概要。
-getName 返回指定路径下的概要的名称。
-getPath 返回指定概要名称的路径。
-validateRegistry 验证概要注册中心,并返回一个无效概要的列表。
-validateAndUpdateRegistry 验证概要注册中心,列出被清除的无效概要。
-getDefaultName 返回缺省概要的名称。
-setDefaultName 设置缺省概要。
-backupProfile 将指定的概要备份到一个 zip 文件。
-restoreProfile 从 zip 文件中恢复指定的概要。
-response 在一个响应文件中管理概要。
-help 显示帮助。

 

下面的两个示例显示 manageprofi les -<mode> - hel p 和 manageprofiles -listProfiles 模式的结果:

输入 manageprofiles -<mode> -help,以显示每种模式的详细帮助。请参阅示例 3-2,查看 manageprofiles -create -help 命令的示例。

C:\Program Files\IBM\WebSphere\AppServer\bin>manageprofiles -create -help The following command line arguments are required for this mode. Command-line arguments are case sensitive. create: Creates a new profile. Specify -help -create -templatePath <path> to get template-specific help information. templatePath: The fully qualified path name of the profile template that is located on the file system. The following example selects a template: templatePath <app_server_home>/profileTemplates/<Template_name> profileName: The name of the profile. profilePath: The intended location of the profile in the file system. The following command line arguments are optional, and have no default values. Command-line arguments are case sensitive. isDefault: Make this profile the default target of commands that do not use their profile parameter.

输入 manageprofiles -listProfiles,查看注册中心的概要列表。下面是 -listProfiles 的一个输出结果示例: 

C:\Program Files\IBM\WebSphere\AppServer\bin>manageprofiles -listProfiles [Dmgr01, AppSrv01, Custom01, Custom02, Dmgr02]


 
3.5.2 创建一个概要

您可以使用 manageprofiles 命令而不是 Profile Management 工具创建概要。

Profile 模板:概要是根据随产品提供的模板创建的。这些模板位于 <was_home>/profileTemplates。每个模板都由一组提供概要初始设置的文件和概要创建后将采取的操作列表组成。目前还没有为您提供修改这些模板以及创建新模板的方法。当您使用

  • manageprofiles 创建概要时,您需要指定下列模板中的一个:
  • Default(对于应用程序服务器概要)
  • Dmgr(对于部署管理器概要)
  • Managed(对于自定义概要)
  • Cell(对于单元概要)

例如,示例 3-3 显示了如果要在主机 kcgg1d7.itso.ibm.com 的 sacell1 单元中,在节点 sanodel 下创建一个名为 saserver1 的应用程序服务器,应在命令行中使用的命令。

示例 3-3 用 manageprofiles 命令创建一个概要

cd $WAS_HOME\bin {asuming WAS_HOME was set to some value, for example to "C:\Program Files\IBM\WebSphere\AppServer"} manageprofiles -create -profileName saserver1 -profilePath C:\myWAS61Profiles\appSrvrProfiles\saserver1 -templatePath $WAS_HOME\profileTemplates\default -nodeName sanode1 -cellName sacell1 -hostName kcgg1d7.itso.ibm.com

在静默模式下创建一个概要

可以在静默模式下使用响应文件创建概要。使用的命令为:

<profile_management_tool> -options <response_file> -silent


在这个示例中,<profile_management_tool> 是启动 Profile Management 工具时需要的命令。用来启动向导的命令与平台有关,该命令位于 <was_home>/bin/ProfileManagement 下。在表 3-6 中选择您的平台所用的命令。

表 3-6 特定于平台的创建向导

平台(32 位)Profile Management 工具命令
Linux/HP-UX/Solaris/AIX pmt.sh
Windows pmt . bat

平台(32 位) Profile Management 工具命令

Linux/HP-UX/Solaris/AIX pmt.sh Windows pmt . bat


示例响应文件存储在 <was_home>/bin/profileCreator 目录中。

3.5.3 删除概要

要删除一个概要,您必须按下列方法操作:

  • 如果您要移除一个已经与某个单元联合的自定义概要或应用程序服务器概要:

                停止节点上的应用程序服务器。

              使用管理控制台或 removeNode 命令,将节点从单元中移除。移除一个节点并不会删除它,只是使它恢复到联合前的配置,该配置以前是作为联合过程的一部分予以保存的。
 

                使用 manageprofi les -del ete 删除概要。

                使用 manageprofi les -val i dateAndUpdateRegi stry 命令清除概要注册中心。

                删除 <profile_home> 目录。

  • 如果您要移除一个未与某个单元联合的应用程序服务器概要:

                停止应用程序服务器。

               使用 manageprofi les -del ete 删除概要。

               使用 manageprofi les -val i dateAndUpdateRegi stry 命令清除概要注册中心。

               删除 <profile_home> 目录。

  • 如果您要移除某个部署管理器概要:

                使用管理控制台或 removeNode 命令,移除与单元联合的所有节点。移除一个节点并不会删除它,只是使它恢复到联合前的配置,该配置以前是作为联合过程的一部分予以保存的。

               停止部署管理器。

               使用 manageprofi les -del ete 删除概要。

               使用 manageprofi les -val i dateAndUpdateRegi stry 命令清除概要注册中心。

               删除 <profile_home> 目录。

用 manageprofiles 删除一个概要

要删除一个概要,请使用 manageprofi les -del ete 命令。其格式是: manageprofiles -delete -profileName <profile>

当该命令完成后,概要将从概要注册中心中移除,除了日志文件之外的运行时组件也将从 <profile_home> 目录中移除。

如果在删除概要时出现了错误,请检查下列日志: <was_home>/logs/manageprofile/<profile_name>_delete.log

例如,在示例 3-4 中,您可以看到用 manageprofi les 命令删除名为 Node06 的概要。

示例 3-4 用 manageprofiles 删除一个概要

C:\WebSphere\ND\profiles\Dmgr01\bin>manageprofiles -delete -profileName Node06 INSTCONFSUCCESS: Success: The profile no longer exists.


正如您在示例 3-4 中看到的,一切似乎进展顺利。但作为保证注册中心已被正确更新的一个额外的步骤,您可以列出概要,以确保概要已从注册中心去除,并对注册中心进行验证。请参阅示例 3-5。

示例 3-5 验证删除概要的结果

C:\WebSphere\ND\profiles\Dmgr01\bin>manageprofiles -listProfiles [Dmgr01, AppSrv01, AppSrv02, SamplesServer, WebServer2Node, DmgrSecure] C:\WebSphere\ND\profiles\Dmgr01\bin> manageprofiles -validateAndUpdateRegistry []
0
相关文章