db-derby-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From chaa...@apache.org
Subject svn commit: r641923 - in /db/derby/docs/trunk/src: adminguide/ ref/ tuning/
Date Thu, 27 Mar 2008 17:41:20 GMT
Author: chaase3
Date: Thu Mar 27 10:41:12 2008
New Revision: 641923

URL: http://svn.apache.org/viewvc?rev=641923&view=rev
Log:
DERBY-3169: Add documentation for replication

New files for Admin Guide, Reference Manual, Tuning Derby; modified Derby properties table in Tuning Guide.

Added:
    db/derby/docs/trunk/src/adminguide/cadminreplication.dita   (with props)
    db/derby/docs/trunk/src/adminguide/cadminreplicfailover.dita   (with props)
    db/derby/docs/trunk/src/adminguide/cadminreplicfailures.dita   (with props)
    db/derby/docs/trunk/src/adminguide/cadminreplicsecurity.dita   (with props)
    db/derby/docs/trunk/src/adminguide/cadminreplicstartrun.dita   (with props)
    db/derby/docs/trunk/src/adminguide/cadminreplicstop.dita   (with props)
    db/derby/docs/trunk/src/ref/rrefattribfailover.dita   (with props)
    db/derby/docs/trunk/src/ref/rrefattribslavehost.dita   (with props)
    db/derby/docs/trunk/src/ref/rrefattribslaveport.dita   (with props)
    db/derby/docs/trunk/src/ref/rrefattribstartmaster.dita   (with props)
    db/derby/docs/trunk/src/ref/rrefattribstartslave.dita   (with props)
    db/derby/docs/trunk/src/ref/rrefattribstopmaster.dita   (with props)
    db/derby/docs/trunk/src/ref/rrefattribstopslave.dita   (with props)
    db/derby/docs/trunk/src/tuning/rtunproperlogbuffersize.dita   (with props)
    db/derby/docs/trunk/src/tuning/rtunpropermaxlogshippinginterval.dita   (with props)
    db/derby/docs/trunk/src/tuning/rtunproperminlogshippinginterval.dita   (with props)
    db/derby/docs/trunk/src/tuning/rtunproperverbose.dita   (with props)
Modified:
    db/derby/docs/trunk/src/adminguide/derbyadmin.ditamap
    db/derby/docs/trunk/src/ref/refderby.ditamap
    db/derby/docs/trunk/src/tuning/ctunproper22250.dita
    db/derby/docs/trunk/src/tuning/tuningderby.ditamap

Added: db/derby/docs/trunk/src/adminguide/cadminreplication.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/adminguide/cadminreplication.dita?rev=641923&view=auto
==============================================================================
--- db/derby/docs/trunk/src/adminguide/cadminreplication.dita (added)
+++ db/derby/docs/trunk/src/adminguide/cadminreplication.dita Thu Mar 27 10:41:12 2008
@@ -0,0 +1,99 @@
+<?xml version="1.0" encoding="utf-8"?>
+
+<!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN"
+ "../dtd/concept.dtd">
+<!-- 
+Licensed to the Apache Software Foundation (ASF) under one or more
+contributor license agreements.  See the NOTICE file distributed with
+this work for additional information regarding copyright ownership.
+The ASF licenses this file to You under the Apache License, Version 2.0
+(the "License"); you may not use this file except in compliance with
+the License.  You may obtain a copy of the License at      
+
+   http://www.apache.org/licenses/LICENSE-2.0  
+
+Unless required by applicable law or agreed to in writing, software  
+distributed under the License is distributed on an "AS IS" BASIS,  
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  
+See the License for the specific language governing permissions and  
+limitations under the License.
+-->
+<concept id="cadminreplication" xml:lang="en-us">
+<title>Replicating databases</title>
+<shortdesc>Replication is an important feature of a robust database management
+system. In <ph conref="../conrefs.dita#prod/productshortname"></ph>, you
+start database replication by using connection URL attributes.
+</shortdesc>
+<prolog><metadata><keywords>
+<indexterm>replicating databases</indexterm>
+<indexterm>database replication</indexterm>
+</keywords></metadata></prolog>
+<conbody><p>The replication capability of
+<ph conref="../conrefs.dita#prod/productshortname"></ph> has the following
+features:</p>
+<ul>
+<li><b>One master, one slave</b>: A replicated database resides in two locations
+and is managed by two different
+<ph conref="../conrefs.dita#prod/productshortname"></ph> instances. One of these
+<ph conref="../conrefs.dita#prod/productshortname"></ph> instances has the
+<i>master</i> role for this database, and the other has the <i>slave</i> role.
+Typically, the master and slave run on different nodes, but this is not a
+requirement. Together, the master and its associated slave represent a
+<i>replication pair</i>.
+</li>
+<li><b>Roll-forward shipped log</b>: Replication is based on shipping the
+<ph conref="../conrefs.dita#prod/productshortname"></ph> transaction log from
+the master to the slave, and then rolling forward the operations described in
+the log to the slave database.
+</li>
+<li><b>Asymmetry</b>: Only the master processes transactions. The slave
+processes no transactions, not even read operations.
+</li>
+<li><b>Asynchronicity</b>: Transactions are committed on the master without
+waiting for the slave. The shipping of the transaction log to the slave is
+performed regularly, and is completely decoupled from the transaction execution
+at the master. This may lead to a few lost transactions if the master crashes.
+</li>
+<li><b>Shared nothing</b>: Apart from the network line, no hardware is assumed to be
+shared.
+</li>
+<li><b>Replication granularity</b>: The granularity for replication is exactly
+one database. However, one
+<ph conref="../conrefs.dita#prod/productshortname"></ph> instance may have
+different roles for different databases. For example, one
+<ph conref="../conrefs.dita#prod/productshortname"></ph> instance may have the
+following roles, all at the same time:
+<ul>
+<li>The master role for one database D1 replicated to one node</li>
+<li>The slave role for a database D2 replicated from another node</li>
+<li>The normal, non-replicated, role for a database D3</li>
+</ul>
+</li>
+</ul>
+<p>Replication builds on
+<ph conref="../conrefs.dita#prod/productshortname"></ph>'s ability to recover
+from a crash by starting with a backup and rolling forward
+<ph conref="../conrefs.dita#prod/productshortname"></ph>'s transaction log
+files. The master sends log records to the slave using a network connection. The
+slave then writes these log records to its local log and redoes them.
+</p>
+<p>If the master fails, the slave completes the recovery by redoing the log that
+has not already been processed. The state of the slave after this recovery is
+close to the state the master had when it crashed. However, some of the last
+transactions performed on the master may not have been sent to the slave and may
+therefore not be reflected. When the slave has completed the recovery work, it
+is transformed into a normal
+<ph conref="../conrefs.dita#prod/productshortname"></ph> instance that is ready
+to process transactions. For more details, see
+<xref href="cadminreplicfailover.dita#cadminreplicfailover"></xref> and
+<xref href="cadminreplicsecurity.dita#cadminreplicsecurity"></xref>.
+</p>
+<p>Several Derby properties allow you to specify the size of the replication
+log buffers and the intervals between log shipments, as well as whether
+replication messages are logged. See
+<ph conref="../conrefs.dita#pub/cittuning"></ph> for details.</p>
+<p>You can perform replication on a database that runs in either embedded mode
+or Network Server mode.
+</p>
+</conbody>
+</concept>

Propchange: db/derby/docs/trunk/src/adminguide/cadminreplication.dita
------------------------------------------------------------------------------
    svn:eol-style = native

Added: db/derby/docs/trunk/src/adminguide/cadminreplicfailover.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/adminguide/cadminreplicfailover.dita?rev=641923&view=auto
==============================================================================
--- db/derby/docs/trunk/src/adminguide/cadminreplicfailover.dita (added)
+++ db/derby/docs/trunk/src/adminguide/cadminreplicfailover.dita Thu Mar 27 10:41:12 2008
@@ -0,0 +1,54 @@
+<?xml version="1.0" encoding="utf-8"?>
+
+<!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN"
+ "../dtd/concept.dtd">
+<!-- 
+Licensed to the Apache Software Foundation (ASF) under one or more
+contributor license agreements.  See the NOTICE file distributed with
+this work for additional information regarding copyright ownership.
+The ASF licenses this file to You under the Apache License, Version 2.0
+(the "License"); you may not use this file except in compliance with
+the License.  You may obtain a copy of the License at      
+
+   http://www.apache.org/licenses/LICENSE-2.0  
+
+Unless required by applicable law or agreed to in writing, software  
+distributed under the License is distributed on an "AS IS" BASIS,  
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  
+See the License for the specific language governing permissions and  
+limitations under the License.
+-->
+<concept id="cadminreplicfailover" xml:lang="en-us">
+<title>Forcing a failover</title>
+<prolog><metadata><keywords>
+<indexterm>replicating databases<indexterm>forcing failover</indexterm></indexterm>
+<indexterm>database replication<indexterm>forcing failover</indexterm></indexterm>
+</keywords></metadata></prolog>
+<conbody>
+<p>At any time, you can transform the
+<ph conref="../conrefs.dita#prod/productshortname"></ph> database that has the
+slave role into a normal 
+<ph conref="../conrefs.dita#prod/productshortname"></ph> database that can
+process transactions. This transformation from being a slave to becoming an
+active <ph conref="../conrefs.dita#prod/productshortname"></ph> database is
+called <i>failover</i>. During failover, the slave applies the parts of the
+transaction log that have not yet been processed. It then undoes operations that
+belong to uncommitted transactions, resulting in a transaction-consistent state
+that includes all transactions whose commit log record has been sent to the
+slave.</p>
+<p>You perform failover from the master system. To do so, you connect to the
+database on the master system using
+the <i>failover=true</i> connection URL attribute. For example, for a database
+named <codeph>wombat</codeph>, you might specify the following connection URL:
+</p>
+<codeblock>
+jdbc:derby:wombat;failover=true
+</codeblock>
+<p>If the network connection between the master system and the slave system is
+lost, you can perform failover from the slave system.</p>
+<p>See the <ph conref="../conrefs.dita#pub/citref"></ph> for details about the
+<i>failover=true</i> attribute.</p>
+<p>There is no automatic failover or restart of replication after one of the
+instances has failed.</p>
+</conbody>
+</concept>

