Visit Azul.com Support

Set-Network-Listener-Configuration

Table of Contents
Need help?
Schedule a consultation with an Azul performance expert.
Contact Us

Helps to modify an existing network listener.

Synopsis

 
asadmin [asadmin-options] set-network-listener-configuration [--help] [--enabled={true|false}] [--dynamic={}true|false}] [--address=address] [--listenerport=port] [--listenerportrange=portrange] [--threadpool=threadpool] [--protocol=protocol] [--transport=transport] [--jkenabled=true|false] [--target target] listener-name

Description

The set-network-listener-configuration subcommand modifies an existing network listener.

Note
If you edit the admin-listener network listener, you must restart the server for the changes to take effect. The Administration Console will not tell you that a restart is required in this case.

Options

asadmin-options: Options for the asadmin utility. For information about these options, see the asadmin help page.

--help: -?: Displays the help text for the subcommand.

--address: The IP address or the hostname (resolvable by DNS).

--listenerport: The port on which the network listener is going to be listening.

--listenerPortRange: Port range which the network listener can bind to.

--threadpool: The name of the thread pool for this listener. Specifying a thread pool is optional. The default is http-thread-pool.

--protocol: The name of the protocol for this listener.

--transport: The name of the transport for this listener. Specifying a transport is optional. The default value is tcp.

--enabled: If set to true, the default, the listener is enabled at runtime.

--jkenabled: If enabled, the network listener will become an Apache mod-jk listener. The default value is false.

--target: Creates the network listener only on the specified target. Valid values are as follows:
server;; Creates the network listener on the default server instance. This is the default value. configuration-name;; Creates the network listener in the specified configuration. cluster-name;; Creates the network listener on all server instances in the specified cluster. standalone-instance-name;; Creates the network listener on the specified standalone server instance.

Operands

name: The name of the network listener.

Examples

Example 1 Modifying a Network Listener

The following command modifies a network listener named sampleListener:

 
asadmin set-network-listener-configuration --dynamic true --enabled=false --listenerport 8080 sampleListener Command set-network-listener-configuration executed successfully.