View File | Revision Log | Show Annotations | Download File | View Changeset
/hippo/attic/hippo-collab/branches/Branch-1.02/README
Revision: 31441
Committed: Mon Nov 28 14:58:10 2011 UTC (10 years, 10 months ago) by bvdschans
File size: 4433 byte(s)
Log Message:
CMSSIX-288: restructure CMS 6 SVN

File Contents

# Content
1 ===============================================
2 How to build and deploy the Hippo Collab Portal
3 ===============================================
4
5 1. Introduction
6
7 Very brief introduction to how to build, test and run the Hippo Collab Portal!
8
9 2. Requirements --
10
11 (1) Java 1.5
12 (2) Maven 2.0.9
13 (3) Tomcat 6.x
14 --> You should install Tomcat 6.x into a folder to deploy Hippo Collab Portal.
15
16 3. Building prerequisites
17
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:
47
48 https://svn.hippocms.org/repos/hippo/ecm/site-toolkit/trunk
49
50 4. 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
64 5. Doing Build
65
66 $ mvn clean install
67
68 6. Deploying
69
70 $ mvn org.apache.portals.jetspeed-2:jetspeed-mvn-maven-plugin:2.2.1-SNAPSHOT:mvn -Dtarget=all
71
72 (You can simplify the above command like this: "mvn jetspeed:mvn -Dtarget=all".
73 Please refer to http://portals.apache.org/jetspeed-2/buildguide/index.html for details.)
74
75
76 7. Running your Tomcat 6.x.
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
96 8. 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

Properties

Name Value
svn:eol-style native
svn:keywords Id