IBM Support

Using IBM Content Collector for File Systems with IBM Cloud Pak for Business Automation

How To


Summary

IBM Content Collector 4.0.1 fix pack 12 (4.0.1.12) supports using IBM Cloud Pak for Business Automation as a repository for Content Collector for File Systems without full-text indexing.

Objective

Setting up a new server to use the IBM Cloud Pak for Business Automation as a repository for Content Collector for File Systems.

Steps

Perform the following steps to set up the Content Collector server (ICC Server).
Setting up Content Collector Server to use Cloud Pak for Business Automation with File Systems
  1. Download the Content Platform Engine API package from the Cloud Pak for Business Automation user portal or use the traditional on-premises Content Platform Engine Client and API package.
  2. Install the Web Services Enhancements.
  3. Install the Content Platform Engine .Net API (FileNetApiSetup.msi) and confirm the .Net API version in the Control Panel.
  4. If the Content Platform Engine API package is downloaded from the Cloud Pak for Business Automation user portal, perform the following steps:
    1. Create a directory structure and copy all the files from the cpeapilib folder (downloaded in Step 1) to the following path:
      C:\Program Files\IBM\FileNet\CEClient\lib
    2. Take a backup of the version.txt file from the cpeapilib folder and place it in the following location:
      C:\Program Files\IBM\FileNet\CEClient
    3. Rename the version.txt file to ce_version.txt.
  5. Install Content Collector 4.0.1 fix pack 12 (4.0.1.12) (from the IBM Fix Central) with File Systems as Source and FileNet P8 as Repository.
    Ignore any 'prerequisites missing' warning for IBM FileNet Content Engine Client on the Preinstallation Summary page, as shown in the following screenshot:

    Screenshot of the Content Collector pre-installation summary
    Image 1: Screenshot of the Content Collector preinstallation summary
     
  6. Add the following environment variable and reboot the system:
    Variable name: IBMAFUFNCEROOT
    Value: C:\Program Files\IBM\FileNet\CEClient
  7. Set the following variable in the startInitialConfig.bat file located at <IBM_installation_folder>\Configuration:
    IBMAFUFNCEROOT= C:\Program Files\IBM\FileNet\CEClient
  8. Set the following variable in the AfuEnv.bat file located at <IBM_installation_folder>\AFUWEB:
    FNCEPATH= C:\Program Files\IBM\FileNet\CEClient
  9. Establish a trust relationship between the Content Collector Web Application Server and Cloud Pak for Business Automation:
    1. Obtain Cloud Pak for Business Automation Root CA certificate
      1. Login to the OCP console using the Cloud Pak for Business Automation admin operator.
      2. Select the appropriate project.
      3. Go to Workloads on the left pane and click Secrets.
      4. Search for a secret ending with root-ca.
      5. Open the secret and copy the tls.crt value.
      6. Save the contents in a new file with .cer extension.
    2. For further steps, refer to the 'Establishing a trust relationship with IBM FileNet P8' section in Migrating IBM embedded WebSphere Application Server to IBM WebSphere Application Liberty Server.
  10. Open Microsoft Management tool (Start > Run > MMC).
    1. Go to File > Add/Remove Snap-in.
    2. Double-click Certificates from the list of Available snap-ins, and select Computer Account.
    3. Click Next and select Local Computer, and then click Finish.
    4. Click OK to exit the Snap-in window and to go to Console Root.
    5. Expand Certificates > Trusted Root Certification Authorities > Certificates.
    6. Right-click Certificates > All Tasks > Import to open the Certificate Import Wizard, and click Next.
    7. Browse to the location where you have stored the certificate and select the .cer file saved in step 9. Click Next.
      Make sure the Certificate Store is set to Trusted Root Certification Authorities.
    8. Click Finish and wait until you see the success message: "The import was successful".
  11. Open the browser to check if the following link opens successfully:
    https://<SERVER_NAME>:<port>/AFUWeb/isAlive.jsp
  12. Launch the Initial Configuration Wizard and complete the steps.
  13. After the initial configuration, open the newly created catalog and navigate to the P8 Connector.
    1. Ensure that the status of the P8 Connection Set is not in the 'error' state.
    2. If the initial configuration or P8 Connection Set fails with the following error message, cross-check whether the certificate downloaded in step 9 is a Root CA certificate and not an intermediate self-signed certificate:
      System.Net.WebException: The underlying connection was closed: Could not establish trust relationship for the SSL/TLS secure channel" and "System.Security.Authentication.AuthenticationException: The remote certificate is invalid according to the validation procedure.

Document Location

Worldwide

[{"Type":"MASTER","Line of Business":{"code":"LOB45","label":"Automation"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSAE9L","label":"Content Collector"},"ARM Category":[{"code":"a8m0z000000cy6mAAA","label":"Compatibility-\u003EICC"},{"code":"a8m0z000000bmyXAAQ","label":"Configuration-\u003EConfiguring Content Collector"}],"ARM Case Number":"","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"4.0.1"}]

Document Information

Modified date:
22 February 2022

UID

ibm16468439

Page Feedback