Difference between revisions of "Recital Replication Text Installation"

From Recital Documentation Wiki
Jump to: navigation, search
 
(8 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{YLM to do}}
 
 
== Replication Type ==
 
== Replication Type ==
The first thing you must specify is what type of Replication Service you will be running on each server. You may install the same types on different servers depending of which type of replication service you are configuring, MSR or PPR.  
+
The first thing you must specify is what type of Replication Service you will be running on each server.
  
[1] '''Slave''' - Select this type if this system will be a slave subscriber in a MSR configuration. There can be many slave subscribers but updates will only be performed from data published by the replication service.
+
[1] '''Slave''' - Select this type if this system will be a slave subscriber. There can be many slave subscribers but updates will only be performed from data published by the replication service.
  
[2] '''Master''' - Select this type if this system will be the master publisher in a MSR configuration. There can be only one master publisher and only updates on this system will be published for replication.
+
[2] '''Master''' - Select this type if this system will be the master publisher. There can be only one master publisher and only updates on this system will be published for replication.
  
[3] '''Peer''' - Select this type if you are setting up a PPR configuration. In a PPR configuration all systems must be set to this type. This system will be able to publish all updates and subscribe to published updates from other systems.
 
 
 
<code>Please choose an option [1] :</code>
 
  
 +
<code>Please choose an option [1] :</code>
  
 
== Slave ==
 
== Slave ==
Line 36: Line 32:
  
 
<code>Publication ID [1] :</code>
 
<code>Publication ID [1] :</code>
 
 
== Peer ==
 
 
=== Publication ID ===
 
The publication ID is a unique number that is used to differentiate each system in the replication service. The value must be set to a value greater than 1 and must not be the same as any other publication ID. This ID should not be changed once the replication service has been started on the system.
 
 
 
<code>Publication ID [1] :</code>
 
 
 
=== Publisher ===
 
Specify the node name or IP Address of the Publisher that you want to subscribe with. You can specify the node name or IP Address of the system you are currently installing on. Doing this will make this system the master publisher and you will need to provide a list of peers.
 
 
 
<code>Publisher [localhost] :</code>
 
 
 
=== Delay ===
 
Specify the delay time in seconds that the service will pause between checking with the publication service. If you have specified this system as the publisher, then it will also be used by the publication service.
 
 
 
<code>Delay [60] :</code>
 
 
 
=== Replication Peers ===
 
This option will be displayed if you have specified that this system will also be the publisher. Please specify a comma separated list of the node names or IP Addresses of the Peers that will be published. You can specify the system you are installing on if you wish to publish it.
 
  
 
== Modifying installed values ==
 
== Modifying installed values ==
 
You can modify the values configured during installation by the following ways;  
 
You can modify the values configured during installation by the following ways;  
 
  
 
=== dbinstall rrs ===
 
=== dbinstall rrs ===
Line 73: Line 41:
 
=== Configuration files ===
 
=== Configuration files ===
 
You can edit the configuration files and change the values manually. The following table contains all the variables defined during the installation process. The configuration file are stored in the ''conf'' directory which is in the root recital installation directory.
 
You can edit the configuration files and change the values manually. The following table contains all the variables defined during the installation process. The configuration file are stored in the ''conf'' directory which is in the root recital installation directory.
 +
  
 
{| class="bordered"  
 
{| class="bordered"  
Line 91: Line 60:
 
| DB_REPLOG
 
| DB_REPLOG
 
| TRUE
 
| TRUE
| dbservice.conf
+
| recital.conf
 
|-
 
|-
 
| DB_REPTYPE
 
| DB_REPTYPE
 
| slave
 
| slave
| dbservice.conf
+
| recital.conf
 
|-
 
|-
 
| DB_PUBLISHER
 
| DB_PUBLISHER
 
| localhost
 
| localhost
| dbservice.conf
+
| recital.conf
 
|-
 
|-
 
| DB_REPDELAY
 
| DB_REPDELAY
 
| 60
 
| 60
| dbservice.conf
+
| recital.conf
 
|-
 
|-
 
| DB_PEERS
 
| DB_PEERS
 
| localhost
 
| localhost
| dbservice.conf
+
| recital.conf
 
|}
 
|}
 
<br>
 
<br>
Line 121: Line 90:
  
 
== Replication Database ==
 
== Replication Database ==
During the installation process a database called ''replication'' will be created. A table called queue will also be created in the replication database. If this system is the master publisher in a peer to peer configuration additional tables describe below will be created.
+
During the installation process a database called ''replication'' will be created. A table called queue will also be created in the replication database.
  
{| class="bordered"
 
|+ Replication Tables
 
|-
 
! Table Name
 
! Replication Type
 
! Service
 
|-
 
| queue
 
| All
 
| All
 
 
|-
 
| peers
 
| Peer to Peer
 
| Master publisher
 
 
|-
 
| pub_queue
 
| Peer to Peer
 
| Master publisher
 
 
|-
 
| conflict_queue
 
| Peer to Peer
 
| Master publisher
 
 
|}
 
 
<br>
 
  
 
[[Category:RRS Installation]]
 
[[Category:RRS Installation]]

Latest revision as of 15:24, 11 March 2010

Replication Type

The first thing you must specify is what type of Replication Service you will be running on each server.

[1] Slave - Select this type if this system will be a slave subscriber. There can be many slave subscribers but updates will only be performed from data published by the replication service.

[2] Master - Select this type if this system will be the master publisher. There can be only one master publisher and only updates on this system will be published for replication.


Please choose an option [1] :

Slave

Publisher

Specify the node name or IP Address of the Publisher that this slave will subscribe to. This should be the system that the Master replication service was installed on.


Publisher [localhost] :


Delay

Specify the delay time in seconds that the service will pause between checking with the publication service.


Delay [60] :


Master

Publication ID

The publication ID is a unique number that is used to differentiate each system in the replication service. For a master publisher it should be set to a value of 1. This ID should not be changed once the replication service has been started on the system.


Publication ID [1] :

Modifying installed values

You can modify the values configured during installation by the following ways;

dbinstall rrs

Executing this command at the operating system prompt will allow you to reconfigure the replication service.

Configuration files

You can edit the configuration files and change the values manually. The following table contains all the variables defined during the installation process. The configuration file are stored in the conf directory which is in the root recital installation directory.


Configuration variables
Variable Name Default Value Configuration File
DB_PUBLICATIONID 0 recital.conf
DB_REPDIR replication recital.conf
DB_REPLOG TRUE recital.conf
DB_REPTYPE slave recital.conf
DB_PUBLISHER localhost recital.conf
DB_REPDELAY 60 recital.conf
DB_PEERS localhost recital.conf


DB_REPDIR

The variable DB_REPDIR is set to path that the replication database is located by default. This path is used to store temporary files used by the replication service. Each Recital user and all replication service must have the permission to create and delete files from this directory.

For better performance this directory can be configured as an in-memory file system

DB_REPLOG

The variable DB_REPLOG is used to enable or disable logging on the replication services. A value of TRUE will enable logging and a value of FALSE will disable logging. By default log files will be stored in the log and/or debug directory located under to root recital installation directory.


Replication Database

During the installation process a database called replication will be created. A table called queue will also be created in the replication database.