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?)
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.