manageprofiles 命令

manageprofiles 命令行工具创建所有应用程序服务器运行时环境。该命令创建概要文件，即定义 Deployment Manager、定制概要文件或独立应用程序服务器的运行时环境的文件集合。

manageprofiles 命令在称为概要文件的文件集中为 WebSphere Application Server 进程创建运行时环境。该概要文件定义运行时环境并包括运行时环境中服务器进程可以更改的所有文件。

manageprofiles 命令及其图形用户界面概要管理工具是创建运行时环境的唯一方法。

命令文件位于 app_server_root/bin 目录。命令文件是名为manageprofiles 的脚本。

要了解有关从何处运行此命令的更多信息，请参阅 使用命令行工具。

注： 如果对受管概要文件模板使用此命令，那么未创建应用程序服务器。但是，如果您正在联合节点，那么仍然使用了端口。

有关在 Microsoft® Windows Vista™ 操作系统上运行 manageprofiles 命令的注意事项：

• 在 Microsoft Windows Vista 操作系统上安装 WebSphere Application Server V6.1 之后，在尝试使用manageprofiles 命令来创建任何概要文件之前应安装一个包含 V6.1.0.9 或更高版本的 service pack。
• 如果您正在 Microsoft Windows Vista 操作系统上运行 V6.1.0.9 或更高版本，那么您必须在具备经过提升的管理员特权的情况下运行manageprofiles 命令。
  要在具备管理员特权的情况下运行 manageprofiles，请在命令提示符窗口中运行此命令，通过执行以下操作可以启动命令提示符窗口：

  • 右键单击“命令提示符”快捷方式。
  • 单击用管理员帐户运行。

语法

manageprofiles 命令用来执行以下操作：

• 创建概要文件（-create）
• 删除概要信息（-delete）
• 扩充概要文件（-augment）
• 缩小概要文件（-unaugment）
• 删除所有概要文件（-deleteAll）
• 列出所有概要文件（-listProfiles）
• 获取概要文件名称（-getName）
• 获取概要文件路径（-getPath）
• 验证概要文件注册表（-validateRegistry）
• 验证并更新概要文件注册表（-validateAndUpdateRegistry）
• 获取缺省概要文件名称（-getDefaultName）
• 设置缺省概要文件名称（-setDefaultName）
• 备份概要文件（-backupProfile）
• 恢复概要文件（-restoreProfile）

对于用 manageprofiles 命令完成的每个任务，要在包括必需参数时获取详细的帮助，请使用 -help 参数。以下示例说明在 Windows 操作系统上对 manageprofiles -augment 命令使用 help 参数：

app_server_root\bin\manageprofiles.bat -augment -help

help 命令的输出将指定哪些参数是必需的以及哪些参数是可选的。

根据您要用 manageprofiles 命令执行的操作的不同，您将需要提供以下一个或多个参数。命令行概要管理工具验证是否提供了必需的参数以及对这些参数输入的值是否有效。因为命令行概要管理工具不会验证参数名称的大小写，所以一定要以正确的大小写输入参数的名称。如果输入的参数的大小写不正确，那么可能导致错误的结果。

• -profileName profile_name
• -profilePath profile_root
• -templatePath template_path
• -nodeName node_name
• -cellName cell_name
• -hostName host_name
• -adminUserName adminUser_ID
• -adminPassword adminPassword
• -appServerNodeName application_server_node_name
• -backupFile backupFile_name
• -dmgrProfilePath dmgr_profile_path
• -dmgrHost dmgr_host_name
• -dmgrPort dmgr_port_number
• -debug
• -enableAdminSecurity true | false
• -federateLater true | false
• -isDefault
• -isDeveloperServer
• -nodeDefaultPorts
• -nodePortsFile node_ports_path
• -nodeProfilePathnode_profile_path
• -omitAction feature1 feature2... featureN
• -response reponse_file
• -samplesPassword samplesPassword
• -startingPort starting_port | -portsFile file_path | -defaultPorts
• -validatePorts
• -webServerCheck true | false
• -webServerHostnamewebserver_host_name
• -webServerInstallPath webserver_installpath_name
• -webServerName webserver_name
• -webServerOS webserver_operating_system
• -webServerPluginPath webserver_plugin_path
• -webServerPort webserver_port
• -webServerType webserver_type
• -enableServicetrue | false
• -serviceUserNameservice_user_ID
• -winserviceChecktrue | false
• -winserviceAccountTypespecifieduser | localsystem
• -winservicePasswordwinservice_password
• -winserviceStartupTypemanual | automatic | disabled
• -winserviceUserNamewinservice_user_ID

