|
|
uPortal is the leading open source enterprise portal framework built by and for the higher education community. uPortal continues to evolve through contributions from its global community and is supported by resources, grants, donations, and memberships fees from academic institutions, commercial affiliates, and non-profit foundations. uPortal is built on open standards-based technologies such as Java and XML, and enables easy, standards-based integration with authentication and security infrastructures, single sign-on secure access, campus applications, web-based content, and end user customization. uPortal can easily integrate with other enterprise systems and can be customized for specific local needs.
You may download uPortal and use it on your site at no cost. Unlike our competitors, uPortal is 100% free open source software managed by Apereo. Our community has access to all releases of the uPortal software with absolutely no costs. We welcome contributions from our community of all types and sizes.
uPortal strives to conform with Web Content Accessibility Guidelines Version 2.0 Level AA. The most recent accessibility audit results can be seen in UP-4735.
The uportal-user@apereo.org email address is the best place to go with questions related to configuring or deploying uPortal.
The uPortal manual is a collaborative resource which has more detailed documentation for each uPortal release.
Additional information about uPortal is available in the Manual.
- uPortal 5.0 Manual
- uPortal 4.3 Manual
- uPortal 4.2 Manual
- uPortal 4.1 Manual
- uPortal 4.0 Manual
- uPortal 3.2 Manual
- uPortal 3.1 Manual
- uPortal 3.0 Manual
- JDK 1.8 - The JRE alone is NOT sufficient, a full JDK is required
- Servlet 3.1 Container - Tomcat 8.0 is required. (NOTE: Tomcat 7 may continue to workin the early 4.3 period. We reserve the right to use leverage Servlet 3.1, JSP 2.3, EL 3.0 and Web Socket 1.1) There some configuration changes that must be made for Tomcat which are documented in the uPortal manual.
- Maven 3.2.2 or later
- Ant 1.8.2 or 1.9.3 or later.
uPortal uses Maven for its project configuration and build system. An Ant build.xml is also provided which handles the initialization and deployment related tasks. As a uPortal deployer you will likely only ever need to use the Ant tasks. Ant 1.8.2 or 1.9.3 or later is required
For a full list of ant tasks run ant -p
- hsql - Starts a HSQL database instance. The default uPortal configuration points to this database and it can be used for portal development.
- initportal - Runs the 'deploy-ear' and 'init-db' ant targets, should be the first and only task run when setting up a new uPortal instance WARNING: This runs 'init-db' which DROPS and re-creates the uPortal database
- deploy-ear - Ensures the latest changes have been compiled and packaged then deploys uPortal, shared libraries and all packaged portlets to the container
- initdb - Sets up the uPortal database. DROPS ALL EXISTING uPortal tables re-creates them and populates them with the default uPortal data WARNING: This DROPS and re-creates the uPortal database
- deploy-war - Ensures the latest uPortal changes have been compiled and packaged then deploys the uPortal WAR to the container.
- deployPortletApp - Deploys the specified portlet application to the container. This is the required process to deploy any portlet to a uPortal instance.
ant deployPortletApp -DportletApp=/path/to/portlet.warTo deploy uPortal you must set the server.home variable in the build.properties file to the instance of Tomcat you want to deploy to.
The approach here is that there is a generic pom.xml and build.xml that you should not have to edit, alongside a build.properties that you absolutely must edit to reflect your local configuration. Edit build.properties to reflect such configuration as where your Tomcat is, what context you would like uPortal to be deployed as, etc.
You must run the initportal target before uPortal is started the first time. This target will take care of compiling, deploying, database population and other initial tasks. Running initportal again is similar to hitting a reset button on the portal. Any saved configuration in the portal is lost and a clean version of the portal is configured.
The /uportal-war/src/main/resources/logback.xml Logback configuration file will end up on the classpath for Logback to find. You'll need to either change that configuration then run deploy-war. You can configure the logging level, where the file should be, or even choose a different logging approach.
Database connection information is read from /uportal-war/src/main/resources/properties/rdbm.properties, but is normally configured in filters/{environment.name}.properties.
VR20