Propchange: db/derby/docs/trunk/src/adminguide/cadminreplicfailover.dita
------------------------------------------------------------------------------
    svn:eol-style = native

Added: db/derby/docs/trunk/src/adminguide/cadminreplicfailures.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/adminguide/cadminreplicfailures.dita?rev=641923&view=auto
==============================================================================
--- db/derby/docs/trunk/src/adminguide/cadminreplicfailures.dita (added)
+++ db/derby/docs/trunk/src/adminguide/cadminreplicfailures.dita Thu Mar 27 10:41:12 2008
@@ -0,0 +1,121 @@
+<?xml version="1.0" encoding="utf-8"?>
+
+<!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN"
+ "../dtd/concept.dtd">
+<!-- 
+Licensed to the Apache Software Foundation (ASF) under one or more
+contributor license agreements.  See the NOTICE file distributed with
+this work for additional information regarding copyright ownership.
+The ASF licenses this file to You under the Apache License, Version 2.0
+(the "License"); you may not use this file except in compliance with
+the License.  You may obtain a copy of the License at      
+
+   http://www.apache.org/licenses/LICENSE-2.0  
+
+Unless required by applicable law or agreed to in writing, software  
+distributed under the License is distributed on an "AS IS" BASIS,  
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  
+See the License for the specific language governing permissions and  
+limitations under the License.
+-->
+<concept id="cadminreplicfailures" xml:lang="en-us">
+<title>Replication failure handling</title>
+<prolog><metadata><keywords>
+<indexterm>replicating databases<indexterm>failure handling</indexterm></indexterm>
+<indexterm>database replication<indexterm>failure handling</indexterm></indexterm>
+</keywords></metadata></prolog>
+<conbody>
+<p>Replication can encounter several failure situations. The following table
+lists these situations and describes the actions that
+<ph conref="../conrefs.dita#prod/productshortname"></ph> takes as a result.
+</p>
+<table id="cadminreplicsecuritytable">
+<title>Replication failure handling</title>
+<tgroup cols="2"><colspec colname="col1" colwidth="30*"/><colspec colname="col2" colwidth="70*"/>
+<thead>
+<row valign="bottom">
+<entry colname="col1">Failure situation</entry>
+<entry colname="col2">Action taken</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry colname="col1">Master loses connection with slave.</entry>
+<entry colname="col2">Transactions are allowed to continue processing while the
+master tries to reconnect with the slave. Log records generated while the
+connection is down are buffered in main memory. If the log buffer reaches its
+size limit before the connection can be reestablished, the master replication
+functionality is stopped. You can use the property
+<i>derby.replication.logBufferSize</i> to configure the size limit of the
+buffer; see <ph conref="../conrefs.dita#pub/cittuning"></ph> for
+details.</entry>
+</row>
+<row>
+<entry colname="col1">Slave loses connection with master.</entry>
+<entry colname="col2">The slave tries to reestablish the connection with the
+master by listening on the specified host and port. It will not give up until it
+is explicitly requested to do so by either the <i>failover=true</i> or
+<i>stopSlave=true</i> connection URL attribute. If a failover is requested, the
+slave applies all received log records and boots the database as described in
+<xref href="cadminreplicfailover.dita#cadminreplicfailover"></xref>. If the
+<i>stopSlave=true</i> attribute is specified, the slave database is shut down
+without further actions.</entry>
+</row>
+<row>
+<entry colname="col1">Two different masters of database D try to replicate to
+the same slave.</entry>
+<entry colname="col2">The slave will only accept the connection from the first
+master attempting to connect. Note that authentication is required to start
+both the slave and the master, as described in 
+<xref href="cadminreplicsecurity.dita#cadminreplicsecurity"></xref>.</entry>
+</row>
+<row>
+<entry colname="col1">The master and slave
+<ph conref="../conrefs.dita#prod/productshortname"></ph> instances are not at
+the same <ph conref="../conrefs.dita#prod/productshortname"></ph> version.
+</entry>
+<entry colname="col2">An exception is raised and replication does not start.
+</entry>
+</row>
+<row>
+<entry colname="col1">The master
+<ph conref="../conrefs.dita#prod/productshortname"></ph> instance crashes, then
+restarts.</entry>
+<entry colname="col2">Replication must be restarted, as described in
+<xref href="cadminreplicstartrun.dita#cadminreplicstartrun"></xref>.</entry>
+</row>
+<row>
+<entry colname="col1">The master
+<ph conref="../conrefs.dita#prod/productshortname"></ph> instance is not able to
+send log data to the slave at the same pace as the log is generated. The main
+memory log buffer gradually fills up and eventually becomes full.</entry>
+<entry colname="col2">The master notices that the main memory log buffer is
+filling up. It first tries to increase the speed of the log shipment to keep
+the amount of log in the buffer below the maximum. If that is not enough to
+keep the buffer from getting full, the response time of transactions may
+increase for as long as log shipment has trouble keeping up with the amount of
+generated log records. You can use properties to tune both the log buffer size
+and the minimum and maximum interval between consecutive log shipments. See
+<ph conref="../conrefs.dita#pub/cittuning"></ph> for details.</entry>
+</row>
+<row>
+<entry colname="col1">The slave
+<ph conref="../conrefs.dita#prod/productshortname"></ph> instance crashes.</entry>
+<entry colname="col2">The master sees this as a lost connection to the slave.
+The master tries to reestablish the connection until the replication log buffer
+is full. Replication is then stopped on the master. Replication must be
+restarted, as described in
+<xref href="cadminreplicstartrun.dita#cadminreplicstartrun"></xref>.</entry>
+</row>
+<row>
+<entry colname="col1">An unexpected failure is encountered.</entry>
+<entry colname="col2">Replication is stopped. The other
+<ph conref="../conrefs.dita#prod/productshortname"></ph> instance of the
+replication pair is notified of the decision if the network connection is still
+alive.</entry>
+</row>
+</tbody>
+</tgroup>
+</table>
+</conbody>
+</concept>

Propchange: db/derby/docs/trunk/src/adminguide/cadminreplicfailures.dita
------------------------------------------------------------------------------
    svn:eol-style = native

Added: db/derby/docs/trunk/src/adminguide/cadminreplicsecurity.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/adminguide/cadminreplicsecurity.dita?rev=641923&view=auto
==============================================================================
--- db/derby/docs/trunk/src/adminguide/cadminreplicsecurity.dita (added)
+++ db/derby/docs/trunk/src/adminguide/cadminreplicsecurity.dita Thu Mar 27 10:41:12 2008
@@ -0,0 +1,85 @@
+<?xml version="1.0" encoding="utf-8"?>
+
+<!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN"
+ "../dtd/concept.dtd">
+<!-- 
+Licensed to the Apache Software Foundation (ASF) under one or more
+contributor license agreements.  See the NOTICE file distributed with
+this work for additional information regarding copyright ownership.
+The ASF licenses this file to You under the Apache License, Version 2.0
+(the "License"); you may not use this file except in compliance with
+the License.  You may obtain a copy of the License at      
+
+   http://www.apache.org/licenses/LICENSE-2.0  
+
+Unless required by applicable law or agreed to in writing, software  
+distributed under the License is distributed on an "AS IS" BASIS,  
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  
+See the License for the specific language governing permissions and  
+limitations under the License.
+-->
+<concept id="cadminreplicsecurity" xml:lang="en-us">
+<title>Replication and security</title>
+<prolog><metadata><keywords>
+<indexterm>replicating databases<indexterm>security</indexterm></indexterm>
+<indexterm>database replication<indexterm>security</indexterm></indexterm>
+</keywords></metadata></prolog>
+<conbody>
+<p>If you want to perform replication with the security manager enabled, you
+must modify the security policy file on both the master and slave systems to
+allow the master-slave network connection. The section to be modified is the
+one following this line:</p>
+<codeblock>
+grant codeBase "${derby.install.url}derby.jar"
+</codeblock>
+<p>Add the following permission to the policy file on the master system:</p>
+<codeblock>
+  permission java.net.SocketPermission "<i>slaveHost</i>:<i>slavePort</i>", "connect,resolve";
+</codeblock>
+<p>Add the following permission to the policy file on the slave system:</p>
+<codeblock>
+  permission java.net.SocketPermission "<i>slaveHost</i>", "accept,resolve";
+</codeblock>
+<p><i>slaveHost</i> and <i>slavePort</i> are the values you specify for the
+<i>slaveHost=hostname</i> and <i>slavePort=portValue</i> attributes, which are
+described in the <ph conref="../conrefs.dita#pub/citref"></ph>.</p>
+<p>See <xref href="tadminnetservbasic.dita#tadminnetservbasic"></xref> for
+details on the security policy file.</p>
+<p>Depending on the security mode <ph
+conref="../conrefs.dita#prod/productshortname"></ph> is running under, the
+measures described in the following table are enforced when you specify the
+replication-related connection URL attributes.
+</p>
+<table id="cadminreplicsecuritytable">
+<title>Replication behavior with <ph
+conref="../conrefs.dita#prod/productshortname"></ph> security</title>
+<tgroup cols="2"><colspec colname="col1" colwidth="30*"/><colspec colname="col2" 
+colwidth="70*"/>
+<thead>
+<row valign="bottom">
+<entry colname="col1">Security mode</entry>
+<entry colname="col2">Replication attribute requirements</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry colname="col1">No security</entry>
+<entry colname="col2">Anyone may specify the replication attributes</entry>
+</row>
+<row>
+<entry colname="col1">Authentication is turned on</entry>
+<entry colname="col2">Normal <ph
+conref="../conrefs.dita#prod/productshortname"></ph> connection policy: specify
+valid <i>user=userName</i> and <i>password=userPassword</i> attributes</entry>
+</row>
+<row>
+<entry colname="col1">Authorization is turned on</entry>
+<entry colname="col2">The <i>user=userName</i> and <i>password=userPassword</i>
+attributes must be valid, and the user must be the owner of the replicated
+database</entry>
+</row>
+</tbody>
+</tgroup>
+</table>
+</conbody>
+</concept>

