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

# 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.

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