以下示例说明在诸如 AIX 或 Linux 这样的操作系统上使用 manageprofiles -create 命令：

app_server_root/bin/manageprofiles.sh -create
              -profileName profile_name 
              -profilePath profile_root
              -templatePath template_path

参数

下列选项可用于 manageprofiles 命令：

-adminUserName adminUser_ID

指定用于管理安全性的用户标识。

-adminPassword adminPassword

为使用 -adminUserName 参数指定的管理安全性用户标识指定密码。

-appServerNodeName application_server_node_name

指定要联合至单元的应用程序服务器的节点名。创建单元的 Deployment Manager 部分及创建单元的应用程序服务器部分时，请指定此参数。

-augment

使用 augment 参数以通过扩充模板对现有概要文件进行更改。augment 参数导致 manageprofiles 命令使用 -templatePath 参数中的模板更新或扩充在 -profileName 参数中标识的概要文件。您可以使用哪些扩充模板取决于您的环境中安装的 IBM 产品及其版本。

注： WebSphere Application Server 附带提供的模板只能用来创建概要文件，而不能用来扩充现有概要文件，因为随该产品只提供了创建模板。

此外，不要手动修改 install_dir/ profileTemplates 目录中的文件。例如，如果要在创建概要文件期间更改端口，那么使用概要管理工具，或者对manageprofiles 命令使用 -startingPort 或 -portsFile 参数，而不要修改概要文件模板目录中的文件。

请对 -templatePath 指定标准文件路径。例如：

manageprofiles(.bat)(.sh) -augment -profileName profile_name -templatePath fully_qualified_template_path

对 -templatePath 参数指定相对文件路径会导致不能充分扩充指定的概要文件。

另请参阅 -unaugment 参数。

-backupProfile

对概要文件文件夹和概要文件注册表文件中的概要文件元数据执行文件系统备份。在调用带 -backupProfile 选项的 manageprofiles 命令之前，必须首先停止任何正在使用要备份的概要文件的服务器。 -backupProfile 参数必须与 -backupFile 和 -profileName 参数一起使用，例如：

manageprofiles(.bat)(.sh) -backupProfile -profileName profile_name -backupFile backupFile_name

在使用 -backupProfile 选项备份概要文件时，必须先停止服务器和正在运行的进程（这些进程属于您想要备份的概要文件）。

-backupFile backupFile_name

将概要文件注册表文件备份到指定的文件。您必须为 backupFile_name 提供标准文件路径。

-cellName cell_name

指定概要文件的单元名。请对每个概要文件使用唯一单元名。

请使用唯一名称，即使您计划将定制概要文件或独立概要文件联合到一个部署管理器单元也应如此。联合要求单元名称是唯一的，然后它才能生成部署管理器单元的节点部分。每当产品在同一物理机器或机器集群上运行（例如在综合系统中）时，单元名必须唯一。此外，当需要在实体之间建立网络连接（在单元之间建立网络连接或者从必须与每个单元通信的客户机建立网络连接）时，单元名也必须唯一。如果要联合单元的名称空间，那么单元名也必须唯一。否则，可能会出现诸如 javax.naming.NameNotFoundException 异常之类的错误。在这种情况下，需要创建名称唯一的单元。

此参数的缺省值以短主机名、常量单元和尾随数字的组合为基础，例如：

if (DMgr)
 shortHostNameCellCellNumber
else
 shortHostNameNodeNodeNumberCell

其中 CellNumber 是从 01 开始的连续数字， NodeNumber 是您用来定义节点名的节点号。

此参数的值不得包含空格或任何无效字符，如：*、?、"、<、>、,、/、\、| 等等。

-create

创建概要文件。

指定 manageprofiles -create -templatePath fully_qualified_file_path_to_template -help 以获取关于创建概要文件的特定信息。可用的模板包括：

• 单元 － Deployment Manager 单元（dmgr 和缺省值）
• dmgr － Deployment Manager
• 缺省值 － 应用程序服务器
• 受管 － 定制

