[Contents] [Prev] [Next] [Index] [Report an Error] [No Frames]


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:

We provide the JBoss Web application server in the SRC software distribution. For information about installing this software, see SRC-PE Getting Started Guide, Chapter 33, Installing Web Applications.

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.
  3. mkdir ssportal
    
    
    
  4. Access the temporary folder.
  5. cd ssportal
    
    
    
  6. Copy the WAR file to the temporary folder.
  7. cp /cdrom/cdrom0/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.
  2. cd ssportal
    
    
    
  3. Extract the files from the WAR file.
  4. unzip -quo ssportal.war
    
    
    
  5. With a text editor, edit the portalBehavior.properties file and other files in the WEB-INF directory as needed. See Overview of Configuration Files for the Sample Residential Portal.

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

  1. Replace the portalBehavior.properties and any other updated files in the WAR file.
  2. zip -u ssportal.war
    

Deploying the Updated WAR File

To deploy the updated WAR file:

If you are using JBoss, copy the file to /opt/UMC/jboss/ server/default/deploy directory. JBoss automatically starts the Web application when a new WAR file is copied into the deployment directory.

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, Chapter 5, Configuring a Simulated Router Driver for Testing with the SRC CLI or SRC-PE Monitoring and Troubleshooting Guide, Chapter 6, Configuring a Simulated Router Driver for Testing with SDX Configuration Editor.


[Contents] [Prev] [Next] [Index] [Report an Error] [No Frames]