您可以使用 Configuration Manager 的命令行版本对 Web 应用程序服务器上已升级的 Content Engine 实例进行配置。
在开始之前,请确保您有必需的帐户和适当的许可权。
要对已升级的 Content Engine 实例进行配置,请完成下列步骤:
- 以 config_mgr_user 身份(即 Configuration Manager 用户)登录到 Content Engine 所安装在的机器。
- 将当前目录切换到 ce_install_path/tools/configure,其中
ce_install_path 是 Content Engine 的安装路径。
例如,ce_install_path 可能是 /opt/FileNet/ContentEngine。
- 从命令提示符运行 generateupgrade 命令以生成升级概要文件。输入命令时,请勿换行。
configmgr_cl generateupgrade [-appserver app_server_type] -server server_name
[-deploy deploy_type] -profile myprofile [-silent] [-force] [-help]
其中:
- -appserver appserver_type
- 仅当 ce_install_path/Servers.xml
文件不存在或者未包含任何服务器时,-appserver appserver_type 参数才是必需的。此参数指定应用程序服务器的类型,并且必须是下列其中一个值:WebSphere、WebLogic 或 JBoss。
- -server server_name
- -server server_name 参数指示要为其创建升级概要文件的服务器。在运行 generateupgrade 命令之前,请使用 listservers 命令来显示有效 server_name 值的列表。
- -deploy deploy_type
- 仅当 ce_install_path/Servers.xml
文件不存在或者未包含所选服务器的部署类型时,-deploy deploy_type 参数才是必需的。此参数指定 Content Engine 部署类型。如果所选服务器的 Servers.xml
文件包含部署类型值,那么将使用 Servers.xml
文件中的值,而不是使用您在命令行中指定的值。
请选择下列其中一项值:standard、cluster 或 netdeploy(网络部署)。
如果您正在将 Content Engine 部署到独立 WebSphere® Application Server、Oracle WebLogic Server 或 JBoss Application Server(即,既不是受管服务器,也不是集群服务器),请指定 standard。
如果您正在将 Content Engine 部署到
WebSphere Application Server、Oracle WebLogic Server 或 JBoss Application Server集群,请指定 cluster。
如果您正在将 Content Engine 部署到受管 WebSphere Application Server
实例,请指定 netdeploy。即,您正在使用 Network Deployment 来管理各个不一定包含在集群中的服务器。
- -profile myprofile
- -profile myprofile 参数指定要使用的概要文件。myprofile 值可以是下列其中一项:
- 概要文件的名称,例如 ce_was_tiv_db2。此概要文件必须位于 ce_install_path/tools/configure/profiles 目录中,其中 ce_install_path 是 Content 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 参数。
- -help
- -help 参数是可选的,它显示有关命令语法的简要消息,而不是运行该命令。
在概要文件目录中,将创建 upgrade.xml 文件以及一个根据每个现有 Content Engine 实例命名的目录。
要点: 如果
generateupgrade 命令返回一条消息,指示升级概要文件已存在,请转到
4。
- (仅限于 IBM® WebSphere Application Server 或 Oracle WebLogic Server)设置应用程序服务器管理员属性:
- 浏览到概要文件/Content_Engine_实例目录。
- 在文本编辑器中打开 applicationserver.xml 文件。
- 设置 ApplicationServerAdminUsername 属性的值。
<propertyname="ApplicationServerAdminUsername">
<value>管理员用户名 </value>
</property>
- 保存更改并关闭文件。
- 运行 storepasswords 命令,它将提示您选择是否对
Web 应用程序服务器管理员密码进行加密并将其存储在 applicationserver.xml
文件中(请回答 yes 或 no)。 如果您选择不保存密码,那么需要编辑 applicationserver.xml
并对 ApplicationServerAdminPassword 属性指定明文密码。
configmgr_cl storepasswords -profile myprofile
提示: 如果 storepasswords
命令提示您将密码存储在磁盘上的配置文件中,那么您必须响应
yes 或 no(而不是
y 或 n)。
- 根据需要重复此步骤,以便编辑所创建的每个 Content Engine 实例目录的应用程序服务器属性。
- (仅适用于 WebSphere)如果您正在从 V4.0.1 或 V4.5.0 升级 Content Engine,那么在命令提示符处运行 execute 命令来配置登录模块:
configmgr_cl generateconfig -appserver app_server_type
-repositorytype ldap_repository_type -task configureloginmodules
-profile myprofile
其中:
- -repositorytype ldap_repository_type
- (仅限于 WebSphere Application Server)-repositorytype ldap_repository_type 参数指定要使用的 LDAP 存储库的类型,并且必须是 standalone 或 federated。
- (仅适用于 JBoss)如果您正在从 V4.0.1、V4.5.0 或 V4.5.1 升级
Content Engine,请从命令提示符运行 execute
命令以配置登录模块:
configmgr_cl execute -task configureloginmodules -profile myprofile
- 在命令提示符处,运行 execute 命令来配置引导属性。
configmgr_cl execute -task configurebootstrap -profile myprofile
状态消息将显示在控制台中。
- 可选: 从命令提示符运行 checkStatus 命令以检查任务的完成状态。
configmgr checkStatus -task configurebootstrap -profile myprofile