Propchange: db/derby/docs/trunk/src/adminguide/cadminreplicsecurity.dita
------------------------------------------------------------------------------
    svn:eol-style = native

Added: db/derby/docs/trunk/src/adminguide/cadminreplicstartrun.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/adminguide/cadminreplicstartrun.dita?rev=641923&view=auto
==============================================================================
--- db/derby/docs/trunk/src/adminguide/cadminreplicstartrun.dita (added)
+++ db/derby/docs/trunk/src/adminguide/cadminreplicstartrun.dita Thu Mar 27 10:41:12 2008
@@ -0,0 +1,92 @@
+<?xml version="1.0" encoding="utf-8"?>
+
+<!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN"
+ "../dtd/concept.dtd">
+<!-- 
+Licensed to the Apache Software Foundation (ASF) under one or more
+contributor license agreements.  See the NOTICE file distributed with
+this work for additional information regarding copyright ownership.
+The ASF licenses this file to You under the Apache License, Version 2.0
+(the "License"); you may not use this file except in compliance with
+the License.  You may obtain a copy of the License at      
+
+   http://www.apache.org/licenses/LICENSE-2.0  
+
+Unless required by applicable law or agreed to in writing, software  
+distributed under the License is distributed on an "AS IS" BASIS,  
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  
+See the License for the specific language governing permissions and  
+limitations under the License.
+-->
+<concept id="cadminreplicstartrun" xml:lang="en-us">
+<title>Starting and running replication</title>
+<prolog><metadata><keywords>
+<indexterm>replicating databases<indexterm>starting and running</indexterm></indexterm>
+<indexterm>database replication<indexterm>starting and running</indexterm></indexterm>
+</keywords></metadata></prolog>
+<conbody>
+<p>Each replicated database is replicated from a master to a slave version of
+that database. Initially there is no replication; a master database must be
+created before it can be replicated. The database may, of course, be empty when
+replication starts. On the other hand, replication does not need to be specified
+immediately after the database is created; it can be initiated at any time after
+the database is created.
+</p>
+<p>Before you start replication, you must boot the master database and then
+copy the database to the slave location. To ensure that the master database
+is not modified between the time you start the file-system copy and the time
+you start replication, you must freeze the master database. Follow these
+steps to start replication:
+</p>
+<ol>
+<li>Boot the database on the master system.</li>
+<li>When you are ready to start replication, freeze the master database by
+calling the <codeph>SYSCS_UTIL.SYSCS_FREEZE_DATABASE</codeph> procedure, as
+shown in the following example:
+<codeblock>CallableStatement cs = conn.prepareCall
+("CALL SYSCS_UTIL.SYSCS_FREEZE_DATABASE()");
+cs.execute();
+cs.close();</codeblock>
+This procedure ensures that all data pages and the log are written to disk,
+and blocks modifications to the database until replication has successfully
+started.</li>
+<li>Copy the database to the slave location.</li>
+<li>Start slave replication mode on the Derby instance that is acting
+as the slave for the database. To start slave replication, use the
+<i>startSlave=true</i> attribute and, optionally, the <i>slaveHost=hostname</i>
+and <i>slavePort=portValue</i> attributes. For example, for a database named
+<codeph>wombat</codeph>, you might use the following connection URL:
+<codeblock>
+jdbc:derby:wombat;startSlave=true
+</codeblock></li>
+<li>Start master replication mode on the Derby instance that is acting as the
+master for the database. To start replication, connect to the database on the
+master system using the <i>startMaster=true</i> attribute in conjunction with
+the <i>slaveHost=hostname</i> attribute (and, optionally, the
+<i>slavePort=portValue</i> attribute). For example, you might use the following
+connection URL:
+<codeblock>
+jdbc:derby:wombat;startMaster=true;slaveHost=myremotesystem
+</codeblock>
+A successful use of the <i>startMaster=true</i> attribute will also unfreeze the
+database.</li>
+</ol>
+<p>See the <ph conref="../conrefs.dita#pub/citref"></ph> for details about these
+attributes.</p>
+<p>After replication has been started, the slave
+is ready to receive logged operations from the master. The master can now
+continue to process transactions. From this point on, the master forwards all
+logged operations to the slave in chunks. The slave repeats
+these operations by applying the contents of the <ph
+conref="../conrefs.dita#prod/productshortname"></ph> transaction log, but does
+not process any other operations. Attempts to connect to the slave database are
+refused. In case of failure, the slave can recover to the state the master was
+in at the time the last chunk of the transaction log was sent.
+</p>
+<p> While replication is running, neither the slave or the master database is
+permitted to be shut down. Replication must be stopped before you can shut down
+either the slave or the master database. There is one exception to this rule:
+if the entire system is shut down, the peer that is shut down notifies the other
+replication peer that replication is stopped.</p>
+</conbody>
+</concept>

Propchange: db/derby/docs/trunk/src/adminguide/cadminreplicstartrun.dita
------------------------------------------------------------------------------
    svn:eol-style = native

Added: db/derby/docs/trunk/src/adminguide/cadminreplicstop.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/adminguide/cadminreplicstop.dita?rev=641923&view=auto
==============================================================================
--- db/derby/docs/trunk/src/adminguide/cadminreplicstop.dita (added)
+++ db/derby/docs/trunk/src/adminguide/cadminreplicstop.dita Thu Mar 27 10:41:12 2008
@@ -0,0 +1,47 @@
+<?xml version="1.0" encoding="utf-8"?>
+
+<!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN"
+ "../dtd/concept.dtd">
+<!-- 
+Licensed to the Apache Software Foundation (ASF) under one or more
+contributor license agreements.  See the NOTICE file distributed with
+this work for additional information regarding copyright ownership.
+The ASF licenses this file to You under the Apache License, Version 2.0
+(the "License"); you may not use this file except in compliance with
+the License.  You may obtain a copy of the License at      
+
+   http://www.apache.org/licenses/LICENSE-2.0  
+
+Unless required by applicable law or agreed to in writing, software  
+distributed under the License is distributed on an "AS IS" BASIS,  
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  
+See the License for the specific language governing permissions and  
+limitations under the License.
+-->
+<concept id="cadminreplicstop" xml:lang="en-us">
+<title>Stopping replication</title>
+<prolog><metadata><keywords>
+<indexterm>replicating databases<indexterm>stopping</indexterm></indexterm>
+<indexterm>database replication<indexterm>stopping</indexterm></indexterm>
+</keywords></metadata></prolog>
+<conbody>
+<p>To stop replication of a database, connect to the master database using the
+<i>stopMaster=true</i> connection URL attribute. The master sends the remaining
+log records that await shipment, and then sends a stop replication command to
+the slave. The slave then writes all logs to disk and shuts down the database.
+For example, for a database named <codeph>wombat</codeph>, you might specify the
+following connection URL:</p>
+<codeblock>
+jdbc:derby:wombat;stopMaster=true
+</codeblock>
+<p>To stop replication on the slave system if the connection to the master is
+lost, use the <i>stopSlave=true</i> connection URL attribute.
+</p>
+<p>See the <ph conref="../conrefs.dita#pub/citref"></ph> for details about these
+attributes.</p>
+<p>You cannot resume replication after it has been stopped. You need to start
+replication over again from the beginning using the <i>startMaster=true</i>
+attribute, as described in
+<xref href="cadminreplicstartrun.dita#cadminreplicstartrun"></xref>.
+</p></conbody>
+</concept>

Propchange: db/derby/docs/trunk/src/adminguide/cadminreplicstop.dita
------------------------------------------------------------------------------
    svn:eol-style = native

Modified: db/derby/docs/trunk/src/adminguide/derbyadmin.ditamap
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/adminguide/derbyadmin.ditamap?rev=641923&r1=641922&r2=641923&view=diff
==============================================================================
--- db/derby/docs/trunk/src/adminguide/derbyadmin.ditamap (original)
+++ db/derby/docs/trunk/src/adminguide/derbyadmin.ditamap Thu Mar 27 10:41:12 2008
@@ -261,6 +261,18 @@
 <topicref href="cadminrollforward.dita" navtitle="Roll-forward recovery">
 </topicref>
 </topicref>
+<topicref collection-type="family" href="cadminreplication.dita" navtitle="Replicating databases">
+<topicref href="cadminreplicstartrun.dita" navtitle="Starting and running replication">
+</topicref>
+<topicref href="cadminreplicstop.dita" navtitle="Stopping replication">
+</topicref>
+<topicref href="cadminreplicfailover.dita" navtitle="Forcing a failover">
+</topicref>
+<topicref href="cadminreplicsecurity.dita" navtitle="Replication and security">
+</topicref>
+<topicref href="cadminreplicfailures.dita" navtitle="Replication failure handling">
+</topicref>
+</topicref>
 <topicref collection-type="family" href="cadminlog98.dita" navtitle="Logging on a separate device">
 <topicref href="tadminlog800206.dita" navtitle="Using the logDevice attribute">
 </topicref>

Modified: db/derby/docs/trunk/src/ref/refderby.ditamap
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/refderby.ditamap?rev=641923&r1=641922&r2=641923&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/refderby.ditamap (original)
+++ db/derby/docs/trunk/src/ref/refderby.ditamap Thu Mar 27 10:41:12 2008
@@ -600,6 +600,8 @@
 </topicref>
 <topicref href="rrefattrib60346.dita" navtitle="encryptionAlgorithm=algorithm attribute">
 </topicref>
+<topicref href="rrefattribfailover.dita" navtitle="failover=true attribute">
+</topicref>
 <topicref href="rrefattrib72457.dita" navtitle="logDevice=logDirectoryPath attribute">
 </topicref>
 <topicref href="rrefattribnewencryptkey.dita" navtitle="newEncryptionKey=key attribute">
