[AIX Solaris HP-UX Linux Windows][IBM i]

manageprofiles 命令

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

[AIX Solaris HP-UX Linux Windows]manageprofiles 命令及其图形用户界面“Profile Management Tool”是创建运行时环境的唯一方法。

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

注: z/OS 上不支持通过直接运行 manageprofiles.sh 来创建概要文件。
切记: 如果对受管概要文件模板使用此命令,那么未创建应用程序服务器。但是,如果您正在联合节点,那么仍然使用了端口。
要点: manageprofiles 的缺省行为是创建具有许可权 755 的文件,并忽略系统范围的 umask。如果您希望修改这些许可权,那么每当您将概要文件从一个用户传递给另一个用户时,就可以使用 chmod 命令进行修改。

语法

manageprofiles 命令用来执行下列任务:
  • 创建概要文件 (-create)
  • 删除概要文件 (-delete)
  • 扩充概要文件 (-augment)
  • 对概要文件取消扩充 (-unaugment)
  • 对已通过特定扩充模板来扩充的所有概要文件取消扩充 (-unaugmentAll)
  • 删除所有概要文件 (-deleteAll)
  • 列出所有概要文件 (-listProfiles)
  • 列出对概要文件的扩充 (-listAugments)
  • 获取概要文件名称 (-getName)
  • 获取概要文件路径 (-getPath)
  • 验证概要文件注册表 (-validateRegistry)
  • 验证并更新概要文件注册表 (-validateAndUpdateRegistry)
  • 获取缺省概要文件名称 (-getDefaultName)
  • 备份概要文件 (-backupProfile)
  • 恢复概要文件 (-restoreProfile)
  • 执行响应文件中包含的 manageprofiles 命令任务 (-response)
对于用 manageprofiles 命令完成的每个任务,要在包括必需参数时获取详细的帮助,请使用 -help 参数。以下示例在 Windows 操作系统上将 help 参数与 manageprofiles -augment 命令配合使用:
app_server_root\bin\manageprofiles.bat -augment -help
根据要通过 manageprofiles 命令执行的操作,您需要提供下列其中一个或多个参数。命令行工具验证是否提供了必需参数以及对这些参数输入的值是否有效。请确保以正确的大小写形式输入这些参数的名称,因为命令行工具不会验证参数名称的大小写情况。如果输入的参数的大小写不正确,那么可能导致错误的结果。
  • -adminPassword adminPassword
  • -adminUserName adminUser_ID
  • -applyPerfTuningSetting standard | peak | development
  • -augment
  • -backupFile backupFile_name
  • -backupProfile
  • -cellName cell_name(可选参数)
  • -create
  • -debug
  • -defaultPorts
  • -delete
  • -deleteAll
  • -enableAdminSecurity true | false
  • [Linux]-enableService true | false
  • -getDefaultName
  • -getPath
  • -getName
  • -help
  • -hostName host_name
  • -ignoreStack(可选参数)
  • -importPersonalCertKS keystore_path
  • -importPersonalCertKSAlias keystore_alias
  • -importPersonalCertKSPassword keystore_password
  • -importPersonalCertKSType keystore_type
  • -importSigningCertKS keystore_path
  • -importSigningCertKSAlias keystore_alias
  • -importSigningCertKSPassword keystore_password
  • -importSigningCertKSType keystore_type
  • -isDefault
  • -isDeveloperServer
  • -keyStorePassword keystore_password
  • -listAugments
  • -listProfiles
  • -nodeName node_name
  • -omitAction feature1 feature2... featureN(可选参数)
  • -personalCertDN distinguished_name
  • -personalCertValidityPeriod validity_period(可选参数)
  • -portsFile file_path(可选参数)
  • -profileName profile_name
  • -profilePath profile_root
  • -response response_file
  • -restoreProfile
  • -serverName server_name
  • -serverType ADMIN_AGENT
  • [Linux]-serviceUserName service_user_ID
  • -setDefaultName
  • -signingCertDN distinguished_name
  • -signingCertValidityPeriod validity_period(可选参数)
  • -startingPort starting_port | -portsFile file_path | -defaultPorts
  • -templatePath template_path
  • -unaugment
  • -unaugmentAll
  • -unaugmentDependents
  • -validateAndUpdateRegistry
  • -validatePorts
  • -validateRegistry
  • -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
  • [Windows]-winserviceAccountType specifieduser | localsystem
  • [Windows]-winserviceCheck true | false
  • [Windows]-winservicePassword winservice_password
  • [Windows]-winserviceStartupType manual | automatic | disabled
  • [Windows]-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 命令:

-adminPassword adminPassword
为使用 -adminUserName 参数指定的管理安全性用户标识指定密码。
-adminUserName adminUser_ID
指定用于管理安全性的用户标识。
-applyPerfTuningSetting option
指定与环境(应用程序服务器将在其中运行)的类型匹配度最高的性能调整设置。

