HOWTO: Install needed tools and frameworks

Install needed tools and frameworks to enable a fluent open source development for the spcp7 project.

  1. Integrated Developer Enviroment
    • Eclipse

      Simply go to http://www.eclipse.org/downloads/ and download a suitable Eclipse version for your system.

      1. Subversion management
        • Subclipse

          To install the subversion management Subclipse follow the steps provided on this page http://subclipse.tigris.org/install.html

      2. XML and Persistance tools
        • JBoss Developer Studio

          Download within Eclipse from the update site http://download.jboss.org/jbosstools/updates/stable or follow these instructions http://labs.jboss.com/wiki/InstallingJBossTools

  2. Build tool
    • Maven

      To use Maven we chose an integration for Eclipse. There are several available and we took M2Eclipse from http://m2eclipse.codehaus.org/.

              Maven Integration for Eclipse provides tight integration for Maven into the IDE and providing the following features:
              
                      * Launching Maven builds from within Eclipse
               
                      * Dependency management for Eclipse build path based on Maven's pom.xml
               
                      * Resolving Maven dependencies from the Eclipse workspace without installing to local Maven repository
               
                      * Automatic downloading of the required dependencies from the remote Maven repositories
                      
                      * Wizards for creating new Maven projects, pom.xml or to enable Maven support on plain Java project
                      
                      * Quick search for dependencies in Maven remote repositories
                      
                      * Quick fixes in the Java editor for looking up required dependencies/jars by the class or package name
          
          
      
              This plugin is using the Maven Embedder component to launch Maven and to work with all Maven data. This is work in progress and we are working hard to make it smooth and nice. 
              

      After installing Maven you have to configure the path to the local repository in its settings.xml. Settings.xml has to be placed in the ~/.m2/ directory.

  3. Ajax framework
    • Icefaces

      http://www.icefaces.org/main/downloads/os-downloads.iface

  4. Portlet Container
    • Liferay

      The easiest way to get an running Liferay on your system, you can download a bundled version of Liferay from their homepage http://www.liferay.com/web/guest/downloads/portal We chose to use a bundled version with Tomcat 6.0, to get it running you will also need a working Java development kit on your system

    Once you have downloaded the bundle you can have Liferay Portal running very quickly following these steps:

    1. Download and install JavaSE 5.0 if you have not done so already. Note: If you picked the Tomcat 5.5 for JDK 1.4 bundle, use the JavaSE 1.4 version instead. Make sure you have defined the JAVA_HOME environment variable.

    2. Unzip the bundle to your applications directory. For example: c:\apps in Windows or /usr/local/ in Linux or UNIX variants.

    3. Go to the bin directory inside the application server directory and run it using the provided script. The name of the script will depend on the application server and you will have to use the version provided for your operating system. Names are usually pretty intuitive such as run.bat, startup.bat, jonas.bat...etc. When in a Unix environment, the batch file to start the server will end with the extension sh instead of bat and it is necessary to make the script executable by running chmod +x filename.sh. It is often neccessary to run the executable from the directory where it resides.

    4. Once the application server has finished initialization (the first time it might take a few minutes) open your browser and go to htp://localhost:8080 (assuming local installation otherwise change localhost with the host name or IP). The bundle comes with an embeded HSQL database loaded with sample data from the public website of Liferay. You can try Liferay as an anonymous user by navigating your local version the public website.
    1. Login as an administrator using the following data:

      • User: test@liferay.com
      • Password: test

    Load the liferay portal dependencies from http://downloads.sourceforge.net/lportal/liferay-portal-dependencies-4.4.0.zip and place it either in your local repository or in a remote one if you have.

    1. DBMS
      • MySQL

        Specify the Database Connector in tomcatfolder \conf\Catalina\localhost\root.xml, in our case the MySQL connector.

        Place the SQL connector obtained from ??? to tomcatfolder \lib\ext

    2. Web CMS
      • Alfresco

        To enable Alfresco inside of Liferay you have to follow the steps as listed here http://wiki.alfresco.com/wiki/Deploying_Alfresco_WAR_to_Liferay