@@ -615,6 +617,18 @@
 <topicref href="rrefattribsecmech.dita" navtitle="securityMechanism=value attribute">
 </topicref>
 <topicref href="rrefattrib16471.dita" navtitle="shutdown=true attribute">
+</topicref>
+<topicref href="rrefattribslavehost.dita" navtitle="slaveHost=hostname attribute">
+</topicref>
+<topicref href="rrefattribslaveport.dita" navtitle="slavePort=portValue attribute">
+</topicref>
+<topicref href="rrefattribstartmaster.dita" navtitle="startMaster=true attribute">
+</topicref>
+<topicref href="rrefattribstartslave.dita" navtitle="startSlave=true attribute">
+</topicref>
+<topicref href="rrefattribstopmaster.dita" navtitle="stopMaster=true attribute">
+</topicref>
+<topicref href="rrefattribstopslave.dita" navtitle="stopSlave=true attribute">
 </topicref>
 <topicref href="rrefattrib56769.dita" navtitle="territory=ll_CC attribute">
 </topicref>

Added: db/derby/docs/trunk/src/ref/rrefattribfailover.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefattribfailover.dita?rev=641923&view=auto
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefattribfailover.dita (added)
+++ db/derby/docs/trunk/src/ref/rrefattribfailover.dita Thu Mar 27 10:41:12 2008
@@ -0,0 +1,83 @@
+<?xml version="1.0" encoding="utf-8"?>
+ 
+<!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN"
+ "../dtd/reference.dtd">
+<!-- 
+Licensed to the Apache Software Foundation (ASF) under one or more
+contributor license agreements.  See the NOTICE file distributed with
+this work for additional information regarding copyright ownership.
+The ASF licenses this file to You under the Apache License, Version 2.0
+(the "License"); you may not use this file except in compliance with
+the License.  You may obtain a copy of the License at      
+
+http://www.apache.org/licenses/LICENSE-2.0  
+
+Unless required by applicable law or agreed to in writing, software  
+distributed under the License is distributed on an "AS IS" BASIS,  
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  
+See the License for the specific language governing permissions and  
+limitations under the License.
+-->
+<reference id="rrefattribfailover" xml:lang="en-us">
+<title>failover=true attribute</title>
+<prolog><metadata>
+<keywords><indexterm>failover=true database connection URL
+attribute</indexterm><indexterm>replicating databases<indexterm>forcing
+failover</indexterm></indexterm><indexterm>database
+replication<indexterm>forcing failover</indexterm></indexterm>
+<indexterm>databases<indexterm>attributes, forcing
+failover</indexterm></indexterm>
+<indexterm>attributes<indexterm>failover</indexterm></indexterm>
+</keywords>
+</metadata></prolog>
+<refbody>
+<section><title>Function</title>
+<p>Stops database replication on the slave system and converts the slave
+database into a normal database.</p>
+<p>If you specify the <i>failover=true</i> attribute on the master, the
+attribute sends the remaining log records to the slave instance and then sends a
+failover message to the slave. The replication functionality and the database
+are then shut down on the master system. If failover is successful, an exception
+with the error code XRE20 is thrown. Hence, when issued on the master, the
+<i>failover=true</i> attribute does not return a valid connection.</p>
+<p>You may specify this attribute on the slave only if the network connection
+between the master and the slave is down.</p>
+<p>When you specify this attribute on the slave, or when a failover message is
+sent as part of the execution of the <i>failover=true</i> attribute on the
+master, all transaction log chunks that have been received from the master are
+written to disk. The slave replication functionality is shut down, and the boot
+process of the database is allowed to complete. The database is now in a
+transaction consistent state, reflecting all transactions whose commit log
+records were received from the master. When issued on the slave, the
+<i>failover=true</i> command returns a valid connection.</p>
+<p>The <ph conref="../conrefs.dita#prod/productshortname"></ph> instance where
+this command is issued must be serving the named database in replication mode.
+</p>
+<p>For more information, see the topics under "Replicating databases" in the
+<ph conref="../conrefs.dita#pub/citadmin"></ph>.</p>
+</section>
+<section><title>Combining with other attributes</title>
+<p>You must specify a database name in the connection URL, either in the
+subprotocol or by using the <i><xref
+href="rrefattrib17246.dita#rrefattrib17246">databaseName=nameofDatabase</xref></i>
+attribute.</p>
+<p>If authentication is turned on, you must also specify
+this attribute in conjunction with the <i><xref
+href="rrefattrib10035.dita#rrefattrib10035">user=userName</xref></i> and
+<i><xref
+href="rrefattrib42686.dita#rrefattrib42686">password=userPassword</xref></i>
+attributes. Authorization for the master database cannot be checked when the
+network connection is down, so the requirement that the user must be the
+database owner is not enforced.</p>
+<p>You may not specify this attribute in conjunction with any attributes not
+mentioned in this section.</p>
+</section>
+<example><title>Examples</title>
+<codeblock><b>-- start failover from master using database name in subprotocol,
+--   authorization
+jdbc:derby:myDB;failover=true;user=mary;password=little88lamb</b></codeblock>
+<codeblock><b>-- start failover using databaseName attribute, no security
+jdbc:derby:;databaseName=myDB;failover=true;</b></codeblock>
+</example>
+</refbody>
+</reference>

Propchange: db/derby/docs/trunk/src/ref/rrefattribfailover.dita
------------------------------------------------------------------------------
    svn:eol-style = native

Added: db/derby/docs/trunk/src/ref/rrefattribslavehost.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefattribslavehost.dita?rev=641923&view=auto
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefattribslavehost.dita (added)
+++ db/derby/docs/trunk/src/ref/rrefattribslavehost.dita Thu Mar 27 10:41:12 2008
@@ -0,0 +1,58 @@
+<?xml version="1.0" encoding="utf-8"?>
+ 
+<!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN"
+ "../dtd/reference.dtd">
+<!-- 
+Licensed to the Apache Software Foundation (ASF) under one or more
+contributor license agreements.  See the NOTICE file distributed with
+this work for additional information regarding copyright ownership.
+The ASF licenses this file to You under the Apache License, Version 2.0
+(the "License"); you may not use this file except in compliance with
+the License.  You may obtain a copy of the License at      
+
+http://www.apache.org/licenses/LICENSE-2.0  
+
+Unless required by applicable law or agreed to in writing, software  
+distributed under the License is distributed on an "AS IS" BASIS,  
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  
+See the License for the specific language governing permissions and  
+limitations under the License.
+-->
+<reference id="rrefattribslavehost" xml:lang="en-us">
+<title>slaveHost=hostname attribute</title>
+<prolog><metadata>
+<keywords><indexterm>slaveHost=hostname database connection URL
+attribute</indexterm><indexterm>replicating databases<indexterm>specifying the
+slave host</indexterm></indexterm><indexterm>database
+replication<indexterm>specifying the slave
+host</indexterm></indexterm><indexterm>databases<indexterm>attributes,
+specifying replication slave host</indexterm></indexterm>
+<indexterm>attributes<indexterm>slaveHost</indexterm></indexterm>
+</keywords>
+</metadata></prolog>
+<refbody>
+<section><title>Function</title>
+<p>Specifies the system that will serve as the slave for database replication.
+</p>
+<p>For more information, see the topics under "Replicating databases" in the
+<ph conref="../conrefs.dita#pub/citadmin"></ph>.</p>
+</section>
+<section><title>Combining with other attributes</title>
+<p>This attribute must be specified in conjunction with the <i><xref
+href="rrefattribstartmaster.dita#rrefattribstartmaster">startMaster=true</xref></i>
+attribute. It may be specified in conjunction with the <i><xref
+href="rrefattribstartslave.dita#rrefattribstartslave">startSlave=true</xref></i>
+attribute; if it is not, the default value is <codeph>localhost</codeph>.</p>
+<p>This attribute may be specified only in conjunction with the other attributes
+permitted with the <i>startMaster=true</i> and <i>startSlave=true</i>
+attributes.</p>
+</section>
+<example><title>Examples</title>
+<p>For examples, see <i><xref
+href="rrefattribstartmaster.dita#rrefattribstartmaster">startMaster=true</xref></i>
+and <i><xref
+href="rrefattribstartslave.dita#rrefattribstartslave">startSlave=true</xref></i>.
+</p>
+</example>
+</refbody>
+</reference>

Propchange: db/derby/docs/trunk/src/ref/rrefattribslavehost.dita
------------------------------------------------------------------------------
    svn:eol-style = native

Added: db/derby/docs/trunk/src/ref/rrefattribslaveport.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefattribslaveport.dita?rev=641923&view=auto
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefattribslaveport.dita (added)
+++ db/derby/docs/trunk/src/ref/rrefattribslaveport.dita Thu Mar 27 10:41:12 2008
@@ -0,0 +1,59 @@
+<?xml version="1.0" encoding="utf-8"?>
+ 
+<!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN"
+ "../dtd/reference.dtd">
+<!-- 
+Licensed to the Apache Software Foundation (ASF) under one or more
+contributor license agreements.  See the NOTICE file distributed with
+this work for additional information regarding copyright ownership.
+The ASF licenses this file to You under the Apache License, Version 2.0
+(the "License"); you may not use this file except in compliance with
+the License.  You may obtain a copy of the License at      
+
+http://www.apache.org/licenses/LICENSE-2.0  
+
+Unless required by applicable law or agreed to in writing, software  
+distributed under the License is distributed on an "AS IS" BASIS,  
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  
+See the License for the specific language governing permissions and  
+limitations under the License.
+-->
+<reference id="rrefattribslaveport" xml:lang="en-us">
+<title>slavePort=portValue attribute</title>
+<prolog><metadata>
+<keywords><indexterm>slavePort=portValue database connection URL
+attribute</indexterm><indexterm>replicating databases<indexterm>specifying the
+slave port</indexterm></indexterm><indexterm>database
+replication<indexterm>specifying the slave
+port</indexterm></indexterm><indexterm>databases<indexterm>attributes,
+specifying replication slave port</indexterm></indexterm>
+<indexterm>attributes<indexterm>slavePort</indexterm></indexterm>
+</keywords>
+</metadata></prolog>
+<refbody>
+<section><title>Function</title>
+<p>Specifies the port that the slave system will use in database replication.
+</p>
+<p>For more information, see the topics under "Replicating databases" in the
+<ph conref="../conrefs.dita#pub/citadmin"></ph>.</p>
+</section>
+<section><title>Combining with other attributes</title>
+<p>This attribute may be specified in conjunction with the <i><xref
+href="rrefattribstartmaster.dita#rrefattribstartmaster">startMaster=true</xref></i>
+attribute and the <i><xref
+href="rrefattribstartslave.dita#rrefattribstartslave">startSlave=true</xref></i>
+attribute. If it is not specified, the default port value is
+<codeph>4851</codeph>.</p>
+<p>This attribute may be specified only in conjunction with the other attributes
+permitted with the <i>startMaster=true</i> and <i>startSlave=true</i>
+attributes.</p>
+</section>
+<example><title>Examples</title>
+<p>For examples, see <i><xref
+href="rrefattribstartmaster.dita#rrefattribstartmaster">startMaster=true</xref></i>
+and <i><xref
+href="rrefattribstartslave.dita#rrefattribstartslave">startSlave=true</xref></i>.
+</p>
+</example>
+</refbody>
+</reference>

