Cisco Subscriber Edge Services Manager Application Management Guide, Release
Total Page:16
File Type:pdf, Size:1020Kb
Cisco Subscriber Edge Services Manager Application Management Guide SESM Release 3.2 September 2003 Corporate Headquarters Cisco Systems, Inc. 170 West Tasman Drive San Jose, CA 95134-1706 USA http://www.cisco.com Tel: 408 526-4000 800 553-NETS (6387) Fax: 408 526-4100 Text Part Number: OL-3983-02 THE SPECIFICATIONS AND INFORMATION REGARDING THE PRODUCTS IN THIS MANUAL ARE SUBJECT TO CHANGE WITHOUT NOTICE. ALL STATEMENTS, INFORMATION, AND RECOMMENDATIONS IN THIS MANUAL ARE BELIEVED TO BE ACCURATE BUT ARE PRESENTED WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED. USERS MUST TAKE FULL RESPONSIBILITY FOR THEIR APPLICATION OF ANY PRODUCTS. THE SOFTWARE LICENSE AND LIMITED WARRANTY FOR THE ACCOMPANYING PRODUCT ARE SET FORTH IN THE INFORMATION PACKET THAT SHIPPED WITH THE PRODUCT AND ARE INCORPORATED HEREIN BY THIS REFERENCE. IF YOU ARE UNABLE TO LOCATE THE SOFTWARE LICENSE OR LIMITED WARRANTY, CONTACT YOUR CISCO REPRESENTATIVE FOR A COPY. The Cisco implementation of TCP header compression is an adaptation of a program developed by the University of California, Berkeley (UCB) as part of UCB’s public domain version of the UNIX operating system. All rights reserved. Copyright © 1981, Regents of the University of California. NOTWITHSTANDING ANY OTHER WARRANTY HEREIN, ALL DOCUMENT FILES AND SOFTWARE OF THESE SUPPLIERS ARE PROVIDED “AS IS” WITH ALL FAULTS. CISCO AND THE ABOVE-NAMED SUPPLIERS DISCLAIM ALL WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING, WITHOUT LIMITATION, THOSE OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OR ARISING FROM A COURSE OF DEALING, USAGE, OR TRADE PRACTICE. IN NO EVENT SHALL CISCO OR ITS SUPPLIERS BE LIABLE FOR ANY INDIRECT, SPECIAL, CONSEQUENTIAL, OR INCIDENTAL DAMAGES, INCLUDING, WITHOUT LIMITATION, LOST PROFITS OR LOSS OR DAMAGE TO DATA ARISING OUT OF THE USE OR INABILITY TO USE THIS MANUAL, EVEN IF CISCO OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. CCIP, CCSP, the Cisco Arrow logo, the Cisco Powered Network mark, the Cisco Systems Verified logo, Cisco Unity, Follow Me Browsing, FormShare, iQ Net Readiness Scorecard, Networking Academy, and ScriptShare are trademarks of Cisco Systems, Inc.; Changing the Way We Work, Live, Play, and Learn, The Fastest Way to Increase Your Internet Quotient, and iQuick Study are service marks of Cisco Systems, Inc.; and Aironet, ASIST, BPX, Catalyst, CCDA, CCDP, CCIE, CCNA, CCNP, Cisco, the Cisco Certified Internetwork Expert logo, Cisco IOS, the Cisco IOS logo, Cisco Press, Cisco Systems, Cisco Systems Capital, the Cisco Systems logo, Empowering the Internet Generation, Enterprise/Solver, EtherChannel, EtherSwitch, Fast Step, GigaStack, Internet Quotient, IOS, IP/TV, iQ Expertise, the iQ logo, LightStream, MGX, MICA, the Networkers logo, Network Registrar, Packet, PIX, Post-Routing, Pre-Routing, RateMUX, Registrar, SlideCast, SMARTnet, StrataView Plus, Stratm, SwitchProbe, TeleRouter, TransPath, and VCO are registered trademarks of Cisco Systems, Inc. and/or its affiliates in the U.S. and certain other countries. All other trademarks mentioned in this document or Web site are the property of their respective owners. The use of the word partner does not imply a partnership relationship between Cisco and any other company. (0304R) Cisco Subscriber Edge Services Manager Application Management Guide Copyright ©2003, Cisco Systems, Inc. All rights reserved. CONTENTS About This Guide vii Document Objectives vii Audience vii Document Organization viii Document Conventions viii Related Documentation ix Obtaining Documentation ix Cisco.com x Documentation CD-ROM x Ordering Documentation x Documentation Feedback x Obtaining Technical Assistance xi Cisco TAC Website xi Opening a TAC Case xi TAC Case Priority Definitions xii Cisco Developer Support Program xii Program Benefits xii Contacting Cisco Developer Support xii Obtaining Additional Publications and Information xiii CHAPTER 1 Introduction 1-1 Application Manager 1-1 SESM Installation Images 1-2 Subscriber and Service Profiles 1-2 SESM Reference Network Diagram 1-3 SESM Application Management 1-4 SESM Documentation Map 1-5 CHAPTER 2 Installing the Application Manager 2-1 Important Information about Installing Application Manager 2-1 Recommended Browsers 2-1 Reference to Detailed Installation Instructions 2-2 Installation Results 2-2 Cisco Subscriber Edge Services Manager Application Management Guide OL-3983-02 iii Contents CHAPTER 3 Configuring the Application Manager 3-1 Underlying Technology 3-1 Required Configuration Procedures 3-3 Granting Access to the RMI Registry 3-3 Setting the Classpath and Running the RMI Registry 3-4 Adding New Applications to Manage 3-4 Configuring Logon Values for the Application Manager 3-6 CHAPTER 4 Running the Application Manager 4-1 Startup Procedures for Application Manager 4-1 Troubleshooting Application Manager Startup 4-2 Stopping the Application Manager 4-4 Adding and Removing Services on Windows 4-4 Service Dependencies 4-4 CHAPTER 5 Using the Application Manager Operational Scenarios 5-1 Purpose of Operational Scenarios 5-1 Accessing the Operational Scenarios 5-2 Researching Applications Not Appearing on an Operational Scenario 5-3 General Instructions for Using the Operational Scenarios 5-4 Changing Attribute Values 5-4 Changing Column Widths 5-4 Changing List Ordering 5-4 Button Operations 5-5 Operational Scenario Descriptions 5-5 CDAT Session Operational Scenario 5-6 Deployment Operational Scenario 5-6 Firewalls Operational Scenario 5-7 Logging Operational Scenario 5-8 RADIUS Dictionary Operational Scenario 5-9 RDP Operational Scenario 5-10 SPE Operational Scenario 5-11 SSG Operational Scenario 5-11 SSG Mappings Scenario 5-11 Bulk Upload Scenario 5-14 CHAPTER 6 Using the Application Manager Advanced Windows 6-1 Introduction 6-1 Cisco Subscriber Edge Services Manager Application Management Guide iv OL-3983-02 Contents Accessing the Advanced Windows 6-2 Buttons on the MBean Windows 6-5 CHAPTER 7 Logging and Debugging in SESM Applications 7-1 Log File Descriptions 7-1 MBeans for Log File Configuration 7-1 Jetty Server Logging and Debugging 7-2 Log MBean 7-2 Debug MBean 7-3 Server MBean 7-4 SESM Application Logging and Debugging 7-5 Logger MBean 7-5 SSG Connectivity 7-8 SSG MBean 7-8 APPENDIX A Manually Editing MBean Configuration Files A-1 Restarting Applications after Editing A-1 MBean Configuration Files A-1 MBean Configuration File Format A-1 SystemProperty and Property Tags in Configuration Files A-4 APPENDIX B Using the SESM Agent View Tool B-1 SESM Agent View Overview B-1 Accessing an Application’s Agent View B-2 Configuring the ManagementConsole MBean B-3 Starting and Removing the Management Console B-3 URLs for Accessing Agent Views B-4 Using the CDAT Main Window to Access Agent Views B-4 Using the Agent View B-5 Using the MBean View B-6 Monitoring an Application B-10 APPENDIX C Application Manager MBeans C-13 Configuring Application MBeans C-13 Generic MBeans C-14 JMImplementation C-14 com.cisco.sesm.ignore C-14 com.cisco.sesm.jmx C-14 Cisco Subscriber Edge Services Manager Application Management Guide OL-3983-02 v Contents Adaptor C-14 Application Management MBeans C-15 com.cisco.sesm C-15 org.mortbay.jetty C-15 RADIUS Data Proxy MBeans C-16 com.cisco.sesm C-16 Captive Portal MBeans C-18 com.cisco.sesm C-18 org.mortbay.jetty C-19 Web Application (NWSP) MBeans C-20 com.cisco.sesm C-20 org.mortbay.jetty C-21 Message Portal MBeans C-22 com.cisco.sesm C-22 org.mortbay.jetty C-23 Web Services Gateway MBeans C-24 com.cisco.sesm C-24 org.mortbay.jetty C-25 CDAT MBeans C-26 com.cisco.sesm C-26 org.mortbay.jetty C-26 DNS Proxy MBeans C-27 Cisco Subscriber Edge Services Manager Application Management Guide vi OL-3983-02 About This Guide This preface introduces the Cisco Subscriber Edge Services Manager Application Management Guide. The preface contains the following sections: • Document Objectives • Audience • Document Organization • Document Conventions • Related Documentation • Obtaining Documentation • Obtaining Technical Assistance • Obtaining Additional Publications and Information Document Objectives This guide describes the Cisco Subscriber Edge Services Manager (Cisco SESM) Application Manager . Audience This guide is intended for administrators and others responsible for installing, configuring, and running SESM applications and deploying SESM solutions. Cisco Subscriber Edge Services Manager Application Management Guide OL-3983-02 vii About This Guide Document Organization Document Organization This guide includes the chapters shown in the following table: Chapter Title Description Chapter 1 Introduction Introduces the Application Manager. Chapter 2 Installing the Application Describes how to install the Application Manager. Manager Chapter 3 Configuring the Application Describes how to configure the Application Manager Manager and the SESM applications so that they can be managed. Chapter 4 Running the Application Describes how to start and run the Application Manager Manager. Chapter 5 Using the Application Manager Describes how to use the Application Manager Operational Scenarios operational scenarios. Chapter 6 Using the Application Manager Describes how to use the Application Manager Advanced Windows advanced windows. Chapter 7 Logging and Debugging in Describes how to configure the logging and SESM Applications debugging mechanisms for SESM applications and the Jetty server. Appendix A Manually Editing MBean Describes the SESM MBean configuration file Configuration Files format and how to manually edit the files. Appendix B Using the SESM Agent View Describes how to remotely manage SESM Tool applications using the SESM Agent View tool. Appendix C Application Manager MBeans Describes the MBeans that are configurable using the Application Manager. Index Document Conventions The following conventions are used in this guide: • Italic font is used for parameters for which you supply a value, emphasis, and to introduce new terms. • Bold font is used for user entry and command names. • Computer font is used for examples. Note Means reader take note. Notes contain helpful suggestions or references to materials not contained in this guide. Caution Means reader be careful.