-debug

打开 manageprofiles 命令使用的 Ant 实用程序的调试功能。

-defaultPorts

对概要文件指定缺省端口值或基本端口值。

不要在使用 -startingPort 或-portsFile 参数时使用此参数。

在创建概要文件时，如果您未指定 -startingPort 参数、-defaultPorts 参数或-portsFile 参数，那么manageprofiles 命令使用一组自动生成的建议端口。根据缺省端口的可用性，建议的端口值可与缺省端口值不同。

注： 如果您要使用受管概要文件模板，那么请不要使用此参数。

-delete

删除概要文件。

删除概要文件不会删除概要文件目录。例如，假定您在 /usr/WebSphere/AppServer/profiles/managedProfile 目录中创建一个概要文件。在您删除概要文件之后，该目录仍然存在。

您可以删除或保留该目录。然而，profile_root/logs 目录包含关于卸载概要文件的信息。例如，您可以保留_nodeuninst.log 文件以确定在卸载过程中发生的任何问题的原因。

如果您在概要文件注册表中删除某个概要文件，而该概要文件已有扩充模板向它注册，那么会自动执行缩小操作。

-deleteAll

删除所有已注册的概要文件。

删除概要文件不会删除概要文件目录。例如，假定您在 /usr/WebSphere/AppServer/profiles/managedProfile 目录中创建一个概要文件。在您删除概要文件之后，该目录仍然存在。

您可以删除或保留该目录。然而，profile_root/logs 目录包含关于卸载概要文件的信息。例如，您可以保留_nodeuninst.log 文件以确定在卸载过程中发生的任何问题的原因。

如果您在概要文件注册表中删除某个概要文件，而该概要文件已有扩充模板向它注册，那么会自动执行缩小操作。

-dmgrHost dmgr_host_name

标识正在运行 Deployment Manager 的机器。指定此参数和 dmgrPort 参数在创建时联合定制概要文件。

主机名可以是 Deployment Manager 机器的长 DNS 名、短 DNS 名或 IP 地址。

指定此可选参数可使 manageprofiles 命令在创建定制概要文件时尝试将定制节点联合到 Deployment Manager 单元。创建 Deployment Manager 概要文件或 Application Server 概要文件时忽略此参数。

如果您在 Deployment Manager 未运行或者由于启用了安全性或其他原因导致 Deployment Manager 不可用时联合定制节点，那么日志中的安装指示信息将为 INSTCONFFAIL，表示安装完全失败。得到的定制概要文件将不可用。在创建具有相同概要文件名的另一个定制概要文件之前，必须将定制概要文件目录从概要文件存储库（概要文件安装根目录）中移出。

如果您已经启用了安全性或更改了缺省 JMX 连接器类型，那么无法用 manageprofiles 命令联合。请使用 addNode 命令替代。

此参数的缺省值为 localhost。此参数的值必须是格式正确的主机名且不得包含空格或无效字符，如：*、?、"、<、>、,、/、\、| 等等。在与 dmgrPort 参数一起使用时，与 Deployment Manager 的连接也必须可用。

-dmgrPort dmgr_port_number

标识 Deployment Manager 的 SOAP 端口。指定此参数和 dmgrHost 参数在创建时联合定制概要文件。Deployment Manager 必须在运行中并且可访问。

如果您已经启用了安全性或更改了缺省 JMX 连接器类型，那么无法用 manageprofiles 命令联合。请使用 addNode 命令替代。

此参数的缺省值为 8879。在与 dmgrHost 参数一起使用时，您指示的端口必须为正整数且与 Deployment Manager 的连接必须可用。

-dmgrProfilePath dmgr_profile_path

指定单元的 Deployment Manager 部分的概要文件路径。创建单元的应用程序服务器部分时，请指定此参数。

-enableAdminSecurity true | false

启用管理安全性。有效值包括 true 或 false。缺省值为 false。

当 enableAdminSecurity 设置为 true 时，您还必须指定参数 -adminUserName 和 -adminPassword 以及这些参数的值。如果在应用程序服务器安装期间安装了样本，那么在创建启用了管理安全性的概要文件时，还必须指定 -samplesPassword 参数。如果启用了管理安全性而未指定 -samplesPassword 参数，虽然会成功创建该概要文件，但当您尝试运行样本时，服务器系统输出日志中将记录异常和故障。