Propchange: db/derby/docs/trunk/src/ref/rrefattribslaveport.dita
------------------------------------------------------------------------------
    svn:eol-style = native

Added: db/derby/docs/trunk/src/ref/rrefattribstartmaster.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefattribstartmaster.dita?rev=641923&view=auto
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefattribstartmaster.dita (added)
+++ db/derby/docs/trunk/src/ref/rrefattribstartmaster.dita Thu Mar 27 10:41:12 2008
@@ -0,0 +1,71 @@
+<?xml version="1.0" encoding="utf-8"?>
+ 
+<!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN"
+ "../dtd/reference.dtd">
+<!-- 
+Licensed to the Apache Software Foundation (ASF) under one or more
+contributor license agreements.  See the NOTICE file distributed with
+this work for additional information regarding copyright ownership.
+The ASF licenses this file to You under the Apache License, Version 2.0
+(the "License"); you may not use this file except in compliance with
+the License.  You may obtain a copy of the License at      
+
+http://www.apache.org/licenses/LICENSE-2.0  
+
+Unless required by applicable law or agreed to in writing, software  
+distributed under the License is distributed on an "AS IS" BASIS,  
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  
+See the License for the specific language governing permissions and  
+limitations under the License.
+-->
+<reference id="rrefattribstartmaster" xml:lang="en-us">
+<title>startMaster=true attribute</title>
+<prolog><metadata>
+<keywords><indexterm>startMaster=true database connection URL
+attribute</indexterm><indexterm>replicating databases<indexterm>starting the
+master</indexterm></indexterm><indexterm>database replication<indexterm>starting
+the master</indexterm></indexterm><indexterm>databases<indexterm>attributes,
+starting the replication master</indexterm></indexterm>
+<indexterm>attributes<indexterm>startMaster</indexterm></indexterm>
+</keywords>
+</metadata></prolog>
+<refbody>
+<section><title>Function</title>
+<p>Starts replication of a database in master mode. The specified database must
+have been created before you specify this attribute.</p>
+<p>For more information, see the topics under "Replicating databases" in the
+<ph conref="../conrefs.dita#pub/citadmin"></ph>.</p>
+</section>
+<section><title>Combining with other attributes</title>
+<p>You must specify a database name in the connection URL, either in the
+subprotocol or by using the <i><xref
+href="rrefattrib17246.dita#rrefattrib17246">databaseName=nameofDatabase</xref></i>
+attribute.</p>
+<p>You must specify this attribute in conjunction with the <i><xref
+href="rrefattribslaveHost.dita#rrefattribslaveHost">slaveHost=hostname</xref></i>
+attribute. You may also specify this attribute in conjunction with the <i><xref
+href="rrefattribslaveport.dita#rrefattribslaveport">slavePort=portValue</xref></i>
+attribute. If you do not specify the <i>slavePort=portValue</i> attribute, the
+default port value is 4851.</p>
+<p>If authentication or authorization is turned on, you
+must also specify this attribute in conjunction with the <i><xref
+href="rrefattrib10035.dita#rrefattrib10035">user=userName</xref></i> and
+<i><xref
+href="rrefattrib42686.dita#rrefattrib42686">password=userPassword</xref></i>
+attributes. If authorization is turned on, the user must be the database owner.
+</p>
+<p>You may not specify this attribute in conjunction with any attributes not
+mentioned in this section.</p>
+</section>
+<example><title>Examples</title>
+<codeblock><b>-- start master using database name in subprotocol, default slave 
+--  port, authorization
+jdbc:derby:myDB;startMaster=true;slaveHost=elsewhere;user=mary;
+   password=little88lamb</b></codeblock>
+<codeblock><b>-- start master using databaseName attribute, non-default slave 
+--  port, no security
+jdbc:derby:;databaseName=myDB;startMaster=true;slaveHost=elsewhere;
+   slavePort=4852</b></codeblock>
+</example>
+</refbody>
+</reference>

Propchange: db/derby/docs/trunk/src/ref/rrefattribstartmaster.dita
------------------------------------------------------------------------------
    svn:eol-style = native

Added: db/derby/docs/trunk/src/ref/rrefattribstartslave.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefattribstartslave.dita?rev=641923&view=auto
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefattribstartslave.dita (added)
+++ db/derby/docs/trunk/src/ref/rrefattribstartslave.dita Thu Mar 27 10:41:12 2008
@@ -0,0 +1,88 @@
+<?xml version="1.0" encoding="utf-8"?>
+ 
+<!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN"
+ "../dtd/reference.dtd">
+<!-- 
+Licensed to the Apache Software Foundation (ASF) under one or more
+contributor license agreements.  See the NOTICE file distributed with
+this work for additional information regarding copyright ownership.
+The ASF licenses this file to You under the Apache License, Version 2.0
+(the "License"); you may not use this file except in compliance with
+the License.  You may obtain a copy of the License at      
+
+http://www.apache.org/licenses/LICENSE-2.0  
+
+Unless required by applicable law or agreed to in writing, software  
+distributed under the License is distributed on an "AS IS" BASIS,  
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  
+See the License for the specific language governing permissions and  
+limitations under the License.
+-->
+<reference id="rrefattribstartslave" xml:lang="en-us">
+<title>startSlave=true attribute</title>
+<prolog><metadata>
+<keywords><indexterm>startSlave=true database connection URL
+attribute</indexterm><indexterm>replicating databases<indexterm>starting the
+slave</indexterm></indexterm><indexterm>database replication<indexterm>starting
+the slave</indexterm></indexterm><indexterm>databases<indexterm>attributes,
+starting the replication slave</indexterm></indexterm>
+<indexterm>attributes<indexterm>startSlave</indexterm></indexterm>
+</keywords>
+</metadata></prolog>
+<refbody>
+<section><title>Function</title>
+<p>Starts replication of a database in slave mode. Before you specify this
+attribute, you must boot the database on the master system, freeze it, and then
+perform a file system copy of the database to the slave system.
+</p>
+<p>The <i>startSlave=true</i> attribute does the following:</p>
+<ol>
+<li>Partially boots the specified database</li>
+<li>Starts to listen on the specified port and accepts a connection from the
+master</li>
+<li>Hangs until the master has connected to it</li>
+<li>Reports the startup status to the caller (whether it has started, and if
+not, why not)</li>
+<li>Continually receives chunks of the transaction log from the master and
+applies the operations in the transaction log to the slave database</li>
+</ol>
+<p>If replication is started successfully, an exception with the error code
+XRE08 is thrown. Hence, the <i>startSlave=true</i> attribute does not return a
+valid connection.</p>
+<p>For more information, see the topics under "Replicating databases" in the
+<ph conref="../conrefs.dita#pub/citadmin"></ph>.</p>
+</section>
+<section><title>Combining with other attributes</title>
+<p>You must specify a database name in the connection URL, either in the
+subprotocol or by using the <i><xref
+href="rrefattrib17246.dita#rrefattrib17246">databaseName=nameofDatabase</xref></i>
+attribute.</p>
+<p>You may specify this attribute in conjunction with the <i><xref
+href="rrefattribslavehost.dita#rrefattribslavehost">slaveHost=hostname</xref></i>
+attribute. If you do not specify the <i>slaveHost=hostname</i> attribute, the
+default value is <codeph>localhost</codeph>.</p>
+<p>You may also specify this attribute in conjunction with the <i><xref
+href="rrefattribslaveport.dita#rrefattribslaveport">slavePort=portValue</xref></i>
+attribute. If you do not specify the <i>slavePort=portValue</i> attribute, the
+default port value is 4851.</p>
+<p>If authentication or authorization is turned on, you
+must also specify this attribute in conjunction with the <i><xref
+href="rrefattrib10035.dita#rrefattrib10035">user=userName</xref></i> and
+<i><xref
+href="rrefattrib42686.dita#rrefattrib42686">password=userPassword</xref></i>
+attributes. If authorization is turned on, the user must be the database owner.
+</p>
+<p>You may not specify this attribute in conjunction with any attributes not
+mentioned in this section.</p>
+</section>
+<example><title>Examples</title>
+<codeblock><b>-- start slave using database name in subprotocol, default slave host 
+--    and port, authorization
+jdbc:derby:myDB;startslave=true;user=mary;password=little88lamb</b></codeblock>
+<codeblock><b>-- start slave using databaseName attribute, non-default slave host 
+--   and port, no security
+jdbc:derby:;databaseName=myDB;startSlave=true;slaveHost=localhost;
+   slavePort=4852</b></codeblock>
+</example>
+</refbody>
+</reference>

Propchange: db/derby/docs/trunk/src/ref/rrefattribstartslave.dita
------------------------------------------------------------------------------
    svn:eol-style = native

