You are viewing a plain text version of this content. The canonical link for it is here.
Posted to jetspeed-dev@portals.apache.org by vk...@apache.org on 2008/10/31 14:45:18 UTC
svn commit: r709411 - in /portals/jetspeed-2/portal/trunk/tutorial/xdocs/01:
build-it.xml first-steps.xml genapp.xml run-it.xml
Author: vkumar
Date: Fri Oct 31 06:45:18 2008
New Revision: 709411
URL: http://svn.apache.org/viewvc?rev=709411&view=rev
Log:
Updating section 1 of jetspeed-2 tutorail for maven2 build system.
Modified:
portals/jetspeed-2/portal/trunk/tutorial/xdocs/01/build-it.xml
portals/jetspeed-2/portal/trunk/tutorial/xdocs/01/first-steps.xml
portals/jetspeed-2/portal/trunk/tutorial/xdocs/01/genapp.xml
portals/jetspeed-2/portal/trunk/tutorial/xdocs/01/run-it.xml
Modified: portals/jetspeed-2/portal/trunk/tutorial/xdocs/01/build-it.xml
URL: http://svn.apache.org/viewvc/portals/jetspeed-2/portal/trunk/tutorial/xdocs/01/build-it.xml?rev=709411&r1=709410&r2=709411&view=diff
==============================================================================
--- portals/jetspeed-2/portal/trunk/tutorial/xdocs/01/build-it.xml (original)
+++ portals/jetspeed-2/portal/trunk/tutorial/xdocs/01/build-it.xml Fri Oct 31 06:45:18 2008
@@ -37,21 +37,17 @@
# Windows
cd \JetspeedTraining\workspace\jetexpress
-mvn -P tomcat,min
+mvn install
+mvn jetspeed:mvn -Dtarget=proddb
+mvn jetspeed:mvn -Dtarget=deploy
]]>
</source>
<p>
- <i>Please take note that there is no space between the comma and the word <b>min</b></i>
- </p>
- <p>
- We are building a <b>min</b> (minimal) deployment. The Min deployment only creates a Jetspeed core portal and a Jetspeed Admin portlet application (j2-admin).
- When the build process completes, you should see the message <b>BUILD SUCCESSFUL</b> at the end of a large amount of build logging information
+ We are building jetexpress(Customized jetspeed portal) and portlet application. When the build process completes, you should see the message <b>BUILD SUCCESSFUL</b> at the end of a large amount of build logging information
The portal is built into a temp directory named <i>target</i> found directory under your <i>jetexpress</i> project directory.
- As well as building, the <i>tomcat,min</i> goals also:
</p>
<ul>
- <li>deploys Jetspeed to the Tomcat application server. If you are following the training material,
- the Tomcat directory is located under <i>/JetspeedTraining/tomcat-express/</i></li>
+ <li>Above command will deploy the deploys Jetexpress and create database on defined location and database, as specified in last step</li>
<li>creates the Jetspeed core schema tables in the Derby database</li>
<li>populates the database with a minimal set of portal information, including default roles, groups, profiles, and administrative users</li>
</ul>
Modified: portals/jetspeed-2/portal/trunk/tutorial/xdocs/01/first-steps.xml
URL: http://svn.apache.org/viewvc/portals/jetspeed-2/portal/trunk/tutorial/xdocs/01/first-steps.xml?rev=709411&r1=709410&r2=709411&view=diff
==============================================================================
--- portals/jetspeed-2/portal/trunk/tutorial/xdocs/01/first-steps.xml (original)
+++ portals/jetspeed-2/portal/trunk/tutorial/xdocs/01/first-steps.xml Fri Oct 31 06:45:18 2008
@@ -31,67 +31,24 @@
<subsection name='Copying in the settings.xml'>
<p>
The first step to building with Maven-2 is to setup your <b>settings.xml</b>.
- These settings hold all the information necessary to build with Maven-2 and Jetspeed.
+ These settings hold all the information necessary to build with Maven-2 and Jetspeed plugin.
</p>
- <p>There is a <i>settings.xml.jetexpress</i> file in the <i>/JetspeedTraining/resources/maven/</i> directory.
- Copy this file into your <i>Maven Home</i> directory. The Maven home directory
+ <p>You need to edit <i>settings.xml</i> This file is in Maven home directory
is located in a directory named <b>.m2</b> found under your <i>User Home</i> directory.
So for example that would be <i>~/.m2/</i> on Linux, or <i>"%USERPROFILE%\.m2\"</i> on Windows.
</p>
- <p>
- <b>Linux: paste into Command Line:</b>
- <input size ='80' value='mkdir ~/.m2'/>
- <input id='cl1' size="80" value="cp resources/maven/settings.xml.jetexpress ~/.m2/settings.xml"/>
- </p>
- <p>
- <b>Windows: paste into Command Line:</b>
- <input size="80" value='mkdir "%USERPROFILE%\.m2"'/>
- <input id='cl1' size="80" value='copy resources\maven\settings.xml.jetexpress "%USERPROFILE%\.m2\settings.xml"'/>
- </p>
</subsection>
<subsection name='Editing the settings.xml'>
- <p>
- The settings file is primarily for configuring your application server and database.
- The settings are preconfigured for an embedded Derby database, so more changes are required
- if another database solution is to be used, covered later in this tutorial.
- </p>
- <p>
- Edit the <i>~/.m2/settings.xml</i> file.
- </p>
- </subsection>
- <subsection name='Change the Jetspeed Server (Tomcat) Location'>
- <p>
- For the purpose of the training, lets all use the same Tomcat home, point it to the <i>/JetspeedTraining/tomcat-express</i> directory.
- </p>
- <source>
- <![CDATA[
- <org.apache.jetspeed.server.home>c:/JetspeedTraining/tomcat-express</org.apache.jetspeed.server.home>
- ]]>
- </source>
- </subsection>
- <subsection name='Change the Derby Database location'>
- <p>
- Next, lets change the location of our Derby database to the <i>/JetspeedTraining/database/jetexpress</i> directory.
- </p>
- <source>
- <![CDATA[
- <org.apache.jetspeed.production.database.url>jdbc:derby:/JetspeedTraining/database/jetexpress</org.apache.jetspeed.production.database.url>
- ]]>
- </source>
- </subsection>
- <subsection name='Change the Repository Location'>
- <p>
- Change the Maven local repository location by modifying the <i><localRepository></i>
- element in the settings.xml file. If you are using the training material, we have pre-configured
- a Maven-2 repository /JetspeedTraining/maven/repository. Lets configure Maven to point there,
- edit the <i>settings.xml</i>:
- </p>
- <source>
- <![CDATA[
- <localRepository>c:/JetspeedTraining/maven/repository/</localRepository>
- ]]>
- </source>
- <p>Go on and save that file.</p>
+ <p>
+ Add the following section in your settings.xml
+ <source>
+ <![CDATA[
+ <pluginGroups>
+ <pluginGroup>org.apache.portals.jetspeed-2</pluginGroup>
+ </pluginGroups>
+ ]]>
+ </source>
+ </p>
</subsection>
<p>
<a href='genapp.html'>Next</a>
Modified: portals/jetspeed-2/portal/trunk/tutorial/xdocs/01/genapp.xml
URL: http://svn.apache.org/viewvc/portals/jetspeed-2/portal/trunk/tutorial/xdocs/01/genapp.xml?rev=709411&r1=709410&r2=709411&view=diff
==============================================================================
--- portals/jetspeed-2/portal/trunk/tutorial/xdocs/01/genapp.xml (original)
+++ portals/jetspeed-2/portal/trunk/tutorial/xdocs/01/genapp.xml Fri Oct 31 06:45:18 2008
@@ -36,23 +36,42 @@
# Windows
cd \JetspeedTraining\workspace
-mvn archetype:create -DarchetypeGroupId=org.apache.portals.jetspeed-2
- -DarchetypeArtifactId=portal-archetype
- -DarchetypeVersion=2.1.3
+mvn archetype:generate -DarchetypeGroupId=org.apache.portals.jetspeed-2
+ -DarchetypeArtifactId=jetspeed-archetype
+ -DarchetypeVersion=2.2-SNAPSHOT
-DgroupId=org.apache.portals.tutorials
-DartifactId=jetexpress
- -Dversion=1.0
+ -Dversion=1.0
]]>
</source>
<p>
<b>Paste into Command Line:</b>
- <input id='genapp' size="80" value="mvn archetype:create -DarchetypeGroupId=org.apache.portals.jetspeed-2 -DarchetypeArtifactId=portal-archetype -DarchetypeVersion=2.1.3 -DgroupId=org.apache.portals.tutorials -DartifactId=jetexpress -Dversion=1.0"/>
+ <input id='genapp' size="80" value="mvn archetype:generate -DarchetypeGroupId=org.apache.portals.jetspeed-2 -DarchetypeArtifactId=jetspeed-archetype -DarchetypeVersion=2.2-SNAPSHOT -DgroupId=org.apache.portals.tutorials -DartifactId=jetexpress -Dversion=1.0"/>
</p>
<p>
- A directory named <b>jetexpress</b> under <i>/JetspeedTraining/workspace</i> should have been created.
+ A directory named <b>jetexpress</b> under <i>/JetspeedTraining/workspace</i> should have been created. This command will also create and sample portlet application, you can use this to create your own portlet and deployed with you customized jetspeed portal server.
Notice that <b>jetexpress</b> will be the name of your portal, not <b>jetspeed</b>. The idea is that you
can create a customized portal based upon Jetspeed, but with a different name, customized to meet your organization requirements.
</p>
+ <p>
+ Now jetspeed maven plugin have created an customized portal server and portlet applicaiton for you. Jetspeed need an database to run, so you need to specify the tomcat location where you want to deploy you
+ portal and database on which jetspeed would be running. you will find an <b>jetspeed-mvn-settings.xml</b> in your workspace. You need to edit <i>jetspeed-mvn-settings.xml</i>.
+ You will found server home and other database fields. you should change this according to your requirements.
+
+ <source>
+ <![CDATA[
+org.apache.jetspeed.server.home
+org.apache.jetspeed.production.database.default.name
+org.apache.jetspeed.production.jdbc.driver.groupId
+org.apache.jetspeed.production.jdbc.driver.artifactId
+org.apache.jetspeed.production.jdbc.driver.version
+org.apache.jetspeed.production.database.driver
+org.apache.jetspeed.production.database.url
+org.apache.jetspeed.production.database.user
+org.apache.jetspeed.production.database.password
+ ]]>
+ </source>
+ </p>
<p>
<a href='first-steps.html'>Previous</a> <a href='build-it.html'>Next</a>
</p>
Modified: portals/jetspeed-2/portal/trunk/tutorial/xdocs/01/run-it.xml
URL: http://svn.apache.org/viewvc/portals/jetspeed-2/portal/trunk/tutorial/xdocs/01/run-it.xml?rev=709411&r1=709410&r2=709411&view=diff
==============================================================================
--- portals/jetspeed-2/portal/trunk/tutorial/xdocs/01/run-it.xml (original)
+++ portals/jetspeed-2/portal/trunk/tutorial/xdocs/01/run-it.xml Fri Oct 31 06:45:18 2008
@@ -31,7 +31,7 @@
</p>
<source>
<![CDATA[
-cd tomcat-express
+cd $server_home
cd bin
# Windows
startup.bat
---------------------------------------------------------------------
To unsubscribe, e-mail: jetspeed-dev-unsubscribe@portals.apache.org
For additional commands, e-mail: jetspeed-dev-help@portals.apache.org