[ 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
