manageprofiles 命令

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

命令文件位于 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
  • -appServerNodeName application_server_node_name
  • -augment
  • -backupFile backupFile_name
  • -backupProfile
  • -cellName cell_name(可选参数)
  • -create
  • -debug
  • -defaultPorts
  • -delete
  • -deleteAll
  • -dmgrAdminPassword password
  • -dmgrAdminUserName user_name
  • -dmgrHost dmgr_host_name(可选参数)
  • -dmgrPort dmgr_port_number
  • -dmgrProfilePath dmgr_profile_path
  • -enableAdminSecurity true | false
  • -federateLater 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
  • -nodeDefaultPorts
  • -nodeName node_name
  • -nodePortsFile node_ports_file_path
  • -nodeProfilePathnode_profile_path
  • -omitAction feature1 feature2... featureN(可选参数)
  • -personalCertDN distinguished_name
  • -personalCertValidityPeriod validity_period(可选参数)
  • -portsFile file_path(可选参数)
  • -profileName profile_name
  • -profilePath profile_root
  • -response response_file
  • -restoreProfile
  • -securityLevel security_level
  • -serverName server_name
  • -serverType DEPLOYMENT_MANAGER | ADMIN_AGENT | JOB_MANAGER
  • -setDefaultName
  • -signingCertDN distinguished_name
  • -signingCertValidityPeriod validity_period(可选参数)
  • -startingPort starting_port | -portsFile ports_file_path | -defaultPorts
  • -supportedProtocols supported_protocols
  • -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
以下示例在诸如 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

-appServerNodeName application_server_node_name
指定要联合至单元的应用程序服务器的节点名。创建单元的 Deployment Manager 部分及创建单元的应用程序服务器部分时,请指定此参数。
-augment
使用 augment 参数以通过扩充模板对现有概要文件进行更改。augment 参数导致 manageprofiles 命令使用 -templatePath 参数中的模板更新或扩充在 -profileName 参数中标识的概要文件。可以使用的扩充模板由环境中安装的 IBM® 产品及版本确定。
要点: WebSphere® Application Server Network Deployment 产品附带的模板只能用于创建概要文件,而不能用于扩充现有概要文件,因为该产品仅提供了创建模板。

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

如果概要文件模板相对于 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(可选参数)
指定概要文件的单元名。请对每个概要文件使用唯一单元名。
避免故障 避免故障: 请使用唯一名称,即使您计划将定制概要文件或独立概要文件联合到一个 Deployment Manager 单元也是如此。联合要求单元名是唯一的,然后它才能生成 Deployment Manager 单元的节点部分。如果该产品在同一物理机器或机器集群(例如综合系统)上运行,那么单元名必须是唯一的。此外,如果需要在实体之间建立网络连接(在单元之间建立网络连接或者从必须与每个单元通信的客户机建立网络连接),那么单元名也必须是唯一的。如果单元名的名称空间为联合名称空间,那么单元名也必须是唯一的。否则,可能会出现诸如 javax.naming.NameNotFoundException 错误之类的症状,在这种情况下,请创建名称唯一的单元。gotcha

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

缺省单元名如下所示:
  • dmgr 模板:profilenameNetwork
  • 缺省模板:shorthostname_profilename
  • 受管模板:shorthostname_profilename
  • 单元模板:对于创建的两个概要文件,与前面的 dmgr 示例相同。

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

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

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

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

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

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

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

避免故障 避免故障: 如果要删除已迁移的旧节点,请先关闭新迁移的 Deployment Manager,然后再删除旧节点。这将确保不会从新迁移的单元中意外除去新迁移的节点。gotcha
-deleteAll
删除所有已注册的概要文件。

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

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

-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 参数在创建时联合定制概要文件。Deployment Manager 必须在运行中并且可访问。

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

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

-dmgrProfilePath dmgr_profile_path
指定单元的 Deployment Manager 部分的概要文件路径。创建单元的应用程序服务器部分时,请指定此参数。
-enableAdminSecurity true | false
启用管理安全性。有效值包括 truefalse。缺省值为 false
enableAdminSecurity 设置为 true 时,您还必须指定参数 -adminUserName-adminPassword 以及这些参数的值。

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

-federateLater true | false
指示是在概要文件创建期间联合受管概要文件,还是稍后使用 addNode 命令联合它。如果 dmgrHostdmgrPortdmgrAdminUserNamedmgrAdminPassword 参数没有值,那么此参数的缺省值为 true。有效值包括 truefalse
-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 参数指定的密钥库文件的类型。值可能为 JCEKSCMSKSPKCS12PKCS11JKS。但是,此列表可根据 java.security 文件中的提供程序更改。

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

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

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

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

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

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

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

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

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

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

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

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

