Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

The system should respond with information about the J2SE installation. For more information about J2SE, please visit http://java.sun.com/javase/.

Image Added

Relational Database

The default implementation of uPortal requires a relational database and corresponding JDBC driver to read and write portal data. For production, most people use proven database products such as PostgreSQL, Oracle, Sybase, Microsoft SQL Server, and DB2. In class, we will be using a free, open-source, java-based relational database called Hypersonic SQL (HSQLDB). To install HSQLDB, please download the HSQLDB distribution from the HSQLDB web site at:

...

The port can actually be any unused port and the database name can be anything you want. Now you can start the database by double-clicking the Start HSQLDB shortcut. The following window should open indicating that the database is running:

Image Added

You can safely minimize this window. Closing this window will shut down HSQLDB. The recommended way to shut down HSQLDB is to press Ctrl+C while this window is active.

...

The system should respond with information about the ant installation. For more information about J2SE, please visit http://ant.apache.org/.

Image Added

Web Container

Before we can install uPortal, we must have a servlet 2.3 or greater compliant web container available. A web container is a JEE server component that enables access to servlets and JSP pages. There are many to choose from including WebLogic (BEA), WebSphere (IBM), JRun (Macromedia), Resin (Caucho), Jetty (Mortbay), and Tomcat (Apache). Tomcat is the easiest implementation to use with uPortal.

...

Create shortcuts to these files and place them on the Windows desktop. Rename the shortcuts Start Tomcat and Stop Tomcat. To make sure Tomcat has been installed correctly and the shortcuts are functioning, double-click the Start Tomcat shortcut. A console window should open with a few startup messages from Tomcat. In a web browser, enter the URL

No Format

http://localhost:8080./

Image Added

This should bring up the Tomcat home page indicating that Tomcat is running successfully on your machine:
To shutdown Tomcat, simply double-click the Stop Tomcat shortcut on your desktop.

...

Now that we have a Java Virtual Machine, a relational database and driver, a servlet container, and the Ant build tool installed on our machine, we can install uPortal. To install uPortal, please download the uPortal distribution from the uPortal web site at:

No Format

http://www.uportal.org/

Once you have the uPortal_rel-2-6-0-RC1.zip file unzip the file into the C:\portal directory:

...

del c:\portal\uPortal_rel-2-6-0-RC1\lib\container-common\hsqldb-1.7.2.4.jar

Image Added

Now it is time to load the database with an initial set of uPortal data (users, channels, layout fragments, etc). Make sure the database is up and running (see section 4). Open a command prompt and change directories to the uPortal installation directory. From this directory, enter the Ant command to load the database and deploy the portal:

...

The output should show information about the database and messages indicating that the database tables have been dropped, created, and populated. There should also be information about the publishing of channels and layout fragments.

Image Added

You should now be able to access the portal by starting Tomcat (restart Tomcat if it was not already running) and entering the following URL into a browser:

No Format

http://localhost:8080/uPortal/

If you see the default uPortal home page in your browser window, you have successfully set up uPortal.

Image Added

You can log into the portal with the following username/password combinations: demo/demo, student/student, staff/staff, faculty/faculty, and admin/admin.