Tuesday, November 19, 2013

How to make repository global repository manually? -- "No Global Registry Docbase found for host: xxxx"

Symptom
How to make repository global repository manually? and Install xPlore and configure a new index agent against any repository either Global or Non-Global. You may get an error: No global registry docbase found. However all apps are working fine.

The user has upgraded content server from 5.x to 6.x. Now they are trying to configure IA (xPlore), and has manually activated the global registry. This manual update process had missed to update object dm_docabse_config attribute docbase_roles[0] with value Global Registry. Though it's an internal attribute which is taken care automatically at the time of global registry configuration during docbase upgrade.

In case, it was updated manually then this issue is expected as when one configure IA (xPlore) against a repository regardless of Global or Non- Global, installer going to check global repository's dm_docabse_config attribute  docbase_roles[0] value if it's a Global Registry or not. If it won't find it, it going to fail with "No Global Registry Docbase found for host: xxxx"

Resolution
Follow solution ID esg106683 (listed below) to resolve the issue.

To enable a repository as a global registry after configuration, you must activate the dm_bof_registry user.
1.     Access Documentum Administrator in a browser and connect to the repository.
2.     Navigate to Administration > User Management > Users.
3.     Locate the user named dm_bof_registry and select View > Properties > Info to access the User Properties - Info page.
4.     Verify that the username attribute is set to dm_bof_registry. The value dm_bof_registry is required.
5.     Optionally, change the user login name to a new value.
6.     Change the user's password.
7.     Set the dm_bof_registry user's status to Active.
8.     Click OK to save the user.
9.     During DFC installation on client machines, such as the Webtop or Documentum Administrator hosts, provide the user login name and password. This updates the dfc.properties file and enables that DFC installation to contact the global registry as required.
10.   To manually modify the dfc.properties file to designate a global registry repository and user credentials:
1.     On the DFC host, navigate to $DOCUMENTUM/config (UNIX or Linux) or %DOCUMENTUM%\config (Windows).
2.     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. In step d, enter the encrypted form of this password in the dfc.properties file.
3.     Open the dfc.properties file in a text editor.
4.     Modify the following attributes:
dfc.globalregistry.repository=global_registry_repository_name
dfc.globalregistry.username=user_login_name
dfc.globalregistry.password=encryped_password_of_user
where encryped_password_of_user is the encrypted password you generated in step b.
5.     Save the dfc.properties file.
In addition to the above instructions, one need to update dm_docabse_config attribute  docbase_roles[0] with value Global Registry in  order to avoid below xPlore index Agent configuration issue against the global repository.

"No Global Registry Docbase found for host: xxxx"


iapi>retreive,c,dm_docbase_config
iapi>set,c,l,docbase_roles[0]
data>Global Registry
iapi>save,c,l
iapi>reinit,c