Configuring Documentum Site Caching Services Target to XML Store

Ed Ramirez
500 Discovery Parkway Suite 200
Superior, CO 80027
www.infotrustgroup.com
Configuring Documentum Site Caching Services Target to XML Store
(Standalone)
Abstract
Per the EMC Documentum Site Caching Services Installation Guide, version 6.5, it describes the required
agent.ini file parameters needed to integrate the target software to the XML Store (Standalone). The
value for the key xhive_bootstrap_path is mentioned to be either set to the absolute path to the XML
Store (Standalone) bootstrap file or to the URL address of the xDB Server. The purpose of this technical
paper is share my findings that I had observed while configuring the two products together on MS
Windows OS.
Setup and Configuration Setting
XML Store (Standalone)
1. Prior to installing and configuring the Site Caching Services Target software, you should have the
XML Store (Standalone) software installed and have created a new xDB database. The Window
Service x‐hive_server should be running prior to launching the X‐Hive/DB Administrator client
(XHAdmin) to create a new xDB database in the X‐Hive federation.
Screenshot of X‐Hive/DB Administrator client:
2. Once in the XHAdmin client, you will not be able to connect or create a new database without
the xhive‐server Windows Service running as below:
Page 1 of 5

Ed Ramirez
500 Discovery Parkway Suite 200
Superior, CO 80027
www.infotrustgroup.com
Create SCS Target Software Configuration
1. Follow the directions under the Configuring the XML Store (Standalone) target section in the
EMC Documentum Site Caching Services Installation Guide, version 6.5 to configure an SCS
target instance.
2. When you have completed the installation of the SCS Target, the software configurator tool will
have created the [Drive]:\...\webcache_target\SCS\admin\config\[port]\agent.ini file with the
following default parameters:
[conn]
secure_connection=raw
transfer_directory=E:\apps\webcache_target\SCS\data\2788
http_port=2788
https_ca_cert=E:\apps\webcache_target\SCS\admin\keys\ca‐cert.der
https_server_cert=E:\apps\webcache_target\SCS\admin\keys\server‐cert.der
https_server_key=E:\apps\webcache_target\SCS\admin\keys\server‐key.der
check_pass=E:\apps\webcache_target\SCS\product\tools\dm_check_password.exe
target_database_connection=jdbc:odbc:local
database_user=webc_target
database_user_pass=SCS_ENCR_TEXT/xxxxxxxxxxxxxxxxx
log_file=E:\apps\webcache_target\SCS\admin\log\2788.log
auth_server=xxxxxxxxxxxxxxxxx
database_name=WebCache_2788
JDBC_DRIVER=sun.jdbc.odbc.JdbcOdbcDriver
clean_transfer_dir=false
xhive_publish_content=true
xhive_publish_metadata=true
xhive_bootstrap_path=E:\apps\xhive‐8.1.1\data\XhiveDatabase.bootstrap
xhive_database_name=webcache_target
xhive_admin_id=Administrator
xhive_admin_password=xxxxxxxxxxxxxxx
xhive_content_subscription_library=wip
xhive_file_filter=all
Page 2 of 5

Ed Ramirez
500 Discovery Parkway Suite 200
Superior, CO 80027
www.infotrustgroup.com
Observations
Using Bootstrap Method
1. As mentioned the EMC Documentum Site Caching Services Installation Guide, version 6.5, the
xhive_bootstrap_path value in the agent.ini file can either be the absolute path to the XML
Store (Standalone) database location (e.g. xhive_bootstrap_path=E:\apps\xhive‐
8.1.1\data\XhiveDatabase.bootstrap in the above example) or the URL path if the xDB is
running in server mode (e.g. xhive_bootstrap_path=xhive://localhost:1221).
2. If you configure the agent.ini file to use the bootstrap file, the xhive‐server Windows Service
must be turned off.
3. When the xhive‐server Window Service is turned‐off, you will not be able to connect the xDB
database through the X‐Hive/DB Administrator client and you will receive the following
connection error:
Page 3 of 5

Ed Ramirez
500 Discovery Parkway Suite 200
Superior, CO 80027
www.infotrustgroup.com
4. Open Documentum Administrator and create a new Site Publishing Configuration to the newly
created SCS Target and run the End to End test. If this fails with the following errors
May 22 15:38:54.921:T:Thread‐7: INFO: ‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐
May 22 15:38:54.937:T:Thread‐7: INFO: XML Store Driver initialization failed.
May 22 15:38:54.937:T:Thread‐7: INFO: com.documentum.webcache.utils.LCSException: XML Store connection failed
May 22 15:38:54.937:S: ERROR: Failed to connect to XML Store database on the target.
May 22 15:38:54.937:S: ERROR: Failed to connect to the target XML Store database.
Validate that the xhive‐server Windows service is NOT currently running.
Using xDB database running in Server Mode
1. Verify and start the xhive‐server Windows Service.
2. Launch the X‐Hive/DB Administrator client software and connect to the existing database
configured for the SCS target software.
3. Select the main menu option Settings/Federation ‐>Start server in adminclient option.
4. Prior to selecting the OK button, note the port value (e.g., 1221) and select the OK button.
Page 4 of 5

Ed Ramirez
500 Discovery Parkway Suite 200
Superior, CO 80027
www.infotrustgroup.com
5. Edit the [Drive]:\...\webcache_target\SCS\admin\config\[port]\agent.ini file with the following
default parameters:
xhive_bootstrap_path=xhive://localhost:1221
6. Restart the SCS Target software through Windows Services.
7. Open Documentum Administrator and create a new Site Publishing Configuration to the newly
created SCS Target and run the End to End test.
Page 5 of 5