-keyStorePassword keystore_password
指定要对概要文件创建期间创建的所有密钥库文件使用的密码。密钥库文件是为缺省个人证书和根签名证书创建的。
-listAugments
列出对概要文件注册表中概要文件的已注册扩充。必须将 -profileName 参数与 -listAugments 参数一起指定。
-listProfiles
列示概要文件注册表中的概要文件。
-nodeDefaultPorts
在结合单元模板创建概要文件时定义端口集。如果指定此选项,那么不能同时指定 -nodePortsFile 或 nodeStartingPort 选项。
-nodeName node_name
指定用新概要文件创建的节点的节点名。请在单元内或机器上使用唯一值。每个共享同一个产品二进制文件集的概要文件必须具有唯一节点名。
存在下列缺省节点名:
  • Deployment Manager、管理代理程序或作业管理器的管理模板:profilenameManager
  • 缺省模板:shorthostname_profilename
  • 受管模板:shorthostname_profilename
  • 单元:请参阅前面的管理模板和缺省模板示例,并在适当时应用到创建的两个概要文件。
  • 安全代理模板:shorthostname_profilename

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

-nodePortsFile node_ports_path
为单元中您要创建的节点部分指定端口。如果指定此选项,那么不能同时指定 -nodeDefaultPorts 或 -nodeStartingPort 选项。
-nodeProfilePath node_profile_path
指定单元的节点部分的概要文件路径。创建单元的 Deployment Manager 部分时,请指定此参数。
-omitActionfeature1 feature2... featureN(可选参数)
排除概要文件功能的可选参数。
每个概要文件模板都预定义了某些可选功能。以下可选功能可与以下概要文件模板的 -omitAction 参数一起使用:
  • default - 应用程序服务器
    • deployAdminConsole
    • defaultAppDeployAndConfig
    • deployIVTApplication
  • management - 用于 Deployment Manager、管理代理程序或作业管理器的管理概要文件
    • deployAdminConsole
  • cell - 由一个 dmgr 和一个缺省概要文件模板组成的 Deployment Manager 单元
    • cell_dmgr(在单元概要文件创建期间创建的 dmgr)
      • deployAdminConsole
      • 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> 是诸如 AppSrvDmgrAdminAgentJobMgrCustom 之类的值
  • <profile_number> 是创建唯一的概要文件名称的序号

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

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

-profilePath profile_root
指定概要文件的标准路径(称为 profile_root)。
指定完整路径以避免由于 Ant 脚本编制限制而导致在将概要文件联合到单元时发生故障。例如:
-profilePath profile_root

缺省值基于 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
此属性指定安装后处理程序是否应该修改它所创建的任何文件的许可权。有效值为 truefalse。所有其他值都缺省为 false。从文件中除去此属性也将导致它缺省为 false。设置为 false 后,安装后处理程序创建的所有文件都具有基于系统的 umask 设置的许可权。

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

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 
  • 请不要在响应文件中指定空白行。这会导致发生错误。
-restoreProfile
要点: manageProfiles -restoreProfile 命令仅支持在相同修订包级别创建的备份。
恢复概要文件备份。必须与 -backupFile 参数一起使用,例如:
manageprofiles(.bat)(.sh) -restoreProfile -backupFile file_name
要恢复概要文件,请执行下列步骤:
  1. 停止服务器和正在运行的进程(这些进程属于您想要恢复的概要文件)。
  2. 从文件系统中手动删除概要文件的目录。
  3. 运行 manageprofiles 命令的 -validateAndUpdateRegistry 选项。
  4. 通过使用 manageprofiles 命令的 -restoreProfile 选项来恢复概要文件。
