admin@glassfish.java.net

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

From: Dixie Pine <Dixie.Pine_at_Sun.COM>
Date: Tue, 20 Oct 2009 10:27:42 -0700

On 10/19/09 18:16, Bill Shannon wrote:
> --user really is just an asadmin option, except with create-domain
> we make it a *required* option. There was no other good way to specify
> that requirement in the command usage so I added it as a subcommand
> option that is required.
>
okay. What description do you want for the option? The asadmin option
version says this:

--user The user name of the authorized administsrative user of the DAS.
> Dixie Pine wrote on 10/16/09 5:38 PM:
>
>> HI Kedar,
>> I've applied your review and I have questions.
>>
>> ?? On the CLI, --user shows up a subcommand option so I included it in
>> the examples. Then I got a deprecated message when I ran a command with
>> --user in it, which I think means that --user should not be in the
>> subcommand syntax. Should I remove --user from the synopsis and options
>> list in the man page?
>>
>> On 10/14/09 17:15, Kedar Mhaswade wrote:
>>
>>> 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.
>>>
>> ?? And this seems wrong for v3. Should terse and echo really be
>> subcommand options for any subcommand in v3? No other local commands
>> have them.
>>
>>>> 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.
>>>
>> DONE
>>
>>> 2- Please explain the authentication and the no-password admin user as
>>> described by Bill (a while ago).
>>>
>> ??Any idea how to find this? Was it in an email? I'm not sure I would
>> recognize it...
>>
>>> 3- Replace (--profile developer | cluster | enterprise) by --profile
>>> profile-name. (Anyway, the option is silently ignored).
>>>
>> A number of the options say "don't use this option..." and the
>> description is hidden. If you want me to restore any of those
>> descriptions because the option is now in use for v3, let me know.
>> Otherwise, I leave then as they were for Prelude.
>>
>>> 4- Add somewhere:
>>> The create-domain process can be customized in that if there are
>>> domain customizers found in domain.xml, they are processed.
>>>
>> DONE
>>
>>> (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.
>>>
>> DONE
>>
>>> 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").
>>>
>> DONE
>>
>>> 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
>>>
>> I redid the create-domain Synopsis because it didn't match the CLI
>> command I ran. There are two additional options for which I need
>> descriptions as the options apply to create-domain:
>>
>> -user --- I took a guess at this one -
>> -nopassword ---What do you want to say about this one?
>>
>> Dixie
>>
>>
>> ------------------------------------------------------------------------
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: admin-unsubscribe_at_glassfish.dev.java.net
>> For additional commands, e-mail: admin-help_at_glassfish.dev.java.net
>>
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: admin-unsubscribe_at_glassfish.dev.java.net
> For additional commands, e-mail: admin-help_at_glassfish.dev.java.net
>
>