Installing the Sample Residential Portal

The sample residential portal is a Web application. The application is packaged as a standard Web application archive (WAR file) in the webapp subdirectory in the SRC software distribution.

Before you install the sample residential portal:

Tasks to install the sample residential portal are:

  1.  Preparing the Application for Customization
  2.  Configuring the Sample Residential Portal
  3.  Deploying the Updated WAR File

    Note: The sample residential portal can be installed by root or authorized nonroot users.

Preparing the Application for Customization

When you customize the sample residential portal, copy the WAR file to a temporary folder and work in that folder. To do so:

  1. Login as root or another authorized user.
  2. Create a temporary folder in which you will work on the WAR file.
    mkdir ssportal
  3. Access the temporary folder.
    cd ssportal
  4. Copy the WAR file to the temporary folder.
    cp /cdrom/cdrom0/Demos+Sample_Applications/webapp/ssportal.war.

Configuring the Sample Residential Portal

To configure the sample residential portal:

  1. Access the temporary folder to which you copied the WAR file.
    cd ssportal
  2. Extract the files from the WAR file.
    unzip -quo ssportal.war
  3. With a text editor, edit the file and other files in the WEB-INF directory as needed. See Configuration Files for the Sample Residential Portal Overview.

    Use WEB-INF/ as a guideline for editing the file to use properties specific to your environment.

  4. Replace the and any other updated files in the WAR file.
    zip -u ssportal.war


Deploying the Updated WAR File

To deploy the updated WAR file:

By default the sample residential portal is deployed into the root context (“/”). You can access the portal through http://server:8080. If you want to deploy the sample residential portal into something other than the root context, modify the WEB-INF/jboss-web.xml configuration file.

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 SRC PE Monitoring and Troubleshooting Guide.