admin@glassfish.java.net

Re: Review of start-domain, stop-domain, and restart-domainsman pages

From: Dixie Pine <Dixie.Pine_at_Sun.COM>
Date: Mon, 19 Oct 2009 15:06:15 -0700

Final pdfs attached.

On 10/14/09 23:55, Byron Nevins wrote:
>
>
> Bill Shannon wrote:
>
>> start-domain:
>>
>> Can someone explain the Mac OS X comment:
>>
>> Note – On the Mac OS X platform, processes can bind to the same
>> port. To
>> avoid this problem, do not start multiple domains with the same
>> port number
>> at the same time.
Did you want me to delete this Mac material? I couldn't tell so I didn't
(yet).
>>
>> That can't really be true, right?
>>
>> --verbose doesn't open a separate console window, right?
>>
>> And can't you kill the server on Windows using CTRL-C?
>>
>> Change the description to something like:
>>
>> Detailed server startup and log messages are displayed to the console
>> window and the start-domain command waits until the server is stopped.
>> If the domain is later restarted by using the restart-domain command
>> (e.g., issued from a different console window), messages continue to
>> be displayed in this console window. You can kill the server by
>> typing CTRL-C, or get a thread dump for the server by using CTRL-\
>> (UNIX) or CTRL-Break (Windows).
Added.
>>
>> (Byron, that's correct, right?)
>
> That is correct, sir!
>
>>
>> Use this for --upgrade:
>>
>> Upgrade the server from a previous release. The server process is
>> started,
>> the configuration is modified to be compatible with this release of
>> Enterprise Server, and the server process terminates. Normally, if
>> start-domain detects that the configuration is from an older
>> release of
>> Enterprise Server, the domain is upgraded automatically before being
>> started. Users should not need to use this option explicitly.
DONE
>>
>>
>> stop-domain:
>>
>> stop-domain takes all the asadmin utility options and is supported in
>> local or remote mode.
>> If you specify a host name, it assumes you're
>> operating in remote mode and you must correctly authenticate to the
>> remote server. In local mode you normally do not need to authenticate
>> to the server if you're running as the same user who started the server.
DONE
>>
>>
>> restart-domain:
>>
>> Like stop-domain, works in either local or remote mode.
Added the descriptive text.
>>
>> If the domain is stopped, restart-domain works like start-domain
>> (you're not asked).
>>
>> I don't believe the paragraph about using start-domain to restart the
>> domain is true.
Removed
>
>