6.11 Configuring the Connector for IBM Content Manager

Note: AEM forms supports IBM Content Manager. See the Supported Platform Combinations document and make sure your ECM is upgraded to the supported version.
Note: Ensure that installing client for the connectors, copying of JAR's file and configuration changes tasks are performed on all the nodes of the cluster.

If you installed the Connector for IBM Content Manager as part of your AEM forms installation, complete the following procedure to configure the service to connect to the IBM Content Manager datastore.

Configure Connector for IBM Content Manager

  1. Locate the adobe-component-ext.properties file in the [appserver root] /bin folder. If the file does not exist, create it.

  2. Add a new system property that provides the location of the following IBM II4C JAR files:

    • cmb81.jar

    • cmbcm81.jar

    • cmbicm81.jar

    • cmblog4j81.jar

    • cmbsdk81.jar

    • cmbutil81.jar

    • cmbutilicm81.jar

    • cmbview81.jar

    • cmbwas81.jar

    • cmbwcm81.jar

    • cmgmt

    Note: cmgmt is not a JAR file. On Windows, by default, this folder is at C:/Program Files/IBM/db2cmv8/ .

    • common.jar

    • db2jcc.jar

    • db2jcc_license_cisuz.jar

    • db2jcc_license_cu.jar

    • ecore.jar

    • ibmjgssprovider.jar

    • ibmjsseprovider2.jar

    • ibmpkcs.jar

    • icmrm81.jar

    • jcache.jar

    • log4j-1.2.8.jar

    • xerces.jar

    • xml.jar

    • xsd.jar

    The new system property looks similar to the following: 

    [component id].ext=[JAR files and/or folders]

    For example, using a default DB2 Universal Database Client and II4C installation, in the file, add the following system property on a new line, with no line breaks, and end the line with a carriage return: 

            C:/Program Files/IBM/db2cmv8/cmgmt, 
        C:/Program Files/IBM/db2cmv8/java/jre/lib/ibmjsseprovider2.jar, 
        C:/Program Files/IBM/db2cmv8/java/jre/lib/ibmjgssprovider.jar, 
        C:/Program Files/IBM/db2cmv8/java/jre/lib/ibmpkcs.jar, 
        C:/Program Files/IBM/db2cmv8/java/jre/lib/xml.jar, 
        C:/Program Files/IBM/db2cmv8/lib/cmbview81.jar, 
        C:/Program Files/IBM/db2cmv8/lib/cmb81.jar, 
        C:/Program Files/IBM/db2cmv8/lib/cmbcm81.jar, 
        C:/Program Files/IBM/db2cmv8/lib/xsd.jar, 
        C:/Program Files/IBM/db2cmv8/lib/common.jar, 
        C:/Program Files/IBM/db2cmv8/lib/ecore.jar, 
        C:/Program Files/IBM/db2cmv8/lib/cmbicm81.jar, 
        C:/Program Files/IBM/db2cmv8/lib/cmbwcm81.jar, 
        C:/Program Files/IBM/db2cmv8/lib/jcache.jar, 
        C:/Program Files/IBM/db2cmv8/lib/cmbutil81.jar, 
        C:/Program Files/IBM/db2cmv8/lib/cmbutilicm81.jar, 
        C:/Program Files/IBM/db2cmv8/lib/icmrm81.jar, 
        C:/Program Files/IBM/db2cmv8/lib/db2jcc.jar, 
        C:/Program Files/IBM/db2cmv8/lib/db2jcc_license_cu.jar, 
        C:/Program Files/IBM/db2cmv8/lib/db2jcc_license_cisuz.jar, 
        C:/Program Files/IBM/db2cmv8/lib/xerces.jar, 
        C:/Program Files/IBM/db2cmv8/lib/cmblog4j81.jar, 
        C:/Program Files/IBM/db2cmv8/lib/log4j-1.2.8.jar, 
        C:/Program Files/IBM/db2cmv8/lib/cmbsdk81.jar, 
        C:/Program Files/IBM/db2cmv8/lib/cmbwas81.jar

  3. If the application server is not currently running, start the server; otherwise, stop and then restart the server.

You can now connect to the IBM Content Manager datastore from the IBMCMConnectorService Property Sheets by using the Use User Credentials as the login mode.

You have now completed the required steps for this procedure.

(Optional) If you want to connect to IBM Content Manager datastore from IBMCMConnectorService Property Sheets by using the Use Credentials From Process Context as the login mode, complete the following procedure.

Connect using Use Credentials from process context login mode

  1. Open a web browser and enter this URL:

    http:// [host] : [port] /adminui

  2. Log in using the super administrator credentials. Default values set during installation are:

    User name: administrator

    Password: password

  3. Click Services > Connector for IBM Content Manager

  4. Type all of the required repository information and click Save . For more information about the IBM Content Manager repository information, click the Help link in the upper-right corner of the page.

  5. Do one of these tasks:

    • To use the IBM Content Manager Authorization service IBMCMAuthProvider to use content from an IBM Content Manager datastore, in the Processes view of Workbench, continue with this procedure. Using the IBM Content Manager Authorization service overrides the default AEM forms authorization and must be configured to log in to Workbench by using IBM Content Manager credentials.

    • To use the System Credentials provided in step 4 to use content from an IBM Content Manager datastore, in the Processes view of Workbench, log in to Workbench by using the AEM forms super administrator credentials (by default, administrator and password ). You have now completed the required steps for this procedure. The System Credentials that are provided in step 4 use the default AEM forms authorization service for accessing the default repository in this case.

  6. Log in to the administration console, and click Settings > User Management > Domain Management .

  7. Click New Enterprise Domain and type a domain ID and name. The domain ID is the unique identifier for the domain. The name is a descriptive name for the domain.

    Note: When using MySQL for your AEM forms database, use only single-byte (ASCII) characters for the ID. (See Adding enterprise domains in administration help .)

  8. Add a custom authentication provider:

    • Click Add Authentication .

    • In the Authentication Provider list, select Custom , and then select IBMCMAuthProviderService and click OK .

  9. Add an LDAP authentication provider:

    • Click Add Authentication .

    • In the Authentication Provider list, select LDAP and then click OK .

  10. Add an LDAP directory:

    • Click Add Directory .

    • In the Profile Name box, type a unique name, and then click Next .

    • Specify values for the Server , Port , SSL , Binding , and Populate page with options. If you select User for the Binding option, you must also specify values for the Name and Password fields. (Optional) Select Retrieve Base DN to retrieve base domain names, as required. When finished, click Next .

    • Configure the user settings, click Next , configure group settings as required, and then click Next .

    For details about the above settings, click the Help link in the upper-right corner of the page.

  11. Click OK to exit the Add Directory page and click OK again.

  12. Select the new enterprise domain and click Sync Now . Depending on the number of users and groups in your LDAP network and the speed on your connection, the synchronization process may take several minutes.

  13. To verify the status of the synchronization, click Refresh and view the status in the Current Sync State column.

  14. Navigate to Settings > User Management > Users and Groups .

  15. Search for users that were synchronized from LDAP and do these tasks:

    • Select one or more users and click Assign Role .

    • Select one or more AEM forms roles and click OK .

    • Click OK a second time to confirm the role assignment.

    Repeat this step for all users that you want to assign roles to. For more information, click the Help link in the upper-right corner of the page.

  16. Start Workbench and log in using the following credentials for IBM Content Manager datastore:

    Username: [username]@[repository_name]

    Password: [password]

    The IBM Content Manager datastore can now be used in the Processes view within Workbench when the login mode for IBMCMConnectorService orchestrable components is selected as Use Credentials from process context.

// Ethnio survey code removed