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:
- Open
your completed Installation and Upgrade Worksheet file.
Tip: In the worksheet file, verify that the command is enabled. To view only Configuration Manager values, filter
by CM: Configure bootstrap properties in the Installation
or Configuration Program column.
- 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.
- Right-click Configure
Bootstrap Properties and Text Extraction in the profile
pane and select Edit Selected Task.
- In the Bootstrap operation field, select
Upgrade.
-
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.
- Click to
save your changes.
-
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.
- 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.
- 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.
- Close the Configure
Bootstrap Properties and Text Extraction task pane.
- 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.