Added: db/derby/docs/trunk/src/ref/rrefattribstopmaster.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefattribstopmaster.dita?rev=641923&view=auto
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefattribstopmaster.dita (added)
+++ db/derby/docs/trunk/src/ref/rrefattribstopmaster.dita Thu Mar 27 10:41:12 2008
@@ -0,0 +1,66 @@
+<?xml version="1.0" encoding="utf-8"?>
+ 
+<!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN"
+ "../dtd/reference.dtd">
+<!-- 
+Licensed to the Apache Software Foundation (ASF) under one or more
+contributor license agreements.  See the NOTICE file distributed with
+this work for additional information regarding copyright ownership.
+The ASF licenses this file to You under the Apache License, Version 2.0
+(the "License"); you may not use this file except in compliance with
+the License.  You may obtain a copy of the License at      
+
+http://www.apache.org/licenses/LICENSE-2.0  
+
+Unless required by applicable law or agreed to in writing, software  
+distributed under the License is distributed on an "AS IS" BASIS,  
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  
+See the License for the specific language governing permissions and  
+limitations under the License.
+-->
+<reference id="rrefattribstopmaster" xml:lang="en-us">
+<title>stopMaster=true attribute</title>
+<prolog><metadata>
+<keywords><indexterm>stopMaster=true database connection URL
+attribute</indexterm><indexterm>replicating databases<indexterm>stopping the
+master</indexterm></indexterm><indexterm>database replication<indexterm>stopping
+the master</indexterm></indexterm><indexterm>databases<indexterm>attributes,
+stopping the replication master</indexterm></indexterm>
+<indexterm>attributes<indexterm>stopMaster</indexterm></indexterm>
+</keywords>
+</metadata></prolog>
+<refbody>
+<section><title>Function</title>
+<p>Stops database replication on the master system. This attribute sends a
+stop-slave message to the slave system if the network connection is working.
+Then it shuts down all replication-related functionality, without shutting down
+the specified database.</p>
+<p>The <ph conref="../conrefs.dita#prod/productshortname"></ph> instance where
+this attribute is specified must be the replication master for the specified
+database.</p>
+<p>For more information, see the topics under "Replicating databases" in the
+<ph conref="../conrefs.dita#pub/citadmin"></ph>.</p>
+</section>
+<section><title>Combining with other attributes</title>
+<p>You must specify a database name in the connection URL, either in the
+subprotocol or by using the <i><xref
+href="rrefattrib17246.dita#rrefattrib17246">databaseName=nameofDatabase</xref></i>
+attribute.</p>
+<p>If authentication or authorization is turned on, you
+must also specify this attribute in conjunction with the <i><xref
+href="rrefattrib10035.dita#rrefattrib10035">user=userName</xref></i> and
+<i><xref
+href="rrefattrib42686.dita#rrefattrib42686">password=userPassword</xref></i>
+attributes. If authorization is turned on, the user must be the database owner.
+</p>
+<p>You may not specify this attribute in conjunction with any attributes not
+mentioned in this section.</p>
+</section>
+<example><title>Examples</title>
+<codeblock><b>-- stop master using database name in subprotocol, authorization
+jdbc:derby:myDB;stopMaster=true;user=mary;password=little88lamb</b></codeblock>
+<codeblock><b>-- stop master using databaseName attribute, no security
+jdbc:derby:;databaseName=myDB;stopMaster=true;</b></codeblock>
+</example>
+</refbody>
+</reference>

Propchange: db/derby/docs/trunk/src/ref/rrefattribstopmaster.dita
------------------------------------------------------------------------------
    svn:eol-style = native

Added: db/derby/docs/trunk/src/ref/rrefattribstopslave.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefattribstopslave.dita?rev=641923&view=auto
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefattribstopslave.dita (added)
+++ db/derby/docs/trunk/src/ref/rrefattribstopslave.dita Thu Mar 27 10:41:12 2008
@@ -0,0 +1,76 @@
+<?xml version="1.0" encoding="utf-8"?>
+ 
+<!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN"
+ "../dtd/reference.dtd">
+<!-- 
+Licensed to the Apache Software Foundation (ASF) under one or more
+contributor license agreements.  See the NOTICE file distributed with
+this work for additional information regarding copyright ownership.
+The ASF licenses this file to You under the Apache License, Version 2.0
+(the "License"); you may not use this file except in compliance with
+the License.  You may obtain a copy of the License at      
+
+http://www.apache.org/licenses/LICENSE-2.0  
+
+Unless required by applicable law or agreed to in writing, software  
+distributed under the License is distributed on an "AS IS" BASIS,  
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  
+See the License for the specific language governing permissions and  
+limitations under the License.
+-->
+<reference id="rrefattribstopslave" xml:lang="en-us">
+<title>stopSlave=true attribute</title>
+<prolog><metadata>
+<keywords><indexterm>stopSlave=true database connection URL
+attribute</indexterm><indexterm>replicating databases<indexterm>stopping the
+slave</indexterm></indexterm><indexterm>database replication<indexterm>stopping
+the slave</indexterm></indexterm><indexterm>databases<indexterm>attributes,
+stopping the replication slave</indexterm></indexterm>
+<indexterm>attributes<indexterm>stopSlave</indexterm></indexterm>
+</keywords>
+</metadata></prolog>
+<refbody>
+<section><title>Function</title>
+<p>Stops database replication on the slave system.</p>
+<p>You can specify this connection URL attribute only if the network connection
+between the master and slave systems is down. If the network connection is
+working, the slave system accepts commands only from the master, so you must
+specify the <i><xref
+href="rrefattribstopmaster.dita#rrefattribstopmaster">stopMaster=true</xref></i>
+attribute on the master system to stop replication on both the master and slave
+systems.</p>
+<p>When this attribute is specified, or when a stop-slave message is sent as
+part of the execution of the <i>stopMaster=true</i> attribute, all transaction
+log chunks that have been received from the master are written to disk. Both the
+slave replication functionality and the database are then shut down.</p>
+<p>The <ph conref="../conrefs.dita#prod/productshortname"></ph> instance where
+this attribute is specified must be serving the specified database in
+replication slave mode.</p>
+<p>For more information, see the topics under "Replicating databases" in the
+<ph conref="../conrefs.dita#pub/citadmin"></ph>.</p>
+</section>
+<section><title>Combining with other attributes</title>
+<p>You must specify a database name in the connection URL, either in the
+subprotocol or by using the <i><xref
+href="rrefattrib17246.dita#rrefattrib17246">databaseName=nameofDatabase</xref></i>
+attribute.</p>
+<p>If authentication is turned on, you must also specify
+this attribute in conjunction with the <i><xref
+href="rrefattrib10035.dita#rrefattrib10035">user=userName</xref></i> and
+<i><xref
+href="rrefattrib42686.dita#rrefattrib42686">password=userPassword</xref></i>
+attributes. Authorization for the master database cannot be checked when the
+network connection is down, so the requirement that the user must be the
+database owner is not enforced.</p>
+<p>You may not specify this attribute in conjunction with any attributes not
+mentioned in this section.</p>
+</section>
+<example><title>Examples</title>
+<codeblock><b>-- stop slave from master using database name in subprotocol,
+--   authorization
+jdbc:derby:myDB;stopSlave=true;user=mary;password=little88lamb</b></codeblock>
+<codeblock><b>-- stop slave using databaseName attribute, no security
+jdbc:derby:;databaseName=myDB;stopSlave=true;</b></codeblock>
+</example>
+</refbody>
+</reference>

Propchange: db/derby/docs/trunk/src/ref/rrefattribstopslave.dita
------------------------------------------------------------------------------
    svn:eol-style = native

Modified: db/derby/docs/trunk/src/tuning/ctunproper22250.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/tuning/ctunproper22250.dita?rev=641923&r1=641922&r2=641923&view=diff
==============================================================================
--- db/derby/docs/trunk/src/tuning/ctunproper22250.dita (original)
+++ db/derby/docs/trunk/src/tuning/ctunproper22250.dita Thu Mar 27 10:41:12 2008
@@ -51,37 +51,37 @@
 <row>
 <entry colname="1"><i><xref href="rtunsearchauthdn.dita#rtunsearchauthdn">derby.authentication.ldap.searchAuthDN</xref></i></entry>
 <entry colname="2">S, D</entry>
-<entry colname="3"></entry>
+<entry colname="3">&nbsp;</entry>
 </row>
 <row>
 <entry colname="1"><i><xref href="rtunsearchauthpw.dita#rtunsearchauthpw">derby.authentication.ldap.searchAuthPW</xref></i></entry>
 <entry colname="2">S, D</entry>
-<entry colname="3"></entry>
+<entry colname="3">&nbsp;</entry>
 </row>
 <row>
 <entry colname="1"><i><xref href="rtunproper26978.dita#rtunproper26978">derby.authentication.ldap.searchBase</xref></i></entry>
 <entry colname="2">S, D</entry>
-<entry colname="3"></entry>
+<entry colname="3">&nbsp;</entry>
 </row>
 <row>
 <entry colname="1"><i><xref href="rtunproper37341.dita#rtunproper37341">derby.authentication.ldap.searchFilter</xref></i></entry>
 <entry colname="2">S, D</entry>
-<entry colname="3"></entry>
+<entry colname="3">&nbsp;</entry>
 </row>
 <row>
 <entry colname="1"><i><xref href="rtunproper13766.dita#rtunproper13766">derby.authentication.provider</xref></i></entry>
 <entry colname="2">S, D</entry>
-<entry colname="3"></entry>
+<entry colname="3">&nbsp;</entry>
 </row>
 <row>
 <entry colname="1"><i><xref href="rtunproper25581.dita#rtunproper25581">derby.authentication.server</xref></i></entry>
 <entry colname="2">S, D</entry>
-<entry colname="3"></entry>
+<entry colname="3">&nbsp;</entry>
 </row>
 <row>
 <entry colname="1"><i><xref href="rtunproper27467.dita#rtunproper27467">derby.connection.requireAuthentication</xref></i></entry>
 <entry colname="2">S, D</entry>
