[jboss-dev-forums] [Design of JBoss Wiki] - Re: Installation of JBoss Wiki

[PeterJ]

Finally! Success!

Here is what I did:

1) Downloaded the source from subversion:

svn co https://anonsvn.jboss.org/repos/portletswap/contrib/wikiPortlet/tags/1.0 wiki_1.0 

2) Manually installed several missing libraries:

mvn install:install-file -DgroupId=jboss -DartifactId=portal-core-lib -Dversion=1.0 -Dpackaging=jar -Dfile=%PORTAL_HOME%\jboss-portal.sar\lib\portal-core-lib.jar
  | mvn install:install-file -DgroupId=jboss -DartifactId=portal-portlet-lib -Dversion=1.0 -Dpackaging=jar -Dfile=%PORTAL_HOME%\jboss-portal.sar\lib\portal-portlet-lib.jar
  | mvn install:install-file -DgroupId=jboss -DartifactId=portal-identity-lib -Dversion=1.0 -Dpackaging=jar -Dfile=%PORTAL_HOME%\jboss-portal.sar\lib\portal-identity-lib.jar
  | mvn install:install-file -DgroupId=jboss -DartifactId=portal-common-lib -Dversion=1.0 -Dpackaging=jar -Dfile=%PORTAL_HOME%\jboss-portal.sar\lib\portal-common-lib.jar
  | mvn install:install-file -DgroupId=jboss -DartifactId=jboss-portlet-api-lib -Dversion=1.0 -Dpackaging=jar -Dfile=%PORTAL_HOME%\jboss-portal.sar\lib\jboss-portlet-api-lib.jar
  | mvn install:install-file -DgroupId=jboss -DartifactId=jboss-ejb3x -Dversion=1.0 -Dpackaging=jar -Dfile=%JBOSS_HOME%\client\jboss-ejb3x.jar
  | mvn install:install-file -DgroupId=jboss -DartifactId=jboss-mail -Dversion=1.0 -Dpackaging=jar -Dfile=%JBOSS_HOME%\server\default\lib\mail.jar
  | mvn install:install-file -DgroupId=jboss -DartifactId=activation -Dversion=1.0 -Dpackaging=jar -Dfile=%JBOSS_HOME%\server\default\lib\activation.jar
  | mvn install:install-file -DgroupId=jboss -DartifactId=portal-api-lib -Dversion=2.7.1 -Dpackaging=jar -Dfile=%PORTAL_HOME%\jboss-portal.sar\lib\portal-api-lib.jar
  | mvn install:install-file -DgroupId=jboss -DartifactId=jboss-jmx -Dversion=1.0 -Dpackaging=jar -Dfile=%JBOSS_HOME%\lib\jboss-jmx.jar
  | mvn install:install-file -DgroupId=jboss -DartifactId=portlet-api -Dversion=2.4.0 -Dpackaging=jar -Dfile=%PORTAL_HOME%\jboss-portal.sar\lib\portlet-api.jar
  | mvn install:install-file -DgroupId=jboss -DartifactId=jboss-j2ee -Dversion=1.0 -Dpackaging=jar -Dfile=%JBOSS_HOME%\server\default\lib\jboss-j2ee.jar
  | mvn install:install-file -DgroupId=jboss -DartifactId=jboss-annotations-ejb3 -Dversion=1.0 -Dpackaging=jar -Dfile=%JBOSS_HOME%\client\jboss-annotations-ejb3.jar

(Looks like the forum is wrapping the lines - each 'mvn' command should be on a single line)

%JBOSS_HOME% is where the JBoss AS 4.2.3.GA binary zip file was installed.

%PORTAL_HOME% is where the Portal 2.7.1.GA binrary was unpacked. If using the Portal + AS bundle, PORTAL_HOME is %JBOSS_HOME%\server\default.
Linux readers can adjust the syntax accordingly.

3) Commented out the jboss-ejb3 dependency in all five pom.xml files.  There is a story behind this - some of the names used for JAR files in the POMs don't match the names o JAR files in either AS or Portal. So when in doubt, I commented out the dependency. If the build failed, I looked up the JAR containing the missing class and manually installed it. There was never an error based on the missing jboss-ejb3 dependency.

