Since D6.0 release, Documentum has made it mandatory to use global registry for every installation. If you are planning to have one docbase for your environment, you can make same docbase as global repository. Best practice is you should have separate docbase and make it global registry. This is useful in case of multi docbase environments. During content server installation, it is optional to specify global registry. But it should be configured for client applications. If client application uses Business Object Framework (BOF), you really need to have one of the repository as BOF global registry. The global registry is specified in dfc.properties
Following are the steps for setting up global registry.
1. Activate “dm_bof_registry” user in the repository.
1.1. Using Documentum Administrator (DA), log into the repository that should be the BOF Global Registry, using an administrator account.
1.2. In Classic view, in the left navigation tree, click on the Administration -> User Management -> Users
1.3. Search the dm_bof_registry user
1.4. View the properties of dm_bof_registry user .
1.5. Verify that the user name attribute is set to dm_bof_registry.
1.6. Set the dm_bof_registry user’s State to Active.
1.7. Click Ok to save the user.
2. Make sure that the dfc.properties file on your client application is referring to correct BOF global registry
2.1. For each client application, locate the dfc.properties file. For most client applications like WebTop, DA, dfc.properties is located at <app-folder>/WEB_INF/classes/dfc.properties
2.2. Open this file in any text editor. Ensure the following three attributes are set
dfc.bof.registry.repository = <name_of_global_repository>
dfc.bof.registry.username = dm_bof_registry
dfc.bof.registry.password = <encrypted_password>
2.3. You need to encrypt the password for dm_bof_registry user using DFC encryption tool
2.4. On client application host, navigate to $DOCUMENTUM/config (UNIX or Linux) or %DOCUMENTUM%config (Windows). From a command prompt, execute the following command to generate the encrypted form of the global registry user’s password:
java -cp dfc.jar com.documentum.fc.tools.RegistryPasswordUtils password_of_user
where password_of_user is the global registry user’s clear-text password.
2.5. Set the encrypted password in dfc.properties and save the file.
2.6. Restart the application server for your client application
3. Verifying that the repository is global registry
3.1. Login to Documentum Administrator (DA) using an administrator account.
3.2. On home page, you will see “Global Repository” property. It should be same repository that should be the BOF Global Registry.
Download PDF version of this post
Contact us, if you need more info on this topic.
