manageprofiles命令详解

manageprofiles命令

使用manageprofiles命令来创建、删除、扩充、备份和复原概要文件，概要文件定义运行时环境。使用概要文件取代多个产品安装可节省磁盘空间并简化产品更新，这是因为只需维护单组核心产品文件。

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

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

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

语法

manageprofiles命令用来执行下列任务：

• 创建概要文件 (-create)
• 删除概要文件 (-delete)
• 扩充概要文件 (-augment)
• 对概要文件取消扩充 (-unaugment)
• 对已通过特定扩充模板来扩充的所有概要文件取消扩充 (-unaugmentAll)
• 删除所有概要文件 (-deleteAll)
• 列出所有概要文件 (-listProfiles)
• 列出对概要文件的扩充 (-listAugments)
• 获取概要文件名称 (-getName)
• 获取概要文件路径 (-getPath)
• 验证概要文件注册表 (-validateRegistry)
• 验证并更新概要文件注册表 (-validateAndUpdateRegistry)
• 获取缺省概要文件名称 (-getDefaultName)
• 设置缺省概要文件名称 (-setDefaultName)
• 备份概要文件 (-backupProfile)
• 恢复概要文件 (-restoreProfile)
• 执行响应文件中包含的manageprofiles命令任务 (-response)

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

app_server_root\bin\manageprofiles.bat -augment -help

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

根据要通过manageprofiles命令执行的操作，您需要提供下列其中一个或多个参数。命令行工具验证是否提供了必需参数以及对这些参数输入的值是否有效。请确保以正确的大小写形式输入这些参数的名称，因为命令行工具不会验证参数名称的大小写情况。如果输入的参数的大小写不正确，那么可能导致错误的结果。

• -profileNameprofile_name
• -profilePathprofile_root
• -templatePathtemplate_path
• -nodeNamenode_name
• -cellNamecell_name
• -hostNamehost_name
• -serverNameserver_name
• -adminUserNameadminUser_ID
• -adminPasswordadminPassword
• -appServerNodeNameapplication_server_node_name
• -backupFilebackupFile_name
• -dmgrAdminPasswordpassword
• -dmgrAdminUserNameuser_name
• -dmgrProfilePathdmgr_profile_path
• -dmgrHostdmgr_host_name
• -dmgrPortdmgr_port_number
• -debug
• -enableAdminSecuritytrue | false
• -federateLatertrue | false
• -importPersonalCertKSkeystore_path
• -importPersonalCertKSTypekeystore_type
• -importPersonalCertKSPasswordkeystore_password
• -importPersonalCertKSAliaskeystore_alias
• -importSigningCertKSkeystore_path
• -importSigningCertKSTypekeystore_type
• -importSigningCertKSPasswordkeystore_password
• -importSigningCertKSAliaskeystore_alias
• -isDefault
• -isDeveloperServer
• -keyStorePasswordkeystore_password
• -listAugments
• -nodeDefaultPorts
• -nodePortsFilenode_ports_path
• -nodeProfilePathnode_profile_path
• -omitActionfeature1 feature2... featureN
• -personalCertDNdistinguished_name
• -personalCertValidityPeriodvalidity_period
• -responseresponse_file
• -samplesPasswordsamplesPassword
• -securityLevelsecurity_level
• -serverTypeDEPLOYMENT_MANAGER | ADMIN_AGENT | JOB_MANAGER
• -signingCertDNdistinguished_name
• -signingCertValidityPeriodvalidity_period
• -startingPortstarting_port | -portsFilefile_path | -defaultPorts
• -supportedProtocolssupported_protocols
• -unaugmentAll
• -unaugmentDependentstrue | false
• -validatePorts
• -webServerChecktrue | false
• -webServerHostnamewebserver_host_name
• -webServerInstallPathwebserver_installpath_name
• -webServerNamewebserver_name
• -webServerOSwebserver_operating_system
• -webServerPluginPathwebserver_plugin_path
• -webServerPortwebserver_port
• -webServerTypewebserver_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   -profilePathprofile_root
   -templatePath template_path

