<center> <h1>AS9.1 Documentation Plan</h1> </center> <b>Revision Date</b> <script> d = new Date( Date.parse(document.lastModified) ); document.writeln(d.getMonth() + 1 + "/" + d.getDate() + "/" + d.getFullYear()); </script>: <br> <b>Doc Plan Owner</b>: Paul Davies <ul> <li><a href="#overview">Overview</a> <li><a href="#staff">Tech Pubs Staff</a> <li><a href="#audience">Audience</a> <li><a href="#deliverables">Deliverables</a> <li><a href="#featurelist">Summary of Documentation Changes by Feature</a> <li><a href="#schedule">Schedule</a> <li><a href="#criteria">Release Exit Criteria</a> </ul> <h2><a name="overview"></a>Overview</h2> App Server 9.1 (Java EE 5.0) will be released initially as an independent feature release (IFR) and in the accessory folder of of JES5 U1. There will be significant product changes, so the entire doc set will be updated. <ul> <li>Admin Guide and Admin Console online/inline help will add: LB administration, clustering admin, JBI integration, session persistence, JSF, etc. <li>High Availability Admin Guide will be updated with the latest HADB administration. <li>The Java EE Tutorial will require minor updates. <li>The WSIT Tutorial will be added to the docset. <li>Developer's Guide will add: session persistence (added to AS9.0UR1) JBI integration info (JSR 208), JRS 196 implementation, and webservices interoperability <li>Reference manual will be updated with the new asadmin commands <li>Performance Tuning Guide updated with performance enhancements <li>Installation Guide updated as necessary (covers install of AppServer NOT glassfish) <li>QuickStart guide updated as necessary (not required for Milestone 2) <li>Troubleshooting guides updated with JBI info. <li>Error message online wiki catalog </ul> <p> <h3>Replacement of AppServer Editions With Profiles</h3> <p> In this release, AppServer Editions are replaced with Profiles. As a result of this change, we post only one doc set on docs.sun.com to cover all profiles. Content that applies only to a particular profile will carry a statement to that effect. Only one version of the bundled docs (e.g. OLH page), will be produced. <p>A usage profile (or profile) identifies how a particular type of users use the application server software. The profile for a particular type of users determines the set of Application Server features that are available to those users. <p>The following pre-defined profiles are provided with AS 9.1:
- Developer profile. Provides access to features optimized for developers (corresponding to the features of PE in previous releases).
- Cluster profile. Provides access to features of EE in previous releases, except for HADB, NSS, and Sun Java System JDBC drivers.
- Enterprise profile. Provides access to features available by default only in EE/JES, including HADB, NSS, and Sun Java System JDBC drivers.
<p>*Note -*Only the cluster profile and developer profile will be usable at beta. <h3>Bundles</h3> <p>The AS 9.1 software is supplied in the following bundles:
<p>The EE/JES bundle contains the software of the PE/GlassFish bundle plus HADB, NSS, and Sun Java System JDBC drivers. <p>A default profile is associated with each bundle is as follows:
- PE/GlassFish - Developer profile
- EE/JES - Cluster profile
<h3>Software Requirements for Each Profile</h3> <p>The required Application Server software depends on the choice of profile as follows:
- Developer profile - The PE/GlassFish bundle is sufficient.
- Cluster profile - The PE/GlassFish bundle is sufficient.
- Enterprise profile - The user has the following choices:
- Use the EE/JES bundle.
- Use the PE/GlassFish bundle, separately obtain and install the EE/JES features (for example, NSS and HADB), and make some global configuration changes.
<p>The enterprise profile template is supplied in all bundles. However, a user who has the PE/Glassfish bundle can create a domain with the enterprise profile only if the EE/JES features (for example, NSS and HADB) are separately installed and some global configuration changes are made. If the EE/JES features are not available with a PE installation, creation and running of the enterprise profile fail. No mechanism to revert to the cluster profile is provided. <h2><a name="staff"></a>Tech Pubs Staff</h2> <ul> <li>Alan Sommerer (SCA) - Manager <li>Pal Davies (SCA) - Lead writer, lead for man pages <li>Scott Fordin (BUR) <li>Chinmayee Srivathsa (BLR) <li>June Parks (SCA): works Wed-Fri <li>Hanan Lang (SCA) <li>Rajeev Jayarajan (BLR) - Lead for Admin Guide, online help </ul> <p> The Java EE and WSIT Tutorial team documents features of the Java EE (J2EE) platform: <ul> <li>Eric Jendrock (BUR) - Lead <li>Jennifer Ball (SCA) <li>Debbie Carson (SCA) <li>Ian Evans (SCA) <li>Kim Haase (BUR) </ul> <p> <p> <h2><a name="audience"></a>Audience</h2> <p>Java Enterprise developers, administrators, and other IT professionals. <p> <h2><a name="deliverables"></a>Deliverables</h2> <p> The following table lists the document deliverables. Author assignments are tentative. <p> <table border="1"> <caption>Documentation Deliverables</caption> <tbody> <tr> <th bgcolor="#cccccc"><b>Document Name</b></th> <th bgcolor="#cccccc"><span style="font-weight: bold;">Authors<br> </span></th> <th bgcolor="#cccccc"><span style="font-weight: bold;">Comments</span><br> </th> </tr> <tr> <td style="text-align: center; vertical-align: middle;" rowspan="1" colspan="3" bgcolor="#ffffcc"><span style="font-weight: bold;">Documentation bundled with product</span><br> </td> </tr> <tr> <td>Bundled HTML pages<br> about.html<br> index.html<br> features.html<br> copyright.html </td> <td>Hanan Lang<br></td> <td>Revised for beta1 delivery </td> </tr> <tr> <td>Admin Console online help</td> <td>Vipin Rajan - lead <br> (Rajeev Jayarajan, Chinmayee Srivathsa)<br> </td> <td><a href="http://swpubs.sfbay/writing/appserver/as9.1/plans/adminplan.html"> Admin Guide and Online Help doc plan </a> </td> </tr> <tr> <td valign="top">QuickStart Guide<br> </td> <td valign="top">Chinmayee Srivathsa<br> </td> <td valign="top">Complete version bundled for PE; same as online.<br> </td> </tr> <tr> <td style="vertical-align: middle; text-align: left;">Migration Tool online help</td> <td style="vertical-align: middle; text-align: left;">Chinmayee <span class="COL">Srivathsa</span></td> <td style="vertical-align: top;"><br> </td> </tr> <tr> <td style="vertical-align: middle; text-align: left;">Upgrade Tool online help</td> <td style="vertical-align: middle; text-align: left;">Chinmayee Srivathsa</td> <td style="vertical-align: top;"><br> </td> </tr> <tr> <td style="vertical-align: middle; text-align: left;">Update Tool online help</td> <td style="vertical-align: middle; text-align: left;">Hanan Lang</td> <td style="vertical-align: top;">Placeholder files checked in for Milestone 4 beta delivery<br> </td> </tr> <tr> <td style="text-align: center; vertical-align: middle;" rowspan="1" colspan="3" bgcolor="#ffffcc"><span style="font-weight: bold;">Manuals posted to docs.sun.com</span><br> </td> </tr> <tr> <td>Administration Guide </td> <td>Rajeev Jayarajan - lead (Hanan Lang, Chinmayee Srivathsa)</td> <td><a href="http://swpubs.sfbay/writing/appserver/as9.1/plans/adminplan.html">Admin Guide and Online Help doc plan</a> </td> </tr> <tr> <td>Application Deployment Guide<br> </td> <td>June Parks<br> </td> <td>Documents any appserver specific Deployment Descriptor files</td> </tr> <tr> <td valign="top">Documentation Center<br> </td> <td valign="top">Hanan Lang<br> </td> <td valign="top">Links to topics in the doc set and Java EE Tutorial<br> </td> </tr> <tr> <td>Developer's Guide</td> <td>June Parks</td> <td> <br> </td> </tr> <tr> <td>Deployment Planning Guide</td> <td>Hanan Lang</td> <td> <br> </td> </tr> <tr> <td>Error Message Reference</td> <td>Scott Fordin</td> <td> App Server Error Messages posted on the Glassfish wiki </td> </tr> <tr> <td>High Availability Admin Guide</td> <td>Paul Davies<br> </td> <td><a href="http://swpubs.sfbay/writing/appserver/as9.1/plans/hadocplan.html">HA Admin Guide and Online Help doc plan </a> </td> </tr> <tr> <td> Installation Guide <br> </td> <td>Chinmayee</td> <td>Writer will also be point of contact for JES Install Guide.<br> </td> </tr> <tr> <td>Performance Tuning Guide</td> <td>Rajeev Jayarajan<br> </td> <td> </td> </tr> <tr> <td>Quick Start Guide</td> <td>Chinmayee<br> </td> <td> <br> </td> </tr> <tr> <td valign="middle">Reference Manual<br> </td> <td valign="middle">Paul Davies - lead<br> (Rajeev Jayarajan, Chinmayee Srivathsa) </td> <td valign="middle">Contains:<br>
- CLI reference (man pages)<br>
<br> <a href="http://swpubs.sfbay/writing/appserver/as9.1/plans/asmanpageplan.html">See man page doc plan</a><br> </td> </tr> <tr> <td valign="top">Admin Reference <br>
</td> <td valign="top">June Parks</td> <td valign="top">Documents domain.xml file</td> </tr> <tr> <td>Release Notes</td> <td> Scott Fordin<br> </td> <td> <br> </td> </tr> <tr> <td>Troubleshooting Guide</td> <td>Scott Fordin</td> <td> <br> </td> </tr> <tr> <td style="vertical-align: middle;">Upgrade & Migration Guide</td> <td style="vertical-align: middle;">Chinmayee Srivathsa</td> <td valign="middle"> <br> </td> </tr> <tr> <td rowspan="1" colspan="3" style="text-align: center;" bgcolor="#ffffcc"><span style="font-weight: bold;">Related Documentation</span><br> </td> </tr> <tr> <td>Java EE, WSIT, Sun Web Developer Pack, and firstcup Tutorials</td> <td>Eric Jendrock<br> (Kim Haase, Ian Evans, Debbie Carson, Jennifer Ball)</td> <td><br> </td> </tr> <tr> <td>Compatibility Test Suite</td> <td>Scott Fordin</td> <td><br> </td> </tr> <tr> <td rowspan="1" colspan="3" style="text-align: center;" bgcolor="#ffffcc"><span style="font-weight: bold;">Documentation Wiki Posting</span><br> </td> </tr> <tr> <td>HTML version of docset to be posted on glassfish docs wiki</td> <td>Hanan Lang</td> <td>Postings to occur on a monthly basis and will include opportunity for customers to provide feedback. </td> </tr> </tbody> </table> <p> <a name="featurelist"><h2>Summary of Documentation Changes by Feature</h2></a> <TABLE BORDER=1> <TR> <TD><B>Feature</B></TD> <TD><B>Affected Documentation</B></TD> <TD><B>Responsible Writers</B></TD> </TR> <TR> <TD COLSPAN=3> <h3>Admin, Update, and Upgrade</h3> </TD> </TR> <TR> <TD ROWSPAN=3> <A HREF="http://www.glassfishwiki.org/gfwiki/attach/OnePagersOrFunctionalSpecs/AdminGuiOnePager.html">Admin Console GUI </A> </TD> <TD>Admin Guide </TD> <TD>Vipin </TD> </TR> <TR> <TD>Admin GUI online help, including help for JBI </TD> <TD>Rajeev, Vipin, Chinmayee </TD> </TR> <TR> <TD>Admin GUI inline help and system text </TD> <TD>Scott </TD> </TR> <TR> <TD ROWSPAN=3><A HREF="http://www.glassfishwiki.org/gfwiki/attach/GlassFishV2AdminRelatedOnePagers/cli-one-pager.html">Admin CLI</A> </TD> <TD>Admin Guide </TD> <TD>Vipin </TD> </TR> <TR> <TD>CLI man pages </TD> <TD>Chinmayee, Rajeev, Vipin </TD> </TR> <TR> <TD>All other AS docs might also be affected </TD> <TD>All writers to investigate. </TD> </TR> <TR> <TD ROWSPAN=3> Update Center </TD> <TD>Update Center online help </TD> <TD>Hanan </TD> </TR> <TR> <TD>Update Center inline help and help text </TD> <TD>Hanan </TD> </TR> <TR> <TD>Administration Guide </TD> <TD>Vipin </TD> </TR> <TR> <TD> <A HREF="http://www.glassfishwiki.org/gfwiki/attach/OnePagersOrFunctionalSpecs/upgrade-one-pager.html">Upgrade </A> </TD> <TD>Upgrade and Migration guide </TD> <TD>N/A </TD> </TR> <TR> <TD><A HREF="http://www.glassfishwiki.org/gfwiki/attach/OnePagersOrFunctionalSpecs/GMSJxtaOnePager.txt">GMS </A> </TD> <TD>Admin Guide </TD> <TD>Vipin </TD> </TR> <TR> <TD><A HREF="http://www.glassfishwiki.org/gfwiki/attach/OnePagersOrFunctionalSpecs/smgmtonepager.txt">Self-Management Templates</A> </TD> <TD>Admin Guide </TD> <TD>Vipin </TD> </TR> <TR> <TD ROWSPAN=3> <A HREF="http://www.glassfishwiki.org/gfwiki/attach/GlassFishV2AdminRelatedOnePagers/profile-support-fs.html">Usage Profile Support</A> </TD> <TD>Admin Guide </TD> <TD>Vipin </TD> </TR> <TR> <TD><tt>asadmin create-domain</tt> man page</TD> <TD>Vipin </TD> </TR> <TR> <TD>All other AS documentation might be affected</TD> <TD>All writers to investigate. </TD> </TR> <TR> <TD ROWSPAN=2>Inline upgrade</TD> <TD>Admin Guide</TD> <TD>Vipin</TD> </TR> <TR> <TD>Upgrade and Migration Guide</TD> <TD>Chinmayee</TD> </TR> <TR> <TD COLSPAN=3> <h3><A HREF="http://www.glassfishwiki.org/gfwiki/attach/GlassFishV2AdminRelatedOnePagers/admin-fs.html">Admin Infrastructure</A></h3> </TD> </TR> <TR> <TD ROWSPAN=2>Domain Configuration Management </TD> <TD>Admin Guide </TD> <TD>Vipin </TD> </TR> <TR> <TD>Admin Reference </TD> <TD>June </TD> </TR> <TR> <TD>Administrative MBeans and JMX Infrastructure </TD> <TD>No impact </TD> <TD>N/A </TD> </TR> <TR> <TD>Inter Process Communication using JMX Connectors </TD> <TD>No impact </TD> <TD>N/A </TD> </TR> <TR> <TD>Management API (AMX) </TD> <TD>No impact </TD> <TD>N/A </TD> </TR> <TR> <TD>JSR 77 Support </TD> <TD>No impact </TD> <TD>N/A </TD> </TR> <TR> <TD>Administrative Security </TD> <TD>Admin Guide </TD> <TD>Vipin </TD> </TR> <TR> <TD>Process Launcher and Startup/Shutdown </TD> <TD>No impact </TD> <TD>N/A </TD> </TR> <TR> <TD>Synchronization </TD> <TD>No impact </TD> <TD>N/A </TD> </TR> <TR> <TD>Node Agent </TD> <TD>HA Admin Guide </TD> <TD>Paul </TD> </TR> <TR> <TD ROWSPAN=2>Miscellaneous </TD> <TD>Admin Guide </TD> <TD>Vipin </TD> </TR> <TR> <TD>Templates and samples </TD> <TD>Paul </TD> </TR> <TR> <TD COLSPAN=3> <h3>Integration, Interoperation, and Enhancements</h3> </TD> </TR> <TR> <TD><A HREF="http://www.glassfishwiki.org/gfwiki/attach/OnePagersOrFunctionalSpecs/wsit-onepager.txt">WSIT </A> </TD> <TD>WSIT Tutorial </TD> <TD>Tutorial Team </TD> </TR> <TR> <TD ROWSPAN=4> <A HREF="http://www.glassfishwiki.org/gfwiki/attach/OnePagersOrFunctionalSpecs/jbi.txt">JBI Integration</A> </TD> <TD><a name="jbidocimpact"></a>Administration Guide </TD> <TD>Rajeev </TD> </TR> <TR> <TD>Developer's Guide </TD> <TD>June </TD> </TR> <TR> <TD>CLI man pages </TD> <TD>Chinmayee, Rajeev, Vipin </TD> </TR> <TR> <TD>JBI documentation </TD> <TD>Gavotte documentation team </TD> </TR> <TR> <TD ROWSPAN=6> <A HREF="http://www.glassfishwiki.org/gfwiki/attach/OnePagersOrFunctionalSpecs/ConnectionPoolOnePager.html">Connection Pool Enhancements</A> </TD> <TD>Administration Guide </TD> <TD>Chinmayee, Hanan </TD> </TR> <TR> <TD>Developer's Guide </TD> <TD>June </TD> </TR> <TR> <TD>Admin Reference </TD> <TD>June </TD> </TR> <TR> <TD>Admin GUI online help </TD> <TD>Chinmayee </TD> </TR> <TR> <TD>Admin GUI inline help and system text </TD> <TD>Scott </TD> </TR> <TR> <TD>CLI help </TD> <TD>Chinmayee, Rajeev, Vipin </TD> </TR> <TR> <TD> <A HREF="http://www.glassfishwiki.org/gfwiki/attach/OnePagersOrFunctionalSpecs/JDBC-4.0-RA-OnePager.txt">JDBC 4.0 support</A> </TD> <TD>Developer's Guide </TD> <TD>June </TD> </TR> <TR> <TD ROWSPAN=3> <A HREF="http://www.glassfishwiki.org/gfwiki/attach/OnePagersOrFunctionalSpecs/as-mq-integration-gfv2.txt">MQ Integration</A> </TD> <TD>Administration Guide </TD> <TD>Vipin </TD> </TR> <TR> <TD>Developer's Guide </TD> <TD>June </TD> </TR> <TR> <TD>HA Admin Guide (maybe) </TD> <TD>Paul to verify with the MQ team </TD> </TR> <TR> <TD><A HREF="http://www.glassfishwiki.org/gfwiki/attach/OnePagersOrFunctionalSpecs/addon-onepager.txt">Addons for EE <BR> Might be internal only</A> </TD> <TD>Upgrade and Migration Guide </TD> <TD>Chinmayee </TD> </TR> <TR> <TD COLSPAN=3> <h3>High Availability Features</h3> </TD> </TR> <TR> <TD ROWSPAN=2> <A HREF="http://www.glassfishwiki.org/gfwiki/attach/OnePagersOrFunctionalSpecs/LB-onepager.txt">Load Balancer Enhancements</A> </TD> <TD>HA Admin Guide </TD> <TD>Rajeev </TD> </TR> <TR> <TD>Error Message Reference </TD> <TD>Scott </TD> </TR> <TR> <TD ROWSPAN=4><A HREF="http://www.glassfishwiki.org/gfwiki/attach/OnePagersOrFunctionalSpecs/memory-replication-one-pager.html">In-memory Replication </A> </TD> <TD>HA Admin Guide </TD> <TD>Paul </TD> </TR> <TR><TD>Developer's Guide </TD> <TD>June </TD> </TR> <TR> <TD>HA Admin CLI Help </TD> <TD>Chinmayee, Rajeev, Vipin </TD> </TR> <TR> <TD>HA Admin Console GUI Help </TD> <TD>Chinmayee </TD> </TR> <TR> <TD ROWSPAN=2><A HREF="http://www.glassfishwiki.org/gfwiki/attach/OnePagersOrFunctionalSpecs/FOLB-one-pager.html">IIOP Failover</A> </TD> <TD>HA Admin Guide </TD> <TD>Paul </TD> </TR> <TR> <TD>Developer's Guide </TD> <TD>June </TD> </TR> <TR> <TD COLSPAN=3> <h3>Features That Do Not Affect Documentation</h3> </TD> </TR> <TR> <TD><A HREF="http://www.glassfishwiki.org/gfwiki/attach/OnePagersOrFunctionalSpecs/genericra-onepager.txt">Generic JMS RA Integration</A> </TD> <TD>None </TD> <TD>N/A </TD> </TR> <TR> <TD><A HREF="http://www.glassfishwiki.org/gfwiki/attach/OnePagersOrFunctionalSpecs/grizzly-v2-one-pager.html">Grizzly v2</A> </TD> <TD>None </TD> <TD>N/A </TD> </TR> </TABLE> <h2><a name="schedule"></a>Schedule</h2> <p> Based on schedule in AS9.1 Plan Proposal. For more detailed doc schedule information, see the AS9.1 Schedule. <p> In the following schedule, all times are C.O.B., PST, unless otherwise noted. See the preceding table to see which docs are bundled and which are posted to docs.sun.com. Although bundled, the About page has separate line items in the schedule. The tasks in parentheses require no action by tech pubs but do affect our schedule. <p> <table border="1" width="586" cellpadding="2" cellspacing="2" height="308"> <caption><b>AS9.1 EE Schedule (2005)</b> </caption> <tbody> <tr> <th valign="middle" align="left" bgcolor="#cccccc">Task<br> </th> <th valign="middle" align="left" bgcolor="#cccccc">Date<br> </th> </tr> <tr> <td valign="top">Monthly HTML documentation posting</td> <td>Posting to begin with Milestone 2 (Sept 25) and continue monthly until full release of AppServer</td> </tr> <tr> <td valign="top">Admin Console Online Help L10N 80% handoff<br> </td> <td valign="top">Jun 8, 2007<br> </td> </tr> <tr> <td valign="middle">Beta 3 Release - Docs posted to docs.sun.com<br> </td> <td valign="middle">Jul 6, 2007<br> </td> </tr> <tr> <td valign="top">Begin final bundled doc technical review <br> </td> <td valign="top">Jul 16, 2007<br> </td> </tr> <tr> <td valign="top">Deadline for review feedback on bundled docs<br> </td> <td valign="top">Jul 20, 2007<br> </td> </tr> <tr> <td style="vertical-align: top;">AS9.1 Hard Code Freeze (HCF) - affects only bundled docs<br> </td> <td style="vertical-align: top;">Jul 30, 2007<br> </td> </tr> <tr> <td valign="top">Admin Console Online Help L10N 100% handoff<sup>*</sup></td> <td valign="top">Jul 30, 2007<br> </td> </tr> <tr> <td valign="top">Begin final unbundled doc technical review <br> </td> <td valign="top">Aug 31, 2007<br> </td> </tr> <tr> <td valign="top">Deadline for review feedback on unbundled docs<br> </td> <td valign="top">Sep 7, 2007<br> </td> </tr> <tr> <td valign="top">Submit books for publication on docs.sun.com<br> </td> <td valign="top">Sep 14, 2007<br> </td> </tr> <tr> <td style="vertical-align: top;" bgcolor="#ffcccc">AS9.1 FCS<br> </td> <td style="vertical-align: top;" bgcolor="#ffcccc">Sep 17, 2007<br> </td> </tr> </tbody> </table> <p> <h3>Localization</h3> <p> The following documents will be localized for AS9.1 EE: <ul> <li>Release Notes <li>Online Help </ul> <p> <h2><a name="criteria"></a>Release Exit Criteria for Docs</h2> <p> <ul> <li>Monthly glassfish wiki postings: pre-beta quality; snapshot of docs in their current state. <li>Beta: Full doc set, beta quality, no unwaived P1 or P2 bugs. "Full doc set" means that no guides will be missing. "Beta quality" means that the scope of a document might be cut in order to meet the schedule deadlines. The tech writers will work with the engineers to determine which topics are the highest priority. <li>RR: Full doc set, no unwaived P1, P2, or P3 bugs. </ul> <h3>Accessiblity</h3> Before FCS, we must verifiy accessibility of HTML files by running the following script: <p> <code>/java/pubs/bin/check508 -t <fully-qualified-directory-name></code>
|