glassfish
  1. glassfish
  2. GLASSFISH-9954

Improve create-transport man page (was: remove the not frequently used options in create-transport)

    Details

    • Type: Improvement Improvement
    • Status: Open
    • Priority: Major Major
    • Resolution: Unresolved
    • Affects Version/s: V3
    • Fix Version/s: not determined
    • Component/s: docs
    • Labels:
      None
    • Environment:

      Operating System: All
      Platform: PC

      Description

      All the parameters used in transport is put as options in create-transport
      command. We shouldn't have put all the attributes available as a command options
      which makes the command more complex to type and use.

      Like create-protocol command the minimal set of frequently used options must be
      part of the command , rest of them can be omitted and put as defaults in config.

      If one wants to modify those they can always to get/set

      Usage: asadmin [asadmin-utility-options] create-transport [--acceptorthreads -1]
      [--buffersizebytes 8192] [--bytebuffertype HEAP] [--classname
      com.sun.grizzly.TCPSelectorHandler] [--displayconfiguration false]
      [--enablesnoop false] [--idlekeytimeoutseconds 30] [--maxconnectionscount 4096]
      [--readtimeoutmillis 30000] [--writetimeoutmillis 30000] [--selectionkeyhandler
      <selectionkeyhandler>] [--selectorpolltimeoutmillis <selectorpolltimeoutmillis>]
      [--tcpnodelay <tcpnodelay>] [-?|--help=false] transportname

      Usage: asadmin [asadmin-utility-options] create-protocol [--securityenabled
      <securityenabled>] [-?|--help=false] protocolname

        Activity

        Hide
        Tom Mueller added a comment -

        Bulk update to change fix version to "not determined" for all issues still open but with a fix version for a released version.

        Show
        Tom Mueller added a comment - Bulk update to change fix version to "not determined" for all issues still open but with a fix version for a released version.
        Hide
        Paul Davies added a comment -

        Under consideration for 3.1.1

        Show
        Paul Davies added a comment - Under consideration for 3.1.1
        Hide
        Mike Fitch added a comment -

        Will investigate reorganizing the man page in a future release.

        Show
        Mike Fitch added a comment - Will investigate reorganizing the man page in a future release.
        Hide
        Bill Shannon added a comment -

        Good or bad, we've already got all those options in v3, so removing them
        would be a compatibility issue. Instead, the man page for this command
        could use some improvement to describe which options are likely or unlikely
        to be used, as well as giving more useful usage examples.

        Show
        Bill Shannon added a comment - Good or bad, we've already got all those options in v3, so removing them would be a compatibility issue. Instead, the man page for this command could use some improvement to describe which options are likely or unlikely to be used, as well as giving more useful usage examples.
        Hide
        Tom Mueller added a comment -

        Nandini no longer on project.

        Show
        Tom Mueller added a comment - Nandini no longer on project.
        Hide
        sankarpn added a comment -

        ok, made as RFE. But I request this to be fixed.

        Show
        sankarpn added a comment - ok, made as RFE. But I request this to be fixed.
        Hide
        Bill Shannon added a comment -

        This sounds like an enhancement request.

        Reassigning to Nandini.

        Show
        Bill Shannon added a comment - This sounds like an enhancement request. Reassigning to Nandini.

          People

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

            Dates

            • Created:
              Updated: