Details

    • Type: Bug Bug
    • Status: Resolved
    • Priority: Major Major
    • Resolution: Fixed
    • Affects Version/s: 3.1_b41
    • Fix Version/s: 3.1
    • Component/s: docs
    • Labels:
      None
    • Environment:

      glassfish mq jmsra

      Description

      [Converting this to a blanket issue to cover all the changes to the JMS-related man pages]

      -------------------------------------------------------------
      Original issue:
      "asadmin -help configure-jms-cluster displays option [-force=

      {false|true}]"

      asadmin --help configure-jms-cluster displays

      configure-jms-cluster [--help]
      [--clustertype={conventional|enhanced}]
      [--configstoretype={masterbroker|shareddb}]
      [--messagestoretype={file|jdbc}]
      [--dbvendor database-vendor]
      [--dbuser database-user]
      [--dburl database-url]
      [--property property-list]
      [--force={false|true}

      ]
      cluster-name

      The --force option has been removed and asadmin still shows it.

      -------------------------------------------------------------
      Review wiki page comments from sarada_k:

      Following are the Comments for man pages:

      1. configure-jms-cluster

      Under Options->clustertype, it should be configstoretype instead of configstorstype

      2.create-jmsdest

      Under Options, remove -T option

      3. create-jms-host

      create-jms-host doesn't work without mqusername & mqpassword options. So example needs to be updated with those options. Are they part of passfile???

      4. delete-jmsdest

      remove -T option under Options

      5.flush-jmsdest

      remove -T option under Options

      6.jms-ping, create-jms-resource etc

      I am seeing the connector statements printed along with jms statements. I am not sure if they should be included in the examples.

      For example:
      intg-v60x-1# ./asadmin jms-ping
      JMS-ping command executed successfully
      Connector resource test_jms_adapter created.
      Command jms-ping executed successfully.

      7.list-jmsdest

      remove -T option under Options

      8.I am also seeing "This subcommand is supported in remote mode only" for most of the jms commands. Is it jms REMOTE mode or something completely different? If it is jms REMOTE mode then the comment should be removed for most of the commands.

      -------------------------------------------------------------
      Review wiki comments from sats_i

      1. change-master-broker
      Its probably worth mentioning here that by default the master broker is the first configured instance in the GF cluster

      2. configure-jms-cluster
      Remove the --force option. This is no longer valid.

      3. create-jms-resource/delete-jms-resource/list-jms-resources:
      config is not a valid target type. Valid targets for these commands are - server, domain, cluster_name, instance_name

      -------------------------------------------------------------
      Email from mathim:

      Adding to Sarada's Comments.

      change-master-broker : It is mentioned that this command is supported only in remote mode. Are you referring to Message Queue mode in glassfish (as in Embedded, Local, Remote)? If not please explain what this refers to. If so it may not be true. This command works with other modes as well.

      configure-jms-cluster :
      1) The --force option has been removed from the command.
      2) This command also mentions that it is supported only in remote mode. Please clarify this

      thanks,
      -Mathi

        Issue Links

          Activity

          mathim created issue -
          mathim made changes -
          Field Original Value New Value
          Assignee Nazrul [ ai109478 ] Satish Kumar [ sats ]
          Paul Davies made changes -
          Assignee Satish Kumar [ sats ] Mike Fitch [ oncered ]
          Fix Version/s 3.1 [ 10968 ]
          Component/s docs [ 10597 ]
          Paul Davies made changes -
          Priority Minor [ 4 ] Major [ 3 ]
          Paul Davies made changes -
          Link This issue blocks GLASSFISH-15929 [ GLASSFISH-15929 ]
          Mike Fitch made changes -
          Summary asadmin --help configure-jms-cluster displays option [--force={false|true}] man-page-review: jms CLIs
          Description asadmin --help configure-jms-cluster displays

               configure-jms-cluster [--help]
               [--clustertype={conventional|enhanced}]
               [--configstoretype={masterbroker|shareddb}]
               [--messagestoretype={file|jdbc}]
               [--dbvendor database-vendor]
               [--dbuser database-user]
               [--dburl database-url]
               [--property property-list]
               [--force={false|true}]
               cluster-name

          The --force option has been removed and asadmin still shows it.
          [Converting this to a blanket issue to cover all the changes to the JMS-related man pages]

          -------------------------------------------------------------
          Original issue:
          "asadmin --help configure-jms-cluster displays option [--force={false|true}]"

          asadmin --help configure-jms-cluster displays

               configure-jms-cluster [--help]
               [--clustertype={conventional|enhanced}]
               [--configstoretype={masterbroker|shareddb}]
               [--messagestoretype={file|jdbc}]
               [--dbvendor database-vendor]
               [--dbuser database-user]
               [--dburl database-url]
               [--property property-list]
               [--force={false|true}]
               cluster-name

          The --force option has been removed and asadmin still shows it.

          -------------------------------------------------------------
          Review wiki page comments from sarada_k:

          Following are the Comments for man pages:

          1. configure-jms-cluster

          Under Options->clustertype, it should be configstoretype instead of configstorstype

          2.create-jmsdest

          Under Options, remove -T option

          3. create-jms-host

          create-jms-host doesn't work without mqusername & mqpassword options. So example needs to be updated with those options. Are they part of passfile???

          4. delete-jmsdest

          remove -T option under Options

          5.flush-jmsdest

          remove -T option under Options

          6.jms-ping, create-jms-resource etc

          I am seeing the connector statements printed along with jms statements. I am not sure if they should be included in the examples.

          For example:
          intg-v60x-1# ./asadmin jms-ping
          JMS-ping command executed successfully
          Connector resource test_jms_adapter created.
          Command jms-ping executed successfully.

          7.list-jmsdest

          remove -T option under Options

          8.I am also seeing "This subcommand is supported in remote mode only" for most of the jms commands. Is it jms REMOTE mode or something completely different? If it is jms REMOTE mode then the comment should be removed for most of the commands.

          -------------------------------------------------------------
          Review wiki comments from sats_i

          1. change-master-broker
          Its probably worth mentioning here that by default the master broker is the first configured instance in the GF cluster

          2. configure-jms-cluster
          Remove the --force option. This is no longer valid.

          3. create-jms-resource/delete-jms-resource/list-jms-resources:
          config is not a valid target type. Valid targets for these commands are - server, domain, cluster_name, instance_name

          -------------------------------------------------------------
          Email from mathim:

          Adding to Sarada's Comments.

          change-master-broker : It is mentioned that this command is supported only in remote mode. Are you referring to Message Queue mode in glassfish (as in Embedded, Local, Remote)? If not please explain what this refers to. If so it may not be true. This command works with other modes as well.

          configure-jms-cluster :
          1) The --force option has been removed from the command.
          2) This command also mentions that it is supported only in remote mode. Please clarify this

          thanks,
          -Mathi
          Mike Fitch made changes -
          Status Open [ 1 ] Resolved [ 5 ]
          Resolution Fixed [ 1 ]

            People

            • Assignee:
              Mike Fitch
              Reporter:
              mathim
            • Votes:
              0 Vote for this issue
              Watchers:
              1 Start watching this issue

              Dates

              • Created:
                Updated:
                Resolved: