Author: vjrj_ Date: 2011-11-17 01:24:07 +0100 (Thu, 17 Nov 2011) New Revision: 1612 Added: trunk/.apt_generated/ Modified: trunk/ trunk/INSTALL trunk/README trunk/TROUBLESHOOT trunk/pom.xml trunk/src/main/java/cc/kune/hspace/client/GroupContentHomeLink.ui.xml Log: Documentation improved thanks to the feedback of @superbranch Property changes on: trunk ___________________________________________________________________ Name: svn:ignore - pmd-eclipse.log .pmd www-test screenlog.0 client public target target-local Main-compile .settings .gwt-cache repository derby.log star-yellow-grey.png run.sh tomcat gwt-out synccss.sh .externalToolBuilders .wtpmodules www testRepository kune-OLD-jcr KuneApp.launch KuneApp NOSERVER.launch old_src org.ourproject.kune.app.Kune org.ourproject.kune.iml org.ourproject.kune.ipr org.ourproject.kune.iws nbproject hibernate.reveng.xml .gwt-tmp target-eclipse .checkstyle .classpath-bien pom.xml.* .gwt .jdee_sources .jdee_classpath prj.el .factorypath .apt_generated target.old _accounts _certificates _deltas logs test-output .recommenders _sessions chromedriver.log kune-screencast* + pmd-eclipse.log .pmd www-test screenlog.0 client public target target-local Main-compile .settings .gwt-cache repository derby.log star-yellow-grey.png run.sh tomcat gwt-out synccss.sh .externalToolBuilders .wtpmodules www testRepository kune-OLD-jcr KuneApp.launch KuneApp NOSERVER.launch old_src org.ourproject.kune.app.Kune org.ourproject.kune.iml org.ourproject.kune.ipr org.ourproject.kune.iws nbproject hibernate.reveng.xml .gwt-tmp target-eclipse .checkstyle .classpath-bien pom.xml.* .gwt .jdee_sources .jdee_classpath prj.el .factorypath target.old _accounts _certificates _deltas logs test-output .recommenders _sessions chromedriver.log kune-screencast* Modified: trunk/INSTALL =================================================================== --- trunk/INSTALL 2011-11-16 18:54:28 UTC (rev 1611) +++ trunk/INSTALL 2011-11-17 00:24:07 UTC (rev 1612) @@ -87,6 +87,10 @@ sudo chown yourUser:yourUser /var/lib/kune/lucene/kune_dev/indexes sudo chown yourUser:yourUser /var/lib/kune/lucene/kune_test/indexes + But in general you can do it recursively with: + + sudo chown -R yourUser:yourUser /var/lib/kune/ + ====Aditional info for W$ users==== Not verified: In case you are using windows as dev platform you only have to create a couple of folders anywhere you like and then specify them in persistence.xml, as follows: @@ -147,7 +151,7 @@ ===Connecting to the server=== -Open your browser and connect to http://localhost:8888/ws/ +Open your browser and connect to http://localhost:8888/ ==Production environment instructions== Modified: trunk/README =================================================================== --- trunk/README 2011-11-16 18:54:28 UTC (rev 1611) +++ trunk/README 2011-11-17 00:24:07 UTC (rev 1612) @@ -1 +1,25 @@ -See INSTALL file for instructions += README of KUNE = + +See the INSTALL file for instructions of how to run Kune. Please follow closely. + +See the DEV-GUIDE for developers information and guidelines. + +See the TROUBLESHOOT file in you have problems with the installation or the development. + +See the CREDITS COPYRIGHT for legal info and author/contributors. + +and for BUGS for inform about problems/feedback etc. + +== Adapting Kune to your site == + +Adapt as much as possible to your needs this files: + +- src/main/resources/kune.properties +- src/main/resources/wave-server.properties +- src/main/resources/log4j.properties +- src/main/webapp/ws.html + +The last one is the home that you get at start-up and have some configurations also. You can change the html inside to your needs but follow the commentaries and try not to remove important parts that make kune to start. + +Note: Remember that if you change this files in some point, you have to make 'mvn compile' so are copied to the target directoy. + Modified: trunk/TROUBLESHOOT =================================================================== --- trunk/TROUBLESHOOT 2011-11-16 18:54:28 UTC (rev 1611) +++ trunk/TROUBLESHOOT 2011-11-17 00:24:07 UTC (rev 1612) @@ -65,6 +65,14 @@ http://code.google.com/p/gwt-examples/wiki/gwtEclipseFaqs about how to fix it in your system. +== If you change some .properties or configuration files in src directory == + +Be sure to do mvn compile (that copy them to the target directory) + +== If the client get: Error fetching initial data from Kune server == + +Probably the client code is outdated from the server code (or viceversa). Try to get both codes in sync compiling it. + == Mysql: Caused by: java.sql.SQLException: Access denied for user 'kune'@'localhost' (using password: YES) == Check that the password you have use in the database creation it's the same like the src/main/resources/META-INF/persistence.xml. If it's wrong maybe you have to remove the mysql user (DROP USER) and repeat the GRANT sentences of the INSTALL. @@ -97,6 +105,15 @@ #general_log = 1 in /etc/mysql/my.cnf +== If during initialization (first start) you get a 'Account already exists' == + +If you stopped the first initialization and the server init is half started you will get something like: + +Caused by: cc.kune.core.client.errors.UserRegistrationException: +Account already exists + +trying to run kune and creating the DB. So better remove the first account of wave and related /var/lib/kune/_* + == Eclipse & GWT == If you have some tests with error like "can not be found in source packages. Check the inheritance chain from your module; it may not be inheriting a required module or a module may not be adding its source path entries properly" and you have installed GWTDesigner, uncheck "client classpath": http://code.google.com/webtoolkit/tools/gwtdesigner/preferences/gwt/preferen... @@ -118,8 +135,17 @@ Compile in PRETTY mode and edit target/kune-VERSION/ws/ws.nocache.js and look for 'unflattenKeylistIntoAnswers' to see a permutation list. See: https://groups.google.com/group/google-web-toolkit/browse_thread/thread/ec77... -=== Outbound variable M2_REPO === +If you want to compile less permutations (only for dev or testing), comment some locale and user.agent in src/main/java/cc/kune/Kune.gwt.xml +== Outbound variable M2_REPO == + Set M2_REPO to eclipse in Preferences > Java > Build Path > Classpath Variable (normally to /home/youruser/.m2/repository/) -=== +== Error generating CoreResources == + +[INFO] Computing all possible rebind results for 'cc.kune.core.client.resources.CoreResources' [INFO] Rebinding cc.kune.core.client.resources.CoreResources [INFO] Invoking generator com.google.gwt.resources.rebind.context.StaticClientBundleGenerator [INFO] [ERROR] Generator 'com.google.gwt.resources.rebind.context.StaticClientBundleGenerator' threw an exception while rebinding 'cc.kune.cor + [INFO] at com.google.gwt.dev.util.Util.computeStrongName(Util.java:170) [INFO] at com.google.gwt.dev.util.Util.computeStrongName(Util.java:145) [INFO] at com.google.gwt.resources.rebind.context.StaticResourceContext.deploy(StaticResourceContext.java:61) + +http://code.google.com/p/google-web-toolkit/issues/detail?id=6103 + +The gwt compiler is trying to create a sprite sheet, an image with all the icons all together (to minimize calls from client to server) but cannot open all the files. This happens normally when ulimit is not setted. See: "Too many files open" above. Modified: trunk/pom.xml =================================================================== --- trunk/pom.xml 2011-11-16 18:54:28 UTC (rev 1611) +++ trunk/pom.xml 2011-11-17 00:24:07 UTC (rev 1612) @@ -1025,7 +1025,7 @@ <!-- <style>PRETTY</style> --> <noServer>true</noServer> <gwtVersion>${gwt.version}</gwtVersion> - <runTarget>/ws/ws.html?log_level=DEBUG</runTarget> + <runTarget>/ws.html?log_level=DEBUG</runTarget> <hostedWebapp>${project.build.directory}/${project.build.finalName} </hostedWebapp> <modules> Modified: trunk/src/main/java/cc/kune/hspace/client/GroupContentHomeLink.ui.xml =================================================================== --- trunk/src/main/java/cc/kune/hspace/client/GroupContentHomeLink.ui.xml 2011-11-16 18:54:28 UTC (rev 1611) +++ trunk/src/main/java/cc/kune/hspace/client/GroupContentHomeLink.ui.xml 2011-11-17 00:24:07 UTC (rev 1612) @@ -6,7 +6,7 @@ <g:FlowPanel styleName="k-home-group-stats-item"> <!-- yes, we use url here because avatars are urls links not resources --> <g:Image ui:field="icon" width="22px" height="22px" styleName="k-home-group-cnt-icon" - url="images/clear.png" /> + url="ws/images/clear.png" /> <g:Hyperlink ui:field="link" styleName="k-home-group-cnt-link" /> </g:FlowPanel> </ui:UiBinder> \ No newline at end of file