admin@glassfish.java.net

Re: Review of create-domain, delete-domain, and list-domains man pages

From: Kedar Mhaswade <Kedar.Mhaswade_at_Sun.COM>
Date: Wed, 14 Oct 2009 17:15:15 -0700

Dixie Pine wrote:
> Hi Kedar,
>
> You are listed as owner on these man pages. Please review quickly so I
> can get any fixes in for hard code freeze. Our deadline is friday Oct. 9
>
> * create-domain has a new option: checkports.
>
> * Question on delete-domain. Is this really the syntax:
>
> Usage: asadmin [asadmin-utility-options] delete-domain [--domaindir
> <domaindir>] *[--terse=false] [--ec ho=false]* [-?|--help=false] domain_name
> (from the CLI in build 66)

Yes, same as v2.
>
> Usually --terse and --echo are strictly asadmin utility options. But
> from this syntax, they are also subcommand options. This looks like a
> mistake on engineering end. However, if they are really subcommand
> options I can add them into the delete-domain man page. If so, these
> options probably need some additional explanation as to how they relate
> to the delete-domain subcommand.
>
> thanks,
> Dixie

create-domain:
1- Please redo the examples.
2- Please explain the authentication and the no-password admin user as
    described by Bill (a while ago).
3- Replace (--profile developer | cluster | enterprise) by --profile
    profile-name. (Anyway, the option is silently ignored).
4- Add somewhere:
   The create-domain process can be customized in that if there are
   domain customizers found in domain.xml, they are processed.
   (Get the details from Jerome, if needed).
5- Remove the statement "Either the --adminport option or the --portbase
option must be specified." -- it's no more true.
6- Replace the paragraph:

In addition to being an administrative boundary, a domain is also a
fully compliant Java EE
server. This means that you can deploy your Java EE applications to the
domain and run them
when the domain is started. A domain provides all the necessary
environment and services
essential to run the applications.
with:

A GlassFish v3 domain is a Java EE 6 compliant server. (The above
paragraph is more for enterprise scenario where they need
dedicated "admin servers").

list-domains:
1- The default value for domains-dir is "generally" as-install/domains,
    but it can be different as well. It's decided by a variable
    AS_DEF_DOMAINS_PATH in install-dir/config/asenv.conf

Thanks!