db-derby-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From chaa...@apache.org
Subject svn commit: r713812 - /db/derby/docs/trunk/src/tuning/
Date Thu, 13 Nov 2008 20:25:15 GMT
Author: chaase3
Date: Thu Nov 13 12:25:14 2008
New Revision: 713812

URL: http://svn.apache.org/viewvc?rev=713812&view=rev
Log:
DERBY-2389: Move Derby system and properties info from Tuning Guide into Reference Manual

This patch removes the system properties reference topics from Tuning Derby and fixes references
to the topics within Tuning Derby.

Patch: DERBY-2389-tuning.diff

Removed:
    db/derby/docs/trunk/src/tuning/ctunproper22250.dita
    db/derby/docs/trunk/src/tuning/ctunproper51399.dita
    db/derby/docs/trunk/src/tuning/rtunproper10607.dita
    db/derby/docs/trunk/src/tuning/rtunproper13217.dita
    db/derby/docs/trunk/src/tuning/rtunproper13766.dita
    db/derby/docs/trunk/src/tuning/rtunproper18151.dita
    db/derby/docs/trunk/src/tuning/rtunproper23835.dita
    db/derby/docs/trunk/src/tuning/rtunproper24390.dita
    db/derby/docs/trunk/src/tuning/rtunproper24846.dita
    db/derby/docs/trunk/src/tuning/rtunproper25025.dita
    db/derby/docs/trunk/src/tuning/rtunproper25581.dita
    db/derby/docs/trunk/src/tuning/rtunproper26978.dita
    db/derby/docs/trunk/src/tuning/rtunproper26985.dita
    db/derby/docs/trunk/src/tuning/rtunproper27355.dita
    db/derby/docs/trunk/src/tuning/rtunproper27467.dita
    db/derby/docs/trunk/src/tuning/rtunproper27529.dita
    db/derby/docs/trunk/src/tuning/rtunproper28026.dita
    db/derby/docs/trunk/src/tuning/rtunproper32066.dita
    db/derby/docs/trunk/src/tuning/rtunproper32213.dita
    db/derby/docs/trunk/src/tuning/rtunproper33027.dita
    db/derby/docs/trunk/src/tuning/rtunproper34037.dita
    db/derby/docs/trunk/src/tuning/rtunproper35028.dita
    db/derby/docs/trunk/src/tuning/rtunproper37341.dita
    db/derby/docs/trunk/src/tuning/rtunproper39325.dita
    db/derby/docs/trunk/src/tuning/rtunproper40346.dita
    db/derby/docs/trunk/src/tuning/rtunproper40688.dita
    db/derby/docs/trunk/src/tuning/rtunproper43414.dita
    db/derby/docs/trunk/src/tuning/rtunproper43517.dita
    db/derby/docs/trunk/src/tuning/rtunproper46141.dita
    db/derby/docs/trunk/src/tuning/rtunproper81359.dita
    db/derby/docs/trunk/src/tuning/rtunproper81405.dita
    db/derby/docs/trunk/src/tuning/rtunproper98166.dita
    db/derby/docs/trunk/src/tuning/rtunproperbootall.dita
    db/derby/docs/trunk/src/tuning/rtunpropercachedn.dita
    db/derby/docs/trunk/src/tuning/rtunproperdurability.dita
    db/derby/docs/trunk/src/tuning/rtunproperlogbuffersize.dita
    db/derby/docs/trunk/src/tuning/rtunpropermaxlogshippinginterval.dita
    db/derby/docs/trunk/src/tuning/rtunproperminlogshippinginterval.dita
    db/derby/docs/trunk/src/tuning/rtunpropernoautoboot.dita
    db/derby/docs/trunk/src/tuning/rtunproperrowlocking.dita
    db/derby/docs/trunk/src/tuning/rtunpropersqlauth.dita
    db/derby/docs/trunk/src/tuning/rtunproperverbose.dita
    db/derby/docs/trunk/src/tuning/rtunproperxatrantimeout.dita
    db/derby/docs/trunk/src/tuning/rtunsearchauthdn.dita
    db/derby/docs/trunk/src/tuning/rtunsearchauthpw.dita
    db/derby/docs/trunk/src/tuning/rtunstorminrecsize.dita
Modified:
    db/derby/docs/trunk/src/tuning/ctunoptimz26019.dita
    db/derby/docs/trunk/src/tuning/ctunperf54492.dita
    db/derby/docs/trunk/src/tuning/ctunperf816059.dita
    db/derby/docs/trunk/src/tuning/ctunsetprop34818.dita
    db/derby/docs/trunk/src/tuning/ctunsetprop44147.dita
    db/derby/docs/trunk/src/tuning/ctunsetprop824533.dita
    db/derby/docs/trunk/src/tuning/ttundepth33391.dita
    db/derby/docs/trunk/src/tuning/tuningderby.ditamap

