admin@glassfish.java.net

Re: Final Review of create-domain man page

From: kedar <Kedar.Mhaswade_at_Sun.COM>
Date: Tue, 20 Oct 2009 14:53:13 -0700

Bill Shannon wrote:
> 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.

The former is correct. Yeah, it's somewhat confusing.

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

We have the zip structure as:
/gf -----|
      glassfishv3
          ---------| bin
          ---------| glassfish
                          -----| bin
                                   -----| asadmin (the admin CLI)
                          -----| config
                                   -----| asenv.conf (server's configuration)
                          -----| modules (the OSGi bundles etc.)
                          -----| domains (location of default admin domains)
                                     -----| domain1 (the "default" domain)
                          -----| docs (some doc pages)
                          -----| (optional)databases (default database)
          ---------| javadb
          ---------| mq

>
> 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.
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: admin-unsubscribe_at_glassfish.dev.java.net
> For additional commands, e-mail: admin-help_at_glassfish.dev.java.net
>