WebSphere WebSphere Enterprise Service Bus V6.0.1 操作系统: AIX, HP-UX, Linux, Solaris, Windows

manageprofiles 命令

manageprofiles 命令行工具可用来创建所有 WebSphere ESB 运行时环境,可替代“创建概要文件”图形向导使用。该命令将创建概要文件,这是用来定义部署管理器、定制概要文件或独立服务器概要文件的运行时环境的一组文件。该命令可用来创建、删除、扩充、取消扩充、列示或验证概要文件。

“创建概要文件”向导是一个 InstallShield for Multiplatforms(ISMP)应用程序。可使用该向导输入本主题中描述的大部分参数。但是,某些参数要求您使用 manageprofiles 命令。必须使用 manageprofiles 命令来删除或取消扩充概要文件,例如,因为“创建概要文件”向导不提供删除功能而这么做。

但是,“创建概要文件”向导也会执行一些 manageprofiles 命令不执行的任务。例如,向导可以为它创建的每个概要文件创建一个 Windows® 服务。它还可根据先前的端口分配指定不冲突的端口。

当使用“创建概要文件”向导(交互式或静默式)来初次创建或扩充概要文件时,创建或扩充概要文件的命令行版本将写至日志文件。可从日志文件中抽取此命令行,仔细修改它,然后使用它来创建或扩充其他概要文件。

要点: 要成功创建新的 WebSphere ESB 概要文件或扩充现有 WebSphere Application Server 概要文件,应先使用“创建概要文件”向导或使用静默安装过程并且只使用 manageprofiles 命令来“克隆”这样的概要文件或创建类似的概要文件。使用 manageprofiles 命令来创建和扩充概要文件包含此过程的逐步指示信息。
有关更多信息,请参阅以下章节:

概要文件类型

每个概要文件的模板在 install_root/profileTemplates 目录中。

此目录包含对应于不同概要文件的各个目录。这些目录是您指示给带有 -templatePath 选项的 manageprofiles 命令的路径。还可指定不在安装根中的概要文件模板(如果有的话)。

WebSphere ESB 中的 manageprofiles 命令可以创建下列类型的 ESB 概要文件:
  • 独立服务器概要文件使用 install_root/profileTemplates/default.esbserver 模板。
  • 部署管理器概要文件使用 install_root/profileTemplates/dmgr.esbserver 模板。
  • 定制概要文件使用 install_root/profileTemplates/managed.esbserver 模板。

命令文件的位置

该命令文件在 install_root/bin 目录中。对于 Linux® 和 UNIX® 平台,该命令文件是名为 manageprofiles.sh 的脚本,对于 Windows 平台,该命令文件是名为 manageprofiles.bat 的脚本。

“创建概要文件”向导是命令行工具的图形用户界面。调用“创建概要文件”向导的命令的文件名根据操作系统平台的不同而变化。

日志记录

每次调用 manageprofiles 都会在 install_root/logs/wasprofile 目录中创建两个日志。
  • wasprofile_<mode>_profile_name.log 将包含 manageprofiles 命令调用的操作的详细信息。
  • manageprofile_<mode>_profile_name.log 将包含应用于给定调用的模板的简短描述及这些模板的返回码。
例如,使用 manageprofiles 命令创建概要文件 profile1 时,将创建两个日志文件:
  • install_root/logs/wasprofile/wasprofile_create_profile1.log
  • install_root/logs/wasprofile/manageprofile-create-profile1.log
LINUX platforms UNIX platforms

manageprofiles.sh 命令语法

将以下语法和参数与 manageprofiles 命令配合使用以获取有关概要文件的信息、删除概要文件或取消扩充概要文件。要使用 manageprofiles 创建或扩充概要文件,遵循使用 manageprofiles 命令来创建和扩充概要文件中的指示信息。

列示现有概要文件:
# ./manageprofiles.sh -listProfiles 
                 
除去概要文件的最新扩充:
# ./manageprofiles.sh -unaugment 
              -profileName profile_name 
