admin@glassfish.java.net

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

From: Byron Nevins <Byron.Nevins_at_Sun.COM>
Date: Wed, 14 Oct 2009 23:55:59 -0700

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.
>
> 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).
>
> (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.
>
>
> 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.
>
>
> restart-domain:
>
> Like stop-domain, works in either local or remote mode.
>
> 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.


-- 
Byron Nevins Work 408-276-4089, Home 650-359-1290, Cell 650-784-4123 - Sun Microsystems, Inc.