Modified: db/derby/docs/trunk/src/tuning/ctunoptimz26019.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/tuning/ctunoptimz26019.dita?rev=713812&r1=713811&r2=713812&view=diff
==============================================================================
--- db/derby/docs/trunk/src/tuning/ctunoptimz26019.dita (original)
+++ db/derby/docs/trunk/src/tuning/ctunoptimz26019.dita Thu Nov 13 12:25:14 2008
@@ -26,11 +26,13 @@
 </metadata>
 </prolog>
 <conbody>
-<p>The system property <i><xref href="rtunproper40346.dita#rtunproper40346"/></i>
determines
+<p>The system property <i>derby.locks.escalationThreshold</i> determines
 the threshold for number of rows touched for a particular table above which
 the system will escalate to table-level locking. The default value of this
 property is 5000. For large systems, set this property to a higher value.
-For smaller systems, lower it.</p>
+For smaller systems, lower it. See the
+"<ph conref="../conrefs.dita#prod/productshortname"></ph> properties" section
of
+the <ph conref="../conrefs.dita#pub/citref"></ph> for details on this property.</p>
 <p>This property also sets the threshold for transaction-based lock escalation
 (see <xref href="ctunoptimz42065.dita#ctunoptimz42065"/>).  
 <note>For more

Modified: db/derby/docs/trunk/src/tuning/ctunperf54492.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/tuning/ctunperf54492.dita?rev=713812&r1=713811&r2=713812&view=diff
==============================================================================
--- db/derby/docs/trunk/src/tuning/ctunperf54492.dita (original)
+++ db/derby/docs/trunk/src/tuning/ctunperf54492.dita Thu Nov 13 12:25:14 2008
@@ -33,12 +33,14 @@
 quickly.</p>
 <p>The default size of the data page cache is 1000 pages. In a multi-user
 environment, or in an environment where the user accesses a lot of data, increase
-the size of the cache. You configure its size with the <xref href="rtunproper81359.dita#rtunproper81359">derby.storage.pageCacheSize</xref>
property. For more information about
-how to set this property and how to estimate memory use, see <i><xref href="rtunproper81359.dita#rtunproper81359">derby.storage.pageCacheSize</xref>.</i>
 
+the size of the cache. You configure its size with the <i>derby.storage.pageCacheSize</i>
property. For more information about
+how to set this property and how to estimate memory use, see the
+"<ph conref="../conrefs.dita#prod/productshortname"></ph> properties" section
of
+the <ph conref="../conrefs.dita#pub/citref"></ph>.</p> 
 <note><ph conref="../conrefs.dita#prod/productshortname"></ph> can
 run even with a small amount of memory and even with a small data page cache,
 although it might perform poorly. Increasing the amount of memory available
-to <ph conref="../conrefs.dita#prod/productshortname"></ph> and increasing the
size of the data page cache improve performance.</note></p>
+to <ph conref="../conrefs.dita#prod/productshortname"></ph> and increasing the
size of the data page cache improve performance.</note>
 <p>In addition, you might want to prime <i>all</i> the caches
 in the background to make queries run faster when the user gets around to
 running them.</p>

Modified: db/derby/docs/trunk/src/tuning/ctunperf816059.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/tuning/ctunperf816059.dita?rev=713812&r1=713811&r2=713812&view=diff
==============================================================================
--- db/derby/docs/trunk/src/tuning/ctunperf816059.dita (original)
+++ db/derby/docs/trunk/src/tuning/ctunperf816059.dita Thu Nov 13 12:25:14 2008
@@ -29,7 +29,9 @@
 I/O time. <ph conref="../conrefs.dita#prod/productshortname"></ph> automatically
 tunes for the database page size. If you have long columns, the default page
 size for the table is set to 32768 bytes. Otherwise, the default is 4096 bytes.
-You can change the default database page size with the <i><xref href="rtunproper40688.dita#rtunproper40688">derby.storage.pageSize</xref></i>
property.
+You can change the default database page size with the <i>derby.storage.pageSize</i>
property,
+described in the "<ph conref="../conrefs.dita#prod/productshortname"></ph>
+properties" section of the <ph conref="../conrefs.dita#pub/citref"></ph>.
 For example:   <codeblock><b>derby.storage.pageSize=8192</b></codeblock></p>
 <note>Large database pages require more memory.</note>
 <p>If row size is large, generally page size should be correspondingly large.

Modified: db/derby/docs/trunk/src/tuning/ctunsetprop34818.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/tuning/ctunsetprop34818.dita?rev=713812&r1=713811&r2=713812&view=diff
==============================================================================
--- db/derby/docs/trunk/src/tuning/ctunsetprop34818.dita (original)
+++ db/derby/docs/trunk/src/tuning/ctunsetprop34818.dita Thu Nov 13 12:25:14 2008
@@ -17,8 +17,13 @@
 -->
 <!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN" "../dtd/concept.dtd">
 <concept xml:lang="en-us" id="ctunsetprop34818">