-enableService true | false

允许创建 Linux 服务。有效值包括 true 或 false。此参数的缺省值为 false。

在将 -enableService 选项设置为true 的情况下运行 manageprofiles 命令时，如果该命令由 root 用户运行，那么会与概要文件一起创建 Linux 服务。当非 root 用户运行 manageprofiles 命令时，会创建概要文件，但不会创建 Linux 服务。因为非 root 用户没有足够的许可权来设置 Linux 服务，所以不会创建该服务。在结束创建概要文件时将显示INSTCONPARTIALSUCCESS 结果，并且概要文件创建日志app_server_root/logs/manageprofiles_create_profilename.log包含一条消息，指示当前用户没有足够的许可权来设置 Linux 服务。

-federateLater true | false

指示是在概要文件创建期间联合受管概要文件，还是稍后使用 addNode 命令联合它。如果 dmgrHost、 dmgrPort、 dmgrAdminUserName 和 dmgrAdminPassword 参数没有值，那么此参数的缺省值为 true。有效值包括 true 或 false。

-getDefaultName

返回缺省概要文件的名称。

-getName

获取以给定的 -profilePath 参数注册的概要文件的名称。

-getPath

获取给定名称的概要文件的文件系统位置。需要 –profileName 参数。

-help

显示命令语法。

-hostName host_name

指定您创建概要文件的主机名。这应该与您在初始产品安装过程中指定的主机名相匹配。此参数的缺省值为长格式的域名系统。此参数的值必须是有效的 IPv6 主机名且不得包含空格或任何无效字符，如： *、 ?、 "、 <、 >、 ,、 /、 \、 | 等等。

-ignoreStack

这是一个可选参数，它与 -templatePath 参数一起用来取消扩充已经扩充的特定概要文件。请参阅 -unaugment 参数。

-isDefault

指定由一起使用的 -profileName 参数标识的概要文件在注册后将成为缺省概要文件。当发出针对缺省概要文件的命令时，那么不必使用命令的 -profileName 属性。

-isDeveloperServer

指定服务器是否仅用于开发目的。在将应用程序部署到生产应用程序服务器上之前，创建概要文件以在非生产服务器上测试应用程序时，此参数很有用。

-listProfiles

列出所有已定义的概要文件。

-nodeDefaultPorts

在结合单元模板创建概要文件时定义端口集。如果指定此选项，那么不能同时指定 -nodePortsFile 或 nodeStartingPort 选项。

-nodePortsFile node_ports_path

为单元中您要创建的节点部分指定端口。如果指定此选项，那么不能同时指定 -nodeDefaultPorts 或 -nodeStartingPort 选项。

-nodeProfilePath node_profile_path

指定单元的节点部分的概要文件路径。创建单元的 Deployment Manager 部分时，请指定此参数。

-nodeName node_name

指定用新概要文件创建的节点的节点名。请在 单元内或机器上使用唯一值。每个共享同一个产品二进制文件集的概要文件必须具有唯一节点名。

此参数的缺省值以短主机名、概要文件类型和尾随数字为基础，例如：

if (DMgr)
 shortHostNameCellManagerNodeNumber
else
 shortHostNameNodeNodeNumber

其中 NodeNumber 是从 01 开始的连续号码。

此参数的值不得包含空格或任何无效字符，如：*、?、"、<、>、,、/、\、| 等等。

-omitAction feature1 feature2... featureN

排除概要文件功能的可选参数。

每个概要文件模板都预定义了某些可选功能。仅当在选择了样本应用程序的情况下安装 WebSphere Application Server 时， samplesInstallAndConfig 选项才可用。以下可选功能可与以下概要文件模板的 -omitAction 参数一起使用：

• 缺省值 － 应用程序服务器
  • deployAdminConsole
  • samplesInstallAndConfig
  • defaultAppDeployAndConfig
• dmgr － Deployment Manager
  • deployAdminConsole
• 单元 － 由一个 dmgr 和一个缺省概要文件模板组成的 Deployment Manager 单元
  • cell_dmgr（在单元概要文件创建期间创建的 dmgr）
    • deployAdminConsole
    • samplesInstallAndConfig
    • defaultAppDeployAndConfig

-portsFile file_path