参数

下列选项可用于manageprofiles命令：

-adminUserNameadminUser_ID

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

-adminPasswordadminPassword

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

-appServerNodeNameapplication_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 -templatePathtemplate_path

如果概要文件模板相对于app_server_root/profileTemplates目录，那么可以为-templatePath参数指定一个相对路径。否则，指定一个标准模板路径。例如：

 manageprofiles -augment -profileName profile_name -templatePathtemplate_path

另请参阅-unaugment参数。

-backupProfile

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

manageprofiles(.bat)(.sh)-backupProfile -profileNameprofile_name -backupFilebackupFile_name

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

-backupFilebackupFile_name

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

-cellNamecell_name

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

请使用唯一名称，即使您计划将定制概要文件或独立概要文件联合到一个 Deployment Manager单元也应如此。联合要求单元名称是唯一的，然后它才能生成 Deployment Manager单元的节点部分。A cell name must be unique in any circumstance in which theproduct is running on the same physical machine or cluster of machines, such asa sysplex. Additionally, a cell name must be unique in any circumstance inwhich network connectivity between entities is required either between thecells or from a client that must communicate with each of the cells. Cell namesmust also be unique if their namespaces are federated. Otherwise, you mightencounter symptoms such as a javax.naming.NameNotFoundException error, in whichcase, create uniquely named cells.

此参数的缺省值基于短主机名、常量单元和尾随数字的组合，如下所示：

• 应用程序服务器概要文件：并非任何
• 定制概要文件：并非任何
• Deployment Manager服务器的管理概要文件：shortHostNameCellCellNumber
• 具有作业管理器服务器的管理概要文件：shortHostNameJobMgrCellCellNumber
• 具有管理代理程序服务器的管理概要文件：shortHostNameAACellCellNumber
• 单元概要文件，应用程序服务器部分：shortHostNameCellCellNumber
• 单元概要文件，Deployment Manager部分：shortHostNameCellCellNumber
• 安全代理概要文件：并非任何

其中CellNumber是从01开始的序号。

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

-create

创建概要文件。

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

• 单元 - Deployment Manager单元（dmgr和缺省值）
• 管理 -管理。与-serverType参数配合使用，以指示管理概要文件的类型。
• 安全代理 -安全代理
• 缺省值 -应用程序服务器
• 受管 -定制

-debug

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

-personalCertValidityPeriodvalidity_period

一个可选参数，用于指定缺省个人证书有效的时间量（以年计）。如果未将此参数与-personalCertDN参数一起指定，那么缺省个人证书有效的时间为一年。

-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文件以确定在卸载过程中发生的任何问题的原因。

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

-dmgrAdminPasswordpassword

如果正在联合节点，那么当对Deployment Manager启用了管理安全性时为该 Deployment Manager指定有效用户名。请将此参数与-dmgrAdminUserName参数和 -federateLater参数配合使用。

-dmgrAdminUserNameuser_name

如果正在联合节点，那么当对Deployment Manager启用了管理安全性时为该 Deployment Manager指定有效密码。请将此参数与-dmgrAdminPassword参数和 -federateLater参数配合使用。

-dmgrHostdmgr_host_name

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

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

指定此可选参数会指示manageprofiles命令尝试将定制节点联合到 Deployment Manager单元，因为它会使用受管 -templatePath参数创建定制概要文件。创建Deployment Manager概要文件或应用程序服务器概要文件时，会忽略 -dmgrHost参数。

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

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

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

-dmgrPortdmgr_port_number

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

如果已启用安全性或已更改缺省 Java™管理扩展 (JMX)连接器类型，那么无法使用manageprofiles命令进行联合。请使用addNode命令替代。

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

-dmgrProfilePathdmgr_profile_path

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

