Documenti di Didattica
Documenti di Professioni
Documenti di Cultura
Content Server
Version 6.5
EMC Corporation
Corporate Headquarters:
Hopkinton, MA 01748‑9103
1‑508‑435‑1000
www.EMC.com
Copyright © 1994 ‑ 2008 EMC Corporation. All rights reserved.
Published July 2008
EMC believes the information in this publication is accurate as of its publication date. The information is subject to change
without notice.
THE INFORMATION IN THIS PUBLICATION IS PROVIDED AS IS. EMC CORPORATION MAKES NO REPRESENTATIONS
OR WARRANTIES OF ANY KIND WITH RESPECT TO THE INFORMATION IN THIS PUBLICATION, AND SPECIFICALLY
DISCLAIMS IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
Use, copying, and distribution of any EMC software described in this publication requires an applicable software license.
For the most up‑to‑date listing of EMC product names, see EMC Corporation Trademarks on EMC.com.
All other trademarks used herein are the property of their respective owners.
Table of Contents
Preface ........................................................................................................................... 7
EMC Documentum Content Server Version 6.5 Multinode Fulltext Installation Guide 3
Table of Contents
List of Figures
4 EMC Documentum Content Server Version 6.5 Multinode Fulltext Installation Guide
Table of Contents
List of Tables
EMC Documentum Content Server Version 6.5 Multinode Fulltext Installation Guide 5
Table of Contents
6 EMC Documentum Content Server Version 6.5 Multinode Fulltext Installation Guide
Preface
Intended audience
The intended audience for this document is EMC Documentum Professional Services
and partners who are certified by EMC to support multinode fulltext implementations.
Before installing a multinode configuration, a customer needs to have its proposed
architecture reviewed and approved by EMC. Contact your Account Manager to arrange
for a review.
Related documentation
• The EMC Documentum Fulltext Indexing System Installation and Administration Guide
contains detailed information on installing the index agent and index server in basic,
consolidated, and high availability deployments, as well as describing indexing
operations and maintenance.
• The EMC Documentum Search Development Guide contains complete information on
querying.
• The Content Server Installation Guide contains information on installing Content
Server.
• The Documentum Administrator online help system contains instructions for
managing the index queue and for starting and stopping the index server and index
agent, in basic, consolidated, and high‑availability deployments. No Documentum
Administrator support is provided for multinode deployments.
Revision history
The following revisions have been made to this document:
EMC Documentum Content Server Version 6.5 Multinode Fulltext Installation Guide 7
Preface
Revision History
Date Description
July 2008 Publication for version 6.5
8 EMC Documentum Content Server Version 6.5 Multinode Fulltext Installation Guide
Chapter 1
Understanding Multinode Deployments
In a basic fulltext indexing scenario, a single index server adds all index information to a single index,
and all queries return results from that index. In a large implementation with a high volume of
documents to index, concentrating all of this activity on a single host machine can negatively impact
performance. The delay between when a new document is added to the repository and when its
content is available for fulltext searches may become unacceptably long.
To improve performance, you can install multiple indexing processes, each one managing a distinct
portion of the index on a distinct host machine. This distributed configuration improves performance
by enabling parallel index processing. Each host machine is referred to as a node, and the distributed
configuration is referred to as a multinode implementation.
This chapter provides conceptual information about installing the index server in a multinode
configuration. It includes these topics:
• Distributing index server processes across nodes, page 10
• Distributing documents across nodes, page 12
• Installing the index server in a multinode configuration, page 14
Note: All hosts in a multinode implementation need to use the same operating system platform. For
best performance, it should be the same operating system as the Content Server host, however this
is not required.
EMC Documentum Content Server Version 6.5 Multinode Fulltext Installation Guide 9
Understanding Multinode Deployments
10 EMC Documentum Content Server Version 6.5 Multinode Fulltext Installation Guide
Understanding Multinode Deployments
The number of nodes depends on the required indexing and querying throughput. You
can add additional nodes as necessary to increase indexing and querying capacity.
The index server’s administrative processes are installed on just one node, referred to as
the administrative node. (Node 1 is the administrative node in Figure 1.) The index agent,
which provides communication with Content Server, is installed on the administrative
node or on the Content Server host.
As documents are added to the repository and need indexing, the index agent passes
the documents to the Content Distributor on the administrative node. The Content
Distributor determines on which node each document will be indexed and routes the
documents to a document processor. The document processor extracts the indexable
content then routes the FIXML representation of the document to the indexer on the
proper node. The indexer updates the column on the indexer’s node.
Note: Figure 1 shows a common configuration with one document processor on each
node. However, there is no special relationship between the document processor and
indexer on the same host machine. The Content Distributor routes documents to the first
available document processor regardless of which node the document is ultimately
targeted for. The document processor passes the document to the indexer on the proper
node. See Document processor section, page 23 for more information about document
processor configuration options.
EMC Documentum Content Server Version 6.5 Multinode Fulltext Installation Guide 11
Understanding Multinode Deployments
When Content Server sends a query to the index server, the index server needs to return
the matching results from all columns. The Query and Results Server (QR Server) on
the administrative node issues the query to the search servers on each node. The search
servers run in parallel and return their results to the QR Server. The QR Server collects
and combines the results before returning them to the Content Server.
12 EMC Documentum Content Server Version 6.5 Multinode Fulltext Installation Guide
Understanding Multinode Deployments
Alternatively, you can configure the Content Distributor to use directed routing. Directed
routing is a means of distributing documents to specific index server nodes based on
which Content Server file store contains their content files. (File stores are the most
common type of storage area in a Documentum repository.) Each Content Server file
store is mapped to a specific index column; when the Content Distributor receives a
document to index, it routes the document to the node associated with the document’s
file store.
Content Server enables you to assign content files to specific file stores based on
user‑specified parameters. For example, you can instruct Content Server to store
documents in particular file stores based on their type (marketing documents in one file
store, engineering documents in another) or on when they were created (documents
checked in from January 1 through June 30 in one file store, those checked in from July 1
to December 31 in another). The time‑based option can be beneficial in archiving and
other high‑volume indexing scenarios. With directed routing, you can divide the fulltext
index along the same lines as the content files.
EMC Documentum Content Server Version 6.5 Multinode Fulltext Installation Guide 13
Understanding Multinode Deployments
• You can add file stores and index nodes as needed, with little or no need to
reorganize the index data.
When you add a node to an implementation using round‑robin distribution, the
index server needs to rebalance the data across nodes. With directed routing, the
index server can begin routing documents to a new node without rebalancing
existing index entries.
• You can close index nodes either temporarily or permanently.
A particular node can become inactive for indexing purposes, for example once the
end date is passed and documents begin to be routed to a new file store. The node
remains active for searching but receives no new entries. You can back up such nodes
when they are closed off, and they need not be backed up from that point forward.
From an implementation perspective, the mapping from specific file stores to specific
index columns occurs in two steps. The index agent configuration file (indexagent.xml)
assigns files from specific file stores to specific collections, and a configuration file on the
index server administrative node (routing.cfg) assigns specific collections to specific
index columns. See Configuring directed routing, page 34 for details about configuring
directed routing.
1. Create a single, global copy of the InstallProfile.xml configuration file that defines the
complete configuration.
The InstallProfile.xml file lists the host machines for each node and specifies
which index server processes to install on each host. See Chapter 2, Creating the
InstallProfile.xml Configuration File.
2. Run the index server installation program on each host machine, as described in
Installing a multinode configuration, page 29.
3. Install an index agent to provide communication with Content Server.
The index agent is usually installed on the host machine where the index server’s
administrative processes are running, or on the Content Server host. See Configuring
the index agent, page 31.
14 EMC Documentum Content Server Version 6.5 Multinode Fulltext Installation Guide
Understanding Multinode Deployments
4. If you plan to use directed routing, configure the index agent and index server to
provide the desired mapping of documents to index columns.
See Configuring directed routing, page 34.
EMC Documentum Content Server Version 6.5 Multinode Fulltext Installation Guide 15
Understanding Multinode Deployments
16 EMC Documentum Content Server Version 6.5 Multinode Fulltext Installation Guide
Chapter 2
Creating the InstallProfile.xml
Configuration File
The InstallProfile.xml configuration file is an XML file that controls which index server components
are installed on each node of a multinode deployment. Before beginning the installation, you create
a single, global copy of InstallProfile.xml that defines the complete configuration. The index server
installation program refers to the file as it installs each node.
EMC Documentum Content Server Version 6.5 Multinode Fulltext Installation Guide 17
Creating the InstallProfile.xml Configuration File
Host section
The host section of the InstallProfile.xml configuration file identifies the hosts in the
multinode deployment and defines some basic configuration parameters for each host.
To complete this section, you need the following information:
• The fully‑qualified domain name for each host computer
For example, tristan.documentum.com, not tristan.
• The platform on which the indexing software will be installed
There is a sample IndexProfile.xml file for Windows, Linux, and Solaris (= Sun OS).
• The installation owner’s user name
This is the same user as the Content Server installation owner. Ensure that you use
the same domain or NIS user account for installing each index server node as you
used for installing Content Server. The user IDs need to match.
• The installation directory
The defaults are drive\Documentum\fulltext\IndexServer\ on Windows and
/fulltext/IndexServer/ (under $DOCUMENTUM) on Linux and UNIX. Since all host
computers use the same InstallProfile.xml file, ensure that you use the same drive
letter or mount‑point specification on all index server nodes.
• The host’s temporary directory
The defaults are C:\temp on Windows and /tmp/ on Linux and UNIX.
• The base index server port
The default is 13000. Use the same base port on all nodes in the multinode
deployment.
Below is a sample of the host section for a Windows installation in
which there are two hosts (norway1.performance.documentum.com and
norway2.performance.documentum.com), with user name dmadmin, installation
directory of F:\Documentum\fulltext\IndexServer\, temporary directory of :
C:\Temp\, remote command of SSH2, and base port of 13000:
<hostset>
<host id="norway1.performance.documentum.com">
<property name="hostname" value="norway1.performance.
documentum.com"/>
<property name="platform" value="Windows"/>
<property name="username" value=".\dmadmin"/>
<property name="installdir" value="F:\Documentum\
fulltext\IndexServer\"/>
<property name="tempdir" value="C:\Temp\"/>
<property name="remotecmd" value="SSH2"/>
<property name="baseport" value="13000"/>
</host>
<host id="norway2.performance.documentum.com">
<property name="hostname" value="norway2.
18 EMC Documentum Content Server Version 6.5 Multinode Fulltext Installation Guide
Creating the InstallProfile.xml Configuration File
performance.documentum.com"/>
<property name="platform" value="Windows"/>
<property name="username" value=".\dmadmin"/>
<property name="installdir" value="F:\Documentum
\fulltext\IndexServer\"/>
<property name="tempdir" value="C:\Temp\"/>
<property name="remotecmd" value="SSH2"/>
<property name="baseport" value="13000"/>
</host>
</hostset>
The items you should update with the details for your configuration are shown below in
italic font. Do not change any other values, such as the remote‑cmd property or its value.
Add an additional <host> section for each host in the configuration, following the pattern
shown below. All <host> sections need to appear inside the <host‑set> element.
Note: On Windows hosts, the value of the property username needs to start with a period
and backslash, for example, .\dmadmin. On UNIX hosts, the value would be dmadmin.
<hostset>
<host id="Fully_qualified_host_name">
<property name="hostname" value=
"Fully_qualified_host_name"/>
<property name="platform" value=
"platform"/>
<property name="username" value=
"installation_owner_name"/>
<property name="installdir" value=
"installation_directory"/>
<property name="tempdir" value=
"temporary_directory"/>
<property name="remotecmd" value="SSH2"/>
<property name="baseport" value=
"base_port_number"/>
</host> </hostset>
EMC Documentum Content Server Version 6.5 Multinode Fulltext Installation Guide 19
Creating the InstallProfile.xml Configuration File
</configurationservice>
<logservice id="LGS1" hostref="norway1.performance.
documentum.com"></logservice>
<administrationgui id="ADM1" hostref="norway1.
performance.documentum.com"></administrationgui>
<vespa id="VSP1" hostref="norway1.performance.
documentum.com"></vespa>
<storageservice id="STOR1" hostref="norway1.
performance.documentum.com" admin="root" adminpassword=
"d4tAs34rch" user=“dmadmin" userpassword=“d3v3l0p">
</storageservice>
<nameservice id="NAME1" hostref="norway1.
performance.documentum.com">
</nameservice>
</administrationset>
The items you should update with the details for your configuration are shown below in
italic font. Do not change any other values; for example, do not change the admin user
name and admin password in the <storage‑service> element.
Note: On Windows hosts, the value of the property user needs to start with a period and
backslash, for example, .\dmadmin. On UNIX hosts, the value would be dmadmin.
<administrationset>
<configurationservice id="CS1" hostref=
"Fully_qualified_host_name">
</configurationservice>
<logservice id="LGS1" hostref=
"Fully_qualified_host_name">
</logservice>
<administrationgui id="ADM1" hostref=
"Fully_qualified_host_name">
</administrationgui>
<vespa id="VSP1" hostref=
"Fully_qualified_host_name">
</vespa>
<storageservice id="STOR1" hostref=
"Fully_qualified_host_name"
admin="root"
adminpassword="d4tAs34rch"
user=“install_owner_name"
userpassword=“install_owner_password">
</storageservice>
<nameservice id="NAME1" hostref=
"Fully_qualified_host_name">
</nameservice>
</administrationset>
20 EMC Documentum Content Server Version 6.5 Multinode Fulltext Installation Guide
Creating the InstallProfile.xml Configuration File
The item you should update with the details for your configuration is shown below in
italic font.
<contentdistributorset>
<contentdistributor id="CD1" hostref=
"Fully_qualified_host_name"/>
</contentdistributorset>
The item you should update with the details for your configuration is shown below in
italic font.
<statusservice>
<statusserver id="STATUS1" hostref=
"Fully_qualified_host_name">
</statusserver>
</statusservice>
EMC Documentum Content Server Version 6.5 Multinode Fulltext Installation Guide 21
Creating the InstallProfile.xml Configuration File
The items you should update with the details for your configuration are shown below in
italic font. Do not change any other values. Do not change the property names indicating
that the search server and indexer are installed or change the value true.
Add an additional <search‑engine> section for each host in the configuration, following
the pattern shown below. All <search‑engine> sections need to appear inside the
<search‑engine‑set> element.
<searchengineset>
<searchengine id="RTS1" hostref=
"Fully_qualified_host_name1">
<property name="search" value="true"/>
<property name="index" value="true"/>
</searchengine>
<searchengine id="RTS2" hostref=
"Fully_qualified_host_name2">
<property name="search" value="true"/>
<property name="index" value="true"/>
</searchengine>
</searchengineset>
<searchengine id="RTSN" hostref=
"Fully_qualified_host_nameN">
<property name="search" value="true"/>
<property name="index" value="true"/>
</searchengine>
22 EMC Documentum Content Server Version 6.5 Multinode Fulltext Installation Guide
Creating the InstallProfile.xml Configuration File
</searchengineset>
A common configuration, such as that shown in Figure 1, page 11, has one document
processor on each host. However, you can install multiple document processors on
the same host or install one or more document processors on host separate from the
nodes where the indexers and columns reside. When the Content Distributor routes a
document, it routes it to the first non‑busy document processor, regardless of which host
the document processor is running on. The document processor passes the document to
the proper indexer.
Figure 4. The first available document processor handles each incoming document
The items you should update with the details for your configuration are shown below in
italic font. Do not change any other values.
Add an additional <document‑processor> section for each document processor you want
to create, following the pattern shown below. All <document‑processor> sections need
EMC Documentum Content Server Version 6.5 Multinode Fulltext Installation Guide 23
Creating the InstallProfile.xml Configuration File
to appear inside the <document‑processor‑set> element. All host names need to match
hosts listed in the Host section, page 18.
<documentprocessorset>
<documentprocessor id="DP1" hostref=
"Fully_qualified_host_name1"/>
<documentprocessor id="DP2" hostref=
"Fully_qualified_host_name2"/>
<documentprocessor id="DPN" hostref=
"Fully_qualified_host_nameN"/>
</documentprocessorset>
The items you should update with the details for your configuration are shown below in
italic font. If you include multiple language codes for the language property, separate
them with commas.
<queryresultprocessorset>
<queryresultprocessor id="QRP1" hostref=
"Fully_qualified_host_name">
24 EMC Documentum Content Server Version 6.5 Multinode Fulltext Installation Guide
Creating the InstallProfile.xml Configuration File
Webcluster section
The webcluster section defines which index columns are associated with which search
engines.
The Search engine section, page 22 provides an ID for the search engine running on
each host (as the value of the id parameter of the <search‑engine> element). They have
sequential names based on which node they are running on: RTS1 for node 1, RTS2 for
node 2, and so on. The webcluster section identifies the index columns and associates
each column with the search engine running on the same node. The IDs for the columns
are also sequential, however the numbering starts at zero. Therefore, as shown in the
sample below, column 0 is associated with search engine RTS1, column 1 is associated
with search engine RTS2, and so on.
<searchengineclusterset>
<searchenginecluster id="webcluster">
<property name="usememsearch" value="false"/>
<property name="indexprofiletype" value="custom"/>
<property name="indexprofilefilename"
value="..\config\datasearch\indexprofiles
\indexprofiledctm.xml"/>
<searchenginecolumn id="col0">
<searchengine idref="RTS1"/>
</searchenginecolumn>
<searchenginecolumn id="col1">
<searchengine idref="RTS2"/>
</searchenginecolumn>
<queryresultprocessors>
<queryresultprocessor idref="QRP1"/>
</queryresultprocessors>
</searchenginecluster>
</searchengineclusterset>
The items you should update with the details for your configuration are shown below
in italic font. Do not modify anything else in the webcluster section. Do not change the
value of the index‑profile‑type. It needs to remain “custom.”
Add an additional <search‑engine‑column> section for each host in the configuration,
following the pattern shown below. All <search‑engine‑column> sections need to appear
inside the <search‑engine‑cluster> element. The value of the <search‑engine‑column id>
needs to be the string “col” followed by the next sequential number after the previous
EMC Documentum Content Server Version 6.5 Multinode Fulltext Installation Guide 25
Creating the InstallProfile.xml Configuration File
column. The number needs to match the partition_id for the column as specified in the
CSConfig.xml file; see Adding a node, page 39.
The value of the <search‑engine id‑ref> property for each node needs to match the
value specified for that host in the Search engine section, page 22. Similarly, the value
of <query‑result‑processor id‑ref> needs to match the ID provided in the Query server
section, page 24.
<searchengineclusterset>
<searchenginecluster id="webcluster">
<property name="usememsearch" value="false"/>
<property name="indexprofiletype" value="custom"/>
<property name="indexprofilefilename"
value="..\config\datasearch\indexprofiles
\indexprofiledctm.xml"/>
<searchenginecolumn id="col0">
<searchengine idref=
"searchengine ID for node 1"/>
</searchenginecolumn>
<searchenginecolumn id="col1">
<searchengine idref=
"searchengine ID for node 2"/>
</searchenginecolumn>
<queryresultprocessors>
<queryresultprocessor idref="QR Server ID"/>
</queryresultprocessors>
</searchenginecluster>
</searchengineclusterset>
Other sections
The configuration file also contains data‑source, anchor‑service, status‑service, and
license‑services sections. Do not modify the data‑source section. In the anchor‑service,
status‑service, and license‑service sections, provide the fully‑qualified name of the
administrative node, which is the node you identified in the Administrative services
section, page 19. Do not modify any other values.
<anchorservice>
<anchorserver id="anch1" hostref="Fully_qualified_host_name">
<property name="dispatcher" value="true"/>
</anchorserver>
</anchorservice>
<statusservice>
<statusserver id="STATUS1" hostref="Fully_qualified_host_name">
</statusserver>
</statusservice>
<licenseservices>
<licenseservice id="LCS1" hostref="Fully_qualified_host_name">
</licenseservice>
26 EMC Documentum Content Server Version 6.5 Multinode Fulltext Installation Guide
Creating the InstallProfile.xml Configuration File
</licenseservices>
EMC Documentum Content Server Version 6.5 Multinode Fulltext Installation Guide 27
Creating the InstallProfile.xml Configuration File
28 EMC Documentum Content Server Version 6.5 Multinode Fulltext Installation Guide
Chapter 3
Installing the Indexing Software
This chapter contains instructions for installing a multinode indexing deployment and configuring it
to use directed routing. It contains the following topics:
• Installing a multinode configuration, page 29
• Configuring the index agent, page 31
• Configuring directed routing, page 34
• Adding a node, page 39
EMC Documentum Content Server Version 6.5 Multinode Fulltext Installation Guide 29
Installing the Indexing Software
and press Enter, where operatingsystem is the operating system on which you
are installing.
6. Select index server installation only.
The installation program detects the InstallProfile.xml file and asks you to confirm
that you require multinode installation.
7. Click Yes.
The correct index server processes are installed and configured on the host.
8. After the installation is completed, ensure that the index server starts.
• On Windows, select Yes, restart my computer., then click Next.
— If the computer does not restart automatically, click
Start®®Shutdown® ®Restart and restart the computer manually.
— If the index server does not automatically start, click
Start®®Programs® ®Administrative Tools® ®Services and start the
FAST InStream service.
— If the system restarts, the index server starts automatically as a Windows
service.
• On UNIX and Linux, run $DOCUMENTUM/fulltext/jboss4.2.0/IndexServer/
bin/startup.sh.
The index server is started.
9. Install and configure an index agent.
See Configuring the index agent, page 31 for instructions.
10. To configure directed routing, perform the steps described in Configuring directed
routing, page 34 on the administrative host.
11. Repeat steps 1 through 8 on each additional node.
12. Confirm that the index server processes are running correctly.
• On the administrative node, type dsadmin listmodules at a command prompt.
The running processes, their version numbers, host name, and port numbers
are displayed.
30 EMC Documentum Content Server Version 6.5 Multinode Fulltext Installation Guide
Installing the Indexing Software
• On each nonadministration node, use the nctrl command to verify that the
processes are running correctly:
$ cd $FASTSEARCH/bin
$ ../setupenv.sh
$ nctrl sysstatus
Each running module name is listed, as well as the process name, process ID,
and status.
5. Start the index agent configuration program using the appropriate command for
your platform.
• Windows: IndexAgent_Configuration_Program.exe –config setup.ini
• AIX: IndexAgent_Configuration_Program.aix –config setup.ini
• Solaris: IndexAgent_Configuration_Program.bin –config setup.ini
• HP‑UX: IndexAgent_Configuration_Program.hp –config setup.ini
EMC Documentum Content Server Version 6.5 Multinode Fulltext Installation Guide 31
Installing the Indexing Software
32 EMC Documentum Content Server Version 6.5 Multinode Fulltext Installation Guide
Installing the Indexing Software
4. If the paths to the content files are different, do not modify the value of
<all_filestores_local>, but instead, create a file store map within the <exporter>
element.
For example, if Content Server is on a host called Dandelion where filestore_01
is physically located in the directory /Dandelion/Documentum/data/
repository_name/content_storage_01 and the index agent and index server
on a host from which the drive on the Content Server host is shared as
/mappingtoDandelion/repository_name/content_storage_01, create an alias as follows:
<local_filestore_map>
<local_filestore>
<store_name>filestore_01</store_name>
<local_mount>/mappingtoDandelion/
repository_name
/content_storage_01</local_mount>
</local_filestore>
<! and so on for each filestore !>
</local_filestore_map>
EMC Documentum Content Server Version 6.5 Multinode Fulltext Installation Guide 33
Installing the Indexing Software
If you are indexing content stored on a NAS device or a Windows 2003 Server host,
you may see the following error message in the dmi_queue_item’s message attribute:
DocumentRetriever :ERROR Retrieval error: Couldn't open file
<file path/name> ERROR Processor error status:
DataNotAvailable Not read permission
To resolve this error, edit the <local_mount> element or elements in the
IndexAgent.xml file that reference the storage area or areas on the NAS device.
Add two backslashes immediately after the opening <local_mount> element. For
example, assume the following references a storage are on an NAS device:
<local_mount>\\100.2.4.32\share3\c\data_for_example
\content_storage_1</local_mount>
After editing, it is now:
<local_mount>\\\\100.2.4.32\share3\c\data_for_example
\content_storage_1</local_mount>
1. Configure Content Server to direct documents to specific file stores based on business
rules. See “Allocating content to storage areas” in the Content Server Administration
Guide for information about creating content assignment policies.
2. Create a fulltext collection corresponding to each index server node. See Creating
fulltext collections, page 35.
3. Update the index agent configuration file (indexagent.xml) to associate particular
file stores with particular fulltext collections. See Mapping file stores to collections,
page 36.
4. Create a routing configuration file on the index server administrative node to
associate each collection with an index column. See Mapping collections to index
columns, page 38.
34 EMC Documentum Content Server Version 6.5 Multinode Fulltext Installation Guide
Installing the Indexing Software
EMC Documentum Content Server Version 6.5 Multinode Fulltext Installation Guide 35
Installing the Indexing Software
36 EMC Documentum Content Server Version 6.5 Multinode Fulltext Installation Guide
Installing the Indexing Software
EMC Documentum Content Server Version 6.5 Multinode Fulltext Installation Guide 37
Installing the Indexing Software
</partition>
<partition>
<storage_name>filestore_03</storage_name>
<collection_name>repb03</collection_name>
</partition>
<partition>
<storage_name>filestore_04</storage_name>
<collection_name>repb03</collection_name>
</partition>
</partition_config>
</indexer>
38 EMC Documentum Content Server Version 6.5 Multinode Fulltext Installation Guide
Installing the Indexing Software
partition_id="0"
ft_mode="0" docapiport="15500">
</column>
Adding a node
Use these instructions to add an additional node to an existing multinode configuration.
EMC Documentum Content Server Version 6.5 Multinode Fulltext Installation Guide 39
Installing the Indexing Software
40 EMC Documentum Content Server Version 6.5 Multinode Fulltext Installation Guide
Installing the Indexing Software
<column host="fully_qualified_host_name"
port="base_port_number" mode="NORMAL"
partition_id="partition_number"
ft_mode="0" docapiport="15500">
The partition_number should be the integer specified as part of
the <search‑engine‑column> ID in the Webcluster section, page
25 of the IndexProfile.xml file; if the IndexProfile.xml file includes
<searchenginecolumn id="col4">, the partition_number for the column
is 4. For example:
<column host="host0.emc.com" port="15674"
mode="NORMAL" partition_id="4" ft_mode="0" docapiport=
"15500>
The port is the index server’s base port number plus the constant 3099. If the
index server is using the default base port 13000, then the port value is 16099.
EMC Documentum Content Server Version 6.5 Multinode Fulltext Installation Guide 41
Installing the Indexing Software
The first integer after ’webcluster’ is the partition_id of the column hosted on
the node.
f. Rebuild the index by running the FIXML feeder on each node. Enter this
command:
cobra fixmlfeeder.py i path_to_temp_dir
The path_to_temp_dir is the path to the directory where you backed up the
FIXML files at step a.
g. When the feeding is complete, use the FAST InStream administration tool to
reset all collections to use the DFTXML (webcluster) pipeline (see step d above).
h. Resume indexing on each node. Enter this command to resume indexing:
rtsadmin localhost port webcluster
partition_id 0 resetindex
9. Restart the index server on each node and restart the index agent.
Removing a node
Use these instructions to remove a node from an existing multinode configuration.
42 EMC Documentum Content Server Version 6.5 Multinode Fulltext Installation Guide
Installing the Indexing Software
1. Verify that all documents are restored to the node by using Matching Engines
and Collections in the FAST administration page.
2. Run a query against the collection on the node.
3. Verify that all documents in the query are returned as expected.
4. Run the ftintegrity tool to verify the completeness and accuracy of the index.
EMC Documentum Content Server Version 6.5 Multinode Fulltext Installation Guide 43
Installing the Indexing Software
Administration Guide to uninstall the index server from each node and to uninstall the
index agent.
44 EMC Documentum Content Server Version 6.5 Multinode Fulltext Installation Guide
Index
C I
collections index agent
routing to columns, 13 configuring, 31
collections, defined, 35 index routing
Content Distributor, described, 10 index server configuration
requirements, 38
index server
D Content Distributor, 10
DFTXML, 10 DocProcessor, 10
directed routing findex process, 10
configuring, 34 Indexer, 10
DocProcessor, described, 10 QR Server, 10
documentation, 7 query subsystem, 10
documents Status Server, 10
routing to nodes, 13 indexagent.xml file, 33
drives, sharing, 33 Indexer, described, 10
installing indexing software, 7
F
findex process, described, 10 P
FIXML, 10 processor, see DocProcessor
frtsobj process, described, 10
fulltext indexes
collections, 35 Q
fulltext indexing QR Server, described, 10
directed routing, configuring, 34 query subsystem, described, 10
documentation, 7
file store mapping, 33
performance, 33
S
routing, directed, 13 Status Server, described, 10
sharing drives, 33
software installation, 7
EMC Documentum Content Server Version 6.5 Multinode Fulltext Installation Guide 45