Tasks generated by the generateConfig command
Based on the parameters that you specify when you run the generateConfig command, the command-line interface generates the tasks that you need to configure and deploy IBM® Content Navigator, IBM ECM CMIS, or IBM FileNet® Collaboration Services in your environment.
An XML file is created for each required task; the files are added to the directory that you specified in the –profile parameter when you ran the generateConfig command. You must edit the configuration XML files to provide values for your environment and then run each task by using the execute command.
The order in which the tasks must be run is shown in the .cfgp file that is created by the generateConfig command in the profile directory.
The following table describes the tasks that the generateConfig command creates.
| Task Name | Description |
|---|---|
| applicationserver |
Required: Yes. The information in this task is required, but you do not need to run this task. Description: Enables the IBM Content Navigator Configuration and Deployment Tool to communicate with the web application server where you plan to deploy your web application. The task contains the application server details that you entered in the following worksheets:
|
| downloadcejarstask | Required: For the following types of applications:
This task is required only if the version of the Content Engine connector files that are installed with IBM Content Navigator do not match the version of the files on your Content Engine or Content Platform Engine server. Prerequisites: Ensure
that you are running a supported version of Content Engine or Content Platform Engine before you run this task.
Description: Downloads the correct version of the client connector files from the Content Engine or Content Platform Engine server. The task contains the values that you entered in the following worksheets:
|
| configureodwek | Required: For IBM Content Navigator
applications connecting toIBM Content Manager OnDemand repositories only. Prerequisites: Install IBM Content Manager OnDemand Web
Enablement Kit on the
IBM Content Navigator server before you run this
task.
Description: Enables the web client to connect to IBM Content Manager OnDemand repositories and tells the web client where to find the Content Manager OnDemand Web Enablement Kit. The task contains the values that you entered in the Worksheet for configuring the Content Manager OnDemand connector. |
| configurepe | Required: For IBM Content Navigator
applications connecting to IBM Content Cortex repositories only. This task is required only if you want to use IBM Content Cortex workflows in IBM Content Navigator. Prerequisites: Before you run
this task:
Description: Registers the IBM Content Navigator application in Process Engine and creates the IBM Content Navigator step processor in the isolated region. The task contains the values that you entered in the Worksheet for configuring Process Engine for IBM Content Navigator. |
| configurecmisp8 | Required: For IBM CMIS for FileNet Content Manager applications
only. Description: Enables the IBM CMIS for FileNet Content Manager web application to communicate with your IBM Content Cortex repository. The task contains the values that you entered in the Worksheet for configuring IBM CMIS for FileNet Content Manager. To configure any optional properties, you must manually edit the cmis.properties file. For information on configuring additional properties, see Configuring additional IBM CMIS for Content Manager settings. |
| configurejdbcjarsecm | Required: For the following types of applications on WebSphere Application
Server:
Prerequisites: Copy the JDBC drivers for your database or
IBM Content Manager library server database to the IBM Content Navigator server before you run this task.
Description:
|
| configurecm8task | Required: For IBM Content Navigator
applications connecting to IBM Content Manager repositories
only. Description: Enables the web client to connect to IBM Content Manager repositories by enabling IBM Content Navigator to communicate with your IBM Content Manager library server. Restriction: You can configure
IBM Content Navigator to connect to IBM Content Manager only if you deploy IBM Content Navigator on WebSphere Application
Server.
The task contains the values that you entered in the Worksheet for configuring the Content Manager connector. |
| configurecmiscmtask | Required: For IBM CMIS for Content Manager
applications only. Description: Enables the IBM CMIS for Content Manager web application to communicate with your IBM Content Manager library server. To configure any optional properties, you must manually edit the cmpathservice.properties file. For information on configuring additional properties, see Configuring additional IBM CMIS for Content Manager settings. The task contains the values that you entered in the Worksheet for configuring IBM CMIS for Content Manager. |
| configurejdbcecm | Required: For IBM Content Navigator
applications only. Prerequisites: If you have an existing data source
that uses the same name as the data source that you plan to use when you run this task, you must use
your application server administration tools to manually remove the data source before you run this
task. If you do not remove the existing data source, you cannot run the task successfully.
You must have an existing database and a database ID before you run this task. Description: Creates a data source connection that enables the web client to connect to the IBM Content Navigator database. IBM Content Navigator stores configuration information and user preferences in a database. This task also updates a script that you can run to build and populate the IBM Content Navigator database on your database instance. Optionally, you can also configure this task to run the script on your database instance. The task contains the values that you entered in the Data source and database configuration worksheets. |
| configureldap | Required: For the following types of applications:
If you have an LDAP configuration on the web application server where you are deploying IBM Content Navigator or IBM CMIS for FileNet Content Manager and the LDAP configuration matches the settings on your Content Engine or Content Platform Engine LDAP repository, you do not need to run this task. Description: Configures your web application server to use the Content Engine or Content Platform Engine LDAP repository. Important: The values that you enter must match the values that are set
on your Content Engine or Content Platform Engine
server.
The IBM Content Navigator Configuration and Deployment Tool does not include every option that you can set when configuring your LDAP server connection. Work with your LDAP server administrator to determine if there are any settings that you must configure that are not included in the IBM Content Navigator Configuration and Deployment Tool. If your LDAP server connection includes additional settings, you must manually update your LDAP server connection on your web application server after you run this task. You can open the administrative console for the web application server for Content Engine or Content Platform Engine to ensure that your LDAP configurations match. The task contains the values that you entered in the following
worksheets:
|
| importltpakey | Required: For the following types of applications on WebSphere Application
Server:
If you plan to deploy IBM Content Navigator or IBM CMIS for FileNet Content Manager in the same cell as Content Engine or Content Platform Engine on WebSphere Application Server, you do not need to run this task. Prerequisites: You must export the
LTPA key file from the Content Engine or Content Platform Engine server and save it to the IBM Content Navigator server before you run this task.
Description: Imports your Content Engine or Content Platform Engine LTPA key to the web application server to enable IBM Content Navigator or IBM CMIS for FileNet Content Manager to authenticate to the Content Engine or Content Platform Engine server. The task contains the values that you entered in the following worksheets:
|
| configureloginmodules | Required: For IBM Content Navigator
applications on WebSphere Application
Server only. This task is required regardless of the types of repositories that you plan to connect to from IBM Content Navigator. Description:IBM Content Navigator uses Java Authentication and Authorization Service (JAAS) to authenticate users’ login credentials. This task configures your web application server to use JAAS authentication. The task contains the values that you entered in the Worksheet for configuring JAAS authentication on your web application server. |
| configurecmisauthenticationtask | Required: For IBM ECM CMIS applications
on WebSphere Application
Server only. Description: Enables you to specify the authentication method that client applications use when sending requests to your IBM ECM CMIS web application. The task contains the values that you entered in the Worksheet for configuring the IBM ECM CMIS authentication method. |
| configuretmtask | Required: In the following situations:
Description: Configures the task manager component. The task contains the values that you entered in the Worksheet for configuring the task manager component. |
| configurefncstask | Required: For FileNet Collaboration
Services applications
only. Description: Configures FileNet Collaboration Services. The task contains the values that you entered in the Worksheet for configuring IBM FileNet Collaboration Services. |
| configureicntask | Required: For IBM Content Navigator
applications only. Description: Collects the information that the IBM Content Navigator Configuration and Deployment Tool uses when it creates the IBM Content Navigator web application, such as the name of the application. The task contains the values that you entered in the Worksheet for configuring the IBM Content Navigator web application. |
| rebuildear | Required: Yes Prerequisites: If you are
running the tasks individually, you must run all of the other tasks to configure IBM Content Navigator for your environment before you run this
task.
Description: Builds the application EAR file that you deploy to your web application server. The task contains the values that you entered in the Worksheet for building the web application. |
| deployapplication | Required: Optional Prerequisites: You must
complete the other web application configuration tasks before you deploy the web application. If any
of the configuration tasks fail, the deployed web application will not work
properly.
Description: You must deploy the web application to your web application server. You can use the IBM Content Navigator Configuration and Deployment Tool to deploy the web application, or you can deploy the EAR file manually. The task contains
the values that you entered in the following worksheets:
|
If you
plan to deploy your web application in a highly available cluster, you must copy the driver to the
same directory on each node in your cluster.