Using the uPortal Only Distribution
| Note |
|---|
The version numbers indicated below are from the version of the quickstart distribution as of the last time this page was edited. The version numbers will most likely be diffrent depending on which version you have downloaded |
What is included?
The uPortal-only distribution is downloaded as a zip file which extracts to directory called uPortal_rel-2-5-1-3.zip . The directory contains the following...
...
- The Java Development Kit (JDK) version 1.3 4 or higher must be installed.
- JAVA_HOME environment variable must be set.
- The Jakarta-Ant build tool (version 1.56.3 2 or later).
- A web application environment such as Tomcat or IBM Websphere
- An SQL database such as HypersonicSQL, Oracle, or PostgreSQL
...
The uPortal web application requires a web application enviroment such as Tomcat or IBM Webshere . If you already have a web application environment installed on a server, the uPortal context can just be deployed to that environment, otherwise you will have to install one. The build files for uPortal have been set up such that it can be easily deployed into Tomcat. The Jakarta-Tomcat servlet container can be downloaded from: http://jakarta.apache.org/tomcat/index.html . Version 45.15.24 9 is recommended.
Compiling and Deploying uPortal
Compiling and deploying uPortal is managed using the Jakarta Ant build environment. It is highly recommended that anyone implementing uPortal or developing channels become familiar with the Ant build tool. Documentation for Ant is available at Jakarta-Ant web site
For detailed instructions on how to compile and deploy uPortal go to the documentation page at:
Building Compiling uPortal.
Setting up A Database
The uPortal system can be deployed such that a database from several different vendors may be used. Installation and configuration information about databases can be found in on the:
Database Installation and Configuration Document page.
Complete the Installation
Once you have compiled and deployed uPortal and setup a database for it to utilize, you still need to publish the channel fragments and internationalize the database. This can be done in one step by issuing the `ant initportal` command. Once this command completes without errors, your uPortal instance should be fully functional.
Database Installation and Configuration Document
Issues and known problems
JDK version issues
...
Library Dependencies
IMPORTANT Instructions for JDK1.4
uPortal uses the JAXP 1.3 compatability libraries for its XML APIs. The JAXP
libraries need to be copied into the endorsed library locations for the JRE
and Tomcat. Instructions can be found at JAXP 1.3 compatibilty.
Proxy/Firewall issues
If uPortal is installed on a system which requires a proxy server for access to remote web sites, the web application server will have to be configured to use the proxy server. Information on how to set up uPortal with a proxy server can be found in the following document:
...