You are viewing a plain text version of this content. The canonical link for it is here.
Posted to general@portals.apache.org by wo...@apache.org on 2011/09/23 19:37:37 UTC

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>