<< Back to previous view

[GLASSFISH-9954] Improve create-transport man page (was: remove the not frequently used options in create-transport) Created: 02/Oct/09  Updated: 06/Mar/12

Status: Open
Project: glassfish
Component/s: docs
Affects Version/s: V3
Fix Version/s: not determined

Type: Improvement Priority: Major
Reporter: sankarpn Assignee: Mike Fitch
Resolution: Unresolved Votes: 0
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified
Environment:

Operating System: All
Platform: PC


Issuezilla Id: 9,954
Tags: 3_1-exclude
Participants: Bill Shannon, Mike Fitch, Paul Davies, sankarpn and Tom Mueller

 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



 Comments   
Comment by Bill Shannon [ 02/Oct/09 04:44 PM ]

This sounds like an enhancement request.

Reassigning to Nandini.

Comment by sankarpn [ 03/Oct/09 07:52 AM ]

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

Comment by Tom Mueller [ 23/Jun/10 10:32 AM ]

Nandini no longer on project.

Comment by Bill Shannon [ 23/Jun/10 01:09 PM ]

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.

Comment by Mike Fitch [ 03/Jan/11 12:07 PM ]

Will investigate reorganizing the man page in a future release.

Comment by Paul Davies [ 27/May/11 10:35 AM ]

Under consideration for 3.1.1

Comment by Tom Mueller [ 06/Mar/12 09:59 PM ]

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

Generated at Fri Apr 18 22:13:19 UTC 2014 using JIRA 4.0.2#472.