You are viewing a plain text version of this content. The canonical link for it is here.
Posted to derby-dev@db.apache.org by "Kim Haase (JIRA)" <ji...@apache.org> on 2007/10/31 20:49:50 UTC
[jira] Created: (DERBY-3168) Reference Manual lacks topics on
trace-related connection URL attributes
Reference Manual lacks topics on trace-related connection URL attributes
------------------------------------------------------------------------
Key: DERBY-3168
URL: https://issues.apache.org/jira/browse/DERBY-3168
Project: Derby
Issue Type: Bug
Components: Documentation
Affects Versions: 10.3.1.4
Reporter: Kim Haase
Assignee: Kim Haase
The Admin Guide topic "Network client tracing" describes three connection URL attributes that enable network client tracing:
http://db.apache.org/derby/docs/dev/adminguide/cadminappsclienttracing.html
The URL attributes are traceFile, traceDirectory, and traceLevel.
These three attributes are missing from the Reference Manual section where all the connection URL attributes are listed and described:
http://db.apache.org/derby/docs/dev/ref/rrefattrib24612.html
Like the securityMechanism and ssl attributes, these attributes appear to apply only to the client/server mode of Derby, not to the embedded mode.
I'll add topics to the Reference Manual for each of these attributes, unless there is some reason not to.
--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.
[jira] Resolved: (DERBY-3168) Reference Manual lacks topics on
trace-related connection URL attributes
Posted by "Kim Haase (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/DERBY-3168?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Kim Haase resolved DERBY-3168.
------------------------------
Resolution: Fixed
Fix Version/s: 10.4.0.0
Thanks very much, Dyre.
> Reference Manual lacks topics on trace-related connection URL attributes
> ------------------------------------------------------------------------
>
> Key: DERBY-3168
> URL: https://issues.apache.org/jira/browse/DERBY-3168
> Project: Derby
> Issue Type: Bug
> Components: Documentation
> Affects Versions: 10.3.1.4
> Reporter: Kim Haase
> Assignee: Kim Haase
> Fix For: 10.4.0.0
>
> Attachments: DERBY-3168-2.diff, DERBY-3168-2.zip, DERBY-3168-3.diff, DERBY-3168-3.zip, DERBY-3168.diff, DERBY-3168.zip
>
>
> The Admin Guide topic "Network client tracing" describes three connection URL attributes that enable network client tracing:
> http://db.apache.org/derby/docs/dev/adminguide/cadminappsclienttracing.html
> The URL attributes are traceFile, traceDirectory, and traceLevel.
> These three attributes are missing from the Reference Manual section where all the connection URL attributes are listed and described:
> http://db.apache.org/derby/docs/dev/ref/rrefattrib24612.html
> Like the securityMechanism and ssl attributes, these attributes appear to apply only to the client/server mode of Derby, not to the embedded mode.
> I'll add topics to the Reference Manual for each of these attributes, unless there is some reason not to.
--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.
[jira] Commented: (DERBY-3168) Reference Manual lacks topics on
trace-related connection URL attributes
Posted by "Dag H. Wanvik (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/DERBY-3168?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#action_12546081 ]
Dag H. Wanvik commented on DERBY-3168:
--------------------------------------
The new topic om traceFileAppend looks good to me.
The one traceDirectory=path didn't have a hyperlink; intended?
Removing questions on db ownership; correct.
+1
> Reference Manual lacks topics on trace-related connection URL attributes
> ------------------------------------------------------------------------
>
> Key: DERBY-3168
> URL: https://issues.apache.org/jira/browse/DERBY-3168
> Project: Derby
> Issue Type: Bug
> Components: Documentation
> Affects Versions: 10.3.1.4
> Reporter: Kim Haase
> Assignee: Kim Haase
> Attachments: DERBY-3168-2.diff, DERBY-3168-2.zip, DERBY-3168.diff, DERBY-3168.zip
>
>
> The Admin Guide topic "Network client tracing" describes three connection URL attributes that enable network client tracing:
> http://db.apache.org/derby/docs/dev/adminguide/cadminappsclienttracing.html
> The URL attributes are traceFile, traceDirectory, and traceLevel.
> These three attributes are missing from the Reference Manual section where all the connection URL attributes are listed and described:
> http://db.apache.org/derby/docs/dev/ref/rrefattrib24612.html
> Like the securityMechanism and ssl attributes, these attributes appear to apply only to the client/server mode of Derby, not to the embedded mode.
> I'll add topics to the Reference Manual for each of these attributes, unless there is some reason not to.
--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.
[jira] Updated: (DERBY-3168) Reference Manual lacks topics on
trace-related connection URL attributes
Posted by "Kim Haase (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/DERBY-3168?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Kim Haase updated DERBY-3168:
-----------------------------
Attachment: DERBY-3168-2.zip
DERBY-3168-2.diff
Attaching DERBY-3168-2.diff and DERBY-3168-2.zip, containing a new file for the traceFileAppend attribute and revised versions of the other three new topics and the map file. I did include an example of using traceDirectory and traceFile together.
The information about traceFileAppend is based on what I could deduce from trying it out; hope it's correct.
I removed the question about database ownership restrictions, deducing that these attributes are similar to attributes like rollForwardRecoveryFrom=path and logDevice=logDirectoryPath, which have no such restrictions. Hope that's correct.
The svn stat output is as follows:
A src/ref/rrefattribtracedirectory.dita
A src/ref/rrefattribtracelevel.dita
A src/ref/rrefattribtracefile.dita
A src/ref/rrefattribtracefileappend.dita
M src/ref/refderby.ditamap
Thanks in advance for any feedback.
> Reference Manual lacks topics on trace-related connection URL attributes
> ------------------------------------------------------------------------
>
> Key: DERBY-3168
> URL: https://issues.apache.org/jira/browse/DERBY-3168
> Project: Derby
> Issue Type: Bug
> Components: Documentation
> Affects Versions: 10.3.1.4
> Reporter: Kim Haase
> Assignee: Kim Haase
> Attachments: DERBY-3168-2.diff, DERBY-3168-2.zip, DERBY-3168.diff, DERBY-3168.zip
>
>
> The Admin Guide topic "Network client tracing" describes three connection URL attributes that enable network client tracing:
> http://db.apache.org/derby/docs/dev/adminguide/cadminappsclienttracing.html
> The URL attributes are traceFile, traceDirectory, and traceLevel.
> These three attributes are missing from the Reference Manual section where all the connection URL attributes are listed and described:
> http://db.apache.org/derby/docs/dev/ref/rrefattrib24612.html
> Like the securityMechanism and ssl attributes, these attributes appear to apply only to the client/server mode of Derby, not to the embedded mode.
> I'll add topics to the Reference Manual for each of these attributes, unless there is some reason not to.
--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.
[jira] Updated: (DERBY-3168) Reference Manual lacks topics on
trace-related connection URL attributes
Posted by "Kim Haase (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/DERBY-3168?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Kim Haase updated DERBY-3168:
-----------------------------
Attachment: DERBY-3168-3.zip
DERBY-3168-3.diff
Oops, I meant there to be one and only one link in each topic to each of the other files. I wasn't consistent about that. Two files (for traceDirectory and traceLevel) had two links to some of them. Thanks for catching that, Dag.
Here is a revised version (DERBY-3168-3.diff and DERBY-3168-3.zip) that I hope makes the fix.
> Reference Manual lacks topics on trace-related connection URL attributes
> ------------------------------------------------------------------------
>
> Key: DERBY-3168
> URL: https://issues.apache.org/jira/browse/DERBY-3168
> Project: Derby
> Issue Type: Bug
> Components: Documentation
> Affects Versions: 10.3.1.4
> Reporter: Kim Haase
> Assignee: Kim Haase
> Attachments: DERBY-3168-2.diff, DERBY-3168-2.zip, DERBY-3168-3.diff, DERBY-3168-3.zip, DERBY-3168.diff, DERBY-3168.zip
>
>
> The Admin Guide topic "Network client tracing" describes three connection URL attributes that enable network client tracing:
> http://db.apache.org/derby/docs/dev/adminguide/cadminappsclienttracing.html
> The URL attributes are traceFile, traceDirectory, and traceLevel.
> These three attributes are missing from the Reference Manual section where all the connection URL attributes are listed and described:
> http://db.apache.org/derby/docs/dev/ref/rrefattrib24612.html
> Like the securityMechanism and ssl attributes, these attributes appear to apply only to the client/server mode of Derby, not to the embedded mode.
> I'll add topics to the Reference Manual for each of these attributes, unless there is some reason not to.
--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.
[jira] Commented: (DERBY-3168) Reference Manual lacks topics on
trace-related connection URL attributes
Posted by "Dag H. Wanvik (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/DERBY-3168?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#action_12542913 ]
Dag H. Wanvik commented on DERBY-3168:
--------------------------------------
Looks good!
There is a tracing property called traceFileAppend; should that be included as well?
Answer to some of your questions:
- Looking at the code, it seems as if traceDirectory and traceFile are *not* mutually exclusive
(quote from ClientBaseDataSource.java):
:
if (traceDirectory != null) {
String fileName;
if (traceFile == null) {
fileName = traceDirectory + File.separator + logWriterInUseSuffix + "_" + traceFileSuffixIndex;
} else {
fileName = traceDirectory + File.separator + traceFile + logWriterInUseSuffix +
"_" + traceFileSuffixIndex;
}
:
but I didn't try it.
- bit mask 65 is correct
> Reference Manual lacks topics on trace-related connection URL attributes
> ------------------------------------------------------------------------
>
> Key: DERBY-3168
> URL: https://issues.apache.org/jira/browse/DERBY-3168
> Project: Derby
> Issue Type: Bug
> Components: Documentation
> Affects Versions: 10.3.1.4
> Reporter: Kim Haase
> Assignee: Kim Haase
> Attachments: DERBY-3168.diff, DERBY-3168.zip
>
>
> The Admin Guide topic "Network client tracing" describes three connection URL attributes that enable network client tracing:
> http://db.apache.org/derby/docs/dev/adminguide/cadminappsclienttracing.html
> The URL attributes are traceFile, traceDirectory, and traceLevel.
> These three attributes are missing from the Reference Manual section where all the connection URL attributes are listed and described:
> http://db.apache.org/derby/docs/dev/ref/rrefattrib24612.html
> Like the securityMechanism and ssl attributes, these attributes appear to apply only to the client/server mode of Derby, not to the embedded mode.
> I'll add topics to the Reference Manual for each of these attributes, unless there is some reason not to.
--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.
[jira] Commented: (DERBY-3168) Reference Manual lacks topics on
trace-related connection URL attributes
Posted by "Kim Haase (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/DERBY-3168?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#action_12543660 ]
Kim Haase commented on DERBY-3168:
----------------------------------
Thanks, Dag! I'm glad you caught traceFileAppend -- it is not mentioned in the "Network client tracing" topic in the Admin Guide, only in the parent topic, so I missed it. I believe it should be in the Reference Manual too. I'll add a topic for it.
And I will revise the docs to indicate that traceDirectory and traceFile can be used together. Maybe I'll include an example of that.
Thanks also for the confirmation on the bit mask. I guess that also means that the column in the table is okay.
> Reference Manual lacks topics on trace-related connection URL attributes
> ------------------------------------------------------------------------
>
> Key: DERBY-3168
> URL: https://issues.apache.org/jira/browse/DERBY-3168
> Project: Derby
> Issue Type: Bug
> Components: Documentation
> Affects Versions: 10.3.1.4
> Reporter: Kim Haase
> Assignee: Kim Haase
> Attachments: DERBY-3168.diff, DERBY-3168.zip
>
>
> The Admin Guide topic "Network client tracing" describes three connection URL attributes that enable network client tracing:
> http://db.apache.org/derby/docs/dev/adminguide/cadminappsclienttracing.html
> The URL attributes are traceFile, traceDirectory, and traceLevel.
> These three attributes are missing from the Reference Manual section where all the connection URL attributes are listed and described:
> http://db.apache.org/derby/docs/dev/ref/rrefattrib24612.html
> Like the securityMechanism and ssl attributes, these attributes appear to apply only to the client/server mode of Derby, not to the embedded mode.
> I'll add topics to the Reference Manual for each of these attributes, unless there is some reason not to.
--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.
[jira] Updated: (DERBY-3168) Reference Manual lacks topics on
trace-related connection URL attributes
Posted by "Kim Haase (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/DERBY-3168?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Kim Haase updated DERBY-3168:
-----------------------------
Attachment: DERBY-3168.zip
DERBY-3168.diff
Attaching patch, DERBY-3168.diff and DERBY-3168.zip, containing first drafts of three new topics:
rrefattribtracedirectory.dita
rrefattribtracefile.dita
rrefattribtracelevel.dita
In the Reference Manual, these topics will appear in the section "Setting attributes for the database connection URL."
The drafts contain some questions about security, interaction with other attributes, and the like.
The output of the "svn stat" command looks like this:
A src/ref/rrefattribtracedirectory.dita
A src/ref/rrefattribtracelevel.dita
A src/ref/rrefattribtracefile.dita
M src/ref/refderby.ditamap
Thanks in advance for any comments.
> Reference Manual lacks topics on trace-related connection URL attributes
> ------------------------------------------------------------------------
>
> Key: DERBY-3168
> URL: https://issues.apache.org/jira/browse/DERBY-3168
> Project: Derby
> Issue Type: Bug
> Components: Documentation
> Affects Versions: 10.3.1.4
> Reporter: Kim Haase
> Assignee: Kim Haase
> Attachments: DERBY-3168.diff, DERBY-3168.zip
>
>
> The Admin Guide topic "Network client tracing" describes three connection URL attributes that enable network client tracing:
> http://db.apache.org/derby/docs/dev/adminguide/cadminappsclienttracing.html
> The URL attributes are traceFile, traceDirectory, and traceLevel.
> These three attributes are missing from the Reference Manual section where all the connection URL attributes are listed and described:
> http://db.apache.org/derby/docs/dev/ref/rrefattrib24612.html
> Like the securityMechanism and ssl attributes, these attributes appear to apply only to the client/server mode of Derby, not to the embedded mode.
> I'll add topics to the Reference Manual for each of these attributes, unless there is some reason not to.
--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.
[jira] Updated: (DERBY-3168) Reference Manual lacks topics on
trace-related connection URL attributes
Posted by "Dyre Tjeldvoll (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/DERBY-3168?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Dyre Tjeldvoll updated DERBY-3168:
----------------------------------
Derby Info: (was: [Patch Available])
Committed revision 599880.
> Reference Manual lacks topics on trace-related connection URL attributes
> ------------------------------------------------------------------------
>
> Key: DERBY-3168
> URL: https://issues.apache.org/jira/browse/DERBY-3168
> Project: Derby
> Issue Type: Bug
> Components: Documentation
> Affects Versions: 10.3.1.4
> Reporter: Kim Haase
> Assignee: Kim Haase
> Attachments: DERBY-3168-2.diff, DERBY-3168-2.zip, DERBY-3168-3.diff, DERBY-3168-3.zip, DERBY-3168.diff, DERBY-3168.zip
>
>
> The Admin Guide topic "Network client tracing" describes three connection URL attributes that enable network client tracing:
> http://db.apache.org/derby/docs/dev/adminguide/cadminappsclienttracing.html
> The URL attributes are traceFile, traceDirectory, and traceLevel.
> These three attributes are missing from the Reference Manual section where all the connection URL attributes are listed and described:
> http://db.apache.org/derby/docs/dev/ref/rrefattrib24612.html
> Like the securityMechanism and ssl attributes, these attributes appear to apply only to the client/server mode of Derby, not to the embedded mode.
> I'll add topics to the Reference Manual for each of these attributes, unless there is some reason not to.
--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.
[jira] Closed: (DERBY-3168) Reference Manual lacks topics on
trace-related connection URL attributes
Posted by "Kim Haase (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/DERBY-3168?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Kim Haase closed DERBY-3168.
----------------------------
> Reference Manual lacks topics on trace-related connection URL attributes
> ------------------------------------------------------------------------
>
> Key: DERBY-3168
> URL: https://issues.apache.org/jira/browse/DERBY-3168
> Project: Derby
> Issue Type: Bug
> Components: Documentation
> Affects Versions: 10.3.1.4
> Reporter: Kim Haase
> Assignee: Kim Haase
> Fix For: 10.4.0.0
>
> Attachments: DERBY-3168-2.diff, DERBY-3168-2.zip, DERBY-3168-3.diff, DERBY-3168-3.zip, DERBY-3168.diff, DERBY-3168.zip
>
>
> The Admin Guide topic "Network client tracing" describes three connection URL attributes that enable network client tracing:
> http://db.apache.org/derby/docs/dev/adminguide/cadminappsclienttracing.html
> The URL attributes are traceFile, traceDirectory, and traceLevel.
> These three attributes are missing from the Reference Manual section where all the connection URL attributes are listed and described:
> http://db.apache.org/derby/docs/dev/ref/rrefattrib24612.html
> Like the securityMechanism and ssl attributes, these attributes appear to apply only to the client/server mode of Derby, not to the embedded mode.
> I'll add topics to the Reference Manual for each of these attributes, unless there is some reason not to.
--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.
[jira] Updated: (DERBY-3168) Reference Manual lacks topics on
trace-related connection URL attributes
Posted by "Kim Haase (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/DERBY-3168?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Kim Haase updated DERBY-3168:
-----------------------------
Derby Info: [Patch Available]
> Reference Manual lacks topics on trace-related connection URL attributes
> ------------------------------------------------------------------------
>
> Key: DERBY-3168
> URL: https://issues.apache.org/jira/browse/DERBY-3168
> Project: Derby
> Issue Type: Bug
> Components: Documentation
> Affects Versions: 10.3.1.4
> Reporter: Kim Haase
> Assignee: Kim Haase
> Attachments: DERBY-3168-2.diff, DERBY-3168-2.zip, DERBY-3168.diff, DERBY-3168.zip
>
>
> The Admin Guide topic "Network client tracing" describes three connection URL attributes that enable network client tracing:
> http://db.apache.org/derby/docs/dev/adminguide/cadminappsclienttracing.html
> The URL attributes are traceFile, traceDirectory, and traceLevel.
> These three attributes are missing from the Reference Manual section where all the connection URL attributes are listed and described:
> http://db.apache.org/derby/docs/dev/ref/rrefattrib24612.html
> Like the securityMechanism and ssl attributes, these attributes appear to apply only to the client/server mode of Derby, not to the embedded mode.
> I'll add topics to the Reference Manual for each of these attributes, unless there is some reason not to.
--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.