指定文件路径的可选参数，该文件定义新概要文件的端口设置。

不要在使用 -startingPort 或-defaultPorts 参数时使用此参数。

在创建概要文件时，如果您未指定 -startingPort 参数、-defaultPorts 参数或-portsFile 参数，那么manageprofiles 命令使用一组自动生成的建议端口。根据缺省端口的可用性，建议的端口值可与缺省端口值不同。

-profileName profile_name

指定概要文件的名称。创建概要文件时使用唯一值。每个共享同一个产品二进制文件集的概要文件必须具有唯一名称。缺省概要文件名称以概要文件类型和一个尾随数字为基础，例如：

profileType ProfileNumber

其中 profileType 是诸如 AppSrv、 Dmgr 或 Custom 的值， ProfileNumber 是用于创建唯一概要文件名称的连续号码。

此参数的值不得包含空格或无效字符，如：*、?、"、<、>、,、/、\、| 等等。不能选择已被使用的概要文件名称。

-profilePath profile_root

指定概要文件的标准路径，此路径在信息中心中始终指 profile_root。

指定完整路径以避免 ANT 脚本编制限制导致将概要文件联合到单元的操作失败。例如：

-profilePath profile_root

如果标准路径包含空格，那么将该值包括在引号中。

缺省值以 app_server_root 目录、概要文件子目录和文件的名称为基础。

例如，缺省值为：

WS_WSPROFILE_DEFAULT_PROFILE_HOME/profileName

其中 WS_WSPROFILE_DEFAULT_PROFILE_HOME 是在 app_server_root /properties 目录中的 wasprofile.properties 文件中定义的。

此参数的值必须是目标系统的有效路径且当前未被使用。

您必须具有写入该目录的许可权。

-response reponse_file

使用 manageprofiles 命令从命令行访问所有 API 函数。

命令行界面可以由响应文件驱动，该响应文件以键和值格式包含属性文件中给定命令的输入参数。以下是创建操作的示例响应文件：

create
profileName=testResponseFileCreate
profilePath=profile_root
templatePath=app_server_root/profileTemplates/default
nodeName=myNodeName
cellName=myCellName
hostName=myHostName
omitAction=myOptionalAction1, myOptionalAction2

Windows 操作系统中的路径语句可以使用正斜杠（/）或反斜杠（\）。如果路径语句使用反斜杠，那么响应文件需要使用双反斜杠才能正确识别路径。以下是使用双反斜杠的创建操作的响应文件示例：

create
templatePath=C:\\WebSphere\\AppServer\\profileTemplates\\default

要确定各种类型的概要文件模板和操作需要哪些输入参数，可使用带有 -help 参数的 manageprofiles 命令。

-restoreProfile

恢复概要文件备份。必须与 -backupFile 参数一起使用，例如：

manageprofiles(.bat)(.sh) -restoreProfile -backupFile file_name

要恢复概要文件，请执行以下步骤：

1. 从文件系统中手动删除概要文件的目录。
2. 运行 manageprofiles 命令的 -validateAndUpdateRegistry 选项。
3. 停止服务器和正在运行的进程（这些进程属于您想要恢复的概要文件）。
4. 通过使用 manageprofiles 命令的 -restoreProfile 选项来恢复概要文件。

-samplesPassword samplesPassword

创建要用于样本的密码。该密码用来限制对安装应用程序服务器期间安装的 Web 应用程序样本的访问。

-serviceUserName service_user_ID

指定在创建 Linux 服务期间使用的用户标识，以便 Linux 服务将在此用户标识下运行。无论此用户标识何时登录，Linux 服务都会运行。

-setDefaultName

将缺省概要文件设置为现有概要文件中的一个。必须与 -profileName 参数一起使用，例如：

manageprofiles(.bat)(.sh) -setDefaultName -profileName profile_name

-startingPort startingPort

指定为概要文件生成和指定所有端口时使用的起始端口号。

端口值是从 -startingPort 值开始按顺序指定的，但是要省略已经在使用的那些端口值。系统识别并解析当前正在使用的端口，并确定端口分配以避免端口冲突。

不要将此参数与 -defaultPorts 或-portsFile 参数一起使用。

