4 messages in net.java.dev.glassfish.qualityRe: FINAL REVIEW of gfv3 Admin Guide| From | Sent On | Attachments |
|---|---|---|
| Dixie Pine | Nov 23, 2009 11:38 am | |
| Jagadish Prasath Ramu | Nov 25, 2009 9:42 am |  .txt |
| Sreenivas Munnangi | Nov 30, 2009 4:26 pm | |
| Jan Luehe | Dec 1, 2009 1:58 pm |
| Subject: | Re: FINAL REVIEW of gfv3 Admin Guide | |
|---|---|---|
| From: | Sreenivas Munnangi (Sree...@Sun.COM) | |
| Date: | Nov 30, 2009 4:26:28 pm | |
| List: | net.java.dev.glassfish.quality | |
Dixie,
Here are my comments based on your remarks.
I am going through the guide and will provide comments separately.
thanks sreeni
Are these config files correct for v3. Should I describe them? Should I descsribe them in REMARK 1--2 Reviewer more detail, or at all? .............................................................................................................. 40
How is it done in v2 ?
Does the restart material in this section work for linux on v3? ......................................... 74 REMARK 3--1 Reviewer
This is similar to v2 and it should work. Are we doing any QA on this doc ?
An example of a set subcommand for updating a thread pool is needed. ........................ 85 REMARK 5--1 Reviewer
PL. see the following
punit[234]: ./asadmin set "server.thread-pools.thread-pool.http-thread-pool.max-thread-pool-size=6" server.thread-pools.thread-pool.http-thread-pool.max-thread-pool-size=6
Command set executed successfully. punit[235]: ./asadmin get "server.thread-pools.thread-pool.http-thread-pool.max-thread-pool-size" server.thread-pools.thread-pool.http-thread-pool.max-thread-pool-size=6
Command get executed successfully. punit[236]:
Is mod_jk proxy setup a separate task? If so, I need instructions. ..................................... 92 REMARK 6--2 Reviewer Is mod_jk LB setup a separate task? If so, I need instructions. .......................................... 93 REMARK 6--3 Reviewer
Pl. check with Amy Roh (cc'd) for both of the remarks above.
Monitoring connector-service material is from V2. What is diff between this and REMARK 8--1 Reviewer resource tree? Should one of them be gone? Please review. ............................................ 107 Monitorinkg ejb material is from V2. Please review. ........................................................ 108 REMARK 8--2 Reviewer Monitoring jms-service material is from V2. Please review. ........................................... 108 REMARK 8--3 Reviewer Monitoring orb material is from V2. Please review. ......................................................... 109 REMARK 8--4 Reviewer Monitoring resources material is from V2. Please review. .............................................. 110 REMARK 8--5 Reviewer Monitoring thread pool material is from V2. Please review. ........................................... 110 REMARK 8--6 Reviewer Monitoring transaction Service material is from v2. Please review. ............................... 110 REMARK 8--7 Reviewer are these commonly monitored types above correct for v3? ........................................... 119 REMARK 8--8 Reviewer
Monitoring team provided comments to all of the above separately. If not, pl. let us know which specific info you need.
I need an example os using set to update a life module. ................................................... 145 REMARK 9--1 Reviewer
You may borrow it from v2.
The syntax of the pkg command syntax need to be reviewed. ......................................... 153 REMARK 10--1 Reviewer
Link to pkg command http://opensolaris.org/sc/src/pkg/gate/src/man/pkg.1.txt
Check with Snjezana.
REMARK 15--4 Reviewer How is an HTTP listener updated? If with set command, I need an example. .............. 261
punit[244]: ./asadmin get "server.network-config.protocols.protocol.http-listener-2.security-enabled" server.network-config.protocols.protocol.http-listener-2.security-enabled=true
Command get executed successfully. punit[245]: ./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. punit[246]: ./asadmin get "server.network-config.protocols.protocol.http-listener-2.security-enabled" server.network-config.protocols.protocol.http-listener-2.security-enabled=false
Command get executed successfully. punit[247]:
An example of a set subcommand for updating an IIOP listener is needed. Or is it? Do I REMARK 17--2 Reviewer update IIOP listeners? .......................................................................................................... 273
punit[249]: ./asadmin get "server.iiop-service.iiop-listener.SSL.enabled" server.iiop-service.iiop-listener.SSL.enabled=true
Command get executed successfully. punit[250]: ./asadmin set "server.iiop-service.iiop-listener.SSL.enabled=false" server.iiop-service.iiop-listener.SSL.enabled=false
Command set executed successfully. punit[251]: ./asadmin get "server.iiop-service.iiop-listener.SSL.enabled" server.iiop-service.iiop-listener.SSL.enabled=false
An example of a set subcommands for updating a Javamail resource is needed. Or is it? REMARK 18--1 Reviewer Do I update javamail resources? ......................................................................................... 278
Pl. check with Bill Shannon.
An example of a set subcommand for updating a JMS host is needed. Or is it? Do I REMARK 19--1 Reviewer update JMS hosts? ................................................................................................................ 28 Can I delete the default JMS host? I assume not. What happens if I try to? ................... 289 REMARK 19--2 Reviewer Does broker failover apply to single host? Should I include this section for V3? .......... 290 REMARK 19--3 Reviewer Iss this section stil valid? How does this material relate to To Configure the Generic REMARK 19--4 Reviewer Resource Adapter? I can't differentiate user's actions from what happens automatically.
................................................................................................................................................. 291 Is Configuring Foreign JMS Providers section still valid? If so, are there tasks for this and REMARK 19--5 Reviewer if so, where? ........................................................................................................................... 291 Does this JMS troubleshooting info apply to v3? .............................................................. 292
Check with Jagadish for 18-1 to 19-5.
REMARK 19--6 Reviewer An example of a set subcommand for updating a custom JNDI resource is needed. Or is REMARK 20--1 Reviewer it? Do I update? ..................................................................................................................... 297 4 Sun GlassFish Enterprise Server v3 Administration Guide . November 2009 Sun Confidential: Internal Use Only FINAL REVIEW
List of Remarks An example of a set subcommand for updating an external JNDI resource is needed. Or REMARK 20--2 Reviewer is it? Do I update? ................................................................................................................. 300
Check with Mahesh for JNDI.
Need some explanation about what heuristic decision is/does for transaction recovery. REMARK 21--1 Reviewer
................................................................................................................................................. 304 how do I identify the transaction I need to roll back? ....................................................... 306 REMARK 21--2 Reviewer Is the recover-transactions subcommand about multiple tx and rollback-transaction is REMARK 21--3 Reviewer about single tx? What's the diff? Don't I have to stop the transaction service to do this manual recovery? Is restart required? ................................................................................ 306
Check with Marina.
Dixie Pine wrote:
Greetings,
The FINAL REVIEW draft of the /GlassFish Enterprise Server v3 Administration Guide/ is available on the comments wiki here:
http://wiki.glassfish.java.net/Wiki.jsp?page=AdministrationGuide
If you are named as a *To:* recipient of this email, you are considered a *key reviewer *of this manual, and I need to hear from you, if only to say "looks fine". I have not called out QA reviewers as key reviewers, but QA names are on the dashboard. The QA review is definitely as important as the dev review. Specific review areas are listed in the Reviewer Dashboard here:
There are some holes and possibly wrong names in the dashboard. Let me know if corrections are needed.
All comments are due by *Tuesday, December 1, 2009*.
As you can see, there's not much time to review (surprise), so please don't delay. Pay special attention to the queries that I have put in the doc. Be sure to include the page number in the PDF with each of your comments. I'm happy to receive comments in email, comments wiki, hardcopy markup, on the phone, face-to-face, whatever works.
DON'T: Please don't open Issue Tracker issues; takes longer for me to process.
Thanks in advance, Dixie