[jboss-jira] [JBoss JIRA] Commented: (AS7-1738) CLI usability: unclear that the CLI is managing a domain not a host

[Radoslav Husar (JIRA)]

    [ https://issues.jboss.org/browse/AS7-1738?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12626452#comment-12626452 ] 

Radoslav Husar commented on AS7-1738:
-------------------------------------

Agreed, but in #2 there is the synopsis: 
{code}Synopsis:    add-jms-queue [--profile=profile_name] ...{code}
the convention is that [, ] mean that its optional (I see its explained later on, but who reads that? ;-))

> CLI usability: unclear that the CLI is managing a domain not a host
> -------------------------------------------------------------------
>
>                 Key: AS7-1738
>                 URL: https://issues.jboss.org/browse/AS7-1738
>             Project: Application Server 7
>          Issue Type: Bug
>          Components: CLI
>    Affects Versions: 7.0.0.Final, 7.0.1.Final
>            Reporter: Radoslav Husar
>            Assignee: Alexey Loubyansky
>            Priority: Minor
>
> Looks to me that the CLI is behaving differently if you are running in a domain mode or in a stadnalone mode managing just a host. However it is not really clear from the CLI help messages.
> In the following log
> * the console does not say its running in the domain mode
> * claims that the --profile argument is optional even though its indeed required
> * does not say that it is not the master domain controller and refuses all changes anyway
> {code}
> [domain at rhusar:9999 /] add-jms-queue --help
> Synopsis:    add-jms-queue [--profile=profile_name] --name=queue_name [--entries=entry(,entry)*] [--selector=selector_name] [--durable=(true|false)]
> Description:    creates a JMS queue
> Arguments:
>     profile        - is allowed and required only in the domain mode, specifies the profile
>                 in which the JMS resource should be created. 
>     name        - the name of the queue.
>     
>     entries        - an optional comma-separated list of JNDI names the queue should be bound under.
>                   If not present, the name will be used as the JNDI name.
>                   
>     selector    - optional selector.
>     
>     durable        - optional, specifies whether the queue should be durable or not (the default is true).
> [domain at rhusar:9999 /] add-jms-queue --profile=ha --name=rQ
> Operation add for address [
>     ("profile" => "ha"),
>     ("subsystem" => "messaging"),
>     ("jms-queue" => "rQ")
> ] can only handled by the master Domain Controller; this host is not the master Domain Controller
> [domain at rhusar:9999 /] add-jms-queue --name=rQ             
> --profile argument value is missing.
> [domain at rhusar:9999 /] quit
> Closed connection to rhusar:9999
> {code}

--
This message is automatically generated by JIRA.
For more information on JIRA, see: http://www.atlassian.com/software/jira