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.
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.
- Install the sample data from the SRC software distribution (see SRC-PE Getting Started Guide, Chapter 29, Defining an Initial Configuration on a Solaris Platform).
- 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:
- Preparing the Application for Customization
- Configuring the Sample Residential Portal
- 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:
- Login as
root
or another authorized user.- Create a temporary folder in which you will work on the WAR file.
mkdir ssportal- Access the temporary folder.
cd ssportal- Copy the WAR file to the temporary folder.
cp /cdrom/cdrom0/webapp/ssportal.war.Configuring the Sample Residential Portal
To configure the sample residential portal:
- Access the temporary folder to which you copied the WAR file.
cd ssportal- Extract the files from the WAR file.
unzip -quo ssportal.war- 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.
- Replace the portalBehavior.properties and any other updated files in the WAR file.
zip -u ssportal.warDeploying 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.