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:

• Install a Web application server on the machine on which you want to install the sample residential portal.
• Install the sample data from the SRC software distribution. See Loading Sample Data in to a Juniper Networks Database (SRC CLI).
• Set up the RADIUS authfile for the user scenario you want to demonstrate. See Installing 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 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.

4. Replace the portalBehavior.properties and any other updated files in the WAR file.

   zip -u ssportal.war

Deploying the Updated WAR File

To deploy the updated WAR file:

• Copy the WAR file to the deployment directory for your Web server.

  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.

Copyright © 2009, Juniper Networks, Inc. All rights reserved. Trademark Notice.