Author: ilya_shaikovsky Date: 2010-09-14 11:19:59 -0400 (Tue, 14 Sep 2010) New Revision: 19198 Modified: sandbox/trunk/archetypes/rf-gae-sample/readme.txt sandbox/trunk/archetypes/rf-gae-sample/src/main/resources/archetype-resources/readme.txt Log: readme.txt files corrections. Modified: sandbox/trunk/archetypes/rf-gae-sample/readme.txt =================================================================== --- sandbox/trunk/archetypes/rf-gae-sample/readme.txt 2010-09-14 15:11:57 UTC (rev 19197) +++ sandbox/trunk/archetypes/rf-gae-sample/readme.txt 2010-09-14 15:19:59 UTC (rev 19198) @@ -14,7 +14,7 @@ -DgroupId=<yourGroupId> -DartifactId=<yourArtifactId> -Dversion=1.0-SNAPSHOT 2) To build the project for deploy to GAE cloud, run - mvn clean install -Pgae + mvn clean install *BEFORE NEXT STEP - you should setup your GAE account at http://appspot.com and register new application there. (read more at http://code.google.com/intl/ru/appengine/docs/python/gettingstarted/uploa...) @@ -22,6 +22,9 @@ 3) Then just execute appcfg from GAE SDK(link) to publish to your account: appcfg update <PATH: "generated-application-target-folder/output application folder"> +NOTE:Do not forget to register your own application name and make sure that the demo uses the same name accordingly. + + 4) now visit your application using http://<application-name>.appspot.com 4.1) check all the information about deployed application at https://appengine.google.com/dashboard?&app_id=<your-application-i... Modified: sandbox/trunk/archetypes/rf-gae-sample/src/main/resources/archetype-resources/readme.txt =================================================================== --- sandbox/trunk/archetypes/rf-gae-sample/src/main/resources/archetype-resources/readme.txt 2010-09-14 15:11:57 UTC (rev 19197) +++ sandbox/trunk/archetypes/rf-gae-sample/src/main/resources/archetype-resources/readme.txt 2010-09-14 15:19:59 UTC (rev 19198) @@ -1,12 +1,38 @@ Project generated with richfaces-archetype-gae -1.1) To build this project for GAE deploy +1) To build the project for deploy to GAE cloud, run + mvn clean install - mvn clean install -1.2) to deploy application to GAE use appcfg from GAE SDK. follow instructions from appspot.com +*BEFORE NEXT STEP - you should setup your GAE account at http://appspot.com and register new application there. +(read more at http://code.google.com/intl/ru/appengine/docs/python/gettingstarted/uploa...) +2) Then just execute appcfg from GAE SDK(link) to publish to your account: + appcfg update <PATH: "generated-application-target-folder/output application folder"> -2) If you wan to create a binaries for Tomcat 6 and JBoss 6 run +NOTE:Do not forget to register your own application name and make sure that the demo uses the same name accordingly. - mvn clean package -P release +3) now visit your application using http://<application-name>.appspot.com +3.1) check all the information about deployed application at https://appengine.google.com/dashboard?&app_id=<your-application-i... + + +PAY ATTENTION: +during build with GAE profile(default one) - our org.richfaces.cdk:maven-resource-plugin executed and generates static resources(web-app\static-resources\) for all the skins in order to +solve the compatibility problem with GAE which restricts java2D usage(our dynamic resources works using that dependency) + +NOTES about additional artifacts in webapp folder: +1) java-gae-jsf-ri - contains modified WebConfiguration.java class which will be put to Web-inf\classes when building with GAE profile. It solves compatibilities +issues exist in GAE for JSF applications. + +2) Webapp-gae folder contains GAE descriptor(appengine-web.xml) and modified application web.xml. Them will be placed to WEb-inf folder after build with GAE profile. web.xml +should be different in order to use static resources generated by plugin instead of dynamic resources. And also restricts threading with +com.sun.faces.enableThreading context parameter as GAE not allows threads. + +============================================================================================================ + +LOCAL DEPLOYMENT +you still could deploy your application as usually using +1) mvn clean install -Prelease +2) put to tomcat6 or jboss (war's for both application servers will be created) +3) run choosen server +4) enjoy going to http:\\localhost:8080\<app-name> \ No newline at end of file