db-derby-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "John H. Embretsen (JIRA)" <derby-...@db.apache.org>
Subject [jira] Commented: (DERBY-1293) Derby Server and Administration Guide - derby.drda.startNetworkServer
Date Mon, 08 May 2006 13:26:22 GMT
    [ http://issues.apache.org/jira/browse/DERBY-1293?page=comments#action_12378418 ] 

John H. Embretsen commented on DERBY-1293:
------------------------------------------

Halley Pacheco de Oliveira commented:
 
> In my opinion John H. Embretsen's sentence could be longer, something like:
> 
> "In this context, Derby Network Server will start when the embedded driver is loaded,
unless it has already been started, and it will shutdown when the application ends, even if
other applications are connected to Derby Network Server, in the case it was started by the
application."

I think this is too much to include in one sentence. 
Is it really necessary to say "unless it has already been started"? Isn't that obvious?
I also think "When you set derby.drda.startNetworkServer, the Network Server will automatically
start when you start Derby. In this context, Derby Network Server will start when the embedded
driver is loaded..." sounds a bit strange. I guess the two sentences will have to be merged.
Anyway, the point of my suggestion was merely to indicate more clearly to the reader how to
start Derby, since this was mentioned in the previous sentence. 

Besides, if we really want to include information about when the network server shuts down,
I think we need to be a bit more careful with the wording, and put it in a separate paragraph.

Yes, it is true that the Network Server will shut down when the embedding application ends.
However, the server also shuts down if 

a) the Derby system is shut down, for example:

ij> connect 'jdbc:derby:;shutdown=true';

or
b) the NetworkServerControl shutdown command is executed from the command line, for example:

$ java org.apache.derby.drda.NetworkServerControl shutdown

or
c) the NetworkServerControl shutdown method is invoked from a Java application, for example:

NetworkServerControl server = new NetworkServerControl();
server.shutdown();

Perhaps there are even more ways to do this...

So, things are more complicated than they seem at first glance. We can make it even more complicated
by including some text about restarting the server after it has been shut down using a), b)
,c) or the end-of-application approach. With a) you can restart the server simply by reloading
the embedded driver, with b) and c) you cannot do that (that is, until you actually "unload"
the embedded driver first).

Unless we can come up with some generic statement which covers all shutdown options, I recommend
not mentioning shutdown in this context. Having said that, I think it would be good to have
a separate doc page with examples and explanations of things in this category. I think this
is largely related to the new document that Stanley Bradbury is working on, see 
http://www.nabble.com/Re%3A-WWD-Review-of-Final-Chapters-%285-and-6%29-p4218805.html


> Derby Server and Administration Guide - derby.drda.startNetworkServer
> ---------------------------------------------------------------------
>
>          Key: DERBY-1293
>          URL: http://issues.apache.org/jira/browse/DERBY-1293
>      Project: Derby
>         Type: Bug

>   Components: Documentation
>     Versions: 10.1.2.3
>  Environment: DITA-sourced documentation
>     Reporter: Halley Pacheco de Oliveira
>     Priority: Minor
>      Fix For: 10.1.2.3
>  Attachments: radminconfigstartnetworkserver.diff, radminconfigstartnetworkserver.diff.html,
radminconfigstartnetworkserver.html
>
> In this page is written:
> When you set derby.drda.startNetworkServer, the Network Server will automatically start
when you start Derby.
> but I think that
> When you set derby.drda.startNetworkServer to true, the Network Server will automatically
start when you start Derby.
> would be better, because "to true" should be explicit instead of implicit as it is in
the original text.

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators:
   http://issues.apache.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see:
   http://www.atlassian.com/software/jira


Mime
View raw message