JavaBlog.fr / Java.lu Documentum,DQL DCTM,TOOLS DCTM Documentum : Introduction to ACS and BOCS

Documentum : Introduction to ACS and BOCS

Hello,

In this post, I would like introduce to Accelerated Content Server (ACS) and Branch Office Caching Services (BOCS).

In Documentum Administrator (DA) under the “Repository/ Administration” node, there are informations concerning the Distributed Content in the System Information:

01System Information  May 01, 2016 9:49:56 AM
02User :  mysuperuser/mysuperuser
03 
04++++++ Repository
05Repository : MY_DOCBASE_DEV     Content Storage Service : Enabled
06Federation : None           Content Intelligence : CIS disabled due to missing dar
07Global Repository : GLOBALR    
08 
09++++++ Content Server
10Content Server : MY_DOCBASE_DEV         Hostname : myDctmServer
11Server Version : 7.1.0190.0300 Win64.Oracle Connection Broker : MYDCTMSERVER
12Trusted Mode : Enabled 
13 
14++++++ Distributed Content
15Network Locations : 0       ACS Server : MYDCTMSERVERACS1
16BOCS Servers : 0        ACS Write : Enabled, Synchronous
17ACS Read : Enabled      BOCS Pre-caching : Enabled
18 
19++++++ LDAP Servers
20Enabled Servers : 5     Last Sync : 4/30/2016 10:06:14 AM
21Disabled Servers : 6

ACS
The Accelerated Content Server (ACS ) server is a content server dedicated to serving content. It does not process metadata nor write content to storage. It only processes content requests.
It gets installed automatically while installing the Documentum Content Server. After installation administrator needs to configure it for distributed environment.

In DA, the configuration of ACS are under “Repository/ Administration / Distributed Content Configuration / ACS Servers”.

1Name=MYDCTMSERVERACS1
2Content Server=MY_DOCBASE_DEV
3Content Access=Access from all stores
4Projections & Stores=Associated content server

In “Info” tab:

01Name :  MYDCTMSERVERACS1
02Associated Content Server : MY_DOCBASE_DEV
03 
04 
05ACS Server Version :    2.3
06 
07Content Access : [X] Access all stores
08         []Access local stores only
09         [] None(Disabled)
10 
11ACS Server Connections / Enter one connection for each unique base URL : http://myDctmServer:9080/ACS/servlet/ACS

Note : The URL http://myDctmServer:9080/ACS/servlet/ACS must return the ACS version like “ACS Server Is Running – Version : 7.1.0190.0156”.

In “Projections & Stores” tab:

1Source / Use projections and stores from:
2    [X] Associated content server : MY_DOCBASE_DEV
3    [] Settings entered here

Note: The following informations are thus automatically extracted from associated content server : MY_DOCBASE_DEV.

01Connection Broker Projections / Broadcast availability to these connection brokers
02TARGET HOST = MYDCTMSERVER
03PORT = 1489
04ENABLED = T
05 
06Network Location Projections / Serve content to users logging in from these network locations
07- No Network Location Projections
08 
09Local Stores / Content from local stores is immediately accessible
10Local Store         Type
11----------------        ---------------
12filestore_01            File Storage
13thumbnail_store_01      File Storage
14streaming_store_01      File Storage
15centera_store_no_retention  Content Addressable Storage
16replicate_temp_store        File Storage
17replica_filestore_01        File Storage
18encrypted_filestore_01      File Storage
19my_other_filestore_01       File Storage

… so, in DA, under “Repository/ Administration / Storage Management / Storage” node, we retrieve the configuration concerning the dm_location and dm_storage respectively filestore_01 and storage_01:

1Name=filestore_01   Type=dm_filestore   Size=1.75GB Status=Online
2 
3In "Info" tab:
4Location or Path    :  storage_01
5 
6In "Space Info" tab:
7Active Space/Files  :   12.73 GB / 388502912
8 
9Orphaned Space/Files    :   188.69 MB / 2204032
1Name=storage_01     Type=dm_location    Size=0KB    Status=Online
2 
3In "Info" tab:
4File System Path    :   Select Path \\MYFILESERVER\data\MY_DOCBASE_DEV\content_storage_01
5 
6Path Type   : Directory
7 
8Security Type   : [X] publicopen     [] public  [] private

