Difference between revisions of "Recitalreplication"

From Recital Documentation Wiki
Jump to: navigation, search
 
(17 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{YLM to do}}
+
The replication services are administrated with the '''recitalreplication''' command. It takes the following arguments.
== dbservice ==
+
The replication services are administrated with the dbservice command. It takes the following arguments;
+
  
 +
Note:  recitalreplication must be run as root.  For systems with a hidden root account, please precede commands with '''sudo'''.
  
=== help  ===
+
==== help  ====
If you can specify ''help'' or ''-h'' argument without a service name first and it will display a list of arguments for all the services.
+
Using the ''help'' or ''-h'' argument will display a list of arguments for all the services.
  
 
<pre>
 
<pre>
# dbservice help
+
recitalreplication help
 
</pre>
 
</pre>
  
=== service name ===
+
==== start ====
For all non help related commands you must specify the name of the service. The following list of service names can be used, these can be abbreviated to the first three letters of the name.
+
This argument is used to start the configured replication services on the system.  
  
{| class="bordered"
+
==== stop ====
|+ Service Names
+
This argument is used to stop the configured replication services on the system.
|-
+
! Service Name
+
! Description
+
  
|-
+
==== restart ====
| rrs
+
This argument is used to restart (stop, then start) the configured replication services on the system.
| This will perform the request on all services
+
  
|-
+
==== status ====
| subscriber
+
This argument is used to show the current status of the configured replication services on the system.  
| This will perform the request on the subscriber service.  
+
  
|-
+
==== fullstatus ====
| publisher
+
This argument is used to show the full status of the configured replication services on the system.  
| This will perform the request on the publisher service.  
+
  
|}
+
==== skip subscriber ====
 +
Skip over the current transaction in the published subscriber queue.
  
=== start ===
+
==== clear subscriber ====
This argument is used to start the specified service. If the service name specified is ''all'', then all configured services will be start on this system.  
+
Clear the current transactions in the published subscriber queue.
  
 +
==== show ====
 +
Show the transaction details for the specified row number from the published queue, default is last transaction.
  
=== stop ===
+
==== add ====
This argument is used to stop the specified service. If the service name specified is ''all'', then all running services will be stopped on this system.  
+
Add a subscriber.
  
 +
==== del ====
 +
Delete a subscriber.
  
=== restart ===
+
==== reset ====
This argument is used to restart the specified service. If the service name specified is ''all'', then all running services will be restarted on this system.  
+
Reset the current transactions in the published subscriber queue.
  
 +
==== -d seconds ====
 +
Specify the delay in seconds between checking for new transactions. Specifying this argument on the command line will overwrite the setting specified for [[DB_REPDELAY]] in the [[Configuration Files|recital.conf]] file.
  
=== status ===
+
==== -h ====
This argument is used to display the current status of the specified service. If the service name specified is ''all'', then the current status for all services will be displayed.
+
 
+
 
+
=== -d seconds ===
+
Specify the delay in seconds between checking for new transactions. Specifying this argument on the command will overwrite the setting specified for DB_REPDELAY in the dbservice.conf file.
+
 
+
=== -i ===
+
Rebuild the subscriber index used for Peer to Peer replication.
+
 
+
 
+
=== -h ===
+
 
List available command line options (this page).
 
List available command line options (this page).
  
 +
==== -l ====
 +
Turn logging on. Specifying this argument on the command line will overwrite the setting specified for [[DB_REPLOG]] in the dbservice.conf file.
  
=== -l ===
+
==== -p password ====
Turn logging on. Specifying this argument on the command will overwrite the setting specified for DB_REPLOG in the dbservice.conf file.
+
 
+
 
+
=== -p password ===
+
 
Specify a password for the server the publisher is running on. The password can also be specified in the data source.
 
Specify a password for the server the publisher is running on. The password can also be specified in the data source.
  
 
+
==== -r ====
=== -r ===
+
 
Reset the time stamp so all transactions in the queue are processed.
 
Reset the time stamp so all transactions in the queue are processed.
  
 +
==== -u username ====
 +
Specify a user name for the server the publisher is running on. The user name can also be specified in the data source.
  
=== -u username ===
+
[[Category:RRS_Configuration]]
Specify a user name for the server the publisher is running on. The user name can also be specified in the data source.
+

Latest revision as of 18:30, 24 June 2010

The replication services are administrated with the recitalreplication command. It takes the following arguments.

Note: recitalreplication must be run as root. For systems with a hidden root account, please precede commands with sudo.

help

Using the help or -h argument will display a list of arguments for all the services.

 recitalreplication help

start

This argument is used to start the configured replication services on the system.

stop

This argument is used to stop the configured replication services on the system.

restart

This argument is used to restart (stop, then start) the configured replication services on the system.

status

This argument is used to show the current status of the configured replication services on the system.

fullstatus

This argument is used to show the full status of the configured replication services on the system.

skip subscriber

Skip over the current transaction in the published subscriber queue.

clear subscriber

Clear the current transactions in the published subscriber queue.

show

Show the transaction details for the specified row number from the published queue, default is last transaction.

add

Add a subscriber.

del

Delete a subscriber.

reset

Reset the current transactions in the published subscriber queue.

-d seconds

Specify the delay in seconds between checking for new transactions. Specifying this argument on the command line will overwrite the setting specified for DB_REPDELAY in the recital.conf file.

-h

List available command line options (this page).

-l

Turn logging on. Specifying this argument on the command line will overwrite the setting specified for DB_REPLOG in the dbservice.conf file.

-p password

Specify a password for the server the publisher is running on. The password can also be specified in the data source.

-r

Reset the time stamp so all transactions in the queue are processed.

-u username

Specify a user name for the server the publisher is running on. The user name can also be specified in the data source.