-securityLevel security_level
为安全代理服务器指定初始安全性级别设置。有效值为。缺省值为。安全性级别基于启动用户许可权、路由注意事项、管理选项以及错误处理。可以选择在创建安全代理服务器概要文件之后更改安全性设置。
-serverName server_name
指定服务器的名称。仅对缺省模板和安全代理模板指定此参数。如果当使用缺省模板或安全代理模板时未指定此参数,那么缺省服务器名称是 server1(对于缺省概要文件)以及 proxy1(对于安全代理概要文件)。
-serverType DEPLOYMENT_MANAGER | ADMIN_AGENT | JOB_MANAGER
指定管理概要文件的类型。对于 Deployment Manager 服务器、管理代理程序服务器和作业管理器服务器,请分别指定 DEPLOYMENT_MANAGERADMIN_AGENTJOB_MANAGER当创建管理概要文件时,此参数是必需的。
-setDefaultName
将缺省概要文件设置为现有概要文件中的一个。必须与 -profileName 参数一起使用,例如:
manageprofiles(.bat)(.sh) -setDefaultName -profileName profile_name
-signingCertDN distinguished_name
指定当创建概要文件时创建的根签名证书的专有名称。指定以引号引起来的专有名称。此缺省个人证书位于服务器密钥库文件中。-importSigningCertKS 参数与 -signingCertDN 参数互斥。如果未特地创建或导入根签名证书,那么在缺省情况下会创建一个根签名证书。请参阅 -signingCertValidityPeriod 参数和 -keyStorePassword 参数。
-signingCertValidityPeriod validity_period(可选参数)
一个可选参数,用于指定根签名证书有效的时间量(以年计)。如果未将此参数与 -signingCertDN 参数一起指定,那么根签名证书的有效期限为 15 年。
-startingPort startingPort
指定为概要文件生成和指定所有端口时使用的起始端口号。

将从 -startingPort 值开始依次分配端口值。

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

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

注意: 如果您要使用受管概要文件模板,那么请不要使用此参数。
-supportedProtocols supported_protocols
指定对用于进行代理请求的安全代理服务器有效的协议。有效值为 SIPHTTPHTTP,SIP
-templatePath template_path
指定安装根目录中模板文件的目录路径。profileTemplates 目录包含对应于不同概要文件类型的各种目录,并且这些目录随所安装产品的类型而异。这些概要文件目录是您在使用 -templatePath 选项时指示的路径。可指定不在安装根目录中的概要文件模板(如果碰巧有的话)。
缺省模板路径为 app_server_root/profileTemplates/default。可以对 -templatePath 参数使用一个相对路径。该路径相对于当前工作目录或者 app_server_root/profileTemplates。以下示例会根据独立应用程序服务器的缺省值来创建概要文件:
manageprofiles -create -profileName MyProfile -startingPort 10380

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

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

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

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

另请参阅 augment 参数。

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

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

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

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

另请参阅 augment 参数。

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

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

-validateAndUpdateRegistry
检查概要文件注册表中列出的所有概要文件,以查看文件系统中是否存在这些概要文件。从注册表除去任何缺少的概要文件。返回从注册表删除的缺少的概要文件列表。
-validatePorts
检查端口以验证端口是否是保留的端口或是否在使用。 此参数帮助您标识未被使用的端口。如果确定端口已被使用,那么概要文件创建操作会停止并显示一条错误消息。在创建命令行时,您可以在任何时候使用此参数。建议将此参数与 –portsFile 参数配合使用。
-validateRegistry
检查概要文件注册表中列出的所有概要文件,以查看文件系统中是否存在这些概要文件。返回缺少的概要文件的列表。
-webServerCheck true | false
指示是否要设置 Web 服务器定义。有效值包括 truefalse。此参数的缺省值为 false
-webServerHostname webserver_host_name
服务器的主机名。此参数的缺省值为本地机器的长主机名。
-webServerInstallPath webserver_installpath_name
Web 服务器的本地或远程安装路径。此参数的缺省值取决于本地机器的操作系统和 webServerType 参数的值。例如:
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 参数一起使用。

