Developing a Portal Based on the Sample Residential Portal

The source code is included with the sample residential portal. To modify the behavior of the portal beyond a simple configuration, install a Java development environment. You can find the source code of the sample residential portal in the directory WEB-INF/src. The portal pages are stored in the layout and tiles directories.

The sample residential portal does not require any specific environment, but the procedures below assume that you use the Eclipse platform. A servlet container is required to run the portals during development. We recommend that you use Tomcat and its Eclipse plug-in.

For information about your development environment, see the documentation for the product you are using.

Preparing to Develop a Portal Based on the Sample Residential Portal

The following instructions describe how to set up a development environment that uses Eclipse and Tomcat on a Solaris platform. If you want to use Eclipse and Tomcat on a different operating system, see the following Web sites:

To get ready to develop a portal based on the sample residential portal:

  1. Download and install Eclipse from

  2. Download the Tomcat plug-in for Eclipse from

  3. Unzip the plug-in into the Eclipse installation directory.
  4. Download Tomcat from

  5. Install Tomcat:
    mkdir $HOME/eclipse cd $HOME/eclipse unzip /tmp/ unzip /tmp/ cd $HOME gzip –dc /tmp/tomcat-4.1.18.tar.gz | tar xvf -
  6. Start Eclipse.
  7. Configure the Tomcat plug-in.

    Select Window > Preferences > Tomcat, and configure the Tomcat version and the path where you installed Tomcat.

Creating a Portal Project

To create a new Tomcat project inside Eclipse:

  1. Select File > New > Project > Java > Tomcat Project, enter the name of the project, and click Finish.
  2. Select File > Import… > Zip File, enter the path for ssportal.war; and click Finish.
  3. Select File > Properties > Java Build Path > Libraries > Add Jars, open the sample project, navigate to WEB-INF/lib, and select all JAR files in the WEB-INF/lib directory.
  4. Select File > Properties > Tomcat, and click Can update server.xml file.

Building the Portal

Eclipse automatically rebuilds the project when you save a modified source file.

To test or debug the project, run the code inside Tomcat.

To start Tomcat:

Deploying the Portal

To create a new Web application, set the name of the target WAR file.

  1. Select File > Properties > Tomcat.
  2. Enter the path of the target WAR file in the field WAR file for export.
  3. Right-click the portal project, and select Tomcat Project > Export to the WAR file set in project properties.
  4. Copy the WAR file to the final deployment location; for example, /opt/UMC/jboss/server/default/deploy on your portal server.

Testing a Portal Application

Simulated router drivers allow you to create subscriber sessions without connecting to a router. You can use a simulated router drive when you want to test your portal application. See Configuring Simulated Router Drivers (SRC CLI).