[jboss-as7-dev] Concerns about options for standalone and domain scripts

[Brian Stansberry]

On 9/12/11 6:14 AM, Rostislav Svoboda wrote:
> Hi guys.
>
> I have concerns about options for standalone and domain .sh/.bat scripts.
>
> Current options for standalone.sh are:
> 10:28:27,893 INFO  [stdout] Usage: ./standalone.sh [args...]
> 10:28:27,893 INFO  [stdout]
> 10:28:27,893 INFO  [stdout] where args include:
> 10:28:27,894 INFO  [stdout]     -b=<value>                          Set system property jboss.bind.address.public to the given value
> 10:28:27,894 INFO  [stdout]     -b<interface>=<value>               Set system property jboss.bind.address.<interface>  to the given value
> 10:28:27,894 INFO  [stdout]     -D<name>[=<value>]                 Set a system property
> 10:28:27,894 INFO  [stdout]     -h                                 Display this message and exit
> 10:28:27,894 INFO  [stdout]     --help                             Display this message and exit
> 10:28:27,894 INFO  [stdout]     -P=<url>                            Load system properties from the given url
> 10:28:27,894 INFO  [stdout]     --properties=<url>                  Load system properties from the given url
> 10:28:27,895 INFO  [stdout]     --server-config=<config>            Name of the server configuration file to use (default is "standalone.xml")
> 10:28:27,895 INFO  [stdout]     -V                                 Print version and exit
> 10:28:27,895 INFO  [stdout]
> 10:28:27,895 INFO  [stdout]     --version                          Print version and exit
>
>
> ** Version vs. help options:  (applies to domain script too)
> -V or --version   vs.   -h or --help
> Shouldn't be '-h' changed to '-H' or '-V' changed to '-v' to stay consistent?
>

Those are inherited from previous versions of JBoss, so I didn't change 
them.

> ** Empty line before --version option   (applies to domain script too)
> Is it intentional?
>

No.

> ** Bind address definition -- https://github.com/jbossas/jboss-as/pull/248
> Shouldn't be legacy syntax of -b xxx mentioned in help too? I know it's against formats described in 'Other command line parameters' chapter of Admin Guide ... but it would prevent confusion of many end users.
>

I've wanted to avoid the "-x value" syntax becoming a standard that we 
have to support and document for any switch we create forever. So I've 
been reluctant to talk about them in our standard docs. I admit that's a 
bit confusing though.

What the heck; there are only 3 legacy switches that need the space 
syntax (-b, -P, --properties) so we can document those.

> ** In help for domain there is nothing about option '-b'
> Command 'bin/domain.sh --domain-config=domain-preview.xml -b=0.0.0.0 -bmanagement=0.0.0.0' works as expected and java processes are listening on 0.0.0.0.
> Is there reason why '-b' options aren't described in help for domain.sh?
>

Nope, I just forgot to add it in. Thanks for pointing it out.

>
> Kind regards.
> Rosta
> _______________________________________________
> jboss-as7-dev mailing list
> jboss-as7-dev at lists.jboss.org
> https://lists.jboss.org/mailman/listinfo/jboss-as7-dev


-- 
Brian Stansberry
Principal Software Engineer
JBoss by Red Hat