(V5.5.0 or upgrades from versions earlier than V5.5.1) Configuring the bootstrap and text extraction settings

The bootstrap settings are for locating the global configuration database (GCD) and for starting Content Platform Engine. The text extraction setting is needed for updating the Content Platform Engine EAR file with the IBM® Content Search Services API JAR files and text extraction modules.

Before you begin

Be sure that you have available the Installation and Upgrade Worksheet that was filled out during your planning activities.

If you plan to configure Content Platform Engine to use the directory server's email attribute (or for Active Directory, the userPrincipalName) as the user short name that is used for login, then you must perform additional configuration steps and enter specific values for your bootstrap settings. For detailed steps, see Configure Content Platform Engine to use email or UPN for login.

If your FileNet® P8 domain uses multiple non-managed application servers, then complete this procedure only on the initial server. You use a copy of the same EAR file with the bootstrap settings on all the servers.

About this task

Note: During the upgrade to V5.5.1 or higher, you must run the Configure Bootstrap and Text Extraction Settings task one last time to facilitate the transfer of credentials to the database. After the upgrade to V5.5.1 or higher is complete, this task is no longer needed.

Procedure

To edit the bootstrap settings and text extraction:

  1. Open your completed Installation and Upgrade Worksheet file.
    Tip: In the worksheet file, verify that the Data > Filter > AutoFilter command is enabled. To view only Configuration Manager values, filter by CM: Configure bootstrap properties in the Installation or Configuration Program column.
  2. If your configuration profile is not open in Configuration Manager, open the profile.
    The Configuration Manager profile is the one you created to perform the upgrade.
  3. Right-click Configure Bootstrap Properties and Text Extraction in the profile pane and select Edit Selected Task.
  4. In the Bootstrap operation field, select Upgrade.
  5. In the Bootstrapped EAR file field, enter the path to the Content Platform Engine EAR file.

    The Deploy Application task that you run later looks for the Bootstrapped EAR file by name in the absolute_path_to_profiles_directory/my_profile/ear directory. If your bootstrapped EAR file is named differently or is in some other location, copy it to the my_profile/ear directory and rename it to follow the naming convention: Engine-appserver.ear before you run the Configure Bootstrap and Text Extraction task.

    Note that the default value in the Bootstrapped EAR file field might not match this required path and file location. Update this field value to the path that is required by the Deploy Application task, for example:

    WebSphere Application Server: absolute_path_to_profiles_directory/my_profile/ear/Engine-ws.ear

    or

    WebLogic: absolute_path_to_profiles_directory/my_profile/ear/Engine-wl.ear

    If the EAR file is not in the configuration manager profile that was created for the upgrade, obtain a copy from the existing system and place it in the required location with the required name.

    You might also find a backup of the EAR file from a previous deployment on the system that was previously used to run the Configure Bootstrap Properties and Text Extraction task, in the following location: ce_install_path/lib/_backup/my_profile.

  6. Click File > Save to save your changes.
  7. Ensure that the task is enabled.
    When the task is disabled, the task name includes the text (disabled). To enable the task, select Configure Bootstrap and Text Extraction (disabled) in the profile pane, and then right-click and click Enable Task from the menu.
  8. Optional: Click View Bootstrapped EAR Information to display the bootstrap information from the modified EAR file.
    Make a note of the GCD data source names for use in the Deploy Application task.
  9. Apply the bootstrap property settings by right-clicking Configure Bootstrap and Text Extraction in the profile pane, and select Run Task.
    Running the configuration task can take a few minutes. The task execution status messages are displayed in the console pane below the bootstrap properties.
  10. Close the Configure Bootstrap Properties and Text Extraction task pane.
  11. If your FileNet P8 domain uses multiple non-managed application servers, then copy the absolute_path_to_profiles_directory/my_profile/ear/Engine-app_server_type.ear file to the profiles directory on each additional Content Platform Engine server.
    absolute_path_to_profiles_directory
    The fully qualified location of your Configuration Manager profiles.
    my_profile
    The directory for the Configuration Manager profile that you created.
    Engine-app_server_type.ear
    The EAR file for your application server type: Engine-ws.ear or Engine-wl.ear.
    Important: Run the Configure Bootstrap and Text Extraction task only on the initial server.