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

• -profileName profile_name
• -profilePath profile_root
• -templatePath template_path
• -nodeName node_name
• -cellName cell_name
• -hostName host_name
• -serverName server_name
• -adminUserName adminUser_ID
• -adminPassword adminPassword
• -appServerNodeName application_server_node_name
• -backupFile backupFile_name
• -dmgrAdminPassword password
• -dmgrAdminUserName user_name
• -dmgrProfilePath dmgr_profile_path
• -dmgrHost dmgr_host_name
• -dmgrPort dmgr_port_number
• -debug
• -enableAdminSecurity true | false
• -federateLater true | false
• -importPersonalCertKS keystore_path
• -importPersonalCertKSType keystore_type
• -importPersonalCertKSPassword keystore_password
• -importPersonalCertKSAlias keystore_alias
• -importSigningCertKS keystore_path
• -importSigningCertKSType keystore_type
• -importSigningCertKSPassword keystore_password
• -importSigningCertKSAlias keystore_alias
• -isDefault
• -isDeveloperServer
• -keyStorePassword keystore_password
• -listAugments
• -nodeDefaultPorts
• -nodePortsFile node_ports_path
• -nodeProfilePathnode_profile_path
• -omitAction feature1 feature2... featureN
• -personalCertDN distinguished_name
• -personalCertValidityPeriod validity_period
• -response response_file
• -samplesPassword samplesPassword
• -securityLevel security_level
• -serverType DEPLOYMENT_MANAGER | ADMIN_AGENT | JOB_MANAGER
• -signingCertDN distinguished_name
• -signingCertValidityPeriod validity_period
• -startingPort starting_port | -portsFile file_path | -defaultPorts
• -supportedProtocols supported_protocols
• -unaugmentAll
• -unaugmentDependents true | false
• -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
• -enableService true | false
• -serviceUserName service_user_ID
• -winserviceCheck true | false
• -winserviceAccountType specifieduser | localsystem
• -winservicePassword winservice_password
• -winserviceStartupType manual | automatic | disabled
• -winserviceUserName winservice_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 template_path

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

 manageprofiles -augment -profileName profile_name -templatePath template_path

另请参阅 -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

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

请使用唯一名称，即使您计划将定制概要文件或独立概要文件联合到一个 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 -templatePath fully_qualified_file_path_to_template -help 以获取关于创建概要文件的特定信息。可用的模板包括：

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

-debug

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

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

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

-dmgrAdminPassword password

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

-dmgrAdminUserName user_name

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

-dmgrHost dmgr_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 的连接也必须可用。

-dmgrPort dmgr_port_number

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

如果已启用安全性或已更改缺省 Java™ 管理扩展 (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 参数，虽然会成功创建该概要文件，但当您尝试运行样本时，服务器系统输出日志中将记录异常和故障。

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

-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 参数。

-importPersonalCertKS keystore_path

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

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

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

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

-importPersonalCertKSType keystore_type

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

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

-importPersonalCertKSPassword keystore_password

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

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

-importPersonalCertKSAlias keystore_alias

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

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

-importSigningCertKS keystore_path

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

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

-importSigningCertKSType keystore_path

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

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

-importSigningCertKSPassword keystore_password

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

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

-importSigningCertKSAlias keystore_alias

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

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

-isDefault

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

-isDeveloperServer

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

-keyStorePassword keystore_password

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

-listAugments

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

-nodeDefaultPorts

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

-nodePortsFile node_ports_path

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

-nodeProfilePath node_profile_path

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

-nodeName node_name

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

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

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

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

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

-omitAction feature1 feature2...featureN

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

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

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

-personalCertDN distinguished_name

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

-portsFile file_path

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

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

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

-profileName profile_name

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

<profile_type><profile_number>

其中

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

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

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

-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. 从文件系统中手动删除概要文件的目录。
3. 运行 manageprofiles 命令的 -validateAndUpdateRegistry 选项。
4. 通过使用 manageprofiles 命令的 -restoreProfile 选项来恢复概要文件。

-samplesPassword samplesPassword

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

-securityLevel security_level

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

-serverName server_name

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

-serverType DEPLOYMENT_MANAGER | ADMIN_AGENT |JOB_MANAGER

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

-serviceUserName service_user_ID

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

-setDefaultName

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

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

-signingCertDN distinguished_name

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

-signingCertValidityPeriod validity_period

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

-startingPort startingPort

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

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

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

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

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

-supportedProtocols supported_protocols

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

-templatePath template_path

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

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

-unaugment

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

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

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

另请参阅 augment参数。

-unaugmentAll

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

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

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

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

另请参阅 augment参数。

-unaugmentDependents true | false  

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

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

-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 服务。此参数的缺省值为 localsystem。

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

-winserviceCheck true | false

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

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

-winservicePassword winservice_password

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

-winserviceStartupType manual |automatic | disabled

可能的startup_type 值为：

• manual
• automatic
• disabled

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

此参数的缺省值为 automatic。

-winserviceUserName winservice_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。