manageprofiles 命令
使用 manageprofiles 命令来创建、删除、扩充、备份和复原概要文件,概要文件定义运行时环境。使用概要文件取代多个产品安装可节省磁盘空间并简化产品更新,这是因为只需维护单组核心产品文件。
manageprofiles 命令及其图形用户界面“Profile Management Tool”是创建运行时环境的唯一方法。
命令文件位于 app_server_root/bin 目录。命令文件是名为 manageprofiles 的脚本。
语法
app_server_root\bin\manageprofiles.bat -augment -help
根据要通过 manageprofiles 命令执行的操作,您需要提供下列其中一个或多个参数。命令行工具验证是否提供了必需参数以及对这些参数输入的值是否有效。请确保以正确的大小写形式输入这些参数的名称,因为命令行工具不会验证参数名称的大小写情况。如果输入的参数的大小写不正确,那么可能导致错误的结果。
app_server_root/bin/manageprofiles.sh -create
-profileName profile_name -profilePath profile_root
-templatePath template_path
参数
下列选项可用于 manageprofiles 命令:
- 为使用 -adminUserName 参数指定的管理安全性用户标识指定密码。
- 指定用于管理安全性的用户标识。
- 指定与环境(应用程序服务器将在其中运行)的类型匹配度最高的性能调整设置。
此参数仅对缺省概要文件模板有效。
- 标准设置是针对常规用途进行优化的现有标准缺省配置设置。
- 峰值性能设置针对生产环境进行优化,在生产环境中极少进行应用程序更改并且最佳运行时性能很重要。
- 开发设置针对开发环境进行优化,在开发环境中需要经常执行应用程序更新并且系统资源最少。要点: 请不要对生产服务器使用开发设置。
如果不指定带有 -applyPerfTuningSetting 参数的选项,那么缺省值为 standard。
如果同时指定 -isDeveloperServer 和 -applyPerfTuningSetting 参数,那么根据为 -applyPerfTuningSetting 选择的选项,-applyPerfTuningSetting 可能会覆盖 -isDeveloperServer。
- 指定要联合至单元的应用程序服务器的节点名。创建单元的 Deployment Manager 部分及创建单元的应用程序服务器部分时,请指定此参数。
- 使用 augment 参数以通过扩充模板对现有概要文件进行更改。augment 参数导致 manageprofiles 命令使用 -templatePath
参数中的模板更新或扩充在 -profileName 参数中标识的概要文件。可以使用的扩充模板由环境中安装的
IBM® 产品及版本确定。要点: WebSphere® Application Server Network Deployment 产品附带的模板只能用于创建概要文件,而不能用于扩充现有概要文件,因为该产品仅提供了创建模板。
此外,不要手动修改 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 参数。
- 将概要文件注册表文件备份到指定的文件。您必须为 backupFile_name 提供标准文件路径。
- 对概要文件文件夹和概要文件注册表文件中的概要文件元数据执行文件系统备份。在调用带 -backupProfile
选项的 manageprofiles 命令之前,必须首先停止任何正在使用要备份的概要文件的服务器。-backupProfile
参数必须与 -backupFile 和 -profileName 参数一起使用,例如:
manageprofiles(.bat)(.sh) -backupProfile -profileName profile_name -backupFile backupFile_name
在使用 -backupProfile 选项备份概要文件时,必须先停止服务器和正在运行的进程(这些进程属于您想要备份的概要文件)。
- 指定概要文件的单元名。请对每个概要文件使用唯一单元名。
避免故障: 请使用唯一名称,即使您计划将定制概要文件或独立概要文件联合到一个 Deployment Manager 单元也是如此。联合要求单元名是唯一的,然后它才能生成 Deployment Manager 单元的节点部分。如果该产品在同一物理机器或机器集群(例如综合系统)上运行,那么单元名必须是唯一的。此外,如果需要在实体之间建立网络连接(在单元之间建立网络连接或者从必须与每个单元通信的客户机建立网络连接),那么单元名也必须是唯一的。如果单元名的名称空间为联合名称空间,那么单元名也必须是唯一的。否则,可能会出现诸如 javax.naming.NameNotFoundException 错误之类的症状,在这种情况下,请创建名称唯一的单元。gotcha
这是一个可选参数。如果您省略该参数,那么将指定缺省单元名。
此参数的缺省值基于短主机名、常量单元和尾随数字的组合,如下所示:此参数的值不得包含空格或任何无效字符(例如 *、?、"、<、>、,、/、\、| 等等)。
- 创建概要文件。指定 manageprofiles -create -templatePath fully_qualified_file_path_to_template -help 以获取关于创建概要文件的特定信息。可用的模板包括:
- 打开 manageprofiles 命令使用的 Ant 实用程序的调试功能。
- 一个可选参数,用于指定缺省个人证书有效的时间量(以年计)。如果未将此参数与 -personalCertDN 参数一起指定,那么缺省个人证书有效的时间为一年。
- 对概要文件指定缺省端口值或基本端口值。
不要在使用 -startingPort 或 -portsFile 参数时使用此参数。
在创建概要文件时,如果您未指定 -startingPort 参数、-defaultPorts 参数或 -portsFile 参数,那么 manageprofiles 命令使用一组自动生成的建议端口。根据缺省端口的可用性,建议的端口值可与缺省端口值不同。
切记: 如果您要使用受管概要文件模板,那么请不要使用此参数。 - 删除概要文件。
删除概要文件不会删除概要文件目录。例如,假定您在 /usr/WebSphere/AppServer/profiles/managedProfile 目录中创建一个概要文件。在您删除概要文件之后,该目录仍然存在。
您可以删除或保留该目录。然而,profile_root/logs 目录包含关于卸载概要文件的信息。例如,您可以保留 _nodeuninst.log 文件以确定在卸载过程中发生的任何问题的原因。
如果您在概要文件注册表中删除某个概要文件,而该概要文件已有扩充模板向它注册,那么会自动执行取消扩充操作。
避免故障: 如果要删除已迁移的旧节点,请先关闭新迁移的 Deployment Manager,然后再删除旧节点。这将确保不会从新迁移的单元中意外除去新迁移的节点。gotcha
- 删除所有已注册的概要文件。
删除概要文件不会删除概要文件目录。例如,假定您在 /usr/WebSphere/AppServer/profiles/managedProfile 目录中创建一个概要文件。在您删除概要文件之后,该目录仍然存在。
您可以删除或保留该目录。然而,profile_root/logs 目录包含关于卸载概要文件的信息。例如,您可以保留 _nodeuninst.log 文件以确定在卸载过程中发生的任何问题的原因。
如果您在概要文件注册表中删除某个概要文件,而该概要文件已有扩充模板向它注册,那么会自动执行取消扩充操作。
- 如果正在联合节点,那么当对 Deployment Manager 启用了管理安全性时为该 Deployment Manager 指定有效用户名。请将此参数与 -dmgrAdminUserName 参数和 -federateLater 参数配合使用。
- 如果正在联合节点,那么当对 Deployment Manager 启用了管理安全性时为该 Deployment Manager 指定有效密码。请将此参数与 -dmgrAdminPassword 参数和 -federateLater 参数配合使用。
- 标识正在运行 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 的连接也必须可用。
- 标识 Deployment Manager 的 SOAP 端口。指定此参数和 dmgrHost 参数在创建时联合定制概要文件。Deployment Manager 必须在运行中并且可访问。
如果已启用安全性或已更改缺省 Java™ 管理扩展 (JMX) 连接器类型,那么无法使用 manageprofiles 命令进行联合。请使用 addNode 命令替代。
此参数的缺省值为 8879。在与 dmgrHost 参数一起使用时,您指示的端口必须为正整数且与 Deployment Manager 的连接必须可用。
- 指定单元的 Deployment Manager 部分的概要文件路径。创建单元的应用程序服务器部分时,请指定此参数。
- 启用管理安全性。有效值包括 true 或 false。缺省值为 false。
- 当 enableAdminSecurity 设置为 true 时,您还必须指定参数 -adminUserName 和 -adminPassword 以及这些参数的值。
您无法使用 -enableAdminSecurity 参数来为定制概要文件启用管理安全性。要为定制概要文件启用安全性,定制概要文件必须联合到 Deployment Manager。要为联合定制概要文件启用安全性,必须为 Deployment Manager 启用管理安全性。
允许创建 Linux 服务。有效值包括 true 或 false。此参数的缺省值为 false。
在 -enableService 选项设置为 true 的情况下运行 manageprofiles 命令时,如果该命令由 root 用户运行,那么会随概要文件创建 Linux 服务。当非 root 用户运行 manageprofiles 命令时,会创建概要文件,但不会创建 Linux 服务。因为非 root 用户没有足够的许可权来设置 Linux 服务,所以不会创建该服务。在概要文件创建结束时会显示 INSTCONPARTIALSUCCESS 结果,并且概要文件创建日志 app_server_root/logs/manageprofiles_create_profilename.log 包含一条消息,指示当前用户没有足够的许可权来设置 Linux 服务。
- 指示是在概要文件创建期间联合受管概要文件,还是稍后使用 addNode 命令联合它。如果 dmgrHost、dmgrPort、dmgrAdminUserName 和 dmgrAdminPassword 参数没有值,那么此参数的缺省值为 true。有效值包括 true 或 false。
- 返回缺省概要文件的名称。
- 获取给定名称的概要文件的文件系统位置。需要 –profileName 参数。
- 获取以给定的 -profilePath 参数注册的概要文件的名称。
- 显示命令语法。
- 指定您创建概要文件的主机名。这应该与您在初始产品安装过程中指定的主机名相匹配。此参数的缺省值为长格式的域名系统。此参数的值必须为有效的 IPv6 主机名,并且不得包含空格或任何无效字符(例如 *、?、"、<、>、,、/、\、| 等等)。
- 这是一个可选参数,它与 -templatePath 参数一起用来取消扩充已经扩充的特定概要文件。请参阅 -unaugment 参数。
- 指定当创建概要文件时用来导入个人证书的密钥库文件的路径。该个人证书是服务器的缺省个人证书。-importPersonalCertKS 参数与 -personalCertDN 参数互斥。如果未特地创建或导入个人证书,那么在缺省情况下会创建一个个人证书。
最佳实践: 将个人证书导入为缺省个人证书时,请导入签署该个人证书的根证书。 否则,manageprofiles 命令会将个人证书的公用密钥添加至 trust.p12 文件并创建根签名证书。bprac
当指定任何以 -importPersonal 开始的参数时,必须指定所有的此类参数。
- 指定对 -importPersonalCertKS 参数指定的密钥库文件中证书的别名。该证书被添加至服务器缺省密钥库文件,并且用作服务器缺省个人证书。
当指定任何以 -importPersonal 开始的参数时,必须指定所有的此类参数。
- 指定对 -importPersonalCertKS 参数指定的密钥库文件的密码。
当指定任何以 -importPersonal 开始的参数时,必须指定所有的此类参数。
- 指定对 -importPersonalCertKS 参数指定的密钥库文件的类型。值可能为
JCEKS、CMSKS、PKCS12、PKCS11
和 JKS。但是,此列表可根据 java.security 文件中的提供程序更改。
当指定任何以 -importPersonal 开始的参数时,必须指定所有的此类参数。
- 指定当创建概要文件时用来导入根证书的密钥库文件的路径。该根证书是用作服务器缺省根证书的证书。-importSigningCertKS
参数与 -signingCertDN 参数互斥。如果未特地创建或导入根签名证书,那么在缺省情况下会创建一个根签名证书。
当指定任何以 -importSigning 开始的参数时,必须指定所有的此类参数。
- 指定对 -importSigningCertKS 参数指定的密钥库文件中证书的别名。该证书被添加至服务器缺省根密钥库,并且用作服务器缺省根证书。
当指定任何以 -importSigning 开始的参数时,必须指定所有的此类参数。
- 指定对 -importSigningCertKS 参数指定的密钥库文件的密码。
当指定任何以 -importSigning 开始的参数时,必须指定所有的此类参数。
- 指定对 -importSigningCertKS 参数指定的密钥库文件的类型。有效值可能为
JCEKS、CMSKS、PKCS12、PKCS11
和 JKS。但是,此列表可根据 java.security 文件中的提供程序更改。
当指定任何以 -importSigning 开始的参数时,必须指定所有的此类参数。
- 指定由一起使用的 -profileName 参数标识的概要文件在注册后将成为缺省概要文件。当发出针对缺省概要文件的命令时,那么不必使用命令的 -profileName 属性。
- 指定服务器仅用于开发目的。将应用程序部署到其生产应用程序服务器上之前,创建概要文件以便在非生产服务器上测试应用程序时,此参数很有用。
此参数仅对缺省概要文件模板有效。
如果同时指定 -isDeveloperServer 和 -applyPerfTuningSetting 参数,那么根据为 -applyPerfTuningSetting 选择的选项,-applyPerfTuningSetting 可能会覆盖 -isDeveloperServer。
- 指定要对概要文件创建期间创建的所有密钥库文件使用的密码。密钥库文件是为缺省个人证书和根签名证书创建的。
- 列出对概要文件注册表中概要文件的已注册扩充。必须将 -profileName 参数与 -listAugments 参数一起指定。
- 列示概要文件注册表中的概要文件。
- 在结合单元模板创建概要文件时定义端口集。如果指定此选项,那么不能同时指定 -nodePortsFile 或 nodeStartingPort 选项。
- 指定用新概要文件创建的节点的节点名。请在单元内或机器上使用唯一值。每个共享同一个产品二进制文件集的概要文件必须具有唯一节点名。此参数的缺省值基于短主机名、概要文件类型和尾随数字,如下所示:
此参数的值不得包含空格或任何无效字符(例如 *、?、"、<、>、,、/、\、| 等等)。
- 为单元中您要创建的节点部分指定端口。如果指定此选项,那么不能同时指定 -nodeDefaultPorts 或 -nodeStartingPort 选项。
- 指定单元的节点部分的概要文件路径。创建单元的 Deployment Manager 部分时,请指定此参数。
- 排除概要文件功能的可选参数。每个概要文件模板都预定义了某些可选功能。以下可选功能可与以下概要文件模板的 -omitAction 参数一起使用:
- 指定当创建概要文件时创建的个人证书的专有名称。指定以引号引起来的专有名称。此缺省个人证书位于服务器密钥库文件中。-importPersonalCertKSType 参数与 -personalCertDN 参数互斥。请参阅 -personalCertValidityPeriod 参数和 -keyStorePassword 参数。
- 指定文件路径的可选参数,该文件定义新概要文件的端口设置。
不要在使用 -startingPort 或 -defaultPorts 参数时使用此参数。
在创建概要文件时,如果您未指定 -startingPort 参数、-defaultPorts 参数或 -portsFile 参数,那么 manageprofiles 命令使用一组自动生成的建议端口。根据缺省端口的可用性,建议的端口值可与缺省端口值不同。
- 指定概要文件的名称。创建概要文件时使用唯一值。每个共享同一个产品二进制文件集的概要文件必须具有唯一名称。缺省概要文件名称基于概要文件类型和一个尾随数字,例如:
其中<profile_type><profile_number>
此参数的值不得包含空格或任何无效字符(例如 *、?、"、<、>、,、/、\、| 等等)。
不能选择已被使用的概要文件名称。
- 指定概要文件的标准路径(称为 profile_root)。指定完整路径以避免由于 Ant 脚本编制限制而导致在将概要文件联合到单元时发生故障。例如:
-profilePath profile_root
如果标准路径包含空格,那么将该值包括在引号中。
缺省值基于 app_server_root 目录、概要文件子目录和概要文件的名称。
例如,缺省值为:
WS_WSPROFILE_DEFAULT_PROFILE_HOME 元素定义于 app_server_root/properties 目录下的 wasprofile.properties 文件中。WS_WSPROFILE_DEFAULT_PROFILE_HOME/profileName
注: wasprofile.properties 文件包括下列属性:- WS_CMT_PI_MODPERMS
- 此属性指定安装后处理程序是否应该修改它所创建的任何文件的许可权。有效值为 true 或 false。所有其他值都缺省为 false。从文件中除去此属性也将导致它缺省为
false。设置为 false
后,安装后处理程序创建的所有文件都具有基于系统的 umask 设置的许可权。
此参数的值必须是目标系统的有效路径且当前未被使用。
您必须具有写入该目录的许可权。
- 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(如果您以吉字节为单位指定值)。
避免故障: 因为所指定的值区分大小写,所以所指定的值中包括的字母必须为大写字母。gotcha
- 您可以指定希望后安装程序将日志保留的时间量。所指定的值可以是 1 到 999 之间的任何整数,后面接着以下单位:
- D(如果您以“日”为单位指定值)。
- W(如果您以“星期”为单位指定值)。
- M(如果您以“月”为单位指定值)。
- Y(如果您以“年”为单位指定值)。
避免故障: 因为所指定的值区分大小写,所以所指定的值中包括的字母必须为大写字母。gotcha
- 您可以指定一个特定日期,在此日期之后就会删除日志。必须使用数值来指定此值,数值之间用短划线分隔,格式为 DD-MM-YYYY。例如,如果您指定 WS_CMT_PI_LOGS=12-31-2013,那么会在 2013 年 12 月 31 日删除所有日志。
避免故障: 如果您未按所指示的格式指定值(数值之间用短划线分隔),那么会忽略此属性设置。gotcha
- 使用 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 操作系统中路径语句可以使用正斜杠 (/) 或反斜杠 (\)。如果路径语句使用反斜杠,那么响应文件需要使用双反斜杠才能正确标识路径。以下是使用双反斜杠的创建操作的响应文件示例:
create templatePath=C:\\WebSphere\\AppServer\\profileTemplates\\default
最佳实践: 使用正斜杠可以降低在平台之间进行切换时发生错误的可能性bprac
- 指定值时,请不要在值的开头或结尾指定双引号 (") 字符,即使该值包含空格也是如此。
- 要点: manageProfiles -restoreProfile 命令仅支持在相同修订包级别创建的备份。恢复概要文件备份。必须与 -backupFile 参数一起使用,例如:
manageprofiles(.bat)(.sh) -restoreProfile -backupFile file_name
要恢复概要文件,请执行下列步骤: - 为安全代理服务器指定初始安全性级别设置。有效值为低、中和高。缺省值为高。安全性级别基于启动用户许可权、路由注意事项、管理选项以及错误处理。可以选择在创建安全代理服务器概要文件之后更改安全性设置。
- 指定服务器的名称。仅对缺省模板和安全代理模板指定此参数。如果当使用缺省模板或安全代理模板时未指定此参数,那么缺省服务器名称是 server1(对于缺省概要文件)以及 proxy1(对于安全代理概要文件)。
- 指定管理概要文件的类型。对于 Deployment Manager 服务器、管理代理程序服务器和作业管理器服务器,请分别指定 DEPLOYMENT_MANAGER、ADMIN_AGENT 和 JOB_MANAGER。当创建管理概要文件时,此参数是必需的。
指定在创建 Linux 服务期间使用的用户标识,以便 Linux 服务通过此用户标识运行。无论此用户标识何时登录,Linux 服务都会运行。
- 将缺省概要文件设置为现有概要文件中的一个。必须与 -profileName
参数一起使用,例如:
manageprofiles(.bat)(.sh) -setDefaultName -profileName profile_name
- 指定当创建概要文件时创建的根签名证书的专有名称。指定以引号引起来的专有名称。此缺省个人证书位于服务器密钥库文件中。-importSigningCertKS 参数与 -signingCertDN 参数互斥。如果未特地创建或导入根签名证书,那么在缺省情况下会创建一个根签名证书。请参阅 -signingCertValidityPeriod 参数和 -keyStorePassword 参数。
- 一个可选参数,用于指定根签名证书有效的时间量(以年计)。如果未将此参数与 -signingCertDN 参数一起指定,那么根签名证书的有效期限为 15 年。
- 指定为概要文件生成和指定所有端口时使用的起始端口号。
端口值是从 -startingPort 值开始依次指定的,但是要省略已经在使用的那些端口值。系统标识并解析当前正在使用的端口,并确定端口分配以避免端口冲突。
不要将此参数与 -defaultPorts 或 -portsFile 参数一起使用。
在创建概要文件时,如果您未指定 -startingPort 参数、-defaultPorts 参数或 -portsFile 参数,那么 manageprofiles 命令使用一组自动生成的建议端口。根据缺省端口的可用性,建议的端口值可与缺省端口值不同。
注意: 如果您要使用受管概要文件模板,那么请不要使用此参数。 - 指定对用于进行代理请求的安全代理服务器有效的协议。有效值为 SIP、HTTP 和 HTTP,SIP。
- 指定安装根目录中模板文件的目录路径。profileTemplates 目录包含对应于不同概要文件类型的各种目录,并且这些目录随所安装产品的类型而异。这些概要文件目录是您在使用 -templatePath 选项时指示的路径。可指定不在安装根目录中的概要文件模板(如果碰巧有的话)。
如果概要文件模板相对于 app_server_root/profileTemplates 目录,那么可以为 -templatePath 参数指定一个相对路径。否则,指定一个标准模板路径。F
“概要文件概念”主题中描述了可用的模板。
- 扩充是指使用扩充模板更改现有概要文件的能力。要取消扩充一个已经扩充的概要文件,必须指定 -unaugment 参数和 -profileName 参数。如果执行了一系列 manageprofiles 扩充,并且您仅指定了这两个参数来取消扩充概要文件,那么取消扩充操作将首先撤销最后的扩充操作。
要取消扩充已经扩充的特定概要文件,还需要指定 -ignoreStack 参数和 -templatePath 参数。通常,您将不取消扩充特定概要文件,因为您必须确保没有违反概要文件模板依赖性。
使用 -templatePath 参数时,请对该参数指定标准文件路径。
另请参阅 augment 参数。
- 对已通过特定扩充模板来扩充的所有概要文件取消扩充。-templatePath 参数必须与 -unaugmentAll 参数一起使用。
使用 -templatePath 参数时,请对该参数指定标准文件路径。
(可选)将 -unaugmentDependents 参数与 -unaugmentAll 参数一起指定,以对要取消扩充的概要文件必备的所有概要文件取消扩充。
注: 如果在不具有任何已通过概要文件模板扩充的概要文件时使用此参数,那么可能会发生错误。另请参阅 augment 参数。
- 如果指定了此参数,那么它会对要使用 -unaugmentAll 参数取消扩充的概要文件必备的所有已扩充概要文件执行取消扩充操作。如果未指定此参数,那么它不会对要取消扩充的概要文件必备的已扩充概要文件执行取消扩充操作。
请将 -unaugmentDependents 参数与 -unaugmentAll 参数一起指定。
- 检查概要文件注册表中列出的所有概要文件,以查看文件系统中是否存在这些概要文件。从注册表除去任何缺少的概要文件。返回从注册表删除的缺少的概要文件列表。
- 检查端口以验证端口是否是保留的端口或是否在使用。 此参数帮助您标识未被使用的端口。如果确定端口已被使用,那么概要文件创建操作会停止并显示一条错误消息。在创建命令行时,您可以在任何时候使用此参数。建议将此参数与 –portsFile 参数配合使用。
- 检查概要文件注册表中列出的所有概要文件,以查看文件系统中是否存在这些概要文件。返回缺少的概要文件的列表。
- 指示是否要设置 Web 服务器定义。有效值包括 true 或 false。此参数的缺省值为 false。
- 服务器的主机名。此参数的缺省值为本地机器的长主机名。
- Web 服务器的本地或远程安装路径。此参数的缺省值取决于本地机器的操作系统和 webServerType 参数的值。例如:
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”
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”
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”
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”
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”
- Web 服务器的名称。此参数的缺省值为 webserver1。
- Web 服务器所驻留的操作系统。有效值包括:Windows、Linux、Solaris、AIX、HP-UX、OS390 和 OS400。请将此参数与 webServerType 参数一起使用。
- Web 服务器使用的插件的路径。此参数的缺省值为 WAS_HOME/plugins。
- 指示访问 Web 服务器时将使用的端口。此参数的缺省值为 80。
- Web 服务器的类型。有效值包括:IHS、SUNJAVASYSTEM、IIS、DOMINO、APACHE 和 HTTPSERVER_ZOS。请将此参数与 webServerOS 参数一起使用。
为概要文件创建的 Windows 服务的所有者帐户的类型。有效值包括 specifieduser 或 localsystem。值 localsystem 用于在创建概要文件的用户的本地帐户下运行 Windows 服务。此参数的缺省值为 localsystem。
如果值为 specifieduser,那么 winservicePassword 参数是必需的。在未指定的情况下,winserviceUserName 参数缺省为环境的用户名值。
该值可以是 true 或 false。指定 true 来为概要文件内创建的服务器进程创建 Windows 服务。指定 false 以不创建 Windows 服务。此参数的缺省值为 false。
要点: 借助定制概要文件,您无法使用此参数来创建 Windows 服务。请改为使用 WASService 命令来单独地创建该服务。为将拥有 Windows 服务的指定用户或本地帐户指定密码。
可能的 startup_type 值为:
有关 Windows 服务的更多信息,请参阅有关 WASService 命令的文章。
此参数的缺省值为 automatic。
指定用户标识以便 Windows 操作系统可以验证您的标识是否能够创建 Windows 服务。您的用户标识必须属于管理员组,而且具有下列高级用户权限:
要点: 在使用指定的用户和密码创建具有 Windows 服务的概要文件时,如果该用户是域用户,那么必须按以下示例所示使用双反斜杠:winServiceUserName=DOMAIN\\DOMAINUSER winServicePassword=DOMAINUSERPASSWORD
使用方案
下列示例说明了正确的语法。请在一行上发出以下任何示例中的命令。每个示例都以多行显示命令来增加可读性。
日志
示例:创建 Deployment Manager 概要文件
在安装核心产品文件之后,可以创建 Deployment Manager 概要文件。Deployment Manager 为一台或多台机器上的一组逻辑应用程序服务器提供了单一管理界面。使用 manageprofiles.sh -create 命令来创建 Deployment Manager 概要文件。
要创建名为 shasti 的 Deployment Manager 概要文件,请执行以下操作:
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
manageprofiles.sh -create
-profileName shasti
-profilePath /shasti/WebSphere
-templatePath /opt/IBM/WebSphere/AppServer/profileTemplates/management
-serverType DEPLOYMENT_MANAGER
-cellName cell1
-hostName planetaix
-nodeName dmgr1
![[Windows]](../images/windows.gif)
manageprofiles.bat -create
-profileName shasti
-profilePath C:\shasti\WebSphere
-templatePath C:\IBM\WebSphere\AppServer\profileTemplates\management
-serverType DEPLOYMENT_MANAGER
-cellName cell1
-hostName planetnt
-nodeName dmgr1
如果您在概要文件创建期间未指定某个端口选项,那么将使用一组建议的端口值。端口冲突解决算法确定这些端口。建议的这组端口一定是没有冲突的。如果要使用 IBM 缺省端口,请在创建概要文件时使用 -defaultPorts 选项。
示例:从起始点增加缺省端口号
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
OVERLAY_UDP_LISTENER_ADDRESS=20020
OVERLAY_TCP_LISTENER_ADDRESS=20021
WC_defaulthost=20002
WC_defaulthost_secure=20003
BOOTSTRAP_ADDRESS=20004
SOAP_CONNECTOR_ADDRESS=20005
IPC_CONNECTOR_ADDRESS=20006
SAS_SSL_SERVERAUTH_LISTENER_ADDRESS=20007
CSIV2_SSL_SERVERAUTH_LISTENER_ADDRESS=20008
CSIV2_SSL_MUTUALAUTH_LISTENER_ADDRESS=20009
ORB_LISTENER_ADDRESS=20010
DCS_UNICAST_ADDRESS=20011
SIB_ENDPOINT_ADDRESS=20012
SIB_ENDPOINT_SECURE_ADDRESS=20013
SIB_MQ_ENDPOINT_ADDRESS=20014
SIB_MQ_ENDPOINT_SECURE_ADDRESS=20015
SIP_DEFAULTHOST=20016
SIP_DEFAULTHOST_SECURE=20017
NODE_MULTICAST_DISCOVERY_ADDRESS=20018
NODE_IPV6_MULTICAST_DISCOVERY_ADDRESS=20019
NODE_DISCOVERY_ADDRESS=20020
NODE_DCS_UNICAST_ADDRESS=20021
NODE_BOOTSTRAP_ADDRESS=20022
NODE_SOAP_CONNECTOR_ADDRESS=20023
NODE_ORB_LISTENER_ADDRESS=20024
NODE_SAS_SSL_SERVERAUTH_LISTENER_ADDRESS=20025
NODE_CSIV2_SSL_MUTUALAUTH_LISTENER_ADDRESS=20026
NODE_CSIV2_SSL_SERVERAUTH_LISTENER_ADDRESS=20027
NODE_IPC_CONNECTOR_ADDRESS=20028OVERLAY_UDP_LISTENER_ADDRESS=20029
OVERLAY_TCP_LISTENER_ADDRESS=20030
NODE_XDAGENT_PORT=20031
NODE_OVERLAY_UDP_LISTENER_ADDRESS=20032
NODE_OVERLAY_TCP_LISTENER_ADDRESS=20033
WC_adminhost=20002
WC_adminhost_secure=20003BOOTSTRAP_ADDRESS=20004
SOAP_CONNECTOR_ADDRESS=20005
IPC_CONNECTOR_ADDRESS=20006
SAS_SSL_SERVERAUTH_LISTENER_ADDRESS=20007
CSIV2_SSL_SERVERAUTH_LISTENER_ADDRESS=20008
CSIV2_SSL_MUTUALAUTH_LISTENER_ADDRESS=20009
ORB_LISTENER_ADDRESS=20010
CELL_DISCOVERY_ADDRESS=20011
DCS_UNICAST_ADDRESS=20012
XDAGENT_PORT=20013
OVERLAY_UDP_LISTENER_ADDRESS=20014
OVERLAY_TCP_LISTENER_ADDRESS=20015
STATUS_LISTENER_ADDRESS=20016
WC_adminhost=20002
WC_adminhost_secure=20003BOOTSTRAP_ADDRESS=20004
SOAP_CONNECTOR_ADDRESS=20005
IPC_CONNECTOR_ADDRESS=20006
SAS_SSL_SERVERAUTH_LISTENER_ADDRESS=20007
CSIV2_SSL_SERVERAUTH_LISTENER_ADDRESS=20008
CSIV2_SSL_MUTUALAUTH_LISTENER_ADDRESS=20009
ORB_LISTENER_ADDRESS=20010
CELL_DISCOVERY_ADDRESS=20011
DCS_UNICAST_ADDRESS=20012
DataPowerMgr_inbound_secure=20013
XDAGENT_PORT=20014
OVERLAY_UDP_LISTENER_ADDRESS=20015
OVERLAY_TCP_LISTENER_ADDRESS=20016
STATUS_LISTENER_ADDRESS=20017
WC_adminhost=20002
WC_adminhost_secure=20003BOOTSTRAP_ADDRESS=20004
SOAP_CONNECTOR_ADDRESS=20005
IPC_CONNECTOR_ADDRESS=20006
SAS_SSL_SERVERAUTH_LISTENER_ADDRESS=20007
CSIV2_SSL_SERVERAUTH_LISTENER_ADDRESS=20008
CSIV2_SSL_MUTUALAUTH_LISTENER_ADDRESS=20009
ORB_LISTENER_ADDRESS=20010
STATUS_LISTENER_ADDRESS=20011
WC_adminhost=20002
WC_adminhost_secure=20003BOOTSTRAP_ADDRESS=20004
SOAP_CONNECTOR_ADDRESS=20005
IPC_CONNECTOR_ADDRESS=20006
SAS_SSL_SERVERAUTH_LISTENER_ADDRESS=20007
CSIV2_SSL_SERVERAUTH_LISTENER_ADDRESS=20008
CSIV2_SSL_MUTUALAUTH_LISTENER_ADDRESS=20009
ORB_LISTENER_ADDRESS=20010
PROXY_HTTP_ADDRESS=20002
PROXY_HTTPS_ADDRESS=20003
PROXY_SIP_ADDRESS=20004
PROXY_SIPS_ADDRESS=20005
IPC_CONNECTOR_ADDRESS=20006
以下示例使用 manageprofiles 命令的 startingPort 参数并从初始值 20002 开始创建端口,附带前面示例中显示的内容:
![[Windows]](../images/windows.gif)
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]](../images/linux.gif)
![[HP-UX]](../images/hpux.gif)
![[Solaris]](../images/solaris.gif)
![[AIX]](../images/aixlogo.gif)
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
示例:创建单元概要文件
要使用 manageprofiles 命令来创建单元概要文件,必须使用两个不同的 manageprofiles 命令行调用来为 Deployment Manager 服务器创建单元管理概要文件以及单元节点概要文件。这两个概要文件的组合就是单元概要文件。
两个模板用来创建单元概要文件:cell_dmgr 和 cell_node。在这两个调用中将链接这些模板,并且某些参数必须在创建参数之间是匹配的。请验证这些调用是否匹配。
从命令行,您可以按任何顺序或在任何时间创建单元的两个组成部分。最好的做法是首先创建概要文件的 Deployment Manager 部分。在您创建单元之后,该单元包含 Deployment Manager 和联合节点。Deployment Manager 部分和节点部分位于不同目录中。
对于创建的这两个概要文件的其中每一个,您都可以使用 -profilePath 参数来指定所产生概要文件的标准路径。如果未指定该参数,那么每个概要文件路径的缺省值都基于 app_server_root 目录、概要文件子目录和概要文件的名称。
组成单元概要文件的两个模板相互之间具有依赖性,这要求某些参数值在两个创建调用之间匹配。要创建一个完整的工作单元,cell_dmgr 概要文件和 cell_node 概要文件的 -nodeProfilePath、-cellName、-appServerNodeName、-nodeName 参数必须具有相同值。对于端口尤其是动态分配的端口来说,创建单元的另一半必须引用在单元的第一半中使用的端口。将 -portsFile 和 -nodePortsFile 参数与对概要文件(表示单元的第一半)的以下文件的引用配合使用:
![[Linux]](../images/linux.gif)
![[HP-UX]](../images/hpux.gif)
![[Solaris]](../images/solaris.gif)
![[AIX]](../images/aixlogo.gif)
![[Windows]](../images/windows.gif)
要在创建单元概要文件时获取详细的帮助,请使用下列命令:
![[Linux]](../images/linux.gif)
![[HP-UX]](../images/hpux.gif)
![[Solaris]](../images/solaris.gif)
![[AIX]](../images/aixlogo.gif)
app_server_root/bin/manageprofiles.sh -create
-templatePath
app_server_root/profileTemplates/cell/dmgr
-help
![[Windows]](../images/windows.gif)
app_server_root\bin\manageprofiles.bat -create
-templatePath
app_server_root\profileTemplates\cell\dmgr
-help
或者
![[Linux]](../images/linux.gif)
![[HP-UX]](../images/hpux.gif)
![[Solaris]](../images/solaris.gif)
![[AIX]](../images/aixlogo.gif)
app_server_root/bin/manageprofiles.sh -create
-templatePath
app_server_root/profileTemplates/cell/default
-help
![[Windows]](../images/windows.gif)
app_server_root\bin\manageprofiles.bat -create
-templatePath
app_server_root\profileTemplates\cell\default
-help
-help 参数的输出指定在创建单元 Deployment Manager 概要文件和单元节点概要文件时,哪些参数是必需的以及哪些参数是可选的。
创建单元概要文件的 Deployment Manager 和节点部分后,必须在这两个服务器之间进行同步。缺省情况下,将自动以某一指定的时间间隔在这两个服务器之间进行同步。但是,如果同步处于禁用状态、时间间隔太长或者发生了某一问题使同步无法及时进行,请运行 syncNode 命令以同步 Deployment Manager 和节点。
您必须使用 portsFile 或 nodePortsFile 参数和 startingPort 或 nodeStartingPort 参数。
如果您使用 manageprofiles 命令,那么可以选择要哪个概要文件成为缺省概要文件。
如果您在创建单元概要文件期间使用 -appServerNodeName 参数联合应用程序服务器节点,那么该节点没有原始配置。如果您在创建单元概要文件期间创建的节点上使用 -removeNode 命令,那么该命令将指示节点除去实用程序无法除去该节点,且无法将该节点恢复到基本配置。要成功除去在创建单元概要文件期间联合的节点,请使用 manageprofiles 命令来除去该节点的概要文件。一旦删除了该节点的概要文件,就在 Deployment Manager 上使用 -cleanupNode 命令来从单元存储库中除去该节点配置。可以通过使用 Profile Management Tool 或 manageprofiles 命令创建一个新的概要文件。
示例:使用预定义端口号
如果未明确设置端口值,那么 manageprofiles 命令会推荐一些初始端口值。您可以改为使用预定义端口值。
概要文件 | 文件路径 |
---|---|
应用程序服务器 | app_server_root/profileTemplates/default/actions/portsUpdate/portdef.props |
单元 - 应用程序服务器部分 | app_server_root/profileTemplates/cell/dmgr/actions/portsUpdate/nodeportdef.props |
单元 - Deployment Manager 部分 | app_server_root/profileTemplates/cell/dmgr/actions/portsUpdate/portdef.props |
定制 | app_server_root/profileTemplates/managed/actions/portsUpdate/portdef.props |
Deployment Manager 服务器的概要文件 | app_server_root/profileTemplates/management/actions/portsUpdate/dmgr.portdef.props |
管理代理程序服务器的管理概要文件 | app_server_root/profileTemplates/management/actions/portsUpdate/adminagent.portdef.props |
作业管理器服务器的管理概要文件 | app_server_root/profileTemplates/management/actions/portsUpdate/jmgr.portdef.props |
安全代理 | app_server_root/profileTemplates/secureproxy/actions/portsUpdate/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
OVERLAY_UDP_LISTENER_ADDRESS=35062
OVERLAY_TCP_LISTENER_ADDRESS=35063
STATUS_LISTENER_ADDRESS=35064
在运行 manageprofiles 命令以使用用户定义的端口值创建概要文件之后,会显示一个成功或失败的结果。
manageprofiles 命令在 profile_root\properties 目录中创建当前 portdefs.props 文件的副本。
请仅将 -startingPort、-defaultPorts 或 -portsFile 这三个端口值参数中的一个用于 manageprofiles 命令。这三个参数是互斥的。