在创建概要文件时，如果您未指定 -startingPort 参数、-defaultPorts 参数或-portsFile 参数，那么manageprofiles 命令使用一组自动生成的建议端口。根据缺省端口的可用性，建议的端口值可与缺省端口值不同。

注： 如果您要使用受管概要文件模板，那么请不要使用此参数。

-templatePath template_path

指定安装根目录中模板文件的目录路径。 profileTemplates 目录包含对应于不同概要文件类型的各种目录，并且这些目录随所安装产品的类型而异。这些概要文件目录是您在使用 -templatePath 选项时指示的路径。可指定不在安装根目录中的概要文件模板（如果碰巧有的话）。

请使用绝对路径。此参数必须作为目录存在且必须指向有效的模板目录。

-unaugment

扩充是指使用扩充模板更改现有概要文件的能力。要取消扩充一个已经扩充的概要文件，必须指定 -unaugment 参数和 -profileName 参数。如果执行了一系列 manageprofiles 扩充，并且您仅指定了这两个参数来取消扩充概要文件，那么取消扩充操作将首先撤销最后的扩充操作。

要取消扩充已经扩充的特定概要文件，还需要指定 -ignoreStack 参数和 -templatePath 参数。通常，您不会取消扩充特定概要文件，因为您必须确保没有违反概要文件模板依赖关系。

使用 -templatePath 参数时，请对该参数指定标准文件路径。

另请参阅 augment 参数。

-validateAndUpdateRegistry

检查概要文件注册表中列出的所有概要文件，以查看文件系统中是否存在这些概要文件。从注册表除去任何缺少的概要文件。返回从注册表删除的缺少的概要文件列表。

-validateRegistry

检查概要文件注册表中列出的所有概要文件，以查看文件系统中是否存在这些概要文件。返回缺少的概要文件的列表。

-validatePorts

指定应该验证端口以确保它们不是保留的或未被使用。此参数帮助您标识未被使用的端口。如果确定端口已被使用，那么概要文件创建操作会停止并显示一条错误消息。在创建命令行时，您可以在任何时候使用此参数。建议将此参数与 portsFile 参数一起使用。

-webServerCheck true | false

指示是否要设置 Web 服务器定义。有效值包括 true 或 false。此参数的缺省值为 false。

-webServerHostname webserver_host_name

服务器的主机名。此参数的缺省值为本地机器的长主机名。

-webServerInstallPath webserver_installpath_name

Web 服务器的本地或远程安装路径。此参数的缺省值取决于本地机器的操作系统和 webServerType 参数的值。例如：

webServerType=IHS: webServerInstallPath 缺省为“C:\Program Files\IBM\HTTPServer”
webServerType=IIS: webServerInstallPath 缺省为“C:\”
webServerType=SUNJAVASYSTEM: webServerInstallPath 缺省为“C:\”
webServerType=DOMINO: webServerInstallPath 缺省为“”
webServerType=APACHE: webServerInstallPath 缺省为“”
webServerType=HTTPSERVER_ZOS: webServerInstallPath 缺省为“n/a”

webServerType=IHS: webServerInstallPath 缺省为“/opt/IBM/HTTPServer”
webServerType=IIS: webServerInstallPath 缺省为“n\a”
webServerType=SUNJAVASYSTEM: webServerInstallPath 缺省为“/opt/sun/webserver”
webServerType=DOMINO: webServerInstallPath 缺省为“”
webServerType=APACHE: webServerInstallPath 缺省为“”
webServerType=HTTPSERVER_ZOS: webServerInstallPath 缺省为“n/a”

webServerType=IHS: webServerInstallPath 缺省为“/usr/IBM/HTTPServer”
webServerType=IIS: webServerInstallPath 缺省为“n\a”
webServerType=SUNJAVASYSTEM: webServerInstallPath 缺省为“/opt/sun/webserver”
webServerType=DOMINO: webServerInstallPath 缺省为“?”
webServerType=APACHE: webServerInstallPath 缺省为“?”
webServerType=HTTPSERVER_ZOS: webServerInstallPath 缺省为“n/a”

webServerType=IHS: webServerInstallPath defaulted to “/opt/IBM/HTTPServer”
webServerType=IIS: webServerInstallPath 缺省为“n\a”
webServerType=SUNJAVASYSTEM: webServerInstallPath 缺省为“/opt/sun/webserver”
webServerType=DOMINO: webServerInstallPath 缺省为“”
webServerType=APACHE: webServerInstallPath 缺省为“”
webServerType=HTTPSERVER_ZOS: webServerInstallPath 缺省为“n/a”

