GlassFish - World's first Java EE 7 Application Server


<h1>Grizzly Documentation Plan</h1>

People and Roles

Name Role Location Time Zone Email
June Parks Documentation Feature Owner SCA16 1724 US Pacific junesm@dev.java.net
Dixie Pine Kim Haase Debbie Carson Additional Writers     java.netID@dev.java.net
Julie Bettis Editor     java.netID@dev.java.net
Jeanfrancois Arcand Oleksiy Stashok Dhiru Pandey Justin Lee Nandini Ektare Software Engineers     java.netID@dev.java.net
Shaline Aditya Dada QA Engineers     java.netID@dev.java.net

Audience

Grizzly is the back end to the HTTP service. Both developers and administrators use Grizzly. Developers use it to develop and deploy web applications. Administrators use it to monitor and tune web container performance.

Summary of the Feature From a User's Perspective

The changes to Grizzly in v3 are mainly in the back-end configuration, visible only to users who view or edit the domain.xml file. There are a few new asadmin commands that replace deprecated asadmin commands. For both domain.xml and asadmin, the Grizzly configuration spec has detailed old-to-new mappings.

Availability

Grizzly is part of the GlassFish kernel, so it is present in all distributions, even those that lack the web container. In fact, v3 changes to Grizzly are primarily for the purpose of separating Grizzly from the HTTP service and the web container.

Statement of Work

The documentation impact is major and reference-based. No task analysis meeting is needed, but some discussion of how asadmin changes affect existing tasks is needed.

Changes to Books

Domain File Format Reference Changes

Section Documentation Impact Writer Reviewers Description of Change
network-config transports transport selection-key-handler protocols protocol protocol-filter protocol-finder http file-cache port-unification network-listeners network-listener NEW June Parks Jeanfrancois Arcand Oleksiy Stashok Dhiru Pandey Justin Lee New descriptions of network config elements and attributes must be added.
http-service http-listener http-protocol virtual-server request-processing connection-pool keep-alive http-file-cache thread-pool Minor June Parks Same Old elements, attributes, and properties must be updated or marked as deprecated with links to new equivalents.

Upgrade Guide Changes

Section Documentation Impact Writer Reviewers Description of Change
HTTP Service to Network Configuration Changes NEW Kim Haase June Parks Jeanfrancois Arcand Oleksiy Stashok Dhiru Pandey Justin Lee A summary of old-to-new element, attribute, and property mappings should be provided. For Preview this was in the Release Notes.

Administration Guide Changes

Section Documentation Impact Writer Reviewers Description of Change
Configuring the HTTP Service Moderate Dixie Pine June Parks Jeanfrancois Arcand Oleksiy Stashok Dhiru Pandey Justin Lee The asadmin create/delete/list-http-listener and create/delete/list-virtual server tasks are unchanged. See the Grizzly Task Analysis for the new tasks to be documented. These are dependent on the man pages, which should be done first.

Changes to Online Help

Topic Title Documentation Impact Writer Reviewers Description of Change
HTTP Service HTTP Listener Moderate Kim Haase Jeanfrancois Arcand Oleksiy Stashok Dhiru Pandey Justin Lee "HTTP listener" is replaced by "network listener," screens are new, but many settings are familiar, just moved and/or renamed.

Changes to Man Pages

Man Page Name and Section Documentation Impact Writer Reviewers Description of Change
create-ssl Minor Debbie Carson Jeanfrancois Arcand Oleksiy Stashok Dhiru Pandey Justin Lee Add "network-listener" value to --type parameter.
create-threadpool Minor Dixie Pine Same Add --maxqueuesize parameter. Mark --workqueues parameter as ignored.
get/set/list Minor Dixie Pine Same Examples of new Grizzly dotted names would be helpful. At least remove any outdated http-service or http-listener examples.
create-virtual-server delete-virtual-server list-virtual-servers Minor June Parks Same No command changes. Some property changes.
create-http-listener delete-http-listener list-http-listeners Minor June Parks Same No command changes. Commands operate on a network-listener behind the scenes.
create-transport delete-transport list-transports create-protocol delete-protocol list-protocols create-http delete-http create-network-listener delete-network-listener list-network-listeners NEW June Parks Same New commands.

Review Schedule

The review schedule for the documentation items that are affected by this feature is provided in the following table.

Item First Draft Start Date First Draft End Date Second Draft Start Date Second Draft End Date Final Version End Date Final Version End Date
             
             
             

Reviewers are listed in the Statement of Work.

Related Information

Email aliases:

  • [admin@glassfish.java.net]
  • [users@glassfish.java.net]
  • [docs@glassfish.java.net]