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 the asadmin(1M) 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 and DIRECT. The default value is HEAP.

--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 is false.

--enablesnoop

If true, writes request/response information to the server log. Useful for debugging, but reduces performance. The default is false.

--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 is 4096.

--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, enables TCP_NODELAY (also called Nagle’s algorithm). The default is false.

--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.

Operands

transport-name: The name of the transport.

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.

Exit Status

0: command executed successfully
1: error in executing the command