admin@glassfish.java.net

Re: Please review: fix for Issue 6199: --keytool option is not in create-domain manpage.

From: Kedar Mhaswade <Kedar.Mhaswade_at_Sun.COM>
Date: Tue, 23 Sep 2008 11:34:55 -0700

Paul,

This manpage is grossly out-of-date. Here are some comments:

- Change --domaindir to say [--domaindir domain folder's parent folder]
- --profile option is unsupported for Prelude, --template too. In general,
   downplay on the profile related conversation in the entire manpage.
- Remove all the examples that use --profile and replace them with current
   ones.
- Change the --keytooloptions description as below:

Specifies an optional list of name-value pairs of keytool options for a
self-signed server certificate generated during create-domain process.

Each pair in the list must be separated by the ':'.
The following properties are *respected*:
CN - Specifies the common name of the host that is to be used for the
self-signed certificate.

This option name is case insensitive.

By default, the value for CN is same as fully qualified name of the
machine where the create-domain command is run.

(Also, show the usage of this option in the examples section).

- Mention somewhere that not all ports are required for Prelude. This is
   a carry-over from V2 (don't say that :)).

Thanks!

-Kedar


Paul Davies wrote:
> Hi,
>
> Please review the fixes for Issue 6199 in the attached copy of the
> create-domain(1M) man page. This issue is a result of the addition of
> --keytool to fix Issue 5722
> <https://glassfish.dev.java.net/issues/show_bug.cgi?id=5722>.
>
> The fixes are marked with change bars.
>
> Please provide your feedback by end of day Wednesday September 23, 2008.
>
> Thank you.
>
> --
> Paul Davies, Senior Technical Writer, Sun Microsystems, Inc.
> http://blogs.sun.com/techscribe/
>