View File | Revision Log | Show Annotations | Download File | View Changeset
/hippo/hippo-collab/trunk/README
(Generate patch)

Comparing hippo-collab/trunk/README (file contents):
Revision 22649 by adouma, Fri Feb 12 15:10:06 2010 UTC vs.
Revision 22650 by wko, Tue May 4 10:39:02 2010 UTC

7 Very brief introduction to how to build, test and run the Hippo Collab Portal! 7 Very brief introduction to how to build, test and run the Hippo Collab Portal!
8 8
92. Requirements -- 92. Requirements --
10 10
11 (1) Java 1.5 11 (1) Java 1.5
12 (2) Maven 2.0.9 12 (2) Maven 2.0.10 or Maven 2.2.1
13 (3) Tomcat 6.x
14 --> You should install Tomcat 6.x into a folder to deploy Hippo Collab Portal.
15 13
163. Building prerequisites 143. Building prerequisites
17 15
18 (1) Check out and build apa-webcontent-1.1-SNAPSHOT from the following URL:
19
20 http://svn.apache.org/repos/asf/portals/applications/webcontent/trunk
21
22 (2) Check out and build apa-gems-1.1-SNAPSHOT from the following URL:
23
24 http://svn.apache.org/repos/asf/portals/applications/gems/trunk
25
26 (3) Check out and build apa-rss-1.1-SNAPSHOT from the following URL:
27
28 http://svn.apache.org/repos/asf/portals/applications/rss/trunk
29
30 (4) Check out and build apa-demo-1.1-SNAPSHOT from the following URL:
31
32 http://svn.apache.org/repos/asf/portals/applications/demo/trunk
33
34 (5) Check out and build Pluto-2.0.1-SNAPSHOT from the following URL:
35
36 https://svn.apache.org/repos/asf/portals/pluto/trunk
37
38 (6) Check out and build Jetspeed-2.2.1-SNAPSHOT from the following URL:
39
40 http://svn.apache.org/repos/asf/portals/jetspeed-2/portal/trunk
41
42 (7) Check out and build J2-ADMIN-2.2.1-SNAPSHOT from the following URL:
43
44 http://svn.apache.org/repos/asf/portals/jetspeed-2/applications/j2-admin/trunk
45
46 (8) Check out and build HST-2 from the following trunk scm URL: 16 (1) Check out and build HST-2 from the following trunk scm URL:
47 17
48 https://svn.hippocms.org/repos/hippo/ecm/site-toolkit/trunk 18 https://svn.hippocms.org/repos/hippo/ecm/site-toolkit/trunk
49 19
504. Configuring Build
51
52 (1) Create your own build configuration file
53 by copying "jetspeed-mvn-settings.xml.sample" to "jetspeed-mvn-settings.xml" in the project root folder.
54
55 (2) Edit your "jetspeed-mvn-settings.xml":
56
57 - Change the following property to set the correct path of your local TOMCAT installation path:
58
59 <org.apache.jetspeed.server.home>/change/this/apache-tomcat-6.0.20/</org.apache.jetspeed.server.home>
60
61 - Optionally, you can change the database settings in your "jetspeed-mvn-settings.xml".
62 However, you don't have to, in most demonstration uses, because it initializes derby portal database automatically.
63
645. Doing Build 204. Doing Build
65 21
66 $ mvn clean install 22 $ mvn clean install
67 23
686. Deploying 245. Running
25
26 -- In a console,
69 27
70 $ mvn org.apache.portals.jetspeed-2:jetspeed-mvn-maven-plugin:2.2.1-SNAPSHOT:mvn -Dtarget=all 28 $ cd cms
29 $ mvn jetty:run-war
71 30
72 (You can simplify the above command like this: "mvn jetspeed:mvn -Dtarget=all". 31 -- In another console,
73 Please refer to http://portals.apache.org/jetspeed-2/buildguide/index.html for details.)
74 32
33 $ cmd site
34 $ mvn jetty:run
75 35
767. Running your Tomcat 6.x. 36 Visit http://localhost:8085/site/
77
78 NOTE: You must set 'emptySessionPath="true"' in the $CATALINA_HOME/conf/server.xml like the following example!!!
79
80 <!-- N.B. the attribute names are case-sensitive! -->
81
82 <Connector port="8080" protocol="HTTP/1.1"
83 connectionTimeout="20000"
84 redirectPort="8443"
85 emptySessionPath="true" />
86
87
88 Now, you can run the Hippo Collab Portal by starting your Tomcat 6.x.
89
90 (1) You can visit portal: http://localhost:8080/collab/
91 (2) You can visit cms by http://localhost:8080/cms/main/ (with ending slash)
92 (3) You can visit cms console by http://localhost:8080/cms/console/ (with ending slash)
93 (4) You can visit repository console by http://localhost:8080/cms/repository/ (with ending slash)
94 (5) You can visit wiki HST-2 site application by http://localhost:8080/wiki/preview/ or http://localhost:8080/wiki/.
95
968. Deploying using MySQL database for the Repository/CMS
97
98 If you want to use a MySQL database for the Repository instead of the default embedded Derby database
99 then fill in/adjust at least the following properties defined in your local jetspeed-mvn-settings.xml:
100
101 org.onehippo.portal.collab.repository.database.user
102 org.onehippo.portal.collab.repository.database.password
103 org.onehippo.portal.collab.repository.directory
104
105 Then, instead of using the -Dtarget=all parameter as shown in step 6., use -Dtarget=all-cms-mysql
106 Or, you can even switch from Derby to MySQL (so after doing step 6.) using -Dtarget=deploy-cms-mysql
107
108 Note: if you want to switch back from MySQL to Derby, you'll have to delete the file $TOMCAT_HOME/conf/Catalina/localhost/cms.xml
109 manually before starting tomcat again!
110

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines