FileNet P8 Content Engine, Version 5.0.+              

generateupgrade command (without Servers.xml file)

The generateupgrade command generates the configuration XML files for upgrading an existing Content Engine. The generateupgrade command has two syntax formats, depending on whether you have a valid copy of the Servers.xml file in the directory where Content Engine is installed. The command name is not case sensitive.

generateupgrade command syntax

Use the following syntax for the generateupgrade command if you do not have an existing Servers.XML file with valid server information in the directory where Content Engine is installed (ce_install_path).

The following syntax includes line breaks to format the command for reading. Enter the command and options on a single line, without any line breaks.
configmgr_cl generateupgrade -appserver app_server_type -server server_name 
-deploy deploy_type -profile myprofile [-silent] 
[-force] [-help]

generateupgrade command parameters

-appserver appserver_type
The -appserver appserver_type parameter is required only if the ce_install_path/Servers.xml file does not exist or does not contain any servers. This parameter specifies the type of application server and must be one of the following values: WebSphere, WebLogic, or JBoss.
-server server_name
The -server server_name parameter indicates the server to create the upgrade profile for. Use the listservers command to display a list of valid server_name values before you run the generateupgrade command.
-deploy deploy_type
The -deploy deploy_type parameter is required only if the ce_install_path/Servers.xml file does not exist or does not contain the deployment type for the selected server. This parameter specifies the type of Content Engine deployment. If a value for the deployment type exists in the Servers.xml file for the selected server, then the value from the Servers.xml file is used instead the value you specify on the command line.

Valid values are standard, cluster, or netdeploy (network deployment).

Specify standard if you are deploying Content Engine to a stand-alone (that is, a server that is not managed or clustered) WebSphere® Application Server, Oracle WebLogic Server, or JBoss Application Server.

Specify cluster if you are deploying Content Engine to a WebSphere Application Server, Oracle WebLogic Server, or JBoss Application Server cluster.

Specify netdeploy if you are deploying Content Engine to a managedWebSphere Application Server instance. That is, you are using Network Deployment to manage individual servers that are not necessarily in a cluster.

-profile myprofile
The -profile myprofile parameter specifies the profile to use. The myprofile value can be one of the following items:
  • The name of the profile, such as ce_was_tiv_db2. The profile must be located in the ce_install_path/tools/configure/profiles directory, where ce_install_path is the location where the Content Engine software is installed.
  • The absolute path to the profile directory, such as "C:\Program Files\IBM\FileNet\ContentEngine\tools\configure\profiles\ce_was_tiv_db2" or opt/IBM/FileNet/ContentEngine/tools/configure/profiles/ce_was_tiv_db2.
  • The absolute path to the profile input file, such as "C:\Program Files\IBM\FileNet\ContentEngine\tools\configure\profiles\ce_was_tiv_db2\ce_was_tiv_db2.cfg" or opt/IBM/FileNet/ContentEngine/tools/configure/profiles/ce_was_tiv_db2/ce_was_tiv_db2.cfg.
Remember: If the path includes a directory name with spaces, enclose the entire path in quotation marks. For example, enter "C:\Program Files\IBM\FileNet\ContentEngine\tools\configure\profiles\ce_was_tiv_db2\ce_was_tiv_db2.cfg".
-silent
The -silent parameter is optional. When -silent is specified, then no prompts or informational messages are displayed in the console, but the errors are written to the log. Failure messages and validation error messages are displayed as needed, such as messages about missing passwords or invalid port numbers. If you run the execute command to run all the tasks in a profile, and you specify the -silent parameter, you must also specify the -force parameter.
-help
The -help parameter is optional and displays a brief message on the command syntax instead of running the command.

generateupgrade command examples

Generate the upgrade configuration files when Servers.xml file does not exists.
The following command generates the upgrade configuration XML files for a server named ceserver1 from an existing Content Engine cluster deployment that uses the profile UpgradeServer1 in the default profile directory:
configmgr_cl generateupgrade -deploy cluster -profile UpgradeServer1
Display the help for the generateupgrade command.
The following command displays the help for the generateupgrade command:
configmgr_cl generateupgrade -help


Feedback

Last updated: November 2010


© Copyright IBM Corporation 2010.
This information center is powered by Eclipse technology. (http://www.eclipse.org)