删除概要文件:
注: 在删除概要文件之前,必须除去该概要文件的所有扩充。在对 WebSphere ESB 概要文件发出 delete 命令之前,应发出两次 unaugment 命令。这将确保删除概要文件及其所有相关工件。在删除概要文件之后,尝试重新创建该概要文件之前,应手工删除 profile_root 目录的内容。
# ./manageprofiles.sh -unaugment 
              -profileName profile_name
# ./manageprofiles.sh -unaugment 
              -profileName profile_name
# ./manageprofiles.sh -delete 
                -profileName profile_name | -profilePath profile_path 
                
通过路径获取现有概要文件的名称:
# ./manageprofiles.sh -getName 
                 -profilePath profile_path 
                
通过名称获取现有概要文件的路径:
# ./manageprofiles.sh -getPath 
                 -profileName profile_name 
                
检查概要文件注册表的完整性:
# ./manageprofiles.sh -validateRegistry 
                
检查概要文件注册表的完整性,同时除去未发现的概要文件:
# ./manageprofiles.sh -validateAndUpdateRegistry 
                 [-backup file_name] 
                
获取命令帮助:
# ./manageprofiles.sh -help

# ./manageprofiles.sh -option_name -help
For Windows platforms

manageprofiles.bat 命令语法

列示现有概要文件:
manageprofiles -listProfiles 
             
除去概要文件的最新扩充:
manageprofiles -unaugment 
               -profileName  profile_name 
删除概要文件:
注: 在删除概要文件之前,必须除去该概要文件的所有扩充。在发出 delete 命令之前,先发出 unaugment 命令两次。这将确保删除概要文件及其所有相关工件。在删除概要文件之后,尝试重新创建该概要文件之前,应手工删除 profile_root 目录的内容。
manageprofiles -unaugment 
               -profileName  profile_name
manageprofiles -unaugment 
               -profileName  profile_name
manageprofiles -delete 
              -profileName profile_name | -profilePath profile_path 
            
通过路径获取现有概要文件的名称:
manageprofiles -getName 
               -profilePath fully_qualified_profile_path 
             
通过名称获取现有概要文件的路径:
manageprofiles -getPath 
               -profileName profile_name 
             
检查概要文件注册表的完整性:
manageprofiles -validateRegistry 
             
检查概要文件注册表的完整性,同时除去任何未发现的概要文件:
manageprofiles -validateAndUpdateRegistry 
             [-backup file_name] 
             
获取命令帮助:
manageprofiles -help

manageprofiles -option_name -help

参数

WebSphere ESB manageprofiles 命令的参数设置与 WebSphere Process Server manageprofiles 命令的参数设置相同。

有关要与 manageprofiles 命令一起用于 WebSphere ESB 的参数的列表和描述,请参阅manageprofiles 参数

命令输出

创建或扩充命令完成时,将在命令行中显示下列其中一个语句(具体字样将根据 manageprofiles 的调用方式不同而变化):
  • INSTCONFSUCCESS:创建概要文件成功。
  • INSTCONFFAILED:创建概要文件失败。
  • INSTCONFPARTIALSUCCESS:某些非关联安装后配置操作未成功。
在某些情况下,该语句将多次显示。例如,对于 WebSphere ESB 概要文件,INSTCONFSUCCESS 行将在命令行中显示 3 次。

示例

取消扩充LINUX platforms UNIX platforms
install_root/bin  manageProfiles.sh -unaugment –profileName profileName
For Windows platforms
install_root\bin  manageProfiles -unaugment –profileName profileName
删除LINUX platforms UNIX platforms
install_root/bin  manageProfiles.sh -delete –profileName profileName
For Windows platforms
install_root\bin  manageProfiles -delete –profileName profileName
相关参考
manageprofiles 参数

参考主题

使用条款 | 评价此页

Timestamp icon上次更新时间: 3 Mar 2006
http://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/index.jsp?topic=/com.ibm.websphere.wesb.doc.nl1_6.0.1\ref\rwesb_manageprofile.html

(C) Copyright IBM Corporation 2005, 2006. All Rights Reserved.
本信息中心基于 Eclipse 技术。(http://www.eclipse.org)