-<entry colname="3"></entry>
+<entry colname="3">&nbsp;</entry>
 </row>
 <row>
 <entry colname="1"><i><xref href="rtunproper24846.dita#rtunproper24846">derby.database.defaultConnectionMode</xref></i></entry>
@@ -91,7 +91,7 @@
 <row>
 <entry colname="1"><i><xref href="rtunproper81405.dita#rtunproper81405">derby.database.forceDatabaseLock</xref></i></entry>
 <entry colname="2">S</entry>
-<entry colname="3"></entry>
+<entry colname="3">&nbsp;</entry>
 </row>
 <row>
 <entry colname="1"><i><xref href="rtunproper25025.dita#rtunproper25025">derby.database.fullAccessUsers</xref></i></entry>
@@ -101,7 +101,7 @@
 <row>
 <entry colname="1"><i><xref href="rtunpropernoautoboot.dita#rtunpropernoautoboot">derby.database.noAutoBoot</xref></i></entry>
 <entry colname="2">D</entry>
-<entry colname="3"></entry>
+<entry colname="3">&nbsp;</entry>
 </row>
 <row>
 <entry colname="1"><i><xref href="rtunproper24390.dita#rtunproper24390">derby.database.propertiesOnly</xref></i></entry>
@@ -116,7 +116,7 @@
 <row>
 <entry colname="1"><i><xref href="rtunproper13217.dita#rtunproper13217">derby.infolog.append</xref></i></entry>
 <entry colname="2">S</entry>
-<entry colname="3"></entry>
+<entry colname="3">&nbsp;</entry>
 </row>
 <row>
 <entry colname="1"><i><xref href="rtunproperxatrantimeout.dita#rtunproperxatrantimeout">derby.jdbc.xaTransactionTimeout</xref></i></entry>
@@ -126,12 +126,12 @@
 <row>
 <entry colname="1"><i><xref href="rtunproper43414.dita#rtunproper43414">derby.language.logQueryPlan</xref></i></entry>
 <entry colname="2">S</entry>
-<entry colname="3"></entry>
+<entry colname="3">&nbsp;</entry>
 </row>
 <row>
 <entry colname="1"><i><xref href="rtunproper43517.dita#rtunproper43517">derby.language.logStatementText</xref></i></entry>
 <entry colname="2">S, D</entry>
-<entry colname="3"></entry>
+<entry colname="3">&nbsp;</entry>
 </row>
 <row>
 <entry colname="1"><i><xref href="rtunproper10607.dita#rtunproper10607">derby.locks.deadlockTimeout</xref></i></entry>
@@ -159,9 +159,29 @@
 <entry colname="3">X</entry>
 </row>
 <row>
+<entry colname="1"><i><xref href="rtunproperlogbuffersize.dita#rtunproperlogbuffersize">derby.replication.logBufferSize</xref></i></entry>
+<entry colname="2">S</entry>
+<entry colname="3">&nbsp;</entry>
+</row>
+<row>
+<entry colname="1"><i><xref href="rtunpropermaxlogshippinginterval.dita#rtunpropermaxlogshippinginterval">derby.replication.maxLogShippingInterval</xref></i></entry>
+<entry colname="2">S</entry>
+<entry colname="3">&nbsp;</entry>
+</row>
+<row>
+<entry colname="1"><i><xref href="rtunproperminlogshippinginterval.dita#rtunproperminlogshippinginterval">derby.replication.minLogShippingInterval</xref></i></entry>
+<entry colname="2">S</entry>
+<entry colname="3">&nbsp;</entry>
+</row>
+<row>
+<entry colname="1"><i><xref href="rtunproperverbose.dita#rtunproperverbose">derby.replication.verbose</xref></i></entry>
+<entry colname="2">S</entry>
+<entry colname="3">&nbsp;</entry>
+</row>
+<row>
 <entry colname="1"><i><xref href="rtunproper27529.dita#rtunproper27529">derby.storage.initialPages</xref></i></entry>
 <entry colname="2">C</entry>
-<entry colname="3"></entry>
+<entry colname="3">&nbsp;</entry>
 </row>
 <row>
 <entry colname="1"><i><xref href="rtunstorminrecsize.dita#rtunstorminrecsize">derby.storage.minimumRecordSize</xref></i></entry>
@@ -171,7 +191,7 @@
 <row>
 <entry colname="1"><i><xref href="rtunproper81359.dita#rtunproper81359">derby.storage.pageCacheSize</xref></i></entry>
 <entry colname="2">S</entry>
-<entry colname="3"></entry>
+<entry colname="3">&nbsp;</entry>
 </row>
 <row>
 <entry colname="1"><i><xref href="rtunproper28026.dita#rtunproper28026">derby.storage.pageReservedSpace</xref></i></entry>
@@ -191,37 +211,37 @@
 <row>
 <entry colname="1"><i><xref href="rtunproper33027.dita#rtunproper33027">derby.stream.error.field</xref></i></entry>
 <entry colname="2">S</entry>
-<entry colname="3"></entry>
+<entry colname="3">&nbsp;</entry>
 </row>
 <row>
 <entry colname="1"><i><xref href="rtunproper18151.dita#rtunproper18151">derby.stream.error.file</xref></i></entry>
 <entry colname="2">S</entry>
-<entry colname="3"></entry>
+<entry colname="3">&nbsp;</entry>
 </row>
 <row>
 <entry colname="1"><i><xref href="rtunproper35028.dita#rtunproper35028">derby.stream.error.method</xref></i></entry>
 <entry colname="2">S</entry>
-<entry colname="3"></entry>
+<entry colname="3">&nbsp;</entry>
 </row>
 <row>
 <entry colname="1"><i><xref href="rtunproper26985.dita#rtunproper26985">derby.stream.error.logSeverityLevel</xref></i></entry>
 <entry colname="2">S</entry>
-<entry colname="3"></entry>
+<entry colname="3">&nbsp;</entry>
 </row>
 <row>
 <entry colname="1"><i><xref href="rtunproperbootall.dita#rtunproperbootall">derby.system.bootAll</xref></i></entry>
 <entry colname="2">S</entry>
-<entry colname="3"></entry>
+<entry colname="3">&nbsp;</entry>
 </row>
 <row>
 <entry colname="1"><i><xref href="rtunproperdurability.dita#rtunproperdurability">derby.system.durability</xref></i></entry>
 <entry colname="2">S</entry>
-<entry colname="3"></entry>
+<entry colname="3">&nbsp;</entry>
 </row>
 <row>
 <entry colname="1"><i><xref href="rtunproper32066.dita#rtunproper32066">derby.system.home</xref></i></entry>
 <entry colname="2">S</entry>
-<entry colname="3"></entry>
+<entry colname="3">&nbsp;</entry>
 </row>
 <row>
 <entry colname="1"><i><xref href="rtunproper27355.dita#rtunproper27355">derby.user.UserName</xref></i></entry>

Added: db/derby/docs/trunk/src/tuning/rtunproperlogbuffersize.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/tuning/rtunproperlogbuffersize.dita?rev=641923&view=auto
==============================================================================
--- db/derby/docs/trunk/src/tuning/rtunproperlogbuffersize.dita (added)
+++ db/derby/docs/trunk/src/tuning/rtunproperlogbuffersize.dita Thu Mar 27 10:41:12 2008
@@ -0,0 +1,57 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- 
+Licensed to the Apache Software Foundation (ASF) under one or more
+contributor license agreements.  See the NOTICE file distributed with
+this work for additional information regarding copyright ownership.
+The ASF licenses this file to You under the Apache License, Version 2.0
+(the "License"); you may not use this file except in compliance with
+the License.  You may obtain a copy of the License at      
+
+http://www.apache.org/licenses/LICENSE-2.0  
+
+Unless required by applicable law or agreed to in writing, software  
+distributed under the License is distributed on an "AS IS" BASIS,  
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  
+See the License for the specific language governing permissions and  
+limitations under the License.
+-->
+<!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN" "../dtd/reference.dtd">
+<reference xml:lang="en-us" id="rtunproperlogbuffersize">
+<title>derby.replication.logBufferSize</title>
+<prolog><metadata>
+<keywords><indexterm>derby.replication.logBufferSize</indexterm>
+<indexterm>replication<indexterm>specifying log buffer size</indexterm></indexterm>
+</keywords>
+</metadata>
+</prolog><refbody>
+<section><title>Function</title>
+<p>Specifies the size of the replication log buffers in bytes. These buffers
+store the log on the master side before it is shipped to the slave. There is a
+total of 10 such buffers. Large buffers increase memory usage but reduce
+the chance that the buffers fill up (in turn increasing response time for
+transactions on the master, as described in the failure situation "The master
+<ph conref="../conrefs.dita#prod/productshortname"></ph> instance is not able
+to send log data to the slave at the same pace as the log is generated" in the
+topic "Replication failure handling" in the
+<ph conref="../conrefs.dita#pub/citadmin"></ph>).</p>
+<p>The minimum value is 8192 (8 KB). The maximum value is 1048576 (1 MB).</p>
+<p>You can also use the properties
+<i><xref href="rtunproperminlogshippinginterval.dita#rtunproperminlogshippinginterval"></xref></i>
+and
+<i><xref href="rtunpropermaxlogshippinginterval.dita#rtunpropermaxlogshippinginterval"></xref></i>
+to tune the rate at which the log is shipped from the master to the slave.</p>
+</section>
+<section><title>Default</title>
+<p>32768 bytes (32KB).</p>
+</section>
+<example><title>Example</title>
+<codeblock><b>derby.replication.logBufferSize=65536</b></codeblock>
+</example>
+<section><title>Scope</title>
+<p><xref href="ctunproper51399.dita#ctunproper51399/rtunproper41229">system-wide</xref></p>
+</section>
+<section><title>Dynamic or static</title>
+<p>This property is static; if you change it while
+<ph conref="../conrefs.dita#prod/productshortname"></ph> is running, the change
+does not take effect until you reboot.</p>
+</section></refbody></reference>

Propchange: db/derby/docs/trunk/src/tuning/rtunproperlogbuffersize.dita
------------------------------------------------------------------------------
    svn:eol-style = native

