Dell DX6004S DX Content Router Setup and Configuration Guide - Page 17

Copyright © 2010 Caringo, Inc.

All rights reserved

13

Version 2.2

December 2010

VLAN=yes

4. Start the new interface:

ifup ifcfg-eth1:1

Note, that if the DX Content Router services are installed on a Cluster Services Node (CSN),

creation of the IP addresses is performed automatically when the services are configured.

4.2. Installing and Configuring DX Content Router Services

4.2.1. Installing Services

The DX Content Router distribution is available as a RHEL rpm package that is installed with a shell

script. The package and its dependencies must be installed as a 'root' user with the following steps:

1. Copy the distributed zip file to your RHEL server and unzip it. Unzipping the distribution on a

separate server and then transferring it to the DX Content Router server is not recommended

as the file may become corrupted during the transfer. The following commands will unzip the file

after it has been copied to the server:

$ sudo su -

# unzip contentrouter-install-2.2.0b1.zip -d

contentrouter-install-2.2.0b1

2. Install DX Content Router by running the shell script from the directory location where the shell

script was unzipped. For instance, to install the 2.2 Beta 1 version of the software from the

contentrouter-install-2.2.0b1 directory created above you would run the following commands:

$ sudo su -

# cd contentrouter-install-2.2.0b1

# ./contentrouter-install.sh

Note

If the installation fails due to 'Missing Dependency', make sure you have installed the

packages mentioned above in the 3rd Party Package Pre-requisites section.

If DX Content Router is installed on a Cluster Services Node (CSN), the necessary software will be

installed automatically as part of the overall software bundle.

4.2.2. Configuring Services and Rules

After installing DX Content Router, you must configure the installed services by updating the

configuration files for each service, Replicator and Publisher, you plan to run as well as creating a

filter rules file for Publisher. The configuration files do not exist on the system after installation and

must be created prior to attempting either service. Failure to create and configure these files will

result in a 'Publisher/Replicator not configured' error when you attempt to start the service.

Both services would be utilized for a mirrored configuration where the server is both publishing

UUIDs from a local cluster and receiving incoming UUIDs to replicate from a remote cluster. For a

one-way Disaster Recovery scenario, you would likely only need to configure one of the services

on a single server. Both the Publisher and Replicator services can be configured from the CSN

management console. Please see the 'Configuration' appendix for a full list of all parameters and

best practice instructions for creating the configuration files and rules.xml file by copying the existing

sample configuration.

Section	Page
Content Router Setup and Configuration Guide	1
Table of Contents	3
Chapter 1. Introduction to DX Content Router	5
1.1. Overview of DX Content Router	5
1.2. About this Document	5
1.2.1. Audience	5
1.2.2. Scope	5
Chapter 2. Replication Topologies	6
2.1. Disaster Recovery	6
2.2. Mirrored Clusters	6
2.3. Multi-Site Disaster Recovery	6
2.4. Content Distribution	7
Chapter 3. DX Content Router Services	8
3.1. Basic Architecture	8
3.1.1. Structure of a DX Content Router Node	9
3.1.2. Publisher Service	11
3.1.2.1. Filtering UUIDs for Publication	11
3.1.2.2. Rules	13
3.1.3. Replicator Service	14
Chapter 4. Installation	15
4.1. Requirements	15
4.1.1. Operating System	15
4.1.2. 3rd Party Package Pre-requisites	15
4.1.3. Network	15
4.1.3.1. Required Communications	15
4.1.3.2. Bandwidth Requirements	15
4.1.3.3. Recommended Infrastructure	16
4.1.3.4. IP Address Configuration	16
4.2. Installing and Configuring DX Content Router Services	17
4.2.1. Installing Services	17
4.2.2. Configuring Services and Rules	17
4.3. Upgrading DX Content Router	18
4.3.1. Upgrading from 1.x	18
4.3.2. Upgrading from 2.x	18
4.4. Removing DX Content Router	18
Chapter 5. Running and Managing DX Content Router	19
5.1. Starting DX Content Router Services	19
5.2. Publisher and Replicator Shutdown	19
5.3. Customizing the Standard Rule Sets	19
5.3.1. Publish all streams on a single channel	19
5.3.2. Publish all streams on two separate channels	20
5.3.3. Publish streams with header ‘someHeaderName’ on one channel and all others except text files to a second	20
5.3.4. Complex Content Metadata Analysis	20
5.3.4.1. Filter Clause	20
5.3.4.2. Exists Clause	21
5.3.4.3. NotExists Clause	22
5.3.4.4. All Clauses	22
5.4. Using the Publisher Console	22
5.4.1. Publisher Console layout:	23
5.5. HTTP Status Reporting for Publisher and Replicator	25
5.5.1. Publisher Response	25
5.5.2. Replicator Response	26
5.5.3. Request for Source Cluster IP Addresses	27
Chapter 6. Support for Content Restoration and Fail-Over	28
6.1. Administrative Disaster Recovery	28
6.2. Content Mirroring	28
6.3. Application-Assisted Fail-Over	28
Appendix A. Content Metadata	29
A.1. System Metadata	29
A.2. Content File Server Metadata	29
A.2.1. Custom Metadata	29
Appendix B. DX Content Router Configuration	30
B.1. Publisher Configuration	30
B.2. Replicator Configuration	34
Appendix C. Enumerator API	38
C.1. Enumerator Types	38
C.2. Enumerator Start	38
C.2.1. Enumerator Start Query Arguments	39
C.2.2. Enumerator Start Response	39
C.3. Enumerator Next	40
C.3.1. Enumerator Next Query Arguments	40
C.3.2. Enumerator Next Response	41
C.4. Enumerator End	41
C.4.1. End Response	41
C.5. Enumerator Timeout	42

Dell DX6004S DX Content Router Setup and Configuration Guide - Page 17

Installing and Configuring DX Content Router Services

Page 17 highlights