generateconfig 命令
generateconfig 命令用于生成所指定配置任务的配置 XML 文件。命令名不区分大小写。
generateconfig 命令语法
为了便于您阅读,以下命令语法分行显示。您在输入命令和选项时,请不要换行。
configmgr_cl generateconfig -appserver app_server_type
-license license_type
-repositorytype ldap_repository_type
-db database_type -ldap ldap_type -bootstrap bootstrap_operation
-deploy deploy_type -task task_type -taskname display_name
-profile myprofile [-silent] [-force] [-help]
generateconfig 命令参数
- -appserver appserver_name
- -appserver appserver_type 指定应用程序服务器的类型,并且必须是 WebSphere、JBoss 或 WebLogic。
- -license license_type
- -license license_type 参数用于指定适用于所安装的产品的许可证类型,并且必须是下列其中一种类型:"UVU"、"PVU Production" 或 "PVU Non-Production"。请注意,如果参数值中包含嵌入空白,那么必须用双引号 (") 将该值定界。
- -repositorytype ldap_repository_type
- (仅限于 WebSphere® Application Server)仅当正在生成 XML 文件时,-repositorytype ldap_repository_type 参数才是必需的。此参数指定要使用的 LDAP 存储库的类型,并且必须是 standalone 或 federated。
- -db database_type
- 只有在同时生成所有文件或者使用 configurejdbcgcd 或 configurejdbcos 选项来生成单一文件时,-db database_type 参数才是必需的。此参数指定 Content Platform Engine 要使用的数据库的类型,并且必须是 mssql、oracle、oracle_rac、db2、db2zos 或 db2pshadr。
- -ldap ldap_type
- 只有在同时生成所有文件或者使用 configureldap 选项来生成单一文件时,-ldap ldap_type 参数才是必需的。此参数指定 Content Platform Engine 用于认证用户的目录服务存储库的类型,并且必须是 activedirectory、adam、ca、edirectory、oid、oracledirectoryse 或 tivoli。adam 选项既适用于 Microsoft ADAM 也适用于 AD LDS。
- -bootstrap bootstrap_operation
- 只有在同时生成所有文件或者使用 configurebootstrap 选项来生成单一文件时,-bootstrap bootstrap_operation 参数才是必需的。此参数指定概要文件的引导程序和文本抽取操作,并且必须是 new、modify 或 upgrade。
- -deploy deploy_type
- 只有在同时生成所有文件或者使用 deployapplication
选项来生成单一文件时,-deploy deploy_type 参数才是必需的。此参数指定 Content Platform Engine 部署类型。值必须是 standard、cluster
或 netdeploy(网络部署)。
如果您正在将 Content Platform Engine 部署到独立 WebSphere Application Server、JBoss Application Server 或 Oracle WebLogic Server(即,不是受管服务器或者集群式服务器),请指定 standard。
如果您正在将 Content Platform Engine 部署到 WebSphere Application Server、JBoss Application Server 或 Oracle WebLogic Server 集群,请指定 cluster。
如果您正在将 Content Platform Engine 部署到受管 WebSphere Application Server 实例,请指定 netdeploy。即,您正在使用 Network Deployment 来管理各个未包含在集群中的服务器。
- -task task_type
- -task task_type 参数指示要生成的任务。如果要生成所有任务,那么可以省略 -task task_type 参数。task_type 的值不区分大小写。下表列示了有效的任务名、与其相关联的配置 XML 文件以及有关该任务所影响的 Content Platform Engine 设置的描述。
表 1. task_type 的值 选项 要生成的配置文件 描述 省略 applicationserver.xml
configurepricingmodel.xml
configurebootstrap.xml
configurejdbcgcd.xml
configurejdbcos.xml
configureldap.xml
configureloginmodules.xml
deployapplication.xml
如果您省略 -task task_type 参数,那么将创建概要文件的所有缺省配置文件。 configurepricingmodel configurepricingmodel.xml
生成文件,该文件用于指定 IBM® FileNet® Content Manager 或 IBM Content Foundation、IBM Case Foundation 和 IBM Case Manager 的许可证选项。
configurebootstrap applicationserver.xml
configurebootstrap.xml
生成应用程序服务器属性文件和一个设置文件,该设置文件包含应用程序服务器上的 Content Platform Engine 引导程序设置。创建全局配置数据库以及启动 Content Platform Engine 时,都需要引导程序信息。
configurejdbcgcd applicationserver.xml
configurejdbcgcd.xml
生成应用程序服务器属性文件和一个设置文件,该设置文件用于配置与Content Platform Engine 所使用的全局配置数据库数据库的 JDBC 连接。
如果该概要文件已包含 applicationserver.xml 文件,那么将保留现有文件。
configurejdbcos applicationserver.xml
configurejdbcos.xml
configurejdbcos.n.xml,其中 n 是大于或等于 2 的整数
生成应用程序服务器属性文件和一个设置文件,该设置文件用于配置与 Content Platform Engine 所使用的单一对象存储数据库的 JDBC 连接。您需要为数据库中的每个对象存储生成、编辑和应用 configurejdbcos 任务设置。
如果生成第二个对象存储 JDBC 配置文件,那么该文件将被命名为 configurejdbcos.2.xml。对于您生成的每个新文件,文件名都将递增。您无法更改文件名,但可以编辑此文件中的任务名称值。
如果该概要文件已包含 applicationserver.xml 文件,那么将保留现有文件。
configureldap applicationserver.xml
configureldap.xml
configureldap.n.xml,其中 n 是大于或等于 2 的整数
生成应用程序服务器属性文件和一个设置文件,该设置文件用于配置与负责认证 Content Platform Engine 用户的目录服务器的连接。
(仅限于 WebSphere Application Server 或 Oracle WebLogic Server。)如果生成第二个 LDAP 配置文件,那么该文件将被命名为 configureldap.2.xml。对于您生成的每个新文件,文件名都将递增。您无法更改文件名,但可以编辑此文件中的任务名称值。
JBoss 不支持多个 LDAP 任务。
如果该概要文件已包含 applicationserver.xml 文件,那么将保留现有文件。
configureloginmodules applicationserver.xml
configureloginmodules.xml
(仅限于 WebSphere Application Server 或 JBoss Application Server。)生成应用程序服务器属性文件以及 Content Platform Engine 应用程序的登录模块文件。
如果该概要文件已包含 applicationserver.xml 文件,那么将保留现有文件。
deployapplication applicationserver.xml
deployapplication.xml
生成应用程序服务器属性文件和一个设置文件,该设置文件包含用于在应用程序服务器上部署 Content Platform Engine 应用程序的设置。
如果该概要文件已包含 applicationserver.xml 文件,那么将保留现有文件。
- -taskname display_name
- -taskname display_name 参数是可选的,并且只有在生成文件时才有效。此参数指定配置 XML 文件中 displayName 属性的值。如果显示名包含空格,请将整个名称括在引号中。在图形用户界面中,显示名用于标识任务。
- -profile myprofile
- -profile myprofile 参数指定要使用的概要文件。myprofile 值可以是下列其中一项:
- 概要文件的名称,例如 ce_was_tiv_db2。此概要文件必须位于 ce_install_path/tools/configure/profiles 目录中,其中 ce_install_path 是 Content Platform Engine 软件的安装位置。
- 概要文件目录的绝对路径,例如 "C:\Program Files\IBM\FileNet\ContentEngine\tools\configure\profiles\ce_was_tiv_db2" 或 /opt/IBM/FileNet/ContentEngine/tools/configure/profiles/ce_was_tiv_db2。
- 概要文件输入文件的绝对路径,例如 "C:\Program Files\IBM\FileNet\ContentEngine\tools\configure\profiles\ce_was_tiv_db2\ce_was_tiv_db2.cfg" 或 /opt/IBM/FileNet/ContentEngine/tools/configure/profiles/ce_was_tiv_db2/ce_was_tiv_db2.cfg。
切记: 如果此路径包含带有空格的目录名,请将整个路径括在引号中。例如,输入 "C:\Program Files\IBM\FileNet\ContentEngine\tools\configure\profiles\ce_was_tiv_db2\ce_was_tiv_db2.cfg"。 - -silent
- -silent 参数是可选的。如果指定了 -silent,那么将不会在控制台中显示任何提示或参考消息,但会将错误写入日志。故障消息和验证错误消息(例如关于遗漏密码或端口号无效的消息)将根据需要显示。如果您通过运行 execute 命令来运行概要文件中的所有任务,并且指定了 -silent 参数,那么还必须指定 -force 参数。
- -force
- -force 参数是可选的,并且只有在您使用了 -silent 参数时才适用。如果指定了 -force,那么任务的运行过程不会进行暂停以便要求您对验证错误消息(例如关于遗漏密码或端口号无效的消息)作出响应。
- -help
- -help 参数是可选的,它显示有关命令语法的简要消息,而不是运行该命令。
generateconfig 命令示例 (WebSphere Application Server)
为了便于您阅读,以下命令语法分行显示。您在输入命令和选项时,请不要换行。
- 生成 configurepricingmodel(选择许可证)任务文件。
- 以下命令将生成 configurepricingmodel.xml 文件,以指定
IBM FileNet Content Manager 或
IBM Content
Foundation、IBM Case
Foundation 和
IBM Case Manager 的处理器价值单元 (PVU) 生产许可:WebSphere Application Server
configmgr_cl generateconfig -appserver websphere -task configurepricingmodel -license "PVU Production" -profile wstdb2jdbc
WebLogic Serverconfigmgr_cl generateconfig -appserver WebLogic -task configurepricingmodel -license "PVU Production -profile wblgprofile
JBoss Application Serverconfigmgr_cl generateconfig -appserver JBoss -appserverVession 6.x_EAP -task configurepricingmodel -license "PVU Production -profile jbprofile
- 同时生成所有配置文件。
- 例如,以下命令生成新安装概要文件的所有配置 XML 文件,以便执行
IBM Tivoli® Directory Server 的标准部署,此部署使用 ce_install_path/tools/configure/profiles/wstdb2
目录中的独立 LDAP 存储库和 DB2®:WebSphere Application Server
configmgr_cl generateconfig -appserver websphere -repositorytype standalone -db db2 -ldap tivoli -bootstrap new -deploy standard -profile wstdb2
WebLogic Serverconfigmgr_cl generateconfig -appserver WebLogic -repositorytype standalone -db mssql -ldap activedirectory -bootstrap new -deploy standard -profile wblgprofile
JBoss Application Serverconfigmgr_cl generateconfig -appserver JBoss -appserverVession 6.x_EAP -repositorytype standalone -db db2 -ldap activedirectory -bootstrap new -deploy standard -profile jbprofile
- 只生成用于对象存储的 configurejdbcos 任务文件。
- 以下命令只生成新安装概要文件的 configurejdbcos.n.xml 文件,以便在
WebSphere 上执行部署(此部署使用
ce_install_path/tools/configure/profiles/wstdb2 目录中的独立 LDAP 存储库):
WebSphere Application Server
configmgr_cl generateconfig -appserver websphere -db db2 -repositorytype standalone -task configurejdbcos -profile wstdb2
WebLogic Serverconfigmgr_cl generateconfig -appserver WebLogic -db msssql -repositorytype standalone -task configurejdbcos -profile wblgprofile
JBoss Application Serverconfigmgr_cl generateconfig -appserver JBoss -appserverVession 6.x_EAP -db db2 -repositorytype standalone -task configurejdbos -profile jbprofile
- 只生成用于对象存储库的 configurejdbcos 任务文件并提供任务的显示名称。
- 以下命令只生成新安装概要文件的 configurejdbcos.n.xml 文件,以便在
WebSphere 上执行部署(此部署使用
ce_install_path/tools/configure/profiles/wstdb2
目录中的独立 LDAP 存储库并使用显示名 Configure Object Store OS23 Data Sources):
WebSphere Application Server
configmgr_cl generateconfig -appserver websphere -db db2 -repositorytype standalone -task configurejdbcos -taskname "Configure Object Store OS23 Data Sources" -profile wstdb2jdbc
WebLogic Serverconfigmgr_cl generateconfig -appserver WebLogic -db mssql -repositorytype standalone -task configurejdbcos -taskname "Configure Object Store OS23 Data Sources" -profile wblgprofile
JBoss Application Serverconfigmgr_cl generateconfig -appserver JBoss -appserverVession 6.x_EAP -db db2 -repositorytype standalone -task configurejdbcos -taskname "Configure Object Store OS23 Data Sources" -profile jbprofile
- 显示 generateconfig 命令的帮助。
- 以下命令显示 generateconfig 命令的帮助:
configmgr_cl generateconfig -help