webServerType=IHS: webServerInstallPath 缺省为“/opt/IBM/HTTPServer”
webServerType=IIS: webServerInstallPath 缺省为“n\a”
webServerType=SUNJAVASYSTEM: webServerInstallPath 缺省为“/opt/sun/webserver”
webServerType=DOMINO: webServerInstallPath 缺省为“”
webServerType=APACHE: webServerInstallPath 缺省为“”
webServerType=HTTPSERVER_ZOS: webServerInstallPath 缺省为“n/a”

-webServerName webserver_name

Web 服务器的名称。此参数的缺省值为 webserver1。

-webServerOS webserver_operating_system

Web 服务器所在的操作系统。有效值包括： windows、 linux、 solaris、 aix、 hpux、 os390 和 os400。请将此参数与 webServerType 参数一起使用。

-webServerPluginPath webserver_pluginpath

Web 服务器使用的插件的路径。此参数的缺省值为 WAS_HOME/plugins。

-webServerPort webserver_port

指示访问 Web 服务器将使用的端口。此参数的缺省值为 80。

-webServerType webserver_type

Web 服务器的类型。有效值包括： IHS、 SUNJAVASYSTEM、 IIS、 DOMINO、 APACHE 和 HTTPSERVER_ZOS。请将此参数与 webServerOS 参数一起使用。

-winserviceAccountType specifieduser | localsystem

为概要文件创建的 Windows 服务的所有者帐户的类型。有效值包括 specifieduser 或 localsystem。 localsystem 值在创建概要文件的用户的本地帐户下运行 Windows 服务。此参数的缺省值为 system。

-winserviceCheck true | false

该值可以为 true 或 false。指定 true 为概要文件内创建的服务器进程创建 Windows 服务。指定 false 以便不创建 Windows 服务。此参数的缺省值为 false。

-winservicePassword winservice_password

为将拥有 Windows 服务的指定用户或本地帐户指定密码。

-winserviceStartupType manual | automatic | disabled

可能的 startup_type 值为：

• manual
• automatic
• disabled

请参阅 中的WASService 命令『WASService 命令』主题以了解有关 Windows 服务的更多信息。

此参数的缺省值为 automatic。

-winserviceUserName winservice_user_ID

指定用户标识以便 Windows 操作系统可以验证您的标识是否能够创建 Windows 服务。您的用户标识必须属于管理员组，而且具有下列高级用户权限：

• 作为操作系统的一部分
• 作为服务登录

此参数的缺省值为当前用户名。此参数的值不得包含空格或无效字符，如： *、 ?、 "、 <、 >、 ,、 /、 \、 | 等等。您指定的用户必须具有适当的许可权才能创建 Windows 服务。您必须为您选择的用户名指定正确的密码。

使用方案

下列示例说明了正确的语法。请在一行上发出以下任何示例中的命令。每个示例都以多行显示命令来增加可读性。

创建 Deployment Manager 概要文件

以下示例使用 dmgr 模板来创建名为 Dmgr001 的 Deployment Manager 概要文件。Deployment Manager 端口从端口 20000 开始。

app_server_root/bin/manageprofiles.sh -create 
   -profileName Dmgr001
   -profilePath profile_root
   -templatePath app_server_root/profileTemplates/dmgr
   -nodeName Dmgr001Node
   -cellName Dmgr001NodeCell
   -hostName localhost
   -isDefault
   -startingPort 20000

app_server_root\bin\manageprofiles.bat -create 
   -profileName Dmgr001
   -profilePath profile_root
   -templatePath app_server_root\profileTemplates\dmgr
   -nodeName Dmgr001Node
   -cellName Dmgr001NodeCell
   -hostName localhost
   -isDefault
   -startingPort 20000

创建定制概要文件

联合定制概要文件以使用 Deployment Manager 定制该概要文件。

创建定制概要文件以使用以下命令将它联合到 Deployment Manager 单元：

