admin@glassfish.java.net

Re: Final Review of create-domain man page

From: Bill Shannon <bill.shannon_at_sun.com>
Date: Tue, 20 Oct 2009 14:26:39 -0700

Dixie Pine wrote on 10/20/09 14:07:
> I removed --user from Synopsis and list of options, added new paragraph
> in description, added
> description for --nopassword. Please review.

I would move the new first paragraph to just before the "local mode only"
paragraph.


There seems to be some inconsistency in the way the default installation
directory is specified, and where other directories are found relative to
it. I think another man page I reviewed used something like
as-install/glassfish/domains. This one uses install-dir/domains.

This confused me at first on the other man pages until I realized that
under the installation directory there really is another "glassfish"
directory (which is what I usually think of as the install directory).


Change --nopassword to:

   Specifies whether the administrative user will have a password.
   If false (the default), the password is specified by the
   AS_ADMIN_PASSWORD entry in the asadmin password file (specified
   by the --passwordfile option), or, if not set, the user is prompted
   for the password. If true, the administrative user is created with
   no password. If a user name for the domain is not specified with
   the --user option, and the --nopassword option is set to true, the
   default user name admin is used.


So much more could be said about the use of ports...

For example, I believe you can't run two domains on the same machine
unless you use a different --portbase when creating them, or you
specify all the ports using --domainproperties when creating at
least one of them. That is, creating two domains and specifying
only different values for --adminport and --instanceport is not
sufficient to allow them both to run at the same time.