uPortal Environment Requirements
To build and run uPortal full-source version , you will need the following:
- Java 7 (Java 8 may work, but Java 7 is still preferred. Java 6 will not work.)
- Maven 3.0.3+
- Ant 1.8.2
- The Servlet Container (Tomcat 7.x)
- 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
- Download Maven
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
Add the
M2_HOME
environment variableexport M2_HOME=/path/to/apache-maven/apache-maven-3.0.x
Add the
M2
environment variableexport M2=$M2_HOME/bin
Add
M2
environment variable to your pathexport PATH=$M2:$PATH
Make sure that
JAVA_HOME
is set to the location of your JDK and add to to your pathexport JAVA_HOME=/path/to/java/jdk1.x export PATH=$JAVA_HOME/bin:$PATH
Run the following command to verify that it is correctly installed
mvn --version
Windows Maven Installation
- Download Maven
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
- Add the
M2_HOME
environment variable- open up the system properties (WinKey + Pause)
- select the "Advanced" tab
- click the "Environment Variables" button
- add the
M2_HOME
variable in the user variables with the valueC:\Program Files\Apache Software Foundation\apache-maven-3.0.x
- Add the
M2
environment variable the same as Step 3. In the user variables enter the value%M2_HOME%\bin
. - Update/Create the
Path
environment variable using the same process as above. In the user variables, prepend the value%M2%
to allow Maven to be available in the command line. - Same as above, 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) - Update the
Path
environment variable to include%JAVA_HOME%\bin
using the Step 3 instructions. - Open a new command prompt (Winkey + R then type
cmd
) and runmvn --version
to verify that it is correctly installed.
Installing Apache Ant
- 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/ )
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
Add the
ANT_HOME
environment variableexport ANT_HOME=/path/to/apache-ant-1.8.2
Make sure the
JAVA_HOME
environment variable is setupexport JAVA_HOME=/usr/local/jdk-1.x
Add the
ANT_HOME
to thePATH
variableexport PATH=$PATH:$ANT_HOME/bin
Confirm that your Ant installation is working by running the following command
ant -version