By the way, why are the dependencies mentioned in the base pom.xml repeated in the pom.xml files in the subdirectories? Those subdirectory POMs reference the base POM as a parent and thus pick up the dependencies automatically.


4) I then cd'ed into the wiki-common, wiki-management, wiki-test and forge-wiki directories and ran:

mvn install

in each one. I had to run it twice for wiki-common, once with 'packaging' set to 'pom' and once with it set to 'jar'.

5) I then changed the version number of the dependency of portal-identify-lib in the base pom.xml to 1.0 (from 2.7.1) to match the version number in wiki-common/pom.xml. 

By the way, it would be nice if the versions were correct! Hardly any of the JARs identified as being at version 1.0 are at that version. If the proper version and artifact names were used, they could be pulled from the JBoss Maven repository instead of
being manually installed.

6) Then from the base directory I ran:

mvn install

The build then completed successfully.

I recommend that someone on the Wiki team make the corrections to the pom.xml files that I mentioned above. And in the base pom.xml, change the header comment to this:

<!--
  | * JBoss, Home of Professional Open Source
  | * Copyright 2009, JBoss Inc., and individual contributors as indicated
  | * by the @authors tag. See the copyright.txt in the distribution for a
  | * full listing of individual contributors.
  | *
  | * This is free software; you can redistribute it and/or modify it
  | * under the terms of the GNU Lesser General Public License as
  | * published by the Free Software Foundation; either version 2.1 of
  | * the License, or (at your option) any later version.
  | *
  | * This software is distributed in the hope that it will be useful,
  | * but WITHOUT ANY WARRANTY; without even the implied warranty of
  | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  | * Lesser General Public License for more details.
  | *
  | * You should have received a copy of the GNU Lesser General Public
  | * License along with this software; if not, write to the Free
  | * Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
  | * 02110-1301 USA, or see the FSF site: http://www.fsf.org.
  | 
  |   
  |   BUILD INSTRUCTIONS
  |   ==================
  |   
  |   1) Manually install various artifacts
  |   
  |   Before you run the build, you must manully install a number of JAR files
  |   into your local Maven repository. The JARs you need to install are:
  |   
  |   From JBoss Portal:
  |     portal-core-lib.jar, version 1.0
  |     portal-portlet-lib, version 1.0
  |     portal-common-lib.jar, version 2.7.1
  |     portal-identity-lib.jar, version 1.0
  |     jboss-portlet-api-lib.jar, version 1.0
  |     jboss-ejb3x.jar, version 1.0
  |     jboss-mail.jar, version 1.0
  |     activation.jar, version 1.0
  |     portal-api-lib.jar, version 2.7.1
  |     jboss-jmx.jar, version 1.0
  |     portlet-api.jar, version 2.4.0
  |     jboss-j2ee.jar, version 
  |     jboss-annotations-ejb3
  | 
  |   Here is an example for installing portal-core-lib.jar, install the other
  |   JAR files using similar command. (If you miss one, or mistype it, Maven
  |   will remind you of the syntax for installing a JAR file.) In the example,
  |   <portal-home> is the location where the Portal binary zip file was unpacked.
  |   
  |      mvn install:install-file -DgroupId=jboss -DartifactId=portal-core-lib -Dversion=1.0 -Dpackaging=jar -Dfile=<portal-home>/jboss-portal.sar/lib/portal-core-lib.jar
  | 
  |   Note that some of the dependencies are located in JBoss AS, not in Portal.
  | 
  | 
  |   2) Build the prerequisite projects
  | 
  |   You must build the wiki-common, wiki-management and wiki-test artifacts first.
  |   To do this, open a command line the corresponding directory, for example:
  |   
  |     cd <wiki-src-dir>/wiki-common
  |   
  |   where <wiki-src-dir> is the base directory of the wiki source, and enter:
  |   
  |      mvn install
  | 
  | 
  |   3) Build the wiki
  |   
  |   Open a command line at the directory containing this POM and enter:
  |   
  |      mvn install
  |   
  |   author: Piergiorgio Lucidi
  | -->

By the way, the licensing text should really follow what is recommended for LGPL.


View the original post : http://www.jboss.org/index.html?module=bb&op=viewtopic&p=4217193#4217193

Reply to the post : http://www.jboss.org/index.html?module=bb&op=posting&mode=reply&p=4217193