c:\WebSphere\AppServer\bin manageprofiles -create
    -profileName Custom01
    -profilePath profile_root
    -templateParh app_server_root\profileTemplates\managed
    -nodeName CustomNode01
    -cellName CustomNodeCell01
    -hostName myhost.mycity.mycompany.com
    -isDefault 
    -dmgrHost myhost.mycity.mycompany.com
    -dmgrPort 8879
    -startingPort 22000

app_server_root/bin/manageprofiles.sh -create
   -profileName Custom01 
   -profilePath profile_root
   -templatePath app_server_root/profileTemplates/managed
   -nodeName Custom01Node
   -cellName Custom01Cell
   -hostName myhost.mycity.mycompany.com
   -isDefault
   -startingPort 22000

创建应用程序服务器概要文件

请使用以下命令创建名为 Default01 的应用程序服务器概要文件：

app_server_root\bin manageprofiles -create 
    -profileName Default01 
    -profilePath profile_root
    -templatePath app_server_root\profileTemplates\default 
    -nodeName Default01Node
    -cellName Default01Cell
    -hostName myhost.mycity.mycompany.com
    -isDefault 
    -winserviceCheck true
    -winserviceAccountType specifieduser
    -winserviceUserName my_user_id
    -winservicePassword my_password
    -winserviceStartupType manual
    -startingPort 21000

app_server_root/bin/manageprofiles.sh -create
   -profileName Default01 
   -profilePath profile_root
   -templatePath app_server_root/profileTemplates/default
   -nodeName Default01Node
   -cellName Default01Cell
   -hostName myhost.mycity.mycompany.com
   -isDefault
   -startingPort 21000

创建单元概要文件

创建单元概要文件要求创建 Deployment Manager 和单元概要文件的应用程序服务器部分。将链接两个概要文件，并且某些参数必须在单元概要文件的 Deployment Manager 部分和应用程序服务器部分的创建参数之间匹配。有关创建单元概要文件的更详细信息，请参阅示例：使用 manageprofiles 命令创建单元概要文件 。

以下示例显示如何创建名为 Dmgr001 的单元概要文件，它的单元名称为 Default01Cell，节点名为 Default01Node。要创建一个完整的工作单元， -nodeProfilePath、 -cellName、 -appServerNodeName、 -nodeName 参数必须在 cell_dmgr 概要文件和 cell_node 概要文件之间匹配。

1. 创建单元概要文件的 Deployment Manager 部分。

   app_server_root\bin\manageprofiles -create
           -templatePath app_server_root\profileTemplates\cell\dmgr
           -nodeProfilePath app_server_root\profiles\AppSrv01
           -profileName Dmgr001
           -cellName Default01Cell
           -nodeName Default01Node
           -appServerNodeName Default01Node

   app_server_root/bin/manageprofiles.sh -create
           -templatePath app_server_root/profileTemplates/cell/dmgr
           -nodeProfilePath app_server_root/profiles/AppSrv01
           -profileName Dmgr001
           -cellName Default01Cell
           -nodeName Default01Node
           -appServerNodeName Default01Node

2. 创建单元概要文件的应用程序服务器部分。

   app_server_root\bin\manageprofiles -create
           -templatePath app_server_root\profileTemplates\cell\default
           -dmgrProfilePath app_server_root\profiles\Dmgr001
           -portsFile app_server_root\profiles\Dmgr001\properties\portdef.props
           -nodePortsFile app_server_root\profiles\Dmgr001\properties\nodeportdef.props
           -profileName AppSrv01
           -cellName Default01Cell
           -nodeName Default01Node
           -appServerNodeName Default01Node

   app_server_root/bin/manageprofiles.sh -create
           -templatePath app_server_root/profileTemplates/cell/default
           -dmgrProfilePath app_server_root/profiles/Dmgr001
           -portsFile app_server_root/profiles/Dmgr001/properties/portdef.props
           -nodePortsFile app_server_root/profiles/Dmgr001/properties/nodeportdef.props
           -profileName AppSrv01
           -cellName Default01Cell
           -nodeName Default01Node
           -appServerNodeName Default01Node

日志

manageprofiles 命令为它创建的每个概要文件创建日志。

• 日志位于 app_server_root/logs/manageprofiles 目录中。这些文件以此模式命名：profile_name_create.log。

• 命令还为它删除的每个概要文件创建日志。日志位于 app_server_root/logs/manageprofiles 目录中。这些文件以此模式命名：profile_name_delete.log。