8.10 Configuring Connector for EMC Documentum

Note: LiveCycle supports EMC Documentum, versions 6.0, 6.5 and 6.7 SP1 only. Make sure your ECM is upgraded accordingly.

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 Connector for EMC Documentum as part of your LiveCycle, complete the following procedure to configure the service to connect to the Documentum repository.

Configure Connector for EMC Documentum

Locate the adobe-component-ext.properties file in the [appserverdomain] folder (if the file does not exist, create it).

Add a new system property that provides the following Documentum Foundation Classes JAR files:

dfc.jar
aspectjrt.jar
log4j.jar
jaxb-api.jar
(For Connector for EMC Documentum 6.5 only)
- configservice-impl.jar,
- configservice-api.jar

The new system property should take on this form:

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

For example, using default Content Server and Documentum Foundation Classes installations, add to the file one of the following system properties on a new line, with no line breaks, and end the line with a carriage return:

Connector for EMC Documentum 6.0 only:

    com.adobe.livecycle.ConnectorforEMCDocumentum.ext= 
    C:/Program Files/Documentum/Shared/dfc.jar, 
    C:/Program Files/Documentum/Shared/aspectjrt.jar, 
    C:/Program Files/Documentum/Shared/log4j.jar 
    C:/Program Files/Documentum/Shared/jaxb-api.jar

Connector for EMC Documentum 6.5 only:

com.adobe.livecycle.ConnectorforEMCDocumentum.ext= 
C:/Program Files/Documentum/Shared/dfc.jar, 
C:/ProgramFiles/Documentum/Shared/aspectjrt.jar, 
C:/Program Files/Documentum/Shared/log4j.jar, 
C:/Program Files/Documentum/Shared/jaxb-api.jar, 
C:/Program Files/Documentum/Shared/configservice-impl.jar, 
C:/Program Files/Documentum/Shared/configservice-api.jar

Note: The above text contains formatting characters for line breaks. If you copy and paste this text, you must remove the formatting characters.

Connector for EMC Documentum 6.7 SP1 only:

com.adobe.livecycle.ConnectorforEMCDocumentum.ext= 
C:/Program Files/Documentum/Shared/dfc.jar, 
C:/ProgramFiles/Documentum/Shared/aspectjrt.jar, 
C:/Program Files/Documentum/Shared/log4j.jar, 
C:/Program Files/Documentum/Shared/jaxb-api.jar, 
C:/Program Files/Documentum/Shared/configservice-impl.jar, 
C:/Program Files/Documentum/Shared/configservice-api.jar 
C:/Program Files/Documentum/Shared/commons-codec-1.3.jar 
C:/Program Files/Documentum/Shared/commons-lang-2.4.jar

Note: The above text contains formatting characters for line breaks. If you copy and paste this text, you must remove the formatting characters.

Repeat previous steps on each application server instance of the cluster.
Open a web browser and enter this URL:
```
http://[host]:[port]/adminui
```
Log in using the default user name and password:

User name: administrator

Password: password
Navigate to Services > LiveCycle ES3 Connector for EMC Documentum > Configuration Settings and perform these tasks:
- Type all the required Documentum repository information.
- To use Documentum as your repository provider, under Repository Service Provider Information, select EMC Documentum Repository Provider, and then click Save. For more information, click the Help link in the upper-right corner of the page in the Administration Help.
(Optional) Navigate to Services > LiveCycle ES3 Connector for EMC Documentum > Repository Credentials Settings, click Add, specify the Docbase information, and then click Save. (For more information, click Help in the upper-right corner.)
If the application server is not currently running, start the server. Otherwise, stop and then restart the server.
Open a web browser and enter this URL.
```
http://[host]:[port]/adminui
```
Log in using the default user name and password:

User name: administrator

Password: password
Navigate to Services > Applications and Services > Service Management and select these services:
- EMCDocumentumAuthProviderService
- EMCDocumentumContentRepositoryConnector
- EMCDocumentumRepositoryProvider
Click Start. If any of the services do not start correctly, check the settings you completed earlier.
Do one of the following tasks:
- To use the Documentum Authorization service (EMCDocumentumAuthProviderService) to display content from a Documentum repository in the Resources view of Workbench, continue with this procedure. Using the Documentum Authorization service overrides the default LiveCycle authorization and must be configured to log in to Workbench using Documentum credentials.
- To use the LiveCycle repository, log in to Workbench by using the LiveCycle super administrator credentials (by default, administrator and password).
You have now completed the required steps for this procedure. Use the credentials provided in step 19 for accessing the default repository in this case and use the default LiveCycle authorization service.
Restart the application server.
Log in to Administration Console and click Settings > User Management > Domain Management.
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: (WebLogic and WebSphere only) When using DB2 for your LiveCycle database, the maximum permitted length of the ID is 100 single-byte (ASCII) characters or 50 double-byte characters or 25 four-byte characters. (See “Adding enterprise domains” in Administration Help.)
Add a custom authentication provider:
- Click Add Authentication.
- In the Authentication Provider list, select Custom.
- Select EMCDocumentumAuthProvider and then click OK.
Add an LDAP authentication provider:
- Click Add Authentication.
- In the Authentication Provider list, select LDAP, and then click OK.
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.
- Click Next, configure the user settings, click Next, configure group settings, as required, and then click Next.
  
  For details about the settings, click User Management Help in the upper-right corner of the page.
Click OK to exit the Add Directory page and then click OK again.
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.

(Optional) To verify the status of the synchronization, click Refresh and view the status in the Current Sync State column.
Navigate to Settings > User Management > Users and Groups.
Search for users that were synchronized from LDAP and perform these tasks:
- Select one or more users and click Assign Role.
- Select one or more LiveCycle roles and click OK.
- Click OK a second time to confirm the role assignment.
  
  Repeat this step for all users that you assign roles to. For more information, click User Management Help in the upper-right corner of the page.
Start Workbench and log in by using the credentials for the Documentum repository:

Username: [username]@[repository_name]

Password: [password]

After you log in, the Documentum repository appears in the Resources view within Workbench. If you do not log in using the username@repository_name, Workbench attempts to log in to the default repository.
(Optional) To install the LiveCycle Samples for Connector for EMC Documentum, create a Documentum repository named Samples, and then install the samples in that repository.

After you configure the Connector for EMC Documentum service, see LiveCycle Administration Help for information about configuring Workbench with your Documentum repository.