-enableAdminSecuritytrue | false

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

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

您无法使用-enableAdminSecurity参数来为定制概要文件启用管理安全性。要为定制概要文件启用安全性，定制概要文件必须联合到 Deployment Manager。要为联合定制概要文件启用安全性，必须为 DeploymentManager启用管理安全性。

-enableServicetrue | 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服务。

-federateLatertrue | false

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

-getDefaultName

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

-getName

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

-getPath

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

-help

显示命令语法。

-hostNamehost_name

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

-ignoreStack

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

-importPersonalCertKSkeystore_path

指定当创建概要文件时用来导入个人证书的密钥库文件的路径。该个人证书是服务器的缺省个人证书。

最佳实践：导入个人证书作为缺省个人证书时，请导入签署该个人证书的根证书。否则，manageprofiles会将个人证书的公用密钥添加至 trust.p12文件并创建根签名证书。

-importPersonalCertKS参数与-personalCertDN参数互斥。如果未特地创建或导入个人证书，那么在缺省情况下会创建一个个人证书。

当指定任何以-importPersonal开始的参数时，必须指定所有的此类参数。

-importPersonalCertKSTypekeystore_type

指定对-importPersonalCertKS参数指定的密钥库文件的类型。值可能为JCEKS、CMSKS、PKCS12、PKCS11和JKS。但是，此列表可根据 java.security文件中的提供程序更改。

当指定任何以-importPersonal开始的参数时，必须指定所有的此类参数。

-importPersonalCertKSPasswordkeystore_password

指定对-importPersonalCertKS参数指定的密钥库文件的密码。

当指定任何以-importPersonal开始的参数时，必须指定所有的此类参数。

-importPersonalCertKSAliaskeystore_alias

指定对-importPersonalCertKS参数指定的密钥库文件中证书的别名。该证书被添加至服务器缺省密钥库文件，并且用作服务器缺省个人证书。

当指定任何以-importPersonal开始的参数时，必须指定所有的此类参数。

-importSigningCertKSkeystore_path

指定当创建概要文件时用来导入根证书的密钥库文件的路径。该根证书是用作服务器缺省根证书的证书。-importSigningCertKS参数与-signingCertDN参数互斥。如果未特地创建或导入根签名证书，那么在缺省情况下会创建一个根签名证书。

当指定任何以-importSigning开始的参数时，必须指定所有的此类参数。

-importSigningCertKSTypekeystore_path

指定对-importSigningCertKS参数指定的密钥库文件的类型。有效值可能为JCEKS、CMSKS、PKCS12、PKCS11和JKS。但是，此列表可根据 java.security文件中的提供程序更改。

当指定任何以-importSigning开始的参数时，必须指定所有的此类参数。

-importSigningCertKSPasswordkeystore_password

指定对-importSigningCertKS参数指定的密钥库文件的密码。

当指定任何以-importSigning开始的参数时，必须指定所有的此类参数。

-importSigningCertKSAliaskeystore_alias

指定对-importSigningCertKS参数指定的密钥库文件中证书的别名。该证书被添加至服务器缺省根密钥库，并且用作服务器缺省根证书。

当指定任何以-importSigning开始的参数时，必须指定所有的此类参数。

-isDefault

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

-isDeveloperServer

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

-keyStorePasswordkeystore_password

指定要对概要文件创建期间创建的所有密钥库文件使用的密码。密钥库文件是为缺省个人证书和根签名证书创建的。

-listAugments

列出对概要文件注册表中概要文件的已注册扩充。必须将 -profileName参数与 -listAugments参数一起指定。

-nodeDefaultPorts

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

-nodePortsFilenode_ports_path

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

-nodeProfilePathnode_profile_path

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

-nodeNamenode_name

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

此参数的缺省值基于短主机名、概要文件类型和尾随数字，如下所示：