使用方案

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

  • 创建 Deployment Manager

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

    manageprofiles -create 
       -profileName Dmgr001
       -profilePath profile_root
       -templatePath management
       -serverType DEPLOYMENT_MANAGER
       -startingPort 20000
  • 创建管理代理程序

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

    manageprofiles -create 
       -profileName AdminAgent001
       -profilePath profile_root
       -templatePath management
       -serverType ADMIN_AGENT
       -startingPort 24000
  • 创建作业管理器

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

    manageprofiles -create
       -profileName JobMgr001
       -profilePath profile_root
       -templatePath management
       -serverType JOB_MANAGER
       -startingPort 25000
  • 创建安全代理

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

    manageprofiles -create 
       -profileName SecureProxySrv001
       -profilePath profile_root
       -templatePath secureproxy
       -startingPort 26000
  • 创建定制概要文件

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

    manageprofiles -create 
       -profileName Custom01 
       -templatePath managed 
       -startingPort 22000
       -dmgrHost myhost.mycity.mycompany.com
       -dmgrPort 8879
  • 创建应用程序服务器概要文件

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

    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
  • 创建单元概要文件
    创建单元概要文件要求创建单元概要文件的 Deployment Manager 部分和应用程序服务器部分。将链接两个概要文件,并且某些参数必须在单元概要文件的 Deployment Manager 部分和应用程序服务器部分的创建参数之间匹配。
    要点: 对于单元概要文件的 Deployment Manager 部分和应用程序服务器部分,您必须对 cellNamenodeNameappServerNodeName 参数使用相同值。在创建单元概要文件的 Deployment Manager 部分时,如果未指定这些参数的名称,那么必须使用在第一个命令行调用中指定的缺省名称。以下示例显示对单元概要文件的 Deployment Manager 部分和应用程序服务器部分中这些参数使用相同值的情况。
    对于 Dmgr:
    -cellName host01Cell01
    -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 -create
         -templatePath app_server_root/profileTemplates/cell/dmgr
         -nodeProfilePath user_data_root/profiles/AppSrv01
         -profileName Dmgr001
         -cellName Default01Cell
         -nodeName Default01Node
         -appServerNodeName Default02Node
    2. 创建单元概要文件的应用程序服务器部分。
      app_server_root/bin/manageprofiles -create
         -templatePath app_server_root/profileTemplates/cell/default
         -dmgrProfilePath user_data_root/profiles/Dmgr001
         -portsFile user_data_root/profiles/Dmgr001/properties/portdef.props
         -nodePortsFile user_data_root/profiles/Dmgr001/properties/nodeportdef.props
         -profileName AppSrv01
         -cellName Default01Cell
         -nodeName Default01Node
         -appServerNodeName Default02Node

日志

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

示例:创建 Deployment Manager 概要文件

在安装核心产品文件之后,可以创建 Deployment Manager 概要文件。Deployment Manager 为一台或多台机器上的一组逻辑应用程序服务器提供了单一管理界面。使用 manageprofiles.sh -create 命令来创建 Deployment Manager 概要文件。

要创建名为 shasti 的 Deployment Manager 概要文件,请执行以下操作:

manageprofiles -create
              -profileName shasti 
              -profilePath /shasti/WebSphere 
              -templatePath /opt/IBM/WebSphere/AppServer/profileTemplates/management
              -serverType DEPLOYMENT_MANAGER
              -cellName cell1
              -hostName planetaix 
              -nodeName dmgr1
该命令在以下位置内具有节点名 dmgr1 的单元(名为 cell1)中创建名为 shasti 的 Deployment Manager 概要文件:
  • /shasti/WebSphere

如果您在概要文件创建期间未指定某个端口选项,那么将使用一组建议的端口值。端口冲突解决算法确定这些端口。建议的这组端口一定是没有冲突的。如果要使用 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
具有 Deployment Manager 概要文件的单元的已分配端口
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
具有 Deployment Manager 服务器的管理概要文件的已分配端口
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 开始创建端口,附带前面示例中显示的内容:

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 命令来创建单元概要文件,必须使用两个不同的 manageprofiles 命令行调用来为 Deployment Manager 服务器创建单元管理概要文件以及单元节点概要文件。这两个概要文件的组合就是单元概要文件。

两个模板用来创建单元概要文件:cell_dmgr 和 cell_node。在这两个调用中将链接这些模板,并且某些参数必须在创建参数之间是匹配的。请验证这些调用是否匹配。

从命令行,您可以按任何顺序或在任何时间创建单元的两个组成部分。最好的做法是首先创建概要文件的 Deployment Manager 部分。在您创建单元之后,该单元包含 Deployment Manager 和联合节点。Deployment Manager 部分和节点部分位于不同目录中。

对于创建的这两个概要文件的其中每一个,您都可以使用 -profilePath 参数来指定所产生概要文件的标准路径。如果未指定该参数,那么每个概要文件路径的缺省值都基于目录、概要文件子目录和概要文件的名称。

组成单元概要文件的两个模板相互之间具有依赖性,这要求某些参数值在两个创建调用之间匹配。要创建一个完整的工作单元,cell_dmgr 概要文件和 cell_node 概要文件的 -nodeProfilePath-cellName-appServerNodeName-nodeName 参数必须具有相同值。对于端口尤其是动态分配的端口来说,创建单元的另一半必须引用在单元的第一半中使用的端口。将 -portsFile-nodePortsFile 参数与对概要文件(表示单元的第一半)的以下文件的引用配合使用:

  • profile_root/properties/portdef.props
  • profile_root/properties/nodeportdef.props