… then, in DA, under “Repository / Administration / Types” node, we retrieve the dm_location=filestore_01 for a custom type:

01Type     :  my_custom_document
02 
03In "Info" tab:
04Type Name :   my_custom_document   
05 
06Super Type Name :     dm_document   
07 
08Default Storage :   filestore_01        
09 
10Default Group :   [None Selected]   Select Default Group    
11 
12Default Permission Set :      [None Selected]   Select Default Permission Set   
13 
14Default Assignment Policy :   [No Policy Set]   
15 
16Enable Indexing :     Register for indexing
17 
18Partitioned :   False

… in DQL, we will retrieve the storing path of a content on dm_location=storage_01. In our case, the location is a files server (ex: MYFILESERVER), however, it is possible to target a local folder (ex: d:\Documentum\data\my_docbase_dev\content_storage_01):
TEST 1 : with filestore targeting on local folder on content server

1DQL>select distinct file_system_path from dm_location order by 1 ;
2d:\Documentum\data\my_docbase_dev\content_storage_01 
3 
4DQL>select r_object_id, i_contents_id from aca_pj WHERE r_object_id='090xxxxxxxxx8f';
5090xxxxxxxxx8f  060xxxxxxxa84
6 
7DQL>execute get_path for '060xxxxxxxa84';
8D:\Documentum\data\my_docbase_dev\content_storage_01\000157e3\80\02\67\8a.pdf

TEST 2 : with filestore targeting a files server

1select distinct file_system_path from dm_location order by 1 ;
2\\MYFILESERVER\data\MY_DOCBASE_DEV\content_storage_01
3 
4DQL>select r_object_id, i_contents_id from my_custom_document WHERE r_object_id='0902yyyyyyyyya8a6';
50902yyyyyyyyya8a6   060yyyyyyyyya5e
6 
7DQL>execute get_path for '060yyyyyyyyya5e';
8\\MYFILESERVER\data\MY_DOCBASE_DEV\content_storage_01\0xxxxc5\80\23\31\bb.htm

BOCS
Branch Office Caching Services (BOCS) is a lightweight server product running in the Apache Tomcat servlet container. BOCS serves content files to Web client end users from a local content cache. BOCS servers communicate only with ACS servers and do not interact with Content Servers or a repository’s supporting database. BOCS servers cannot write content to a repository. BOCS servers use the HTTP or HTTPS protocol to serve content. BOCS is used in distributed environments. BOCS is easily installed and has minimal administration requirements. The BOCS server is supported on the same platforms as Content Server. It needs to be configured for each repository. => BOCS can only be created in repositories that are designated as global registries (like GLOBALR). The current repository is not a global registry. Click the link below to log in to the global registry repository known to DFC on the Documentum Administrator host. You must have superuser privileges to create BOCS.

In DA, the configuration of BOCS are under “Repository/ Administration / Distributed Content Configuration / BOCS Servers”.

Here, 2 Documentum distributed models using BOCS servers (found on internet):
Example 1 : Single Repository distributed environments (Content is distributed across sites)

  • A Single Repository, with content stored at the primary site and accessed from remote sites using ACS Server. Optionally, BOCS servers can be used.
  • A Single Repository, with content stored in a distributed storage area and accessed from remote sites using Remote Content Servers, ACS Servers, and optionally BOCS Servers.


Example 2 : Multi-Repository distributed environments (Objects, content & metadata, are distributed across sites)

  • Multiple Repositories that replicate objects among themselves.
  • Multiple Repositories organized as a federation.

Notes : ACS only creates URLs, it’s a non-mandatory component and for some documents, you can’t even use it (Ex: Centera). Disabling ACS, unless the request explicitly says “I want a URL”, will simply create a BinaryContent rather than an URLContent.
Using an URLContent avoids having to forward the content of the document to the application server (ex WAS).

Best regards,

Huseyin OZVEREN

Leave a Reply

Your email address will not be published.

Time limit is exhausted. Please reload CAPTCHA.

Related Post