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 "Halley Pacheco de Oliveira (JIRA)" <de...@db.apache.org> on 2006/04/08 16:08:28 UTC
[jira] Created: (DERBY-1194) Derby Server and Administration Guide
- Managing the Derby Network Server
Derby Server and Administration Guide - Managing the Derby Network Server
-------------------------------------------------------------------------
Key: DERBY-1194
URL: http://issues.apache.org/jira/browse/DERBY-1194
Project: Derby
Type: Bug
Components: Documentation
Versions: 10.1.2.3
Environment: DITA files
Reporter: Halley Pacheco de Oliveira
Priority: Minor
Fix For: 10.1.2.3
In this manual is written:
Managing the Derby Network Server
The Derby Network Server can run as a stand-alone server, with Derby as an embedded part of the application.
It can also be managed remotely from a web server by using a servlet interface. You can manage the Network Server by using shell scripts, the command line, or the Network Server API. See Managing the Derby Network Server remotely by using the servlet interface for information about starting and shutting down the Network Server using the servlet interface.
It seems to me that the sentences of this last paragraph are not in the correct order, and the first and second sentences should be swapped, becoming:
You can manage the Network Server by using shell scripts, the command line, or the Network Server API. It can also be managed remotely from a web server by using a servlet interface. See Managing the Derby Network Server remotely by using the servlet interface for information about starting and shutting down the Network Server using the servlet interface.
--
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
[jira] Updated: (DERBY-1194) Clarify wording for ways to manage the
Network Server in the Derby Server and Administration Guide
Posted by "Bryan Pendleton (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/DERBY-1194?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Bryan Pendleton updated DERBY-1194:
-----------------------------------
Attachment: cadminconfig86869.html
docs.diff
Attached is an updated patch proposal, and an updated HTML version of the man page.
I think I included all the comments from this issue. Any suggestions or feedback
are quite appreciated!
> Clarify wording for ways to manage the Network Server in the Derby Server and Administration Guide
> --------------------------------------------------------------------------------------------------
>
> Key: DERBY-1194
> URL: https://issues.apache.org/jira/browse/DERBY-1194
> Project: Derby
> Issue Type: Bug
> Components: Documentation
> Affects Versions: 10.1.3.1
> Environment: DITA files
> Reporter: Halley Pacheco de Oliveira
> Assignee: Bryan Pendleton
> Priority: Minor
> Attachments: cadminconfig86869.diff, cadminconfig86869.diff.html, cadminconfig86869.html, cadminconfig86869.html, cadminconfig86869_a.diff, cadminconfig86869_a.diff.html, docs.diff
>
>
> In this manual is written:
> Managing the Derby Network Server
> The Derby Network Server can run as a stand-alone server, with Derby as an embedded part of the application.
> It can also be managed remotely from a web server by using a servlet interface. You can manage the Network Server by using shell scripts, the command line, or the Network Server API. See Managing the Derby Network Server remotely by using the servlet interface for information about starting and shutting down the Network Server using the servlet interface.
> It seems to me that the sentences of this last paragraph are not in the correct order, and the first and second sentences should be swapped, becoming:
> You can manage the Network Server by using shell scripts, the command line, or the Network Server API. It can also be managed remotely from a web server by using a servlet interface. See Managing the Derby Network Server remotely by using the servlet interface for information about starting and shutting down the Network Server using the servlet interface.
--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.
[jira] Commented: (DERBY-1194) Derby Server and Administration
Guide - Managing the Derby Network Server
Posted by "Halley Pacheco de Oliveira (JIRA)" <de...@db.apache.org>.
[ http://issues.apache.org/jira/browse/DERBY-1194?page=comments#action_12373773 ]
Halley Pacheco de Oliveira commented on DERBY-1194:
---------------------------------------------------
About John H. Embretsen's comment:
In my opinion, in the sentence "The Derby Network Server can run as a stand-alone server, with Derby as an embedded part of the application." the word "application" stands for "Derby Network Server", and the sentence could be:
"The Derby Network Server can run as a stand-alone server, with Derby as an embedded part of the Derby Network Server."
or
"The Derby Network Server can run as a stand-alone server, with Derby as an embedded part of it."
My opinion is based on this part of the manual:
The Derby Network Server
The Network Server is a solution for multiple JVMs that connect to the database, unlike the embedded scenario where only one JVM runs as part of the system. When Derby is embedded in a single-JVM application, the embedded JDBC driver calls the local Derby database. When Derby is embedded in a server framework, the server framework's connectivity software provides data to multiple client JDBC applications over a network or the Internet.
PS: I will attach the HTML output along with the new correction. Thank you for the tip.
> Derby Server and Administration Guide - Managing the Derby Network Server
> -------------------------------------------------------------------------
>
> Key: DERBY-1194
> URL: http://issues.apache.org/jira/browse/DERBY-1194
> Project: Derby
> Type: Bug
> Components: Documentation
> Versions: 10.1.2.3
> Environment: DITA files
> Reporter: Halley Pacheco de Oliveira
> Priority: Minor
> Fix For: 10.1.2.3
> Attachments: cadminconfig86869.diff, cadminconfig86869.diff.html
>
> In this manual is written:
> Managing the Derby Network Server
> The Derby Network Server can run as a stand-alone server, with Derby as an embedded part of the application.
> It can also be managed remotely from a web server by using a servlet interface. You can manage the Network Server by using shell scripts, the command line, or the Network Server API. See Managing the Derby Network Server remotely by using the servlet interface for information about starting and shutting down the Network Server using the servlet interface.
> It seems to me that the sentences of this last paragraph are not in the correct order, and the first and second sentences should be swapped, becoming:
> You can manage the Network Server by using shell scripts, the command line, or the Network Server API. It can also be managed remotely from a web server by using a servlet interface. See Managing the Derby Network Server remotely by using the servlet interface for information about starting and shutting down the Network Server using the servlet interface.
--
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
[jira] Updated: (DERBY-1194) Derby Server and Administration Guide
- Managing the Derby Network Server
Posted by "Rick Hillegas (JIRA)" <de...@db.apache.org>.
[ http://issues.apache.org/jira/browse/DERBY-1194?page=all ]
Rick Hillegas updated DERBY-1194:
---------------------------------
Fix Version/s: 10.2.2.0
(was: 10.2.1.0)
Moving to 10.2.2.0.
> Derby Server and Administration Guide - Managing the Derby Network Server
> -------------------------------------------------------------------------
>
> Key: DERBY-1194
> URL: http://issues.apache.org/jira/browse/DERBY-1194
> Project: Derby
> Issue Type: Bug
> Components: Documentation
> Affects Versions: 10.1.2.3
> Environment: DITA files
> Reporter: Halley Pacheco de Oliveira
> Priority: Minor
> Fix For: 10.2.2.0
>
> Attachments: cadminconfig86869.diff, cadminconfig86869.diff.html, cadminconfig86869.html, cadminconfig86869_a.diff, cadminconfig86869_a.diff.html
>
>
> In this manual is written:
> Managing the Derby Network Server
> The Derby Network Server can run as a stand-alone server, with Derby as an embedded part of the application.
> It can also be managed remotely from a web server by using a servlet interface. You can manage the Network Server by using shell scripts, the command line, or the Network Server API. See Managing the Derby Network Server remotely by using the servlet interface for information about starting and shutting down the Network Server using the servlet interface.
> It seems to me that the sentences of this last paragraph are not in the correct order, and the first and second sentences should be swapped, becoming:
> You can manage the Network Server by using shell scripts, the command line, or the Network Server API. It can also be managed remotely from a web server by using a servlet interface. See Managing the Derby Network Server remotely by using the servlet interface for information about starting and shutting down the Network Server using the servlet interface.
--
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
[jira] Resolved: (DERBY-1194) Clarify wording for ways to manage
the Network Server in the Derby Server and Administration Guide
Posted by "Bryan Pendleton (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/DERBY-1194?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Bryan Pendleton resolved DERBY-1194.
------------------------------------
Resolution: Fixed
Fix Version/s: 10.6.0.0
Thanks Jean and John for the wording suggestions, and thanks Kim for the review!
I updated the bullet points and committed this change to the docs trunk as revision 882792.
> Clarify wording for ways to manage the Network Server in the Derby Server and Administration Guide
> --------------------------------------------------------------------------------------------------
>
> Key: DERBY-1194
> URL: https://issues.apache.org/jira/browse/DERBY-1194
> Project: Derby
> Issue Type: Bug
> Components: Documentation
> Affects Versions: 10.1.3.1
> Environment: DITA files
> Reporter: Halley Pacheco de Oliveira
> Assignee: Bryan Pendleton
> Priority: Minor
> Fix For: 10.6.0.0
>
> Attachments: cadminconfig86869.diff, cadminconfig86869.diff.html, cadminconfig86869.html, cadminconfig86869.html, cadminconfig86869_a.diff, cadminconfig86869_a.diff.html, docs.diff
>
>
> In this manual is written:
> Managing the Derby Network Server
> The Derby Network Server can run as a stand-alone server, with Derby as an embedded part of the application.
> It can also be managed remotely from a web server by using a servlet interface. You can manage the Network Server by using shell scripts, the command line, or the Network Server API. See Managing the Derby Network Server remotely by using the servlet interface for information about starting and shutting down the Network Server using the servlet interface.
> It seems to me that the sentences of this last paragraph are not in the correct order, and the first and second sentences should be swapped, becoming:
> You can manage the Network Server by using shell scripts, the command line, or the Network Server API. It can also be managed remotely from a web server by using a servlet interface. See Managing the Derby Network Server remotely by using the servlet interface for information about starting and shutting down the Network Server using the servlet interface.
--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.
[jira] Updated: (DERBY-1194) Derby Server and Administration Guide
- Managing the Derby Network Server
Posted by "Mike Matrigali (JIRA)" <de...@db.apache.org>.
[ http://issues.apache.org/jira/browse/DERBY-1194?page=all ]
Mike Matrigali updated DERBY-1194:
----------------------------------
Fix Version/s: 10.2.1.0
> Derby Server and Administration Guide - Managing the Derby Network Server
> -------------------------------------------------------------------------
>
> Key: DERBY-1194
> URL: http://issues.apache.org/jira/browse/DERBY-1194
> Project: Derby
> Issue Type: Bug
> Components: Documentation
> Affects Versions: 10.1.2.3
> Environment: DITA files
> Reporter: Halley Pacheco de Oliveira
> Priority: Minor
> Fix For: 10.2.1.0
>
> Attachments: cadminconfig86869.diff, cadminconfig86869.diff.html, cadminconfig86869.html, cadminconfig86869_a.diff, cadminconfig86869_a.diff.html
>
>
> In this manual is written:
> Managing the Derby Network Server
> The Derby Network Server can run as a stand-alone server, with Derby as an embedded part of the application.
> It can also be managed remotely from a web server by using a servlet interface. You can manage the Network Server by using shell scripts, the command line, or the Network Server API. See Managing the Derby Network Server remotely by using the servlet interface for information about starting and shutting down the Network Server using the servlet interface.
> It seems to me that the sentences of this last paragraph are not in the correct order, and the first and second sentences should be swapped, becoming:
> You can manage the Network Server by using shell scripts, the command line, or the Network Server API. It can also be managed remotely from a web server by using a servlet interface. See Managing the Derby Network Server remotely by using the servlet interface for information about starting and shutting down the Network Server using the servlet interface.
--
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
[jira] Commented: (DERBY-1194) Derby Server and Administration
Guide - Managing the Derby Network Server
Posted by "John H. Embretsen (JIRA)" <de...@db.apache.org>.
[ http://issues.apache.org/jira/browse/DERBY-1194?page=comments#action_12373766 ]
John H. Embretsen commented on DERBY-1194:
------------------------------------------
I agree that the flow is much better when the two sentences are swapped. :)
Also, I am not sure I completely understand what is meant by the first paragraph,
"The Derby Network Server can run as a stand-alone server, with Derby as an embedded part of the application."
Is it that the Derby "engine" is an embedded part of the Network Server application? Or is the purpose to say that is is possible to run the Network server either as a stand-alone server or as an embedded server in the user's Java application?
If the latter case is true, I think the sentence should be rephrased to something like this:
"The Derby Network Server can run as a stand-alone server, or as an embedded part of a Java application."
What do others think?
Halley, in the future, it would be nice (easier for for reviewers) if you attached the html output generated by the DITA toolkit, as explained here:
http://db.apache.org/derby/manuals/dita.html#Creating+output
In this particular case, you would find the generated html file in this location in your docs repository:
out/adminguide/cadminconfig86869.html
> Derby Server and Administration Guide - Managing the Derby Network Server
> -------------------------------------------------------------------------
>
> Key: DERBY-1194
> URL: http://issues.apache.org/jira/browse/DERBY-1194
> Project: Derby
> Type: Bug
> Components: Documentation
> Versions: 10.1.2.3
> Environment: DITA files
> Reporter: Halley Pacheco de Oliveira
> Priority: Minor
> Fix For: 10.1.2.3
> Attachments: cadminconfig86869.diff, cadminconfig86869.diff.html
>
> In this manual is written:
> Managing the Derby Network Server
> The Derby Network Server can run as a stand-alone server, with Derby as an embedded part of the application.
> It can also be managed remotely from a web server by using a servlet interface. You can manage the Network Server by using shell scripts, the command line, or the Network Server API. See Managing the Derby Network Server remotely by using the servlet interface for information about starting and shutting down the Network Server using the servlet interface.
> It seems to me that the sentences of this last paragraph are not in the correct order, and the first and second sentences should be swapped, becoming:
> You can manage the Network Server by using shell scripts, the command line, or the Network Server API. It can also be managed remotely from a web server by using a servlet interface. See Managing the Derby Network Server remotely by using the servlet interface for information about starting and shutting down the Network Server using the servlet interface.
--
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
Re: [jira] Commented: (DERBY-1194) Derby Server and Administration
Guide - Managing the Derby Network Server
Posted by John Embretsen <Jo...@Sun.COM>.
Dag H. Wanvik wrote:
> "John H. Embretsen (JIRA)" <de...@db.apache.org> writes:
>
>> [
>> http://issues.apache.org/jira/browse/DERBY-1194?page=comments#action_12374701
>> ]
>>
>> John H. Embretsen commented on DERBY-1194:
>> ------------------------------------------
>>
>> Here is another suggestion which captures both interpretations of the
>> sentence "The Derby Network Server can run as a stand-alone server, with
>> Derby as an embedded part of the application.":
>>
>> "The Derby Network Server can either run stand-alone, that is as an
>> independent Java process embedding the Derby database engine, or
>> embedded within another Java application. In the latter ("embedded
>> server") setting both the Network Server framework and Derby are loaded
>> by the Java application."
>
> I like this wording better than those suggested so far in this thread,
> although I'd put "setting" in front of the parenthesized clause.
I agree, that would be better.
> However, this still fails to capture explicitly the fact that the
> embedding application can access Derby using the embedded driver while
> also offering access to other applications via the client driver and the
> server.
Yes, but I am not sure how much of this should be included on the particular
manual page in question, with the title "Managing the Derby Network Server".
That said, the only place I could find something like this mentioned in the
manuals is in the admin guide, under "Network Server sample programs for
embedded and client connections",
http://db.apache.org/derby/docs/dev/adminguide/cadminovntsrvsample.html.
Perhaps the best solution would be to include a link to this page from the
"Managing the Derby Network Server" page, i.e. something like this:
"An application embedding the Network Server can access Derby using both the
embedded driver and a client driver. For more information and examples, see
<link_to_sample_page>."
It is likely that the embedded server scenario is not documented well enough
in the manuals. But I guess that is something for another day, in another
Jira issue.
--
John
Re: [jira] Commented: (DERBY-1194) Derby Server and Administration
Guide - Managing the Derby Network Server
Posted by "Dag H. Wanvik" <Da...@Sun.COM>.
"John H. Embretsen (JIRA)" <de...@db.apache.org> writes:
> [ http://issues.apache.org/jira/browse/DERBY-1194?page=comments#action_12374701 ]
>
> John H. Embretsen commented on DERBY-1194:
> ------------------------------------------
>
> Here is another suggestion which captures both interpretations of the sentence "The Derby Network Server can run as a stand-alone server,
> with Derby as an embedded part of the application.":
>
> "The Derby Network Server can either run stand-alone, that is as an
> independent Java process embedding the Derby database engine, or
> embedded within another Java application. In the latter ("embedded
> server") setting both the Network Server framework and Derby are
> loaded by the Java application."
I like this wording better than those suggested so far in this thread,
although I'd put "setting" in front of the parenthesized clause.
However, this still fails to capture explicitly the fact that the
embedding application can access Derby using the embedded driver while
also offering access to other applications via the client driver and
the server.
Dag
[jira] Commented: (DERBY-1194) Derby Server and Administration
Guide - Managing the Derby Network Server
Posted by "John H. Embretsen (JIRA)" <de...@db.apache.org>.
[ http://issues.apache.org/jira/browse/DERBY-1194?page=comments#action_12374701 ]
John H. Embretsen commented on DERBY-1194:
------------------------------------------
Here is another suggestion which captures both interpretations of the sentence "The Derby Network Server can run as a stand-alone server,
with Derby as an embedded part of the application.":
"The Derby Network Server can either run stand-alone, that is as an independent Java process embedding the Derby database engine, or embedded within another Java application. In the latter ("embedded server") setting both the Network Server framework and Derby are loaded by the Java application."
I still think it can be improved, but to me this seems clearer than the other suggestions seen so far.
> Derby Server and Administration Guide - Managing the Derby Network Server
> -------------------------------------------------------------------------
>
> Key: DERBY-1194
> URL: http://issues.apache.org/jira/browse/DERBY-1194
> Project: Derby
> Type: Bug
> Components: Documentation
> Versions: 10.1.2.3
> Environment: DITA files
> Reporter: Halley Pacheco de Oliveira
> Priority: Minor
> Attachments: cadminconfig86869.diff, cadminconfig86869.diff.html, cadminconfig86869.html, cadminconfig86869_a.diff, cadminconfig86869_a.diff.html
>
> In this manual is written:
> Managing the Derby Network Server
> The Derby Network Server can run as a stand-alone server, with Derby as an embedded part of the application.
> It can also be managed remotely from a web server by using a servlet interface. You can manage the Network Server by using shell scripts, the command line, or the Network Server API. See Managing the Derby Network Server remotely by using the servlet interface for information about starting and shutting down the Network Server using the servlet interface.
> It seems to me that the sentences of this last paragraph are not in the correct order, and the first and second sentences should be swapped, becoming:
> You can manage the Network Server by using shell scripts, the command line, or the Network Server API. It can also be managed remotely from a web server by using a servlet interface. See Managing the Derby Network Server remotely by using the servlet interface for information about starting and shutting down the Network Server using the servlet interface.
--
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
[jira] Updated: (DERBY-1194) Derby Server and Administration Guide
- Managing the Derby Network Server
Posted by "Andrew McIntyre (JIRA)" <de...@db.apache.org>.
[ http://issues.apache.org/jira/browse/DERBY-1194?page=all ]
Andrew McIntyre updated DERBY-1194:
-----------------------------------
Fix Version: (was: 10.1.2.3)
> Derby Server and Administration Guide - Managing the Derby Network Server
> -------------------------------------------------------------------------
>
> Key: DERBY-1194
> URL: http://issues.apache.org/jira/browse/DERBY-1194
> Project: Derby
> Type: Bug
> Components: Documentation
> Versions: 10.1.2.3
> Environment: DITA files
> Reporter: Halley Pacheco de Oliveira
> Priority: Minor
> Attachments: cadminconfig86869.diff, cadminconfig86869.diff.html, cadminconfig86869.html, cadminconfig86869_a.diff, cadminconfig86869_a.diff.html
>
> In this manual is written:
> Managing the Derby Network Server
> The Derby Network Server can run as a stand-alone server, with Derby as an embedded part of the application.
> It can also be managed remotely from a web server by using a servlet interface. You can manage the Network Server by using shell scripts, the command line, or the Network Server API. See Managing the Derby Network Server remotely by using the servlet interface for information about starting and shutting down the Network Server using the servlet interface.
> It seems to me that the sentences of this last paragraph are not in the correct order, and the first and second sentences should be swapped, becoming:
> You can manage the Network Server by using shell scripts, the command line, or the Network Server API. It can also be managed remotely from a web server by using a servlet interface. See Managing the Derby Network Server remotely by using the servlet interface for information about starting and shutting down the Network Server using the servlet interface.
--
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
[jira] Updated: (DERBY-1194) Derby Server and Administration Guide
- Managing the Derby Network Server
Posted by "Halley Pacheco de Oliveira (JIRA)" <de...@db.apache.org>.
[ http://issues.apache.org/jira/browse/DERBY-1194?page=all ]
Halley Pacheco de Oliveira updated DERBY-1194:
----------------------------------------------
Attachment: cadminconfig86869.diff
cadminconfig86869.diff.html
svn diff file and the HTMLized version
> Derby Server and Administration Guide - Managing the Derby Network Server
> -------------------------------------------------------------------------
>
> Key: DERBY-1194
> URL: http://issues.apache.org/jira/browse/DERBY-1194
> Project: Derby
> Type: Bug
> Components: Documentation
> Versions: 10.1.2.3
> Environment: DITA files
> Reporter: Halley Pacheco de Oliveira
> Priority: Minor
> Fix For: 10.1.2.3
> Attachments: cadminconfig86869.diff, cadminconfig86869.diff.html
>
> In this manual is written:
> Managing the Derby Network Server
> The Derby Network Server can run as a stand-alone server, with Derby as an embedded part of the application.
> It can also be managed remotely from a web server by using a servlet interface. You can manage the Network Server by using shell scripts, the command line, or the Network Server API. See Managing the Derby Network Server remotely by using the servlet interface for information about starting and shutting down the Network Server using the servlet interface.
> It seems to me that the sentences of this last paragraph are not in the correct order, and the first and second sentences should be swapped, becoming:
> You can manage the Network Server by using shell scripts, the command line, or the Network Server API. It can also be managed remotely from a web server by using a servlet interface. See Managing the Derby Network Server remotely by using the servlet interface for information about starting and shutting down the Network Server using the servlet interface.
--
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
[jira] Commented: (DERBY-1194) Derby Server and Administration
Guide - Managing the Derby Network Server
Posted by "Jean T. Anderson (JIRA)" <de...@db.apache.org>.
[ http://issues.apache.org/jira/browse/DERBY-1194?page=comments#action_12374252 ]
Jean T. Anderson commented on DERBY-1194:
-----------------------------------------
regarding this paragraph:
"The Derby Network Server can run as a stand-alone server, with Derby as an embedded part of the application."
Actually, the Network Server can either run stand-alone, as depicted in Figure 2 at http://db.apache.org/derby/papers/DerbyTut/ns_intro.html#Embedded+Server, or it can run as an embedded server, as depicted in Figure 3 at http://db.apache.org/derby/papers/DerbyTut/ns_intro.html#Embedded+Server .
Here's another suggestion that bounces off of Halley's, but it isn't quite there yet because it's JVM-centric:
"The Derby Network Server can run stand-alone, in its own JVM, with Derby embedded in it. Or it can run in another application's JVM, and it's the Java application that loads both Derby and the Network Server."
more suggestions?
> Derby Server and Administration Guide - Managing the Derby Network Server
> -------------------------------------------------------------------------
>
> Key: DERBY-1194
> URL: http://issues.apache.org/jira/browse/DERBY-1194
> Project: Derby
> Type: Bug
> Components: Documentation
> Versions: 10.1.2.3
> Environment: DITA files
> Reporter: Halley Pacheco de Oliveira
> Priority: Minor
> Attachments: cadminconfig86869.diff, cadminconfig86869.diff.html, cadminconfig86869.html, cadminconfig86869_a.diff, cadminconfig86869_a.diff.html
>
> In this manual is written:
> Managing the Derby Network Server
> The Derby Network Server can run as a stand-alone server, with Derby as an embedded part of the application.
> It can also be managed remotely from a web server by using a servlet interface. You can manage the Network Server by using shell scripts, the command line, or the Network Server API. See Managing the Derby Network Server remotely by using the servlet interface for information about starting and shutting down the Network Server using the servlet interface.
> It seems to me that the sentences of this last paragraph are not in the correct order, and the first and second sentences should be swapped, becoming:
> You can manage the Network Server by using shell scripts, the command line, or the Network Server API. It can also be managed remotely from a web server by using a servlet interface. See Managing the Derby Network Server remotely by using the servlet interface for information about starting and shutting down the Network Server using the servlet interface.
--
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
[jira] Updated: (DERBY-1194) Derby Server and Administration Guide
- Managing the Derby Network Server
Posted by "Mike Matrigali (JIRA)" <de...@db.apache.org>.
[ http://issues.apache.org/jira/browse/DERBY-1194?page=all ]
Mike Matrigali updated DERBY-1194:
----------------------------------
Derby Info: (was: [Patch Available])
>From the comments, and no response to kathy's query months back it looks like this "patch" is not really ready.
> Derby Server and Administration Guide - Managing the Derby Network Server
> -------------------------------------------------------------------------
>
> Key: DERBY-1194
> URL: http://issues.apache.org/jira/browse/DERBY-1194
> Project: Derby
> Issue Type: Bug
> Components: Documentation
> Affects Versions: 10.1.2.3
> Environment: DITA files
> Reporter: Halley Pacheco de Oliveira
> Priority: Minor
> Fix For: 10.2.2.0
>
> Attachments: cadminconfig86869.diff, cadminconfig86869.diff.html, cadminconfig86869.html, cadminconfig86869_a.diff, cadminconfig86869_a.diff.html
>
>
> In this manual is written:
> Managing the Derby Network Server
> The Derby Network Server can run as a stand-alone server, with Derby as an embedded part of the application.
> It can also be managed remotely from a web server by using a servlet interface. You can manage the Network Server by using shell scripts, the command line, or the Network Server API. See Managing the Derby Network Server remotely by using the servlet interface for information about starting and shutting down the Network Server using the servlet interface.
> It seems to me that the sentences of this last paragraph are not in the correct order, and the first and second sentences should be swapped, becoming:
> You can manage the Network Server by using shell scripts, the command line, or the Network Server API. It can also be managed remotely from a web server by using a servlet interface. See Managing the Derby Network Server remotely by using the servlet interface for information about starting and shutting down the Network Server using the servlet interface.
--
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
[jira] Commented: (DERBY-1194) Clarify wording for ways to manage
the Network Server in the Derby Server and Administration Guide
Posted by "Kim Haase (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/DERBY-1194?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12780778#action_12780778 ]
Kim Haase commented on DERBY-1194:
----------------------------------
I think you've done a great job disentangling all the various suggestions, Bryan. I think I looked at them a long time ago and couldn't think *what* to do.
Also, pointing to those figures in the tutorial works really well.
You don't really need the "Or" in the bullet list, and you don't need punctuation at the end -- it can just be
o As .... engine
o As .... application
> Clarify wording for ways to manage the Network Server in the Derby Server and Administration Guide
> --------------------------------------------------------------------------------------------------
>
> Key: DERBY-1194
> URL: https://issues.apache.org/jira/browse/DERBY-1194
> Project: Derby
> Issue Type: Bug
> Components: Documentation
> Affects Versions: 10.1.3.1
> Environment: DITA files
> Reporter: Halley Pacheco de Oliveira
> Assignee: Bryan Pendleton
> Priority: Minor
> Attachments: cadminconfig86869.diff, cadminconfig86869.diff.html, cadminconfig86869.html, cadminconfig86869.html, cadminconfig86869_a.diff, cadminconfig86869_a.diff.html, docs.diff
>
>
> In this manual is written:
> Managing the Derby Network Server
> The Derby Network Server can run as a stand-alone server, with Derby as an embedded part of the application.
> It can also be managed remotely from a web server by using a servlet interface. You can manage the Network Server by using shell scripts, the command line, or the Network Server API. See Managing the Derby Network Server remotely by using the servlet interface for information about starting and shutting down the Network Server using the servlet interface.
> It seems to me that the sentences of this last paragraph are not in the correct order, and the first and second sentences should be swapped, becoming:
> You can manage the Network Server by using shell scripts, the command line, or the Network Server API. It can also be managed remotely from a web server by using a servlet interface. See Managing the Derby Network Server remotely by using the servlet interface for information about starting and shutting down the Network Server using the servlet interface.
--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.
[jira] Updated: (DERBY-1194) Derby Server and Administration Guide
- Managing the Derby Network Server
Posted by "Rick Hillegas (JIRA)" <ji...@apache.org>.
[ http://issues.apache.org/jira/browse/DERBY-1194?page=all ]
Rick Hillegas updated DERBY-1194:
---------------------------------
Fix Version/s: 10.2.3.0
(was: 10.2.2.0)
Move to 10.2.3.0.
> Derby Server and Administration Guide - Managing the Derby Network Server
> -------------------------------------------------------------------------
>
> Key: DERBY-1194
> URL: http://issues.apache.org/jira/browse/DERBY-1194
> Project: Derby
> Issue Type: Bug
> Components: Documentation
> Affects Versions: 10.1.3.1
> Environment: DITA files
> Reporter: Halley Pacheco de Oliveira
> Priority: Minor
> Fix For: 10.2.3.0
>
> Attachments: cadminconfig86869.diff, cadminconfig86869.diff.html, cadminconfig86869.html, cadminconfig86869_a.diff, cadminconfig86869_a.diff.html
>
>
> In this manual is written:
> Managing the Derby Network Server
> The Derby Network Server can run as a stand-alone server, with Derby as an embedded part of the application.
> It can also be managed remotely from a web server by using a servlet interface. You can manage the Network Server by using shell scripts, the command line, or the Network Server API. See Managing the Derby Network Server remotely by using the servlet interface for information about starting and shutting down the Network Server using the servlet interface.
> It seems to me that the sentences of this last paragraph are not in the correct order, and the first and second sentences should be swapped, becoming:
> You can manage the Network Server by using shell scripts, the command line, or the Network Server API. It can also be managed remotely from a web server by using a servlet interface. See Managing the Derby Network Server remotely by using the servlet interface for information about starting and shutting down the Network Server using the servlet interface.
--
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
[jira] Updated: (DERBY-1194) Derby Server and Administration Guide
- Managing the Derby Network Server
Posted by "Halley Pacheco de Oliveira (JIRA)" <de...@db.apache.org>.
[ http://issues.apache.org/jira/browse/DERBY-1194?page=all ]
Halley Pacheco de Oliveira updated DERBY-1194:
----------------------------------------------
Attachment: cadminconfig86869.html
cadminconfig86869_a.diff
cadminconfig86869_a.diff.html
New manual page file, diff file, and HTMLized diff file.
> Derby Server and Administration Guide - Managing the Derby Network Server
> -------------------------------------------------------------------------
>
> Key: DERBY-1194
> URL: http://issues.apache.org/jira/browse/DERBY-1194
> Project: Derby
> Type: Bug
> Components: Documentation
> Versions: 10.1.2.3
> Environment: DITA files
> Reporter: Halley Pacheco de Oliveira
> Priority: Minor
> Fix For: 10.1.2.3
> Attachments: cadminconfig86869.diff, cadminconfig86869.diff.html, cadminconfig86869.html, cadminconfig86869_a.diff, cadminconfig86869_a.diff.html
>
> In this manual is written:
> Managing the Derby Network Server
> The Derby Network Server can run as a stand-alone server, with Derby as an embedded part of the application.
> It can also be managed remotely from a web server by using a servlet interface. You can manage the Network Server by using shell scripts, the command line, or the Network Server API. See Managing the Derby Network Server remotely by using the servlet interface for information about starting and shutting down the Network Server using the servlet interface.
> It seems to me that the sentences of this last paragraph are not in the correct order, and the first and second sentences should be swapped, becoming:
> You can manage the Network Server by using shell scripts, the command line, or the Network Server API. It can also be managed remotely from a web server by using a servlet interface. See Managing the Derby Network Server remotely by using the servlet interface for information about starting and shutting down the Network Server using the servlet interface.
--
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
[jira] Updated: (DERBY-1194) Clarify wording for ways to manage the
Network Server in the Derby Server and Administration Guide
Posted by "Bryan Pendleton (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/DERBY-1194?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Bryan Pendleton updated DERBY-1194:
-----------------------------------
Assignee: Bryan Pendleton
Summary: Clarify wording for ways to manage the Network Server in the Derby Server and Administration Guide (was: Derby Server and Administration Guide - Managing the Derby Network Server)
There are a lot of good suggestions in the attached patches, and in the various comments.
I will see if I can incorporate these into the current documentation page.
> Clarify wording for ways to manage the Network Server in the Derby Server and Administration Guide
> --------------------------------------------------------------------------------------------------
>
> Key: DERBY-1194
> URL: https://issues.apache.org/jira/browse/DERBY-1194
> Project: Derby
> Issue Type: Bug
> Components: Documentation
> Affects Versions: 10.1.3.1
> Environment: DITA files
> Reporter: Halley Pacheco de Oliveira
> Assignee: Bryan Pendleton
> Priority: Minor
> Attachments: cadminconfig86869.diff, cadminconfig86869.diff.html, cadminconfig86869.html, cadminconfig86869_a.diff, cadminconfig86869_a.diff.html
>
>
> In this manual is written:
> Managing the Derby Network Server
> The Derby Network Server can run as a stand-alone server, with Derby as an embedded part of the application.
> It can also be managed remotely from a web server by using a servlet interface. You can manage the Network Server by using shell scripts, the command line, or the Network Server API. See Managing the Derby Network Server remotely by using the servlet interface for information about starting and shutting down the Network Server using the servlet interface.
> It seems to me that the sentences of this last paragraph are not in the correct order, and the first and second sentences should be swapped, becoming:
> You can manage the Network Server by using shell scripts, the command line, or the Network Server API. It can also be managed remotely from a web server by using a servlet interface. See Managing the Derby Network Server remotely by using the servlet interface for information about starting and shutting down the Network Server using the servlet interface.
--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.
[jira] Commented: (DERBY-1194) Derby Server and Administration
Guide - Managing the Derby Network Server
Posted by "Kathey Marsden (JIRA)" <de...@db.apache.org>.
[ http://issues.apache.org/jira/browse/DERBY-1194?page=comments#action_12422658 ]
Kathey Marsden commented on DERBY-1194:
---------------------------------------
Halley, are you actively working on this issue? Do you still need more reviews of the patch after John's review? If not can we uncheck "Patch Available"? I have not looked at the patch itsself but have a comment on the Jira Summary for this issue. Since the Jira Summary is what prints in the release notes and is the primary search mechnism used by users to search for issues, it is good to have something quite specific so that users don't have to drill down into the description to find out what is fixed by the issue.
For this issue, something like:
"Clarify wording for ways to manage the Network Server in the Derby Server and Administration Guide"
would be a more clear description of what is being fixed.
> Derby Server and Administration Guide - Managing the Derby Network Server
> -------------------------------------------------------------------------
>
> Key: DERBY-1194
> URL: http://issues.apache.org/jira/browse/DERBY-1194
> Project: Derby
> Issue Type: Bug
> Components: Documentation
> Affects Versions: 10.1.2.3
> Environment: DITA files
> Reporter: Halley Pacheco de Oliveira
> Priority: Minor
> Attachments: cadminconfig86869.diff, cadminconfig86869.diff.html, cadminconfig86869.html, cadminconfig86869_a.diff, cadminconfig86869_a.diff.html
>
>
> In this manual is written:
> Managing the Derby Network Server
> The Derby Network Server can run as a stand-alone server, with Derby as an embedded part of the application.
> It can also be managed remotely from a web server by using a servlet interface. You can manage the Network Server by using shell scripts, the command line, or the Network Server API. See Managing the Derby Network Server remotely by using the servlet interface for information about starting and shutting down the Network Server using the servlet interface.
> It seems to me that the sentences of this last paragraph are not in the correct order, and the first and second sentences should be swapped, becoming:
> You can manage the Network Server by using shell scripts, the command line, or the Network Server API. It can also be managed remotely from a web server by using a servlet interface. See Managing the Derby Network Server remotely by using the servlet interface for information about starting and shutting down the Network Server using the servlet interface.
--
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