-<title>Working with Derby properties</title>
+<title>Working with <ph conref="../conrefs.dita#prod/productshortname"></ph>
properties</title>
 <prolog>
 </prolog>
 <conbody>
+<p>This section describes how to use
+<ph conref="../conrefs.dita#prod/productshortname"></ph> properties. For
+details on specific properties, see the
+"<ph conref="../conrefs.dita#prod/productshortname"></ph> properties" section
of
+the <ph conref="../conrefs.dita#pub/citref"></ph>.</p>
 </conbody></concept>

Modified: db/derby/docs/trunk/src/tuning/ctunsetprop44147.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/tuning/ctunsetprop44147.dita?rev=713812&r1=713811&r2=713812&view=diff
==============================================================================
--- db/derby/docs/trunk/src/tuning/ctunsetprop44147.dita (original)
+++ db/derby/docs/trunk/src/tuning/ctunsetprop44147.dita Thu Nov 13 12:25:14 2008
@@ -30,6 +30,7 @@
 <li>As system-wide properties via a <i>Properties</i> object
 in the application in which the <ph conref="../conrefs.dita#prod/productshortname"></ph>
engine is embedded</li>
 </ul></p>
-<p>See <xref href="rtunproper32213.dita#rtunproper32213"/>, for information about
specific
-properties.</p>
+<p>See the "<ph conref="../conrefs.dita#prod/productshortname"></ph> properties"
+section of the <ph conref="../conrefs.dita#pub/citref"></ph> for information
+about specific properties.</p>
 </conbody></concept>

Modified: db/derby/docs/trunk/src/tuning/ctunsetprop824533.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/tuning/ctunsetprop824533.dita?rev=713812&r1=713811&r2=713812&view=diff
==============================================================================
--- db/derby/docs/trunk/src/tuning/ctunsetprop824533.dita (original)
+++ db/derby/docs/trunk/src/tuning/ctunsetprop824533.dita Thu Nov 13 12:25:14 2008
@@ -28,10 +28,13 @@
 </prolog>
 <conbody>
 <p>There is one important exception to the search order for properties described
-above: When you set the <i><xref href="rtunproper24390.dita#rtunproper24390">derby.database.propertiesOnly</xref></i>
property
+above: When you set the <i>derby.database.propertiesOnly</i> property
 to <i>true</i>, database-wide properties cannot be overridden
 by system-wide properties.</p>
 <p>This property ensures that a database's environment cannot be modified
 by the environment in which it is booted. Any application running in an embedded
 environment can set this property to <codeph>true</codeph> for security reasons.</p>
+<p>See the "<ph conref="../conrefs.dita#prod/productshortname"></ph> properties"
+section of the <ph conref="../conrefs.dita#pub/citref"></ph> for details on the
+<i>derby.database.propertiesOnly</i> property.</p>
 </conbody></concept>

Modified: db/derby/docs/trunk/src/tuning/ttundepth33391.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/tuning/ttundepth33391.dita?rev=713812&r1=713811&r2=713812&view=diff
==============================================================================
--- db/derby/docs/trunk/src/tuning/ttundepth33391.dita (original)
+++ db/derby/docs/trunk/src/tuning/ttundepth33391.dita Thu Nov 13 12:25:14 2008
@@ -50,10 +50,12 @@
 <step><cmd>Use RunTimeStatistics to identify tables that are scanned excessively.
 Check that the appropriate indexes are being used to satisfy the query and
 that <ph conref="../conrefs.dita#prod/productshortname"></ph> is choosing
-the best join order.  You can also set derby.language.logQueryPlan to true
+the best join order.  You can also set <i>derby.language.logQueryPlan</i> to
true
 to check whether indexes are being used or not. This property will  is print
-query plans in the derby.log file. See <xref href="rtunproper43414.dita#rtunproper43414"></xref>,
-as well as <xref href="ctundepth13055.dita#ctundepth13055"></xref> for more
+query plans in the <i>derby.log</i> file. See the
+"<ph conref="../conrefs.dita#prod/productshortname"></ph> properties" section
of
+the <ph conref="../conrefs.dita#pub/citref"></ph> for details on this property.
+See <xref href="ctundepth13055.dita#ctundepth13055"></xref> for more
 information.</cmd></step>
 <step><cmd>Make any necessary changes and then repeat.</cmd></step>
 <step><cmd>If changing data access does not create significant improvements,

Modified: db/derby/docs/trunk/src/tuning/tuningderby.ditamap
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/tuning/tuningderby.ditamap?rev=713812&r1=713811&r2=713812&view=diff
==============================================================================
--- db/derby/docs/trunk/src/tuning/tuningderby.ditamap (original)
+++ db/derby/docs/trunk/src/tuning/tuningderby.ditamap Thu Nov 13 12:25:14 2008
@@ -241,87 +241,6 @@
 </topicref>
 </topicref>
 </topicref>
