svn commit: r1174904 - in /portals/site: bridges/src/site/xdoc/bridges-script/ jetspeed/jetspeed-2.2/jetspeed-guide-build/src/site/xdoc/ jetspeed/jetspeed-2.2/src/site/xdoc/

Author: woonsan
Date: Fri Sep 23 17:37:37 2011
New Revision: 1174904

URL: http://svn.apache.org/viewvc?rev=1174904&view=rev
Log:
APA-45: Adding a warning note on max permanent generation size of jvm

Modified:
    portals/site/bridges/src/site/xdoc/bridges-script/index.xml
    
portals/site/jetspeed/jetspeed-2.2/jetspeed-guide-build/src/site/xdoc/jetspeed-archetype.xml
    
portals/site/jetspeed/jetspeed-2.2/jetspeed-guide-build/src/site/xdoc/maven-2-build.xml
    
portals/site/jetspeed/jetspeed-2.2/src/site/xdoc/getting-started-installer.xml

Modified: portals/site/bridges/src/site/xdoc/bridges-script/index.xml
URL: 
http://svn.apache.org/viewvc/portals/site/bridges/src/site/xdoc/bridges-script/index.xml?rev=1174904&r1=1174903&r2=1174904&view=diff
==============================================================================
--- portals/site/bridges/src/site/xdoc/bridges-script/index.xml (original)
+++ portals/site/bridges/src/site/xdoc/bridges-script/index.xml Fri Sep 23 
17:37:37 2011
@@ -439,6 +439,16 @@ new GenericPortlet(
           You must have the permission to add portlets into the page.
         </p>
       </subsection>
+      <subsection name="7. Additional Notes">
+        <p>
+          <em>Note:</em> You may need to increase the permanent generation 
size of your JVM to run script portlets without <CODE>OutOfMemoryError</CODE> 
errors.
+          <br/>
+          Because JSR-223 Scripting Engine implementations depend on dynamic 
proxy solutions, it requires more permanent generation space.
+          By default, it is 64MB. Increasing it to be 
<CODE>-XX:MaxPermSize=128m</CODE> might be a good start.
+          <br/>
+          Please see <a 
href="http://wiki.apache.org/tomcat/FAQ/Memory">http://wiki.apache.org/tomcat/FAQ/Memory</a>
 for detail.
+        </p>
+      </subsection>
     </section>
   </body>
 </document>

Modified: 
portals/site/jetspeed/jetspeed-2.2/jetspeed-guide-build/src/site/xdoc/jetspeed-archetype.xml
URL: 
http://svn.apache.org/viewvc/portals/site/jetspeed/jetspeed-2.2/jetspeed-guide-build/src/site/xdoc/jetspeed-archetype.xml?rev=1174904&r1=1174903&r2=1174904&view=diff
==============================================================================
--- 
portals/site/jetspeed/jetspeed-2.2/jetspeed-guide-build/src/site/xdoc/jetspeed-archetype.xml
 (original)
+++ 
portals/site/jetspeed/jetspeed-2.2/jetspeed-guide-build/src/site/xdoc/jetspeed-archetype.xml
 Fri Sep 23 17:37:37 2011
@@ -257,6 +257,14 @@ $ mvn org.apache.maven.plugins:maven-arc
             <a class="externalLink" 
href="http://localhost:8080/hello">http://localhost:8080/hello</a>
         </p>
       </subsection>
+      <subsection name="Note on Permanent Generation Size of Your JVM">
+      <p>
+        <em>Note:</em> You may need to increase the permanent generation size 
of your JVM when there are a lot of Servlets, JSP's 
+        or when script portlets are used, in order to avoid 
<CODE>OutOfMemoryError</CODE> errors.
+        By default, it is 64MB. Increasing it to be 
<CODE>-XX:MaxPermSize=128m</CODE> might be a good start.
+        Please see <a 
href="http://wiki.apache.org/tomcat/FAQ/Memory">http://wiki.apache.org/tomcat/FAQ/Memory</a>
 for detail.
+      </p>
+      </subsection>
       <subsection name="Advanced Build Options">
         <p>
           By the command, `$mvn jetspeed:mvn -Dtarget=all', the 
<strong>jetspeed-archtype</strong> will build and install your custom portal 
project, initialize your database and finally deploy your portal and portlet 
application to your Tomcat.

Modified: 
portals/site/jetspeed/jetspeed-2.2/jetspeed-guide-build/src/site/xdoc/maven-2-build.xml
URL: 
http://svn.apache.org/viewvc/portals/site/jetspeed/jetspeed-2.2/jetspeed-guide-build/src/site/xdoc/maven-2-build.xml?rev=1174904&r1=1174903&r2=1174904&view=diff
==============================================================================
--- 
portals/site/jetspeed/jetspeed-2.2/jetspeed-guide-build/src/site/xdoc/maven-2-build.xml
 (original)
+++ 
portals/site/jetspeed/jetspeed-2.2/jetspeed-guide-build/src/site/xdoc/maven-2-build.xml
 Fri Sep 23 17:37:37 2011
@@ -268,6 +268,14 @@
                     For login, use one of the following username/password 
combinations: admin/admin, user/user, jetspeed/jetspeed
                 </p>
             </subsection>
+            <subsection name="Note on Permanent Generation Size of Your JVM">
+            <p>
+              <em>Note:</em> You may need to increase the permanent generation 
size of your JVM when there are a lot of Servlets, JSP's 
+              or when script portlets are used, in order to avoid 
<CODE>OutOfMemoryError</CODE> errors.
+              By default, it is 64MB. Increasing it to be 
<CODE>-XX:MaxPermSize=128m</CODE> might be a good start.
+              Please see <a 
href="http://wiki.apache.org/tomcat/FAQ/Memory">http://wiki.apache.org/tomcat/FAQ/Memory</a>
 for detail.
+            </p>
+            </subsection>
             <subsection name="Deploying a minimal Jetspeed Portal">
                 <p>
                   If you don't need the demo portlet applications, you can 
also deploy Jetspeed with only the j2-admin portlet application using the 
following command instead:

Modified: 
portals/site/jetspeed/jetspeed-2.2/src/site/xdoc/getting-started-installer.xml
URL: 
http://svn.apache.org/viewvc/portals/site/jetspeed/jetspeed-2.2/src/site/xdoc/getting-started-installer.xml?rev=1174904&r1=1174903&r2=1174904&view=diff
==============================================================================
--- 
portals/site/jetspeed/jetspeed-2.2/src/site/xdoc/getting-started-installer.xml 
(original)
+++ 
portals/site/jetspeed/jetspeed-2.2/src/site/xdoc/getting-started-installer.xml 
Fri Sep 23 17:37:37 2011
@@ -135,6 +135,14 @@ cd ~/jetspeed-2.2.1/bin
                        startup and final installation. After starting the 
server, start up a web browser 
                        and navigate to <a 
href='http://localhost:8080/jetspeed/portal'>http://localhost:8080/jetspeed/portal</a>
                               
                        </p>
+            </subsection>
+                       <subsection name="Note on Permanent Generation Size of 
Your JVM">
+                       <p>
+                         <em>Note:</em> You may need to increase the permanent 
generation size of your JVM when there are a lot of Servlets, JSP's 
+                         or when script portlets are used, in order to avoid 
<CODE>OutOfMemoryError</CODE> errors.
+              By default, it is 64MB. Increasing it to be 
<CODE>-XX:MaxPermSize=128m</CODE> might be a good start.
+              Please see <a 
href="http://wiki.apache.org/tomcat/FAQ/Memory">http://wiki.apache.org/tomcat/FAQ/Memory</a>
 for detail.
+                       </p>
                        </subsection>
                        <subsection name="Login to Jetspeed-2">
                        <p>