quality@glassfish.java.net

Re: FINAL REVIEW of gfv3 Admin Guide

From: Sreenivas Munnangi <Sreenivas.Munnangi_at_Sun.COM>
Date: Mon, 30 Nov 2009 16:28:18 -0800

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:
>
> http://wiki.glassfish.java.net/Wiki.jsp?page=GlassFishV3DocPlanAdminGuide#section-GlassFishV3DocPlanAdminGuide-ReviewerDashboard
>
> 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
>
>