-<topicref collection-type="family" href="rtunproper32213.dita" navtitle="Derby properties">
-<topicref href="ctunproper51399.dita" navtitle="Scope of Derby properties">
-</topicref>
-<topicref collection-type="family" href="ctunproper22250.dita" navtitle="Derby properties">
-<topicref href="rtunsearchauthdn.dita" navtitle="derby.authentication.ldap.searchAuthDN">
-</topicref>
-<topicref href="rtunsearchauthpw.dita" navtitle="derby.authentication.ldap.searchAuthPW">
-</topicref>
-<topicref href="rtunproper26978.dita" navtitle="derby.authentication.ldap.searchBase">
-</topicref>
-<topicref href="rtunproper37341.dita" navtitle="derby.authentication.ldap.searchFilter">
-</topicref>
-<topicref href="rtunproper13766.dita" navtitle="derby.authentication.provider">
-</topicref>
-<topicref href="rtunproper25581.dita" navtitle="derby.authentication.server">
-</topicref>
-<topicref href="rtunproper27467.dita" navtitle="derby.connection.requireAuthentication">
-</topicref>
-<topicref href="rtunproper24846.dita" navtitle="derby.database.defaultConnectionMode">
-</topicref>
-<topicref href="rtunproper81405.dita" navtitle="derby.database.forceDatabaseLock">
-</topicref>
-<topicref href="rtunproper25025.dita" navtitle="derby.database.fullAccessUsers">
-</topicref>
-<topicref href="rtunpropernoautoboot.dita" navtitle="derby.database.noAutoBoot">
-</topicref>
-<topicref href="rtunproper24390.dita" navtitle="derby.database.propertiesOnly">
-</topicref>
-<topicref href="rtunproper39325.dita" navtitle="derby.database.readOnlyAccessUsers">
-</topicref>
-<topicref href="rtunpropersqlauth.dita" navtitle="derby.database.sqlAuthorization">
-</topicref>
-<topicref href="rtunproper13217.dita" navtitle="derby.infolog.append"></topicref>
-<topicref href="rtunproperxatrantimeout.dita" navtitle="derby.jdbc.xaTransactionTimeout"></topicref>
-<topicref href="rtunproper43414.dita" navtitle="derby.language.logQueryPlan">
-</topicref>
-<topicref href="rtunproper43517.dita" navtitle="derby.language.logStatementText">
-</topicref>
-<topicref href="rtunproper10607.dita" navtitle="derby.locks.deadlockTimeout">
-</topicref>
-<topicref href="rtunproper23835.dita" navtitle="derby.locks.deadlockTrace">
-</topicref>
-<topicref href="rtunproper40346.dita" navtitle="derby.locks.escalationThreshold">
-</topicref>
-<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">
-</topicref>
-<topicref href="rtunproper81359.dita" navtitle="derby.storage.pageCacheSize">
-</topicref>
-<topicref href="rtunproper28026.dita" navtitle="derby.storage.pageReservedSpace">
-</topicref>
-<topicref href="rtunproper40688.dita" navtitle="derby.storage.pageSize"></topicref>
-<topicref href="rtunproperrowlocking.dita" navtitle="derby.storage.rowLocking"></topicref>
-<topicref href="rtunproper34037.dita" navtitle="derby.storage.tempDirectory">
-</topicref>
-<topicref href="rtunproper33027.dita" navtitle="derby.stream.error.field">
-</topicref>
-<topicref href="rtunproper18151.dita" navtitle="derby.stream.error.file">
-</topicref>
-<topicref href="rtunproper35028.dita" navtitle="derby.stream.error.method">
-</topicref>
-<topicref href="rtunproper26985.dita" navtitle="derby.stream.error.logSeverityLevel">
-</topicref>
-<topicref href="rtunproperbootall.dita" navtitle="derby.system.bootAll">
-</topicref>
-<topicref href="rtunproperdurability.dita" navtitle="derby.system.durability">
-</topicref>
-<topicref href="rtunproper32066.dita" navtitle="derby.system.home"></topicref>
-<topicref href="rtunproper27355.dita" navtitle="derby.user.UserName">
-<topicref href="rtunpropercachedn.dita" navtitle="Caching user DNs"></topicref>
-</topicref>
-</topicref>
-</topicref>
 <topicref collection-type="family" href="ctuntransform13966.dita" navtitle="Internal language
transformations">
 <topicref collection-type="family" href="ctuntransform35783.dita" navtitle="Predicate
transformations">
 <topicref href="rtuntransform139.dita" navtitle="BETWEEN transformations">



Mime
View raw message