By default, when Enterprise Server starts, the following HTTP listeners are started automatically:
HTTP listeners associated with the virtual server named server:
The listener named http-listener-1 does not have security enabled.
The listener named http-listener-2 has security enabled
An HTTP listener named admin-listener, associated with the virtual server named __asadmin. For this listener, security is not enabled.
The following table describes the Enterprise Server default ports for the listeners that use ports.
Table 16–1 Default Ports for Listeners
Listener |
Default Port |
Description |
---|---|---|
Administrative server |
4848 |
A domain’s administrative server is accessed by the Administration Console and the asadmin utility. For the Administration Console, specify the port number in the URL of the browser. When running an asadmin subcommand remotely, specify the port number by using the --port option. |
HTTP |
8080 |
The web server listens for HTTP requests on a port. To access deployed web applications and services, clients connect to this port. |
HTTPS |
8181 |
Web applications configured for secure communications listen on a separate port. |
The following topics are addressed here:
Use the subcommands in this procedure to create an internet connection with the full range of listener options. A network listener is created behind the scenes. For the shortcut version of this process , see To Create an HTTP Network Listener.
Ensure that the server is running.
Remote subcommands require a running server.
Create an HTTP or HTTPS protocol by using the create-protocol(1) subcommand with the --securityenabled option.
To use the built-in http-listener-1 HTTP protocol, or http-listener-2 HTTPS protocol, skip this step.
Create an HTTP configuration by using the create-http(1) subcommand.
To use a built-in protocol, skip this step.
Create a transport by using the create-transport(1) subcommand.
To use the built-in tcp transport, skip this step.
(Optional) Create a thread pool by using the create-threadpool(1) subcommand.
To avoid using a thread pool, or to use the built-in http-thread-pool thread pool, skip this step.
For additional thread pool information, see Chapter 5, Administering Thread Pools.
Create an HTTP listener by using the create-network-listener(1) subcommand.
Specify a protocol and transport, optionally a thread pool.
To apply your changes, restart Enterprise Server.
See To Restart a Domain.
You can also view the full syntax and options of the subcommand by typing a command such as asadmin help create-http-listener at the command line.
Each HTTP listener has an HTTP protocol, which is created either by using the create-protocol subcommand or by using the built-in protocols that are applied when you follow the instructions in To Create an HTTP Network Listener.
The following topics are addressed here:
Use the create-protocol subcommand in remote mode to create a protocol.
Ensure that the server is running.
Remote subcommands require a running server.
Create a protocol by using the create-protocol(1)
Information about options and properties for the subcommand are included in this help page.
This example creates a protocol named http-1 with security enabled.
asadmin> create-protocol --securityenabled=true http-1 Command create-protocol executed successfully. |
You can also view the full syntax and options of the subcommand by typing asadmin help create-protocol at the command line.
Use the list-protocols subcommand in remote mode to list the existing HTTP protocols.
Ensure that the server is running.
Remote subcommands require a running server.
List the existing protocols by using the list-protocols(1) subcommand.
This example lists the existing protocols.
asadmin> list-protocols admin-listener http-1 http-listener-1 http-listener-2 Command list-protocols executed successfully. |
You can also view the full syntax and options of the subcommand by typing asadmin help list-protocols at the command line.
Use the delete-protocol subcommand in remote mode to remove a protocol.
Ensure that the server is running.
Remote subcommands require a running server.
Delete a protocol by using the delete-protocol(1) subcommand
This example deletes the protocol named http-1.
asadmin> delete-protocol http-1 Command delete-protocol executed successfully. |
You can also view the full syntax and options of the subcommand by typing asadmin help delete-protocol at the command line.
Each HTTP listener has an HTTP configuration, which is created either by using the create-http subcommand or by using the built-in configurations that are applied when you follow the instructions in To Create an HTTP Network Listener.
The following topics are addressed here:
Use the create-http subcommand in remote mode to create a set of HTTP parameters for a protocol. This set of parameters configures one or more network listeners,
Ensure that the server is running.
Remote subcommands require a running server.
Create an HTTP configuration by using the create-http(1) subcommand.
Information about options and properties for the subcommand are included in this help page.
This example creates an HTTP parameter set for the protocol named http-1.
asadmin> create-http --timeout-seconds 60 --default-virtual-server server http-1 Command create-http executed successfully. |
You can also view the full syntax and options of the subcommand by typing asadmin help create-http at the command line.
Use the delete-http subcommand in remote mode to remove HTTP parameters from a protocol.
Ensure that the server is running.
Remote subcommands require a running server.
Delete the HTTP parameters from a protocol by using the delete-http(1) subcommand.
This example deletes the HTTP parameter set from a protocol named http-1.
asadmin> delete-http http-1 Command delete-http executed successfully. |
You can also view the full syntax and options of the subcommand by typing asadmin help delete-http at the command line.
Each HTTP listener has an HTTP transport, which is created either by using the create-transport subcommand or by using the built-in transports that are applied when you follow the instructions in To Create an HTTP Network Listener.
The following topics are addressed here:
Use the create-transport subcommand in remote mode to create a transport for a network listener,
Ensure that the server is running.
Remote subcommands require a running server.
Create a transport by using the create-transport(1) subcommand.
Information about options and properties for the subcommand are included in this help page.
This example 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. |
You can also view the full syntax and options of the subcommand by typing asadmin help create-transport at the command line.
Use the list-transports subcommand in remote mode to list the existing HTTP transports.
Ensure that the server is running.
Remote subcommands require a running server.
List the existing transports by using the list-transports(1) subcommand.
This example lists the existing transports.
asadmin> list-transports http1-trans tcp Command list-transports executed successfully. |
You can also view the full syntax and options of the subcommand by typing asadmin help list-transports at the command line.
Use the delete-transport subcommand in remote mode to remove a transport.
Ensure that the server is running.
Remote subcommands require a running server.
Delete a transport by using the delete-transport(1) subcommand.
This example deletes he transport named http1-trans.
asadmin> delete-transport http1-trans Command delete-transport executed successfully. |
You can also view the full syntax and options of the subcommand by typing asadmin help delete-transport at the command line.
The following topics are addressed here:
Use the create-http-listener subcommand or the create-network-listener subcommand in remote mode to create a listener. These subcommands provide backward compatibility and also provide a shortcut for creating network listeners that use the HTTP protocol. Behind the scenes, a network listener is created as well as its associated protocol, transport, and HTTP configuration. This method is a convenient shortcut, but it gives access to only a limited number of options. If you want to specify the full range of listener options, follow the instructions in To Create an Internet Connection.
Ensure that the server is running.
Remote subcommands require a running server.
Create an HTTP network listener by using the create-network-listener(1) subcommand or the create-http-listener(1) subcommand.
If needed, restart the server.
If you edit the special HTTP network listener named admin-listener, you must restart the server for changes to take effect. See To Restart a Domain.
This example creates an HTTP listener named sampleListener that uses a non-default number of acceptor threads. Security is not enabled at runtime.
asadmin> create-http-listener --listeneraddress 0.0.0.0 --listenerport 7272 --defaultvs server --servername host1.sun.com --acceptorthreads 100 --securityenabled=false --enabled=false sampleListener Command create-http-listener executed successfully. |
This example 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. |
You can also view the full syntax and options of the subcommand by typing asadmin help create-http-listener or asadmin help create-network-listener at the command line.
Use the list-http-listeners subcommand or the list-network-listeners subcommand in remote mode to list the existing HTTP listeners.
Ensure that the server is running.
Remote subcommands require a running server.
List HTTP listeners by using the list-http-listeners(1) or list-network-listeners(1) subcommand.
This example lists the HTTP listeners. The same output is given if you use the list-network-listeners subcommand.
asadmin> list-http-listeners admin-listener http-listener-2 http-listener-1 Command list-http-listeners executed successfully. |
You can also view the full syntax and options of the subcommand by typing asadmin help list-http-listeners or asadmin help list-network-listeners at the command line.
List HTTP listeners by using the list-http-listeners(1) or list-network-listeners(1) subcommand.
Modify the values for the specified listener by using the set(1) subcommand.
The listener is identified by its dotted name.
This example changes security-enabled to false.
asadmin> set "server.network-config.protocols.protocol. http-listener-2.security-enabled=false"server.network-config. protocols.protocol.http-listener-2.security-enabled=false Command set executed successfully. |
Use the delete-http-listener subcommand or the delete-network-listener subcommand in remote mode to delete an existing HTTP listener. This disables secure communications for the listener.
Ensure that the server is running.
Remote subcommands require a running server.
List HTTP listeners by using the list-http-listeners(1) subcommand.
Delete an HTTP listener by using the delete-http-listener(1) or delete-network-listener(1) subcommand.
To apply your changes, restart Enterprise Server.
See To Restart a Domain.
This example deletes the HTTP listener named sampleListener:
asadmin> delete-http-listener sampleListener Command delete-http-listener executed successfully. |
You can also view the full syntax and options of the subcommand by typing asadmin help delete-http-listener or asadmin help delete-network-listener at the command line.
Use the create-ssl subcommand in remote mode to create and configure an SSL element in the specified listener. This enables secure communication for the listener.
Ensure that the server is running.
Remote subcommands require a running server.
Configure an HTTP listener by using the create-ssl(1) subcommand.
To apply your changes, restart Enterprise Server.
See To Restart a Domain.
This example enables the HTTP listener named http-listener-1 for SSL:
asadmin> create-ssl --type http-listener --certname sampleCert http-listener-1 Command create-ssl executed successfully. |
You can also view the full syntax and options of the subcommand by typing asadmin help create-ssl at the command line.
Use the delete-ssl subcommand in remote mode to delete the SSL element in the specified listener. This disables secure communications for the listener.
Ensure that the server is running.
Remote subcommands require a running server.
Delete SSL from an HTTP listener by using the delete-ssl(1) subcommand.
To apply your changes, restart Enterprise Server.
See To Restart a Domain.
This example disables SSL for the HTTP listener named http-listener-1:
asadmin> delete-ssl --type http-listener http-listener-1 Command delete-http-listener executed successfully. |
You can also view the full syntax and options of the subcommand by typing asadmin help delete-ssl at the command line.
tbd
In the Administration Console, open the HTTP Service component under the relevant configuration.
Open the HTTP Listeners component under the HTTP Service component.
Select or create a new HTTP listener.
Select from the Default Virtual Server drop-down list.
For more information, see To Assign a Default Web Module to a Virtual Server.
For details, click the Help button in the Administration Console from the HTTP Listeners page.