此参数仅对缺省概要文件模板有效。

standard
标准设置是针对常规用途进行优化的现有标准缺省配置设置。
peak
峰值性能设置针对生产环境进行优化,在生产环境中极少进行应用程序更改并且最佳运行时性能很重要。
development
开发设置针对开发环境进行优化,在开发环境中需要经常执行应用程序更新并且系统资源最少。
要点: 请不要对生产服务器使用开发设置。

如果不指定带有 -applyPerfTuningSetting 参数的选项,那么缺省值为 standard。

如果同时指定 -isDeveloperServer 和 -applyPerfTuningSetting 参数,那么根据为 -applyPerfTuningSetting 选择的选项,-applyPerfTuningSetting 可能会覆盖 -isDeveloperServer。

-augment
使用 augment 参数以通过扩充模板对现有概要文件进行更改。augment 参数导致 manageprofiles 命令使用 -templatePath 参数中的模板更新或扩充在 -profileName 参数中标识的概要文件。可以使用的扩充模板由环境中安装的 IBM® 产品及版本确定。
要点: WebSphere® Application Server Base 产品附带的模板只能用于创建概要文件,而不能用于扩充现有概要文件,因为该产品仅提供了创建模板。

此外,不要手动修改 install_dir/ profileTemplates 目录中的文件。例如,如果要在创建概要文件期间更改端口,请对 manageprofiles 命令使用 -startingPort 或 -portsFile 参数,而不是在概要文件模板目录中修改该文件。

[AIX Solaris HP-UX Linux Windows]请对 -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 参数。

-backupFile backupFile_name
将概要文件注册表文件备份到指定的文件。您必须为 backupFile_name 提供标准文件路径。
-backupProfile
对概要文件文件夹和概要文件注册表文件中的概要文件元数据执行文件系统备份。在调用带 -backupProfile 选项的 manageprofiles 命令之前,必须首先停止任何正在使用要备份的概要文件的服务器。-backupProfile 参数必须与 -backupFile 和 -profileName 参数一起使用,例如:
manageprofiles(.bat)(.sh) -backupProfile -profileName profile_name -backupFile backupFile_name

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

-cellName cell_name(可选参数)
指定概要文件的单元名。请对每个概要文件使用唯一单元名。
避免故障 避免故障: 单元名必须唯一。如果单元具有重复名称,那么您可能会遇到单元之间的远程通信(例如,远程 Enterprise JavaBeans 调用)问题。gotcha

这是一个可选参数。如果您省略该参数,那么将指定缺省单元名。

[AIX Solaris HP-UX Linux Windows]此参数的缺省值基于短主机名、常量单元和尾随数字的组合,如下所示:
  • 应用程序服务器概要文件:并非任何
  • 具有管理代理程序服务器的管理概要文件:shortHostNameAACellCellNumber
其中 CellNumber 是从 01 开始的序号。
[IBM i]缺省单元名如下所示:
  • 缺省模板:shorthostname_profilename
  • 受管模板:shorthostname_profilename

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

-create
创建概要文件。
指定 manageprofiles -create -templatePath fully_qualified_file_path_to_template -help 以获取关于创建概要文件的特定信息。可用的模板包括:
  • management - 管理。与 -serverType 参数配合使用,以指示管理概要文件的类型。
  • default - 应用程序服务器
-debug
打开 manageprofiles 命令使用的 Ant 实用程序的调试功能。
-personalCertValidityPeriod validity_period(可选参数)
一个可选参数,用于指定缺省个人证书有效的时间量(以年计)。如果未将此参数与 -personalCertDN 参数一起指定,那么缺省个人证书有效的时间为一年。
-defaultPorts
对概要文件指定缺省端口值或基本端口值。

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

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

切记: 如果您要使用受管概要文件模板,那么请不要使用此参数。
-delete
删除概要文件。

[AIX Solaris HP-UX Linux Windows]删除概要文件不会删除概要文件目录。例如,假定您在 /usr/WebSphere/AppServer/profiles/managedProfile 目录中创建一个概要文件。在您删除概要文件之后,该目录仍然存在。

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

[IBM i]删除概要文件时删除了概要文件目录,以便您可以重新创建概要文件而不必手动删除目录。

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

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

[AIX Solaris HP-UX Linux Windows]删除概要文件不会删除概要文件目录。例如,假定您在 /usr/WebSphere/AppServer/profiles/managedProfile 目录中创建一个概要文件。在您删除概要文件之后,该目录仍然存在。

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

[IBM i]删除概要文件时删除了概要文件的目录,以便当您重新创建概要文件时,不需要管理已过时的信息。

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

-enableAdminSecurity true | false
启用管理安全性。有效值包括 true 或 false。缺省值为 false。
当 enableAdminSecurity 设置为 true 时,您还必须指定参数 -adminUserName 和 -adminPassword 以及这些参数的值。
[Linux]-enableService true | false
[Linux]允许创建 Linux 服务。有效值包括 true 或 false。此参数的缺省值为 false。

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