此方法确保使用单元的第一半的正确相关性来创建单元的第二半中的端口。

要在创建单元概要文件时获取详细的帮助,请使用下列命令:

app_server_root/bin/manageprofiles -create
 -templatePath 
app_server_root/profileTemplates/cell/dmgr 
 -help

或者

app_server_root/bin/manageprofiles -create
 -templatePath 
app_server_root/profileTemplates/cell/default 
 -help

-help 参数的输出指定在创建单元 Deployment Manager 概要文件和单元节点概要文件时,哪些参数是必需的以及哪些参数是可选的。

以下示例创建名为 Dmgr001 的单元概要文件,它的单元名为 Default01Cell,节点名为 Default01Node
  1. 验证以下路径是否可供使用:

    当您创建单元的 Deployment Manager 和节点部分并对每个部分添加子目录时,此路径必须可用。

    • app_server_root/profiles
  2. 创建单元概要文件的 Deployment Manager 部分。
    app_server_root/bin/manageprofiles -create
     -templatePath 
    app_server_root/profileTemplates/cell/dmgr 
     -nodeProfilePath app_server_root/profiles/AppSrv01
     -profileName Dmgr001
     -cellName Default01Cell
     -nodeName Default01Node
     -appServerNodeName federated_node_name
  3. 验证 Dmgr001 概要文件是否存在,因为该概要文件必须存在,您才能创建单元概要文件的应用程序服务器部分。
  4. 创建单元概要文件的应用程序服务器部分。
    要点: 必须对单元概要文件的 Deployment Manager 部分中使用的 cellName、nodeName 和 appServerNodeName 参数使用相同的值。以下示例说明对单元概要文件的 Deployment Manager 部分和应用程序服务器部分中 cellName、nodeName 和 appServerNodeName 参数使用相同值的情况。
    对于 Dmgr:
    -cellName host01Cell01
    -nodeName host01CellManager01
    -appServerNodeName host01Node01                                 
    对于 AppServer:
    -cellName host01Cell01
    -nodeName host01CellManager01
    -appServerNodeName host01Node01 
    在创建单元概要文件的 Deployment Manager 部分时,如果未指定这些参数的名称,那么必须使用在第一个命令行调用中指定的缺省名称。
    app_server_root/bin/manageprofiles -create
     -templatePath 
    app_server_root/profileTemplates/cell/default 
     -dmgrProfilePath app_server_root/profiles/Dmgr001
     -portsFile app_server_root/profiles/Dmgr001/properties/portdef.props
     -nodePortsFile app_server_root/profiles/Dmgr001/properties/nodeportdef.props
     -profileName AppSrv01
     -cellName Default01Cell
     -nodeName Default01Node
     -appServerNodeName federated_node_name

创建单元概要文件的 Deployment Manager 和节点部分后,必须在这两个服务器之间进行同步。缺省情况下,将自动以某一指定的时间间隔在这两个服务器之间进行同步。但是,如果同步处于禁用状态、时间间隔太长或者发生了某一问题使同步无法及时进行,请运行 syncNode 命令以同步 Deployment Manager 和节点。

您必须使用 portsFile 或 nodePortsFile 参数和 startingPort 或 nodeStartingPort 参数。

如果您使用 manageprofiles 命令,那么可以选择要哪个概要文件成为缺省概要文件。

示例:使用预定义端口号

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

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

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

概要文件 文件路径
应用程序服务器 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
要在创建概要文件之前在 portdef.props 文件中定制端口值,请执行下列步骤。以下示例创建缺省概要文件。对于其他类型的概要文件,必须用要创建的概要文件的文件路径替代示例中的文件路径。
  1. app_server_root/profileTemplates/default/actions/portsUpdate/portdef.props 文件从缺省概要文件模板路径复制到诸如以下各项之类的任意临时目录中:
    • /temp/ports
  2. 在新文件中,修改端口设置以指定您的端口值。
  3. 使用 manageprofiles 命令来创建概要文件。使用已修改的端口值。在 -portsFile 参数上指定已修改的 portdef.props 文件的位置。指定 -validatePorts 参数以确保端口不是保留的或未在使用。请将以下示例用作指南:
    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
OVERLAY_UDP_LISTENER_ADDRESS=35062
OVERLAY_TCP_LISTENER_ADDRESS=35063
STATUS_LISTENER_ADDRESS=35064

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

注: 成功创建概要文件后,控制台将输出一条消息,指示创建成功并建议您检查 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-nd-iseries&topic=rxml_manageprofiles
文件名:rxml_manageprofiles.html