Hi Wim,
Thanks very much! Your review is very helpful. A few comments inline.
Gail
Wim Verreycken wrote:
> Hi gail,
>
> Here's the short version already :
>
> Page 1 : Enterprise Server -> Glassfish/Sun Java Enterprise Server
> Page 10 : "Uniform Resource Locator (URL) -> URL will do fine, don't
> pampetr/insult the reader
Good point.
>
> Page 16 : ...and functional "yet" :
> Don't worry users about backwards compatibility.
> + there is limited EJB 3.1 Support ie. If EJB's Session Beans are packaged
> within the war they will be operational in Prelude V3
> (you can develop a session bean stateless or statefull, put it under a
> package within the war, gf 3 Prelude will install them as EJB's
Good point. I'll rewrite this content.
>
> Page 17 : Please refer to chapter about visualVM here
You mean refer to 'Troubleshooting Tools' section?
>
> Page 18 : + permgen size : this is a common error (when a OutOfMemoryError :
> Perm Genspace is throuwn
I'll add this to 'What is Your System Configuration?'
>
> Page 19 : could you explain briefly HOWTO log meesages to windows event log
> Standard, this is NOT the case
Can anyone on the list provide this information?
>
> Page 20 : See page 19 : howto use Windows Event log to log errors.
I'll add this.
> + ps-ef can proof usefull
> + Task manager can be usefull to kill process on windows systems
I'll add this to 'Operating System Utilities'.
>
> Page 22 :
> Most common use of visual VM
> Detect memory leaks : refer to visualVM home page
Great - I'll add this.
>
> Page 25 : If the specified port number is already taken ...
> This is not correct. Gf V3 prelude will not attempt to take the next
> available port.
I'll remove this.
>
> Page 26 : Note also : an entry can be made in the systems hosts file,
> pointing 127.0.0.1 to the localhost. 127.0.0.1 is not proxied.
I'll add this to the note.
>
>
> Page 29 : ~/.asadminprefs : don't know about this in prelude
> On windows : no command line security by default. This is imo a security
> breach in v3 predlude
Can anyone comment on this?
>
> Page 30 : V3 prelude does not automatically choose next available port on
> windows
I'll remove this.
>
> Page 31 : "After" is the default on V3 prelude, I think
I'm not totally clear on this.
>
> Page 32 : netstat only reports the first instance (at least on windows)
I'll change this.
>
> Page 34 : or you can kill it, refer to page 20
I'll add this to 'Cannot Stop Domain Using ...'
>
> Page 35 : Note that EJB Session Beans can be put in the war, just putting
> the EJB and it's interpaces in a normal package under the web project/war
> file
Good point. I'll include this.
>
> Page 37 : never used gf v3 with eclipse....
> But netstat -ab can proof usefull here (shows pid)
OK. I'll mention this.
>
> Page 38 : instllation errors related to ant :
> Depricated!
> For V3 Prelude, one does not need to rubn ant -f setup.xml anymore
I'll remove this.
>
> P49 : no an expert on this, but I think there's a possibility using java
> keytool?
Can anyone provide this information?
>
> In general :
>
> 2 Common errors are not discussed :
> - unsafe or unchecked operations :
> Is it possible this error occurs on deployment when one chooses not to
> precompile JSP's???
> In this case :
> Most common cause : lack of use of generics
> Refer to JSR 14
>
> - java.lang.OutOfMemoryError : PermGen space :
> increase perm gen space in server.xml
Great - thanks for these suggestions. I'm a little confused about the
first error - what's the error message (or is that included at the start
of your text)?
>
> Hope this helps...
Oh yes, this helps tremendously - thanks!
>
> wim
> -----Original Message-----
> From: Wim Verreycken [mailto:wim_at_pizzastop.be]
> Sent: maandag 24 november 2008 20:46
> To: dev_at_glassfish.dev.java.net
> Subject: RE: Reminder: Re: REVIEW REQUEST: Troubleshooting Guide
>
> Hi Gail, yes I reviewed it, I'll send comments tonight/tomorrow, sorry for
> the delay.
>
> Some questions remain open though, not an expert on all...
> wim
> -----Original Message-----
> From: Gail.Risdal_at_Sun.COM [mailto:Gail.Risdal_at_Sun.COM]
> Sent: maandag 24 november 2008 19:08
> To: dev_at_glassfish.dev.java.net; users_at_glassfish.dev.java.net;
> quality_at_glassfish.dev.java.net; docs_at_glassfish.dev.java.net
> Subject: Reminder: Re: REVIEW REQUEST: Troubleshooting Guide
>
> Hello,
>
> Just a reminder that review comments are due close of business today PT.
>
> Thanks,
> Gail
>
> Gail Risdal wrote:
>
>>Hello,
>>
>>The GlassFish v3 Prelude Troubleshooting Guide is now available for
>>review. Please review the document and provide feedback by close of
>>business Monday Nov 24th PT (earlier would be even better). I know
>>that's not much time, but that's the reality of the schedule.
>>
>>The document is available from the doc comments wiki:
>>http://wiki.glassfish.java.net/Wiki.jsp?page=TroubleShootingGuideV3
>>
>>Please add your comments to the page or, given the short timeline, send
>>them directly to me (gail.risdal_at_sun.com) - whatever is easiest for you.
>>A copyedit will be performed to address editorial and formatting issues
>>(and there are some), so I'm less concerned about those than I am about
>>the accuracy of the content. That's the important thing. Some of the
>>content was carried forward from the GlassFish v2 Troubleshooting Guide,
>>and some is new.
>>
>>Because the document covers so many areas and technologies, providing a
>>list of mandatory reviewers is not feasible in this case. Please review
>>the content for your specific area of expertise and ownership.
>>
>>Thanks in advance! Your input is important and greatly appreciated.
>>
>>Gail
>>+++++
>>GlassFish Documentation
>>
>>
>>---------------------------------------------------------------------
>>To unsubscribe, e-mail: dev-unsubscribe_at_glassfish.dev.java.net
>>For additional commands, e-mail: dev-help_at_glassfish.dev.java.net
>>
>
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe_at_glassfish.dev.java.net
> For additional commands, e-mail: dev-help_at_glassfish.dev.java.net
>
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe_at_glassfish.dev.java.net
> For additional commands, e-mail: dev-help_at_glassfish.dev.java.net
>
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe_at_glassfish.dev.java.net
> For additional commands, e-mail: dev-help_at_glassfish.dev.java.net
>