db-derby-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Myrna van Lunteren (JIRA)" <j...@apache.org>
Subject [jira] Commented: (DERBY-2182) Documentation for derby.system.bootAll is missing
Date Mon, 10 Dec 2007 21:01:53 GMT

    [ https://issues.apache.org/jira/browse/DERBY-2182?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#action_12550185
] 

Myrna van Lunteren commented on DERBY-2182:
-------------------------------------------

I guess we can start with these comments from org.apache.derby.iapi.reference.Property.java,
maybe that's enough for a start to document this, combined with Dag's findings in the comment
above:
"only databases specified in: 

    derby.service.<dbdir>=serviceDirectory 

settings are actually ever autobooted (more than one setting works). "

	
	/**
		derby.system.bootAll
		<BR>
		Automatically boot any services at start up time. When set to true
		this services will  be booted at startup, otherwise services
		will be booted on demand.
	*/
	String BOOT_ALL = "derby.system.bootAll";

	/**
		derby.database.noAutoBoot
		<BR>
		Don't automatically boot this service at start up time. When set to true
		this service will only be booted on demand, otherwise the service
		will be booted at startup time if possible.
	*/
	String NO_AUTO_BOOT = "derby.database.noAutoBoot";
    
Further, there is the test org.apache.derbyTesting.functionTests.tests.store.BootAllTest.java
which describes some of the tests, and thus the behavior...
And test org.apache.derbyTesting.functionTests.tests.store.databaseProperties.sql with it's
expected output in ...functionTests.master.databaseProperties.out to show some behavior.

I haven't looked at derby.service.*; judging from the source, that's not a property in itself,
but the starting string for a number of properties used by the Monitors...Frankly, I'd suggest
not documenting those, but referring users to the actual source code...


> Documentation for derby.system.bootAll is missing
> -------------------------------------------------
>
>                 Key: DERBY-2182
>                 URL: https://issues.apache.org/jira/browse/DERBY-2182
>             Project: Derby
>          Issue Type: Bug
>          Components: Documentation
>            Reporter: Dag H. Wanvik
>            Assignee: Kim Haase
>            Priority: Minor
>         Attachments: DERBY-2182.diff, DERBY-2182.stat, DERBY-2182.zip
>
>
> This property is not documented in the Tuning Derby guide, but it is referred to 
> in the developer's guide in a couple of places with dangling pointers to the Tuning Guide:
> http://db.apache.org/derby/docs/dev/devguide/cdevdvlp27715.html
> http://db.apache.org/derby/docs/dev/devguide/cdevcsecure60146.html
> http://db.apache.org/derby/docs/dev/devguide/cdevadvjdbc41138.html
> Googling, I find it documented in older Cloudscape docs e.g. in
> http://www.novell.com/documentation/extendas37/docs/help/java/jdkee/cloudscape/doc/html/coredocs/proper42.htm#1014327,
> but not in Cloudscape 10 docs, e.g. http://publib.boulder.ibm.com/infocenter/cldscp10/topic/com.ibm.cloudscape.doc/perf63.htm
> which could indicate it was removed for some reason. So, either we
> should document it anew or remove the references to it. If we decide to keep it, we should
also consider
> derby.database.noAutoBoot (not currently documented).

-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.


Mime
View raw message