Added: db/derby/docs/trunk/src/tuning/rtunpropermaxlogshippinginterval.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/tuning/rtunpropermaxlogshippinginterval.dita?rev=641923&view=auto
==============================================================================
--- db/derby/docs/trunk/src/tuning/rtunpropermaxlogshippinginterval.dita (added)
+++ db/derby/docs/trunk/src/tuning/rtunpropermaxlogshippinginterval.dita Thu Mar 27 10:41:12 2008
@@ -0,0 +1,54 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- 
+Licensed to the Apache Software Foundation (ASF) under one or more
+contributor license agreements.  See the NOTICE file distributed with
+this work for additional information regarding copyright ownership.
+The ASF licenses this file to You under the Apache License, Version 2.0
+(the "License"); you may not use this file except in compliance with
+the License.  You may obtain a copy of the License at      
+
+http://www.apache.org/licenses/LICENSE-2.0  
+
+Unless required by applicable law or agreed to in writing, software  
+distributed under the License is distributed on an "AS IS" BASIS,  
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  
+See the License for the specific language governing permissions and  
+limitations under the License.
+-->
+<!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN" "../dtd/reference.dtd">
+<reference xml:lang="en-us" id="rtunpropermaxlogshippinginterval">
+<title>derby.replication.maxLogShippingInterval</title>
+<prolog><metadata>
+<keywords><indexterm>derby.replication.maxLogShippingInterval</indexterm>
+<indexterm>replication<indexterm>specifying maximum log shipping interval</indexterm></indexterm>
+</keywords>
+</metadata>
+</prolog><refbody>
+<section><title>Function</title>
+<p>Specifies, in milliseconds, the longest interval between two consecutive
+shipments of the transaction log from the master to the slave. This property
+provides a "soft" guarantee that the slave will not deviate more than this
+number of milliseconds from the master.</p>
+<p>The value specified for the <i>derby.replication.maxLogShippingInterval</i>
+property must be at least ten times the value specified for the
+<i><xref href="rtunproperminlogshippinginterval.dita#rtunproperminlogshippinginterval"></xref></i>
+property. If you set <i>derby.replication.maxLogShippingInterval</i> to a lower
+value, <ph conref="../conrefs.dita#prod/productshortname"></ph> changes the
+<i><xref href="rtunproperminlogshippinginterval.dita#rtunproperminlogshippinginterval"></xref></i>
+property value to the value of the
+<i>derby.replication.maxLogShippingInterval</i> property divided by 10.</p>
+</section>
+<section><title>Default</title>
+<p>5000 milliseconds (5 seconds).</p>
+</section>
+<example><title>Example</title>
+<codeblock><b>derby.replication.maxLogShippingInterval=10000</b></codeblock>
+</example>
+<section><title>Scope</title>
+<p><xref href="ctunproper51399.dita#ctunproper51399/rtunproper41229">system-wide</xref></p>
+</section>
+<section><title>Dynamic or static</title>
+<p>This property is static; if you change it while
+<ph conref="../conrefs.dita#prod/productshortname"></ph> is running, the change
+does not take effect until you reboot.</p>
+</section></refbody></reference>

Propchange: db/derby/docs/trunk/src/tuning/rtunpropermaxlogshippinginterval.dita
------------------------------------------------------------------------------
    svn:eol-style = native

Added: db/derby/docs/trunk/src/tuning/rtunproperminlogshippinginterval.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/tuning/rtunproperminlogshippinginterval.dita?rev=641923&view=auto
==============================================================================
--- db/derby/docs/trunk/src/tuning/rtunproperminlogshippinginterval.dita (added)
+++ db/derby/docs/trunk/src/tuning/rtunproperminlogshippinginterval.dita Thu Mar 27 10:41:12 2008
@@ -0,0 +1,53 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- 
+Licensed to the Apache Software Foundation (ASF) under one or more
+contributor license agreements.  See the NOTICE file distributed with
+this work for additional information regarding copyright ownership.
+The ASF licenses this file to You under the Apache License, Version 2.0
+(the "License"); you may not use this file except in compliance with
+the License.  You may obtain a copy of the License at      
+
+http://www.apache.org/licenses/LICENSE-2.0  
+
+Unless required by applicable law or agreed to in writing, software  
+distributed under the License is distributed on an "AS IS" BASIS,  
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  
+See the License for the specific language governing permissions and  
+limitations under the License.
+-->
+<!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN" "../dtd/reference.dtd">
+<reference xml:lang="en-us" id="rtunproperminlogshippinginterval">
+<title>derby.replication.minLogShippingInterval</title>
+<prolog><metadata>
+<keywords><indexterm>derby.replication.minLogShippingInterval</indexterm>
+<indexterm>replication<indexterm>specifying minimum log shipping interval</indexterm></indexterm>
+</keywords>
+</metadata>
+</prolog><refbody>
+<section><title>Function</title>
+<p>Specifies, in milliseconds, the shortest interval between two consecutive
+shipments of the transaction log from the master to the slave.</p>
+<p>The value specified for the <i>derby.replication.minLogShippingInterval</i>
+property must be no more than one-tenth the value specified for the
+<i><xref href="rtunpropermaxlogshippinginterval.dita#rtunpropermaxlogshippinginterval"></xref></i>
+property. If you set <i>derby.replication.minLogShippingInterval</i> to a 
+higher value, <ph conref="../conrefs.dita#prod/productshortname"></ph> changes
+the <i>derby.replication.minLogShippingInterval</i> property value to the value
+of the
+<i><xref href="rtunpropermaxlogshippinginterval.dita#rtunpropermaxlogshippinginterval"></xref></i>
+property divided by 10.</p>
+</section>
+<section><title>Default</title>
+<p>100 milliseconds.</p>
+</section>
+<example><title>Example</title>
+<codeblock><b>derby.replication.minLogShippingInterval=500</b></codeblock>
+</example>
+<section><title>Scope</title>
+<p><xref href="ctunproper51399.dita#ctunproper51399/rtunproper41229">system-wide</xref></p>
+</section>
+<section><title>Dynamic or static</title>
+<p>This property is static; if you change it while
+<ph conref="../conrefs.dita#prod/productshortname"></ph> is running, the change
+does not take effect until you reboot.</p>
+</section></refbody></reference>

Propchange: db/derby/docs/trunk/src/tuning/rtunproperminlogshippinginterval.dita
------------------------------------------------------------------------------
    svn:eol-style = native

Added: db/derby/docs/trunk/src/tuning/rtunproperverbose.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/tuning/rtunproperverbose.dita?rev=641923&view=auto
==============================================================================
--- db/derby/docs/trunk/src/tuning/rtunproperverbose.dita (added)
+++ db/derby/docs/trunk/src/tuning/rtunproperverbose.dita Thu Mar 27 10:41:12 2008
@@ -0,0 +1,44 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- 
+Licensed to the Apache Software Foundation (ASF) under one or more
+contributor license agreements.  See the NOTICE file distributed with
+this work for additional information regarding copyright ownership.
+The ASF licenses this file to You under the Apache License, Version 2.0
+(the "License"); you may not use this file except in compliance with
+the License.  You may obtain a copy of the License at      
+
+http://www.apache.org/licenses/LICENSE-2.0  
+
+Unless required by applicable law or agreed to in writing, software  
+distributed under the License is distributed on an "AS IS" BASIS,  
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  
+See the License for the specific language governing permissions and  
+limitations under the License.
+-->
+<!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN" "../dtd/reference.dtd">
+<reference xml:lang="en-us" id="rtunproperverbose">
+<title>derby.replication.verbose</title>
+<prolog><metadata>
+<keywords><indexterm>derby.replication.verbose</indexterm>
+<indexterm>replication<indexterm>specifying message logging</indexterm></indexterm>
+</keywords>
+</metadata>
+</prolog><refbody>
+<section><title>Function</title>
+<p>Specifies whether replication messages are written to the 
+<ph conref="../conrefs.dita#prod/productshortname"></ph> log.</p>
+</section>
+<section><title>Default</title>
+<p>True.</p>
+</section>
+<example><title>Example</title>
+<codeblock><b>derby.replication.verbose=false</b></codeblock>
+</example>
+<section><title>Scope</title>
+<p><xref href="ctunproper51399.dita#ctunproper51399/rtunproper41229">system-wide</xref></p>
+</section>
+<section><title>Dynamic or static</title>
+<p>This property is static; if you change it while
+<ph conref="../conrefs.dita#prod/productshortname"></ph> is running, the change
+does not take effect until you reboot.</p>
+</section></refbody></reference>

Propchange: db/derby/docs/trunk/src/tuning/rtunproperverbose.dita
------------------------------------------------------------------------------
    svn:eol-style = native

Modified: db/derby/docs/trunk/src/tuning/tuningderby.ditamap
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/tuning/tuningderby.ditamap?rev=641923&r1=641922&r2=641923&view=diff
==============================================================================
--- db/derby/docs/trunk/src/tuning/tuningderby.ditamap (original)
+++ db/derby/docs/trunk/src/tuning/tuningderby.ditamap Thu Mar 27 10:41:12 2008
@@ -288,6 +288,10 @@
 <topicref href="rtunproper98166.dita" navtitle="derby.locks.monitor"></topicref>
 <topicref href="rtunproper46141.dita" navtitle="derby.locks.waitTimeout">
 </topicref>
+<topicref href="rtunproperlogbuffersize.dita" navtitle="derby.replication.logBufferSize"></topicref>
+<topicref href="rtunpropermaxlogshippinginterval.dita" navtitle="derby.replication.maxLogShippingInterval"></topicref>
+<topicref href="rtunproperminlogshippinginterval.dita" navtitle="derby.replication.minLogShippingInterval"></topicref>
+<topicref href="rtunproperverbose.dita" navtitle="derby.replication.verbose"></topicref>
 <topicref href="rtunproper27529.dita" navtitle="derby.storage.initialPages">
 </topicref>
 <topicref href="rtunstorminrecsize.dita" navtitle="derby.storage.minimumRecordSize">



Mime
View raw message