FileNet P8 Content Engine, Version 5.0.+              

Establishing the FileNet P8 domain and Global Configuration Data (GCD)

With Content Engine installed and deployed, you must use IBM® FileNet® Enterprise Manager to create a FileNet P8 domain. You can also use Enterprise Manager to set a URL to the FileNet P8 online help if you did not specify the location when you ran the Content Engine installation program.

High availability Remember: Create only one FileNet P8 domain per highly available environment.

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

High availability Restriction: Using a load-balancer for the Enterprise Manager connection is not supported.
Important: If you run Enterprise Manager as a limited (non-administrative) user account, you cannot update the Base URL for the FileNet P8 Platform help files field in the General tab of the Enterprise Manager Properties dialog box. However, you can update the field later by logging on to Enterprise Manager as the gcd_admin user.
Tip: You can also use the Web-based IBM Administrative Console for Content Engine to accomplish this task. To do so, access http://ce_server_name:port/acce.login.jsp. from a Web browser client, log on as the gcd_admin user, and review the embedded assistance as needed. ce_server_name is the name of the system where Content Engine is deployed. port is the WSI port that is used by the application server on which Content Engine is deployed.
  1. Create a FileNet P8 domain:
    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 Enterprise Manager values for this task, filter by EM: Create FileNet P8 domain in the Installation or Configuration Program column.
    2. Start Enterprise Manager by double-clicking the Enterprise Manager icon on the desktop, or by clicking Start > All Programs > IBM FileNet P8 Platform > Enterprise Manager Administration Tool.
    3. Complete the wizard screens by using the values in your worksheet. The values displayed in the screens are default values that you must change to match your site.
  2. Configure directory service authentication.
    Important: For multi-realm authorization, run the Create a Directory Configuration wizard once for each realm. See the IBM FileNet P8 help topic Security > IBM FileNet P8 Security > How to... > Configure multiple realms.
    1. Return to your completed Installation and Upgrade Worksheet file.
      Tip: In the worksheet file, verify that the Data > Filter > AutoFilter command is enabled. To view only Enterprise Manager values for this task, filter by EM: Create a Directory Configuration in the Installation or Configuration Program column.
    2. In the FileNet P8 Logon dialog box, click Connect.
    3. In the Add Domain Configuration window, enter the values from your worksheet.
    4. In the Create P8 Domain window, enter the name for a new FileNet P8 domain from your worksheet and click Continue to start the Create a Directory Configuration wizard.

      If an error occurs, check the application server log file on the machine where Content Engine is deployed.

      Application server type Path to log file
      IBM WebSphere® Application Server WAS_install_path/AppServer/profiles/profile_name/logs/server_name/SystemOut.log
      Oracle WebLogic Server WLS_install_path/user_projects/domains/domain_name/servers/server_name/logs/server_name.log
      JBoss Application Server JBOSS_DIST/server/server_name/log/server_name.log
    5. Complete the wizard screens by using the values in your worksheet. The values displayed in the screens are default values that you must change to match your site.

      The Create a Directory Configuration wizard prompts you for many of the same parameters that you provided to Configuration Manager when you edited the Configure LDAP task.

      See the topic for your directory service provider in the IBM FileNet P8 help topic Security > IBM FileNet P8 Security > Directory service providers.

    6. In the Configure New Domain Permissions message box, click OK to acknowledge that the directory configuration is complete but remains in restricted mode. The Configure New Domain Permissions wizard automatically starts the first time you start Enterprise Manager if you have not defined any Global Configuration Data (GCD) administrators.
  3. Configure permissions for the FileNet P8 domain.
    1. Return to your completed Installation and Upgrade Worksheet file.
      Tip: In the worksheet file, verify that the Data > Filter > AutoFilter command is enabled. To view only Enterprise Manager values for this task, filter by EM: Configure New Domain Permissions in the Installation or Configuration Program column.
    2. Complete the wizard screens by using the values in your worksheet.
    3. In the Configure New Domain Permissions message box, click OK.
    After you complete this step, every other Content Engine server instance that starts in a farm or application server cluster can see the FileNet P8 domain.
  4. Check for errors in the p8_server_error.log file on the application server.
  5. Navigate to the level (domain, site, virtual server, or server instance) at which trace logging is configured, right-click the node at that level, and choose Properties.
  6. Click the Trace Control tab.
  7. If the current value of the Log File Output Location parameter is not consistent with the version of the application server, then edit the value as needed.

    The following table shows default locations, at the server instance level, for the trace log file, starting at install_root, the installation path for the application server.

    Application Server Type Path to Trace Log File
    IBM WebSphere Application Server install_root /profiles/profile_name/FileNet/server_name/ p8_server_trace.log
    Oracle WebLogic Server install_root/user_projects/domains/domain_name/FileNet/server_name/p8_server_trace.log
    JBoss Application Server install_root/bin/FileNet/server_name/p8_server_trace.log
  8. Click OK.
  9. Close Enterprise Manager.


Feedback

Last updated: November 2010


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