Building and Deploying Instructions for:

...

Step 1: Configure the build.properties file

 The uPortal build requires a build.properties file describing the deployment environment to be available in the root of the uPortal project.

     1. Go to your uPortal source directory and create the build.properties file by copying the build.properties.sample file to build.properties

...

• In the filters folder, locate the default local.properties file and configure the Database Connection Settings, uPortal Server Configuration Properties,  CAS Server Configuration, Logging information, and LDAP settings. Replace localhost:8080 with your server name.

uPortal provides an optional mechanism to override these settings with a file that is completely outside uPortal source. This approach allows systems administrators to change these settings without rebuilding.  It also provides an easy way for adopters to keep sensitive information outside of their Source Code Management system (See Properties Files and Properties Overrides).

...

• Shared Libraries

  • uPortal places libraries in CATALINA_BASE/shared/lib The default Tomcat 67.0 download does not enable libraries to be loaded from this directory. To resolve this you must edit CATALINA_BASE/conf/catalina.properties and change the line that begins "shared.loader=" to the following:

     

...

• Shared Sessions

  • Jasig portlets, as well as many other popular JSR-168/JSR-286 portlets, rely on the ability to share user session data between the portal web application and portlet applications. To enable this feature:
    • Tomcat 6.0: add the emptySessionPath="true" parameter to the in-use connector (configured in Tomcat in CATALINA_BASE/conf/server.xml).
    • Tomcat 7.0:  add the "sessionCookiePath="/" to CATALINA_BASE/conf/context.xml.

...

Start uPortal by running the ant command from inside the uPortal-4.1-quick-start directory

# Linux
# Temporary due to https://issues.jasig.org/browse/UP-4454:
export M2_HOME=<pathToYourQuickstartLocation>/apache-maven-3.0.5
export PATH=$PATH:$M2_HOME/bin 
./ant.sh start

 
# Windows
ant start

...