-getDefaultName
返回缺省概要文件的名称。
-getPath
获取给定名称的概要文件的文件系统位置。需要 –profileName 参数。
-getName
获取以给定的 -profilePath 参数注册的概要文件的名称。
-help
显示命令语法。
-hostName host_name
指定您创建概要文件的主机名。这应该与您在初始产品安装过程中指定的主机名相匹配。此参数的缺省值为长格式的域名系统。此参数的值必须为有效的 IPv6 主机名,并且不得包含空格或任何无效字符(例如 *、?、"、<、>、,、/、\、| 等等)。
-ignoreStack(可选参数)
这是一个可选参数,它与 -templatePath 参数一起用来取消扩充已经扩充的特定概要文件。请参阅 -unaugment 参数。
-importPersonalCertKS keystore_path
指定当创建概要文件时用来导入个人证书的密钥库文件的路径。该个人证书是服务器的缺省个人证书。
最佳实践 最佳实践: 将个人证书导入为缺省个人证书时,请导入签署该个人证书的根证书。 否则,manageprofiles 命令会将个人证书的公用密钥添加至 trust.p12 文件并创建根签名证书。bprac
-importPersonalCertKS 参数与 -personalCertDN 参数互斥。如果未特地创建或导入个人证书,那么在缺省情况下会创建一个个人证书。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

-isDefault
指定由一起使用的 -profileName 参数标识的概要文件在注册后将成为缺省概要文件。当发出针对缺省概要文件的命令时,那么不必使用命令的 -profileName 属性。
-isDeveloperServer
指定服务器仅用于开发目的。将应用程序部署到其生产应用程序服务器上之前,创建概要文件以便在非生产服务器上测试应用程序时,此参数很有用。

此参数仅对缺省概要文件模板有效。

如果同时指定 -isDeveloperServer 和 -applyPerfTuningSetting 参数,那么根据为 -applyPerfTuningSetting 选择的选项,-applyPerfTuningSetting 可能会覆盖 -isDeveloperServer。

-keyStorePassword keystore_password
指定要对概要文件创建期间创建的所有密钥库文件使用的密码。密钥库文件是为缺省个人证书和根签名证书创建的。
-listAugments
列出对概要文件注册表中概要文件的已注册扩充。必须将 -profileName 参数与 -listAugments 参数一起指定。
-listProfiles
列示概要文件注册表中的概要文件。
-nodeName node_name
指定用新概要文件创建的节点的节点名。请在机器上使用唯一值。每个共享同一个产品二进制文件集的概要文件必须具有唯一节点名。
[AIX Solaris HP-UX Linux Windows]此参数的缺省值基于短主机名、概要文件类型和尾随数字,如下所示:
  • 应用程序服务器概要文件:shortHostNameNodeNodeNumber
  • 具有管理代理程序服务器的管理概要文件:shortHostNameAANodeNodeNumber
其中 NodeNumber 是从 01 开始的序号。
[IBM i]存在下列缺省节点名:
  • 缺省模板:shorthostname_profilename
  • 受管模板:shorthostname_profilename
  • 单元:请参阅前面的管理模板和缺省模板示例,并在适当时应用到创建的两个概要文件。

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

-omitActionfeature1 feature2... featureN(可选参数)
排除概要文件功能的可选参数。
每个概要文件模板都预定义了某些可选功能。以下可选功能可与以下概要文件模板的 -omitAction 参数一起使用:
  • default - 应用程序服务器
    • deployAdminConsole
    • defaultAppDeployAndConfig
    • deployIVTApplication
  • management - 用于 管理代理程序的管理概要文件
    • deployAdminConsole
-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、AdminAgent 之类的值
  • <profile_number> 是创建唯一的概要文件名称的序号

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

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

-profilePath profile_root
指定概要文件的标准路径(称为 profile_root)。

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

[AIX Solaris HP-UX Linux Windows]缺省值基于 app_server_root 目录、概要文件子目录和概要文件的名称。

[IBM i]缺省值基于 user_data_root 目录、概要文件子目录和概要文件的名称。

例如,缺省值为:
WS_WSPROFILE_DEFAULT_PROFILE_HOME/profileName
WS_WSPROFILE_DEFAULT_PROFILE_HOME 元素定义于 app_server_root/properties 目录下的 wasprofile.properties 文件中。
注: wasprofile.properties 文件包括下列属性:
WS_CMT_PI_MODPERMS
此属性指定安装后处理程序是否应该修改它所创建的任何文件的许可权。有效值为 true 或 false。所有其他值都缺省为 false。从文件中除去此属性也将导致它缺省为 false。设置为 false 后,安装后处理程序创建的所有文件都具有基于系统的 umask 设置的许可权。

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

[AIX Solaris HP-UX Linux Windows]您必须具有写入该目录的许可权。

[IBM i]QEJBSVR 概要文件必须具有写入该目录的许可权。

WS_CMT_PI_LOGS
此属性指定后安装程序是否应该清除以及何时清除每个产品在 PROFILE_HOME/logs/service/productDir 目录中的日志。此属性的设置使您能够指定以下日志清除条件:
  • 您可以指定希望 PROFILE_HOME/logs/service/productDir 目录中为每个产品保留的日志数。所指定的值可以是 1 到 999 之间的任何整数。例如,如果您指定 WS_CMT_PI_LOGS=5,那么后安装程序将为每个产品保留五条最新日志。
  • 您可以指定日志可以占用的最大存储空间量。所指定的值可以是 1 到 999 之间的任何整数,后面接着以下单位:
    • KB(如果您以千字节为单位指定值)。
    • MB(如果您以兆字节为单位指定值)。
    • GB(如果您以吉字节为单位指定值)。
    例如,如果您指定 WS_CMT_PI_LOGS=10MB,那么在日志占用的存储空间量超过 10 兆字节时,后安装程序就会开始删除最早产生的日志。
    避免故障 避免故障: 因为所指定的值区分大小写,所以所指定的值中包括的字母必须为大写字母。gotcha
  • 您可以指定希望后安装程序将日志保留的时间量。所指定的值可以是 1 到 999 之间的任何整数,后面接着以下单位:
    • D(如果您以“日”为单位指定值)。
    • W(如果您以“星期”为单位指定值)。
    • M(如果您以“月”为单位指定值)。
    • Y(如果您以“年”为单位指定值)。
    例如,如果您指定 WS_CMT_PI_LOGS=2W,那么每个日志将保留两个星期。
    避免故障 避免故障: 因为所指定的值区分大小写,所以所指定的值中包括的字母必须为大写字母。gotcha
  • 您可以指定一个特定日期,在此日期之后就会删除日志。必须使用数值来指定此值,数值之间用短划线分隔,格式为 DD-MM-YYYY。例如,如果您指定 WS_CMT_PI_LOGS=12-31-2013,那么会在 2013 年 12 月 31 日删除所有日志。
    避免故障 避免故障: 如果您未按所指示的格式指定值(数值之间用短划线分隔),那么会忽略此属性设置。gotcha
-response reponse_file
使用 manageprofiles 命令从命令行访问所有 API 函数。

命令行界面可以由响应文件驱动,该响应文件以键和值格式包含属性文件中给定命令的输入参数。要确定各种类型的概要文件模板和操作所需要的输入参数,请将 manageprofiles 命令与 -help 参数配合使用。

请使用以下示例响应文件来运行创建操作:
create
profileName=testResponseFileCreate
profilePath=profile_root
templatePath=app_server_root/profileTemplates/default
nodeName=myNodeName
cellName=myCellName
hostName=myHostName
omitAction=myOptionalAction1,myOptionalAction2
创建响应文件时,请考虑下面的一组准则:
  • 指定值时,请不要在值的开头或结尾指定双引号 (") 字符,即使该值包含空格也是如此。
    注: 这与您在命令行上指定值时所采用的规则不同。
  • 指定包含逗号字符的单个值(例如,personalCertDN 和 signingCertDN 参数的专有名称)时,请在逗号字符前使用双反斜杠。例如,以下内容说明了如何指定具有专有名称的 signingCertDN 值:
    signingCertDN=cn=testserver.ibm.com\\,ou=Root Certificate\\,
       ou=testCell\\,ou=testNode01\\,o=IBM\\,c=US 
  • 指定多个值时,请使用逗号字符分隔这些值,并且不要使用双反斜杠。例如,以下内容说明了如何对 omitAction 参数指定多个值:
    omitAction=deployAdminConsole,defaultAppDeployAndConfig 
  • 请不要在响应文件中指定空白行。这会导致发生错误。
  • [Windows]在 Windows 操作系统中路径语句可以使用正斜杠 (/) 或反斜杠 (\)。如果路径语句使用反斜杠,那么响应文件需要使用双反斜杠才能正确标识路径。以下是使用双反斜杠的创建操作的响应文件示例:
    create
    templatePath=C:\\WebSphere\\AppServer\\profileTemplates\\default
    最佳实践 最佳实践: 使用正斜杠可以降低在平台之间进行切换时发生错误的可能性bprac
-restoreProfile
要点: manageProfiles -restoreProfile 命令仅支持在相同修订包级别创建的备份。
恢复概要文件备份。必须与 -backupFile 参数一起使用,例如:
manageprofiles(.bat)(.sh) -restoreProfile -backupFile file_name
要恢复概要文件,请执行下列步骤:
  1. 停止服务器和正在运行的进程(这些进程属于您想要恢复的概要文件)。
  2. 从文件系统中手动删除概要文件的目录。
  3. 运行 manageprofiles 命令的 -validateAndUpdateRegistry 选项。
  4. 通过使用 manageprofiles 命令的 -restoreProfile 选项来恢复概要文件。
-serverName server_name
指定服务器的名称。仅对缺省模板和安全代理模板指定此参数。如果当使用缺省模板或安全代理模板时未指定此参数,那么缺省服务器名称是 server1(对于缺省概要文件)以及 proxy1(对于安全代理概要文件)。
-serverType ADMIN_AGENT
指定管理概要文件的类型。对于管理代理程序服务器,请指定 ADMIN_AGENT。当创建管理概要文件时,此参数是必需的。
[Linux]-serviceUserName service_user_ID
[Linux]指定在创建 Linux 服务期间使用的用户标识,以便 Linux 服务通过此用户标识运行。无论此用户标识何时登录,Linux 服务都会运行。
-setDefaultName
将缺省概要文件设置为现有概要文件中的一个。必须与 -profileName 参数一起使用,例如:
manageprofiles(.bat)(.sh) -setDefaultName -profileName profile_name
-signingCertDN distinguished_name
指定当创建概要文件时创建的根签名证书的专有名称。指定以引号引起来的专有名称。此缺省个人证书位于服务器密钥库文件中。-importSigningCertKS 参数与 -signingCertDN 参数互斥。如果未特地创建或导入根签名证书,那么在缺省情况下会创建一个根签名证书。请参阅 -signingCertValidityPeriod 参数和 -keyStorePassword 参数。
-signingCertValidityPeriod validity_period(可选参数)
一个可选参数,用于指定根签名证书有效的时间量(以年计)。如果未将此参数与 -signingCertDN 参数一起指定,那么根签名证书的有效期限为 15 年。
-startingPort startingPort
指定为概要文件生成和指定所有端口时使用的起始端口号。

[AIX Solaris HP-UX Linux Windows]端口值是从 -startingPort 值开始依次指定的,但是要省略已经在使用的那些端口值。系统标识并解析当前正在使用的端口,并确定端口分配以避免端口冲突。

[IBM i]将从 -startingPort 值开始依次分配端口值。

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

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

注意: 如果您要使用受管概要文件模板,那么请不要使用此参数。
-templatePath template_path
指定安装根目录中模板文件的目录路径。profileTemplates 目录包含对应于不同概要文件类型的各种目录,并且这些目录随所安装产品的类型而异。这些概要文件目录是您在使用 -templatePath 选项时指示的路径。可指定不在安装根目录中的概要文件模板(如果碰巧有的话)。

[AIX Solaris HP-UX Linux Windows]如果概要文件模板相对于 app_server_root/profileTemplates 目录,那么可以为 -templatePath 参数指定一个相对路径。否则,指定一个标准模板路径。F

[IBM i]缺省模板路径为 app_server_root/profileTemplates/default。可以对 -templatePath 参数使用一个相对路径。该路径相对于当前工作目录或者 app_server_root/profileTemplates。以下示例会根据独立应用程序服务器的缺省值来创建概要文件:
manageprofiles -create -profileName MyProfile -startingPort 10380

“概要文件概念”主题中描述了可用的模板。

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

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

[AIX Solaris HP-UX Linux Windows]使用 -templatePath 参数时,请对该参数指定标准文件路径。

[IBM i]使用 -templatePath 参数时,可以对该参数指定相对文件路径。

另请参阅 augment 参数。

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

[AIX Solaris HP-UX Linux Windows]使用 -templatePath 参数时,请对该参数指定标准文件路径。

[IBM i]使用 -templatePath 参数时,可以对该参数指定相对文件路径。

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

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

另请参阅 augment 参数。

-unaugmentDependents
如果指定了此参数,那么它会对要使用 -unaugmentAll 参数取消扩充的概要文件必备的所有已扩充概要文件执行取消扩充操作。如果未指定此参数,那么它不会对要取消扩充的概要文件必备的已扩充概要文件执行取消扩充操作。

请将 -unaugmentDependents 参数与 -unaugmentAll 参数一起指定。

-validateAndUpdateRegistry
检查概要文件注册表中列出的所有概要文件,以查看文件系统中是否存在这些概要文件。从注册表除去任何缺少的概要文件。返回从注册表删除的缺少的概要文件列表。
-validatePorts
检查端口以验证端口是否是保留的端口或是否在使用。 此参数帮助您标识未被使用的端口。如果确定端口已被使用,那么概要文件创建操作会停止并显示一条错误消息。在创建命令行时,您可以在任何时候使用此参数。建议将此参数与 –portsFile 参数配合使用。
-validateRegistry
检查概要文件注册表中列出的所有概要文件,以查看文件系统中是否存在这些概要文件。返回缺少的概要文件的列表。
-webServerCheck true | false
指示是否要设置 Web 服务器定义。有效值包括 true 或 false。此参数的缺省值为 false。
-webServerHostname webserver_host_name
服务器的主机名。此参数的缺省值为本地机器的长主机名。
-webServerInstallPath webserver_installpath_name
Web 服务器的本地或远程安装路径。此参数的缺省值取决于本地机器的操作系统和 webServerType 参数的值。例如:
[Windows]
webServerType=IHS: webServerInstallPath defaulted to “C:\Program Files\IBM\HTTPServer”
webServerType=IIS: webServerInstallPath defaulted to “C:\”
webServerType=SUNJAVASYSTEM: webServerInstallPath defaulted to “C:\”
webServerType=DOMINO: webServerInstallPath defaulted to “”
webServerType=APACHE: webServerInstallPath defaulted to “”
webServerType=HTTPSERVER_ZOS: webServerInstallPath defaulted to “n/a”
[Linux]
webServerType=IHS: webServerInstallPath defaulted to “/opt/IBM/HTTPServer”
webServerType=IIS: webServerInstallPath defaulted to “n\a”
webServerType=SUNJAVASYSTEM: webServerInstallPath defaulted to “/opt/sun/webserver”
webServerType=DOMINO: webServerInstallPath defaulted to “”
webServerType=APACHE: webServerInstallPath defaulted to “”
webServerType=HTTPSERVER_ZOS: webServerInstallPath defaulted to “n/a”
[AIX]
webServerType=IHS: webServerInstallPath defaulted to “/usr/IBM/HTTPServer”
webServerType=IIS: webServerInstallPath defaulted to “n\a”
webServerType=SUNJAVASYSTEM: webServerInstallPath defaulted to “/opt/sun/webserver”
webServerType=DOMINO: webServerInstallPath defaulted to “?”
webServerType=APACHE: webServerInstallPath defaulted to “?”
webServerType=HTTPSERVER_ZOS: webServerInstallPath defaulted to “n/a”
[HP-UX]
webServerType=IHS: webServerInstallPath defaulted to “/opt/IBM/HTTPServer”
webServerType=IIS: webServerInstallPath defaulted to “n\a”
webServerType=SUNJAVASYSTEM: webServerInstallPath defaulted to “/opt/sun/webserver”
webServerType=DOMINO: webServerInstallPath defaulted to “”
webServerType=APACHE: webServerInstallPath defaulted to “”
webServerType=HTTPSERVER_ZOS: webServerInstallPath defaulted to “n/a”
[Solaris]
webServerType=IHS: webServerInstallPath defaulted to “/opt/IBM/HTTPServer”
webServerType=IIS: webServerInstallPath defaulted to “n\a”
webServerType=SUNJAVASYSTEM: webServerInstallPath defaulted to “/opt/sun/webserver”
webServerType=DOMINO: webServerInstallPath defaulted to “”
webServerType=APACHE: webServerInstallPath defaulted to “”
webServerType=HTTPSERVER_ZOS: webServerInstallPath defaulted to “n/a”
[IBM i]
webServerType=IHS: webServerInstallPath defaulted to “n\a”
webServerType=IIS: webServerInstallPath defaulted to “n\a”
webServerType=SUNJAVASYSTEM: webServerInstallPath defaulted to “n\a”
webServerType=DOMINO: webServerInstallPath defaulted to “n\a”
webServerType=APACHE: webServerInstallPath defaulted to “n\a”
webServerType=HTTPSERVER_ZOS: webServerInstallPath defaulted to “n\a”
-webServerName webserver_name
Web 服务器的名称。此参数的缺省值为 webserver1。
-webServerOS webserver_operating_system
Web 服务器所驻留的操作系统。有效值包括:Windows、Linux、Solaris、AIX、HP-UX、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 参数一起使用。
[Windows]-winserviceAccountType specifieduser | localsystem
[Windows]为概要文件创建的 Windows 服务的所有者帐户的类型。有效值包括 specifieduser 或 localsystem。值 localsystem 用于在创建概要文件的用户的本地帐户下运行 Windows 服务。此参数的缺省值为 localsystem。

如果值为 specifieduser,那么 winservicePassword 参数是必需的。在未指定的情况下,winserviceUserName 参数缺省为环境的用户名值。

[Windows]-winserviceCheck true | false
[Windows]该值可以是 true 或 false。指定 true 来为概要文件内创建的服务器进程创建 Windows 服务。指定 false 以不创建 Windows 服务。此参数的缺省值为 false。
要点: 借助定制概要文件,您无法使用此参数来创建 Windows 服务。请改为使用 WASService 命令来单独地创建该服务。
[Windows]-winservicePassword winservice_password
[Windows]为将拥有 Windows 服务的指定用户或本地帐户指定密码。
[Windows]-winserviceStartupType manual | automatic | disabled
[Windows]可能的 startup_type 值为:
  • manual
  • automatic
  • disabled

有关 Windows 服务的更多信息,请参阅有关 WASService 命令的文章。

此参数的缺省值为 automatic。

[Windows]-winserviceUserName winservice_user_ID
[Windows]指定用户标识以便 Windows 操作系统可以验证您的标识是否能够创建 Windows 服务。您的用户标识必须属于管理员组,而且具有下列高级用户权限:
  • 作为操作系统的一部分存在
  • 作为服务登录
此参数的缺省值为当前用户名。此参数的值不得包含空格或无效字符(例如 *、?、"、<、>、,、/、\、| 等等)。您指定的用户必须具有适当的许可权才能创建 Windows 服务。您必须为您选择的用户名指定正确的密码。
要点: 在使用指定的用户和密码创建具有 Windows 服务的概要文件时,如果该用户是域用户,那么必须按以下示例所示使用双反斜杠:
winServiceUserName=DOMAIN\\DOMAINUSER
winServicePassword=DOMAINUSERPASSWORD

使用方案

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

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

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

    [Windows]该命令还创建 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
       -winserviceAccountType specifieduser
       -winserviceUserName my_user_id
       -winservicePassword my_password
       -winserviceStartupType manual
       -startingPort 21000
       -personalCertDN "cn=testa, ou=Rochester, o=IBM, c=US"
       -signingCertDN "cn=testc, ou=Rochester, o=IBM, c=US"
       -keyStorePassword ap3n9krw
    [Linux][AIX HP-UX Solaris]
    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
    [IBM i]
    manageprofiles -create
       -profileName Default01 
       -templatePath default 
       -startingPort 21000
       -personalCertDN "cn=testa, ou=Rochester, o=IBM, c=US"
       -signingCertDN "cn=testc, ou=Rochester, o=IBM, c=US"
       -keyStorePassword ap3n9krw

日志

manageprofiles 命令为它创建的每个概要文件创建日志。
  • [AIX Solaris HP-UX Linux Windows]日志位于 app_server_root/logs/manageprofiles 目录中。这些文件以此模式命名:profile_name_create.log。
  • [AIX Solaris HP-UX Linux Windows]命令还为它删除的每个概要文件创建日志。日志位于 app_server_root/logs/manageprofiles 目录中。这些文件以此模式命名:profile_name_delete.log。
  • [IBM i]日志位于 user_data_root/profileRegistry/logs/manageprofiles 目录中。这些文件以此模式命名:profile_name_create.log。
  • [IBM i]命令还为它删除的每个概要文件创建日志。日志位于 user_data_root/profileRegistry/logs/manageprofiles 目录中。这些文件以此模式命名:profile_name_delete.log。

示例:从起始点增加缺省端口号

manageprofiles 命令可以根据起始端口值分配端口号。您可以从命令行使用 -startingPort 参数来提供起始端口值。该命令从起始端口号值开始依次指定端口号。但是,如果该序列中的端口值与指定的现有端口发生冲突,那么会使用下一个可用端口值

端口指定的顺序是任意的。预测指定是不可能的。

例如,用 -startingPort 20002 创建的端口将与以下示例类似那样出现:

应用程序服务器概要文件的已分配端口
WC_defaulthost=20002
WC_adminhost=20003
WC_defaulthost_secure=20004
WC_adminhost_secure=20005
BOOTSTRAP_ADDRESS=20006
SOAP_CONNECTOR_ADDRESS=20007
IPC_CONNECTOR_ADDRESS=20008
SAS_SSL_SERVERAUTH_LISTENER_ADDRESS=20009
CSIV2_SSL_SERVERAUTH_LISTENER_ADDRESS=20010
CSIV2_SSL_MUTUALAUTH_LISTENER_ADDRESS=20011
ORB_LISTENER_ADDRESS=20012
DCS_UNICAST_ADDRESS=20013
SIB_ENDPOINT_ADDRESS=20014
SIB_ENDPOINT_SECURE_ADDRESS=20015
SIB_MQ_ENDPOINT_ADDRESS=20016
SIB_MQ_ENDPOINT_SECURE_ADDRESS=20017
SIP_DEFAULTHOST=20018
SIP_DEFAULTHOST_SECURE=20019

以下示例使用 manageprofiles 命令的 startingPort 参数并从初始值 20002 开始创建端口,附带前面示例中显示的内容:

[Windows]
manageprofiles.bat -create
               -profileName shasti 
               -profilePath G:\shasti\WebSphere 
               -templatePath G:\shasti\WebSphere\profileTemplates\default 
               -nodeName W2K03 
               -cellName W2K03_Cell01
               -hostName planetnt 
               -startingPort 20002 
                            
[Linux][HP-UX][Solaris][AIX]
app_server_root/bin/manageprofiles.sh -create
               -profileName shasti 
               -profilePath app_server_root/profiles/shasti
               -templatePath app_server_root/profileTemplates/default
               -nodeName W2K03 
               -cellName W2K03_Cell01
               -hostName planetnt 
               -startingPort 20002
[IBM i]
app_server_root/bin/manageprofiles -create
               -profileName shasti 
               -profilePath user_data_root/profiles/shasti
               -templatePath app_server_root/profileTemplates/default
               -nodeName W2K03 
               -cellName W2K03_Cell01
               -hostName planetnt 
               -startingPort 20002

示例:使用预定义端口号

如果未明确设置端口值,那么 manageprofiles 命令会推荐一些初始端口值。您可以改为使用预定义端口值。

当未指定 -defaultPorts、-startingPort 或 -portsFile 的选项时,manageprofiles 命令会建议一些端口值。
表 1. 缺省端口值的文件位置.

下表按概要文件类型列示了缺省端口值的文件位置。

概要文件 文件路径
应用程序服务器 app_server_root/profileTemplates/default/actions/portsUpdate/portdef.props
管理代理程序服务器的管理概要文件 app_server_root/profileTemplates/management/actions/portsUpdate/adminagent.portdef.props
要在创建概要文件之前在 portdef.props 文件中定制端口值,请执行下列步骤。以下示例创建缺省概要文件。对于其他类型的概要文件,必须用要创建的概要文件的文件路径替代示例中的文件路径。
  1. 将 app_server_root/profileTemplates/default/actions/portsUpdate/portdef.props 文件从缺省概要文件模板路径复制到诸如以下各项之类的任意临时目录中:
    • [Windows]c:\temp\ports
    • [AIX HP-UX Solaris][IBM i]/temp/ports
  2. 在新文件中,修改端口设置以指定您的端口值。
  3. 使用 manageprofiles 命令来创建概要文件。使用已修改的端口值。在 -portsFile 参数上指定已修改的 portdef.props 文件的位置。指定 -validatePorts 参数以确保端口不是保留的或未在使用。请将以下示例用作指南:
    [Windows]
    manageprofiles.bat 
       -create
       -profileName Wow_Profile 
       -profilePath profile_root
       -templatePath app_server_root\profileTemplates\default 
       -nodeName Wow_node 
       -cellName Wow_cell
       -hostName lorriemb 
       -portsFile C:\temp\ports\portdef.props 
       -validatePorts
    [AIX][Linux]
    manageprofiles.sh 
       -create
       -profileName Wow_Profile 
       -profilePath profile_root
       -templatePath app_server_root\profileTemplates\default 
       -nodeName Wow_node 
       -cellName Wow_cell
       -hostName lorriemb 
       -portsFile \temp\ports\portdef.props   -validatePorts
    [IBM i]
    manageprofiles   -create
       -profileName Wow_Profile 
       -profilePath profile_root
       -templatePath app_server_root\profileTemplates\default 
       -nodeName Wow_node 
       -cellName Wow_cell
       -hostName lorriemb 
       -portsFile \temp\ports\portdef.props   -validatePorts
假设 portdef.props 文件具有以下值:
WC_defaulthost=39080
WC_adminhost=39060
WC_defaulthost_secure=39443
WC_adminhost_secure=39043
BOOTSTRAP_ADDRESS=32809
SOAP_CONNECTOR_ADDRESS=38880
IPC_CONNECTOR_ADDRESS=39633
SAS_SSL_SERVERAUTH_LISTENER_ADDRESS=39401
CSIV2_SSL_SERVERAUTH_LISTENER_ADDRESS=39403
CSIV2_SSL_MUTUALAUTH_LISTENER_ADDRESS=39402
ORB_LISTENER_ADDRESS=39100
DCS_UNICAST_ADDRESS=39353
SIB_ENDPOINT_ADDRESS=37276
SIB_ENDPOINT_SECURE_ADDRESS=37286
SIB_MQ_ENDPOINT_ADDRESS=35558
SIB_MQ_ENDPOINT_SECURE_ADDRESS=35578
SIP_DEFAULTHOST=35060
SIP_DEFAULTHOST_SECURE=35061

在运行 manageprofiles 命令以使用用户定义的端口值创建概要文件之后,会显示一个成功或失败的结果。

[IBM i]注: 成功创建概要文件后,控制台将输出一条消息,指示创建成功并建议您检查 AboutThisProfile.txt 文件。但是,在 IBM i 上创建客户机概要文件或插件概要文件时,不会生成 AboutThisProfile.txt 文件。

manageprofiles 命令在 profile_root\properties 目录中创建当前 portdefs.props 文件的副本。

请仅将 -startingPort、-defaultPorts 或 -portsFile 这三个端口值参数中的一个用于 manageprofiles 命令。这三个参数是互斥的。


指示主题类型的图标 参考主题



时间戳记图标 最近一次更新时间: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-base-dist&topic=rxml_manageprofiles
文件名:rxml_manageprofiles.html