Requirements

uPortal Environment Requirements

To build and run uPortal full-source version , you will need the following:

• Java 7 (uPortal 4.2 will run with Java 8).  Java 6 will not work.
• Maven 3.0.3+
• Ant 1.8.2
• The Servlet Container (Tomcat 7.x) (Tomcat 8.x not yet supported)
• Database

To build and run the uPortal quick-start version, download the quick-start version and continue to the Building and Deploying uPortal instructions.

Installing Apache Maven

Unix/Linux Maven Installation

1. Download Maven

2. Extract the archive (apache-maven-3.0.x-bin.tar.gz) in the directory you wish to install Maven

   tar -xvf apache-maven-3.0.x-bin.tar.gz
   

3. Make sure that JAVA_HOME is set to the location of your JDK

   export JAVA_HOME=/path/to/java/jdk1.x
   

4. Configure the M2_HOME and MAVEN_OPTS environment variables

   On Ubuntu, by default Maven is typically found under /usr/share/maven2

   export M2_HOME=/path/to/apache-maven/apache-maven-3.0.x
   
   export MAVEN_OPTS="-Xmx1024M -XX:MaxPermSize=512m"

5. Add Java and Maven to your PATH

   export PATH=$JAVA_HOME/bin:$PATH:$M2_HOME/bin

6. Run the following command to verify that it is correctly installed

   mvn --version
   

Windows Maven Installation

1. Download Maven

2. Unzip the archive, apache-maven-3.0.x-bin.zip to the directory you wish to install Maven (i.e., C:
   Program Files\Apache Software Foundation)

   unzip apache-maven-3.0.x.bin.zip
   

3. Add the M2_HOMEenvironment variable
   
   • open up the system properties (WinKey + Pause)
   • select the "Advanced" tab
   • click the "Environment Variables" button
   • create the M2_HOME variable in the user variables with the value C:\Program Files\Apache Software Foundation\apache-maven-3.0.x
   • create the MAVEN_OPTS variable in the user variables with the value -Xmx1024M -XX:MaxPermSize=512m
4. Same as above (*-nix instructions), make sure that JAVA_HOME exists in your user variables or in the system variables and set the location of your JDK (C:\Program Files\Java\jdk1.x)
5. Update the Path environment variable to include both %JAVA_HOME%\bin (which should come first or early) and %M2_HOME%\bin (which may come last or late) using the Step 3 instructions.
6. Open a new command prompt (Winkey + R then type cmd) and run mvn --version to verify that it is correctly installed.

Installing Apache Ant

1. Download Apache Ant (it needs to be version 1.8.2; you can get that older version of Ant here: http://archive.apache.org/dist/ant/binaries/ )

2. Extract the archive in the directory you wish to install Apache Ant

   //extracting tar.gz archive
   tar -xvf apache-ant-1.8.2-bin.tar.gz
   

3. Add the ANT_HOMEenvironment variable

   export ANT_HOME=/path/to/apache-ant-1.8.2
   

4. Make sure the JAVA_HOMEenvironment variable is setup

   export JAVA_HOME=/usr/local/jdk-1.x
   

5. Add the ANT_HOME to the PATHvariable

   export PATH=$PATH:$ANT_HOME/bin
   

6. Confirm that your Ant installation is working by running the following command

   ant -version