create-transport
Adds a new transport.
Synopsis
asadmin [asadmin-options] create-transport [--help]
[--acceptorthreads acceptor-threads]
[--buffersizebytes buffer-size]
[--bytebuffertype byte-buffer-type]
[--classname class-name]
[--displayconfiguration={false|true}]
[--enablesnoop={false|true}]
[--idlekeytimeoutseconds idle-key-timeout]
[--maxconnectionscount max-connections]
[--readtimeoutmillis read-timeout]
[--writetimeoutmillis write-timeout]
[--selectionkeyhandler selection-key-handler]
[--selectorpolltimeoutmillis selector-poll-timeout]
[--tcpnodelay={false|true}]
[--target target]
transport-name
Description
The create-transport
subcommand creates a transport for a network listener. This subcommand is supported in remote mode only.
Options
- asadmin-options
-
Options for the
asadmin
utility. For information about these options, see theasadmin
help page. --help
-?
-
Displays the help text for the subcommand.
--acceptorthreads
-
The number of acceptor threads for the transport. The recommended value is the number of processors in the machine. The default value is
1
. --buffersizebytes
-
The size, in bytes, of the buffer to be provided for input streams created by the network listener that references this transport. The default value is
8192
. --bytebuffertype
-
The type of the buffer to be provided for input streams created by a network-listener. Allowed values are
HEAP
andDIRECT
. The default value isHEAP
. --classname
-
The fully qualified name of the Java class that implements the transport. The default is
org.glassfish.grizzly.TCPSelectorHandler
. --displayconfiguration
-
If
true
, flushes the internal network configuration to the server log. Useful for debugging, but reduces performance. The default isfalse
. --enablesnoop
-
If
true
, writes request/response information to the server log. Useful for debugging, but reduces performance. The default isfalse
. --idlekeytimeoutseconds
-
The idle key timeout. The default is
30
seconds. --maxconnectionscount
-
The maximum number of connections for the network listener that references this transport. A value of
-1
specifies no limit. The default value is4096
. --readtimeoutmillis
-
The amount of time the server waits during the header and body parsing phase. The default is
30000
milliseconds, or 30 seconds. --writetimeoutmillis
-
The amount of time the server waits before considering the remote client disconnected when writing the response. The default is
30000
milliseconds, or 30 seconds. --selectionkeyhandler
-
The name of the selection key handler associated with this transport. There is no default.
--selectorpolltimeoutmillis
-
The number of milliseconds a NIO Selector blocks waiting for events (user requests). The default value is
1000
milliseconds. --tcpnodelay
-
If
true
, the default, enablesTCP_NODELAY
(also called Nagle’s algorithm). The default isfalse
. --target
-
Creates the transport only on the specified target. Valid values are as follows:
server
-
Creates the transport on the default server instance. This is the default value.
- configuration-name
-
Creates the transport in the specified configuration.
- cluster-name
-
Creates the transport on all server instances in the specified cluster.
- standalone-instance-name
-
Creates the transport on the specified standalone server instance.
Examples
Example 1 Creating a Transport
The following command creates a transport named http1-trans
that uses a non-default number of acceptor threads:
asadmin> create-transport --acceptorthreads 100 http1-trans
Command create-transport executed successfully.