• 应用程序服务器概要文件：shortHostNameNodeNodeNumber
• 定制概要文件：shortHostNameNodeNodeNumber
• Deployment Manager服务器的管理概要文件：shortHostNameCellManagerNodeNumber
• 具有作业管理器服务器的管理概要文件：shortHostNameJobMgrNodeNumber
• 具有管理代理程序服务器的管理概要文件：shortHostNameAANodeNodeNumber
• 单元概要文件，应用程序服务器部分：shortHostNameNodeNodeNumber
• 单元概要文件，Deployment Manager部分：shortHostNameCellManagerNodeNumber
• 安全代理概要文件：shortHostNameNodeNodeNumber

其中NodeNumber是从01开始的序号。

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

-omitActionfeature1 feature2...featureN

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

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

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

-personalCertDNdistinguished_name

指定当创建概要文件时创建的个人证书的专有名称。指定以引号引起来的专有名称。此缺省个人证书位于服务器密钥库文件中。-importPersonalCertKSType参数与-personalCertDN参数互斥。请参阅-personalCertValidityPeriod参数和-keyStorePassword参数。

-portsFilefile_path

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

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

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

-profileNameprofile_name

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

<profile_type><profile_number>

其中

• <profile_type>是诸如AppSrv、Dmgr、AdminAgent、JobMgr或Custom之类的值
• <profile_number>是创建唯一的概要文件名称的序号

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

不能选择已被使用的概要文件名称。

-profilePathprofile_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文件中。

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

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

-responsereponse_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 -backupFilefile_name

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

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

-samplesPasswordsamplesPassword

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

-securityLevelsecurity_level

为安全代理服务器指定初始安全性级别设置。有效值为低、中和高。缺省值为高。安全性级别基于启动用户许可权、路由注意事项、管理选项以及错误处理。可以选择在创建安全代理服务器概要文件之后更改安全性设置。

-serverNameserver_name

指定服务器的名称。仅对缺省模板和安全代理模板指定此参数。如果当使用缺省模板或安全代理模板时未指定此参数，那么缺省服务器名称是 server1（对于缺省概要文件）以及 proxy1（对于安全代理概要文件）。

-serverTypeDEPLOYMENT_MANAGER | ADMIN_AGENT |JOB_MANAGER

指定管理概要文件的类型。指定DEPLOYMENT_MANAGER（对于 Deployment Manager服务器）、ADMIN_AGENT（对于管理代理程序服务器）或JOB_MANAGER（对于作业管理器服务器）。当创建管理概要文件时，此参数是必需的。

-serviceUserNameservice_user_ID

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

-setDefaultName

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

manageprofiles(.bat)(.sh)-setDefaultName -profileNameprofile_name

-signingCertDNdistinguished_name

指定当创建概要文件时创建的根签名证书的专有名称。指定以引号引起来的专有名称。此缺省个人证书位于服务器密钥库文件中。-importSigningCertKS参数与-signingCertDN参数互斥。如果未特地创建或导入根签名证书，那么在缺省情况下会创建一个根签名证书。请参阅-signingCertValidityPeriod参数和-keyStorePassword参数。

-signingCertValidityPeriodvalidity_period

一个可选参数，用于指定根签名证书有效的时间量（以年计）。如果未将此参数与-signingCertDN参数一起指定，那么根签名证书有效的时间为 20年。

-startingPortstartingPort

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

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

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

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

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

-supportedProtocolssupported_protocols

指定对用于进行代理请求的安全代理服务器有效的协议。有效值为SIP、HTTP和HTTP,SIP。

-templatePathtemplate_path

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

如果概要文件模板相对于app_server_root/profileTemplates目录，那么可以为-templatePath参数指定一个相对路径。否则，指定一个标准模板路径。F

-unaugment

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

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

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

另请参阅 augment参数。

-unaugmentAll

对已通过特定扩充模板来扩充的所有概要文件取消扩充。-templatePath参数必须与 -unaugmentAll参数一起使用。

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

（可选）将-unaugmentDependents参数与 -unaugmentAll参数一起指定，以对要取消扩充的概要文件必备的所有概要文件取消扩充。

注：如果在不具有任何已通过概要文件模板扩充的概要文件时使用此参数，那么可能会发生错误。

另请参阅 augment参数。

-unaugmentDependentstrue | false 

如果设置为 true，那么该参数会对要使用 -unaugmentAll 参数取消扩充的概要文件必备的所有已扩充概要文件进行取消扩充。此参数的缺省值为false。

（可选）将-unaugmentDependents参数与 -unaugmentAll参数一起指定。

-validateAndUpdateRegistry

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

-validateRegistry

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

-validatePorts

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

-webServerChecktrue | false

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

-webServerHostnamewebserver_host_name

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

-webServerInstallPathwebserver_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”

-webServerNamewebserver_name

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

-webServerOSwebserver_operating_system

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

-webServerPluginPathwebserver_pluginpath

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

-webServerPortwebserver_port

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

-webServerTypewebserver_type

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

-winserviceAccountTypespecifieduser |localsystem

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

如果值为specifieduser，那么 winservicePassword参数是必需的。winserviceUserName参数缺省为环境 user.name值（如果未指定）。

-winserviceChecktrue | false

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

重要：借助定制概要文件，您无法使用此参数来创建 Windows服务。请改为使用WASService命令来单独地创建该服务。

-winservicePasswordwinservice_password

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

-winserviceStartupTypemanual |automatic | disabled

可能的startup_type值为：

• manual
• automatic
• disabled

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

此参数的缺省值为automatic。

-winserviceUserNamewinservice_user_ID

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

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

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

使用方案

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

创建 Deployment Manager

以下示例使用管理模板来创建名为 Dmgr001的 DeploymentManager。Deployment Manager端口从端口号 20000开始。

 

app_server_root/bin/manageprofiles.sh -create
   -profileName Dmgr001
   -profilePath profile_root
   -templatePath app_server_root/profileTemplates/management
   -serverTypeDEPLOYMENT_MANAGER
   -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\management
   -serverTypeDEPLOYMENT_MANAGER
   -nodeName Dmgr001Node
   -cellName Dmgr001NodeCell
   -hostName localhost
   -isDefault
   -startingPort 20000

创建管理代理程序

以下示例使用管理模板来创建名为 AdminAgent001的管理代理程序。管理代理程序端口从端口号 24000开始。

 

app_server_root/bin/manageprofiles.sh -create
   -profileName AdminAgent001
   -profilePath profile_root
   -templatePath app_server_root/profileTemplates/management
   -serverType ADMIN_AGENT
   -nodeName AdminAgent001Node
   -hostName localhost
   -isDefault
   -startingPort 24000

app_server_root\bin\manageprofiles.bat -create
   -profileName AdminAgent001
   -profilePath profile_root
   -templatePath app_server_root\profileTemplates\management
   -serverType ADMIN_AGENT
   -nodeName AdminAgent001Node
   -hostName localhost
   -isDefault
   -startingPort 24000

创建作业管理器

以下示例使用管理模板来创建名为 JobMgr001的作业管理器。作业管理器端口从端口号 25000开始。

 

app_server_root/bin/manageprofiles.sh -create
   -profileName JobMgr001
   -profilePath profile_root
   -templatePath app_server_root/profileTemplates/management
   -serverType JOB_MANAGER
   -nodeName JobMgr001Node
   -cellName JobMgr001NodeCell
   -hostName localhost
   -isDefault
   -startingPort 25000

app_server_root\bin\manageprofiles.bat -create
   -profileName JobMgr001
   -profilePath profile_root
   -templatePath app_server_root\profileTemplates\management
   -serverType JOB_MANAGER
   -nodeName JobMgr001Node
   -cellName JobMgr001NodeCell
   -hostName localhost
   -isDefault
   -startingPort 25000

创建安全代理

以下示例使用安全代理模板来创建名为SecureProxySrv001的安全代理。安全代理端口从端口号 26000开始。

 

app_server_root/bin/manageprofiles.sh -create
   -profileNameSecureProxySrv001
   -profilePath profile_root
   -templatePath app_server_root/profileTemplates/secureproxy
   -nodeNameSecureProxySrv001Node
   -serverName secproxy1
   -hostName localhost
   -isDefault
   -startingPort 26000

app_server_root\bin\manageprofiles.bat -create
   -profileNameSecureProxySrv001
   -profilePath profile_root
   -templatePath app_server_root\profileTemplates\secureproxy
   -nodeNameSecureProxySrv001Node
   -serverName secproxy1
   -hostName localhost
   -isDefault
   -startingPort 26000

创建定制概要文件

以下示例创建定制概要文件并将该概要文件联合到Deployment Manager单元中。

c:\WebSphere\AppServer\binmanageprofiles.bat -create
   -profileName Custom01
   -profilePath profile_root
   -templatePath 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
   -dmgrHost myhost.mycity.mycompany.com
   -dmgrPort 8879
   -startingPort 22000

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

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

该命令还创建 Windows服务（对于应用程序服务器）、个人证书和根签名证书（对于概要文件）以及密钥库密码（对于这两个证书）。

app_server_root\bin manageprofiles.bat -create
   -profileName Default01
   -profilePath profile_root
   -templatePath app_server_root\profileTemplates\default
   -nodeName Default01Node
   -cellName Default01Cell
   -hostName myhost.mycity.mycompany.com
   -isDefault
   -winserviceCheck true
   -winserviceAccountTypespecifieduser
   -winserviceUserName my_user_id
   -winservicePassword my_password
   -winserviceStartupTypemanual
   -startingPort 21000
   -personalCertDN "cn=testa,ou=Rochester, o=IBM, c=US"
   -signingCertDN "cn=testc,ou=Rochester, o=IBM, c=US"
   -keyStorePassword ap3n9krw

 

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
   -personalCertDN "cn=testa,ou=Rochester, o=IBM, c=US"
   -signingCertDN "cn=testc,ou=Rochester, o=IBM, c=US"
   -keyStorePassword ap3n9krw

创建单元概要文件

创建单元概要文件要求创建单元概要文件的 DeploymentManager部分和应用程序服务器部分。将链接两个概要文件，并且某些参数必须在单元概要文件的 Deployment Manager部分和应用程序服务器部分的创建参数之间匹配。

重要：对于单元概要文件的 Deployment Manager部分和应用程序服务器部分，您必须对cellName、nodeName和appServerNodeName参数使用相同值。在创建单元概要文件的Deployment Manager部分时，如果未指定这些参数的名称，那么必须使用在第一个命令行调用中指定的缺省名称。紧接在后的示例显示对单元概要文件的 Deployment Manager部分和应用程序服务器部分中这些参数使用相同值的情况。

对于 Dmgr：

-cellNamehost01Cell01
-nodeName host01CellManager01
-appServerNodeName host01Node01
                               
对于 AppServer：
-cellName host01Cell01
-nodeName host01CellManager01
-appServerNodeName host01Node01

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

1. 创建单元概要文件的 Deployment Manager部分。
   app_server_root\bin\manageprofiles.bat -create
      -templatePath app_server_root\profileTemplates\cell\dmgr
      -nodeProfilePath app_server_root\profiles\AppSrv01
      -profileName Dmgr001
      -cellName Default01Cell
      -nodeName Default01Node
      -appServerNodeName Default02Node
   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 Default02Node
2. 创建单元概要文件的应用程序服务器部分。
   app_server_root\bin\manageprofiles.bat -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 Default02Node
   
   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 Default02Node

日志

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

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