HTTP Service to Network Service Changes

In GlassFish Server 3.1, most HTTP Service settings are defined in the Network Service configuration that was introduced in Sun GlassFish Enterprise Server v3.

The changes are described in the following sections.

• Changes to Dotted Names

• Changes to asadmin Commands

• Remapping of HTTP Service Attributes and Properties

• New Network Service Elements and Attributes

Changes to Dotted Names

The dotted name hierarchy for the HTTP Service configuration in GlassFish Server 3.1 is shown below. Elements that are no longer supported are request-processing, keep-alive, connection-pool, http-protocol, http-file-cache, and http-listener. During the upgrade process, these discontinued elements are remapped to the new configuration automatically and then deleted.

config
    http-service
        access-log
        request-processing
        keep-alive
        connection-pool
        http-protocol
        http-file-cache
        http-listener
            ssl 
            property
        virtual-server
            http-access-log
            property
        property
    thread-pools
        thread-pool

The dotted name hierarchy for the GlassFish Server 3.1 Network Service and HTTP Service configurations is shown below. The network-config element and all its children are new except for ssl.

config
    network-config
        transports
            selection-key-handler
            transport
        protocols
            protocol
                http
                    file-cache
                port-unification
                    protocol-finder
                protocol-chain-instance-handler
                    protocol-chain
                protocol-filter
                ssl
        network-listeners
            network-listener
    http-service
        access-log
        virtual-server
            http-access-log
            property
        property
    thread-pools
        thread-pool

The following example compares the commands for setting a listener port for Sun GlassFish Enterprise Server v3 and GlassFish Server 3.1. Note that the configuration for Enterprise Server v3 also applies to all earlier Enterprise Server 2.x releases.

• Command for Sun GlassFish Enterprise Server v3 and earlier:

  asadmin set server-config.http-service.http-listener.http-1.listenerport=4321

• Command for GlassFish Server 3.1:

  asadmin set server-config.network-config.network-listeners.network-\
  listener.http-1.listenerport=4321

Changes to asadmin Commands

To accommodate the move of HTTP Service into the new Network Service configuration, asadmin(1M) commands are changed as follows:

• The create-ssl(1) command has a new --type parameter value, network-listener.

• The create-virtual-server(1) command has a new parameter, --networklisteners.

• The create-http-listener(1) command adds a network-listener element to the domain configuration. The syntax and options of this commands are unchanged.

Remapping of HTTP Service Attributes and Properties

The following tables describe how attributes and properties in the HTTP Service configuration for GlassFish Server 3.1 are remapped to attributes in the Network Service configuration for older product releases. If you use a configuration from a Sun GlassFish Enterprise Server v2 or v3 release, this remapping happens automatically and then discontinued elements are deleted.

Table 1-3 com.sun.grizzly Property Remapping

Table 1-4 connection-pool Attribute Remapping

Table 1-5 http-file-cache Attribute Remapping

Table 1-6 http-listener Attribute Remapping

Table 1-7 http-listener Property Remapping

Table 1-8 http-protocol Attribute Remapping

Table 1-9 http-service Property Remapping

Table 1-10 keep-alive Attribute Remapping

Table 1-11 request-processing Attribute Remapping

Table 1-12 ssl Attribute Changes

Table 1-13 thread-pool Attribute Changes

Table 1-14 virtual-server Attribute Changes

New Network Service Elements and Attributes

The following tables describe the Network Service elements and attributes that were introduced in Sun GlassFish Enterprise Server v3. For attributes and properties remapped from discontinued elements to new elements, see Remapping of HTTP Service Attributes and Properties.

The new file-cache element has no new attributes. All of its attributes are remapped from the http-file-cache element. For details, see Table 1-5.

Table 1-15 New http Attributes

For remapped http attributes, see Table 1-4, Table 1-6, Table 1-7, Table 1-8, Table 1-10, and Table 1-11.

Table 1-16 New network-listener Attributes

For remapped network-listener attributes, see Table 1-6.

Table 1-17 New port-unification Attributes

Table 1-18 New protocol Attributes

For remapped protocol attributes, see Table 1-6.

Table 1-19 New protocol-chain Attributes

Table 1-20 New protocol-chain-instance-handler Attributes

Table 1-21 New protocol-filter Attributes

Table 1-22 New protocol-finder Attributes

Table 1-23 New selection-key-handler Attributes

Table 1-24 New ssl Attributes

For remapped ssl attributes, see Table 1-12.

Table 1-25 New thread-pool Attributes

For remapped thread-pool attributes, see Table 1-4, Table 1-11, and Table 1-13.

Table 1-26 New transport Attributes

For remapped transport attributes, see Table 1-3, Table 1-4, Table 1-6, and Table 1-7.