adds a new network listener socket


create-network-listener [--help]
[--address address] 
--listenerport listener-port 
[--threadpool thread-pool] 
--protocol protocol 
[--transport transport] 
[--target target]


The create-network-listener subcommand creates a network listener. This subcommand is supported in remote mode only.


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


You can use the create-http-listener subcommand to create a network listener that uses the HTTP protocol without having to first create a protocol, transport, or HTTP configuration. This subcommand is a convenient shortcut, but it gives access to only a limited number of options.



Displays the help text for the subcommand.


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


The port number to create the listen socket on. Legal values are 1-65535. On UNIX, creating sockets that listen on ports 1-1024 requires superuser privileges. Configuring an SSL listen socket to listen on port 443 is standard.


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


The name of the protocol for this listener.


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


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


If set to true, mod_jk is enabled for this listener. The default is false.


Creates the network listener only on the specified target. Valid values are as follows:


Creates the network listener on the default server instance. This is the default value.


Creates the network listener in the specified configuration.


Creates the network listener on all server instances in the specified cluster.


Creates the network listener on the specified standalone server instance.



The name of the network listener.


Example 1   Creating a Network Listener

The following command creates a network listener named sampleListener that is not enabled at runtime:

asadmin> create-network-listener --listenerport 7272 protocol http-1 
--enabled=false sampleListener
Command create-network-listener executed successfully.

Exit Status


command executed successfully


error in executing the command

See Also

delete-network-listener(1), list-network-listeners(1), create-transport(1), create-protocol(1), create-threadpool(1), create-http-listener(1)