Nonstop Servlets for Javaserver Pages (NSJSP) 6.1 System Administrator’S Guide
Total Page:16
File Type:pdf, Size:1020Kb
NonStop Servlets for JavaServer Pages (NSJSP) 6.1 System Administrator’s Guide Abstract NonStop™ Servlets for JavaServer Pages (NSJSP) is a container that runs Java servlets and JavaServer Pages (JSPs) that are platform-independent server-side programs, which programmatically extend the functionality of web-based applications by providing dynamic content from a web server to a client browser over the HTTP protocol. Product Version NonStop Servlets for JavaServer Pages 6.1 (T1222H60^AAN) Supported Release Version Updates (RVUs) This publication supports J06.04 and all subsequent J-series RVUs and H06.15 and all subsequent H-series RVUs, until otherwise indicated by its replacement publications. Part Number Published 596210-006 June 2013 Document History Part Number Product Version Published 596210-001 NonStop Servlets for JavaServer Pages June 2010 6.1 (T1222H60^AAN) 596210-002 NonStop Servlets for JavaServer Pages November 2011 6.1 (T1222H60^AAN) 596210-005 NonStop Servlets for JavaServer Pages March 2012 6.1 (T1222H60^AAN) 596210-006 NonStop Servlets for JavaServer Pages June 2013 6.1 (T1222H60^AAN) Legal Notices Copyright 2012 Hewlett-Packard Development Company L.P. Confidential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license. The information contained herein is subject to change without notice. The only warranties for HP products and services are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additional warranty. HP shall not be liable for technical or editorial errors or omissions contained herein. Export of the information contained in this publication may require authorization from the U.S. Department of Commerce. Microsoft, Windows, and Windows NT are U.S. registered trademarks of Microsoft Corporation. Intel, Itanium, Pentium, and Celeron are trademarks or registered trademarks of Intel Corporation or its subsidiaries in the United States and other countries. Java is a U.S. trademark of Sun Microsystems, Inc. Motif, OSF/1, UNIX, X/Open, and the "X" device are registered trademarks and IT DialTone and The Open Group are trademarks of The Open Group in the U.S. and other countries. Open Software Foundation, OSF, the OSF logo, OSF/1, OSF/Motif, and Motif are trademarks of the Open Software Foundation, Inc. OSF MAKES NO WARRANTY OF ANY KIND WITH REGARD TO THE OSF MATERIAL PROVIDED HEREIN, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. OSF shall not be liable for errors contained herein or for incidental consequential damages in connection with the furnishing, performance, or use of this material. © 1990, 1991, 1992, 1993 Open Software Foundation, Inc. This documentation and the software to which it relates are derived in part from materials supplied by the following: © 1987, 1988, 1989 Carnegie-Mellon University. © 1989, 1990, 1991 Digital Equipment Corporation. © 1985, 1988, 1989, 1990 Encore Computer Corporation. © 1988 Free Software Foundation, Inc. © 1987, 1988, 1989, 1990, 1991 Hewlett-Packard Company. © 1985, 1987, 1988, 1989, 1990, 1991, 1992 International Business Machines Corporation. © 1988, 1989 Massachusetts Institute of Technology. © 1988, 1989, 1990 Mentat Inc. © 1988 Microsoft Corporation. © 1987, 1988, 1989, 1990, 1991, 1992 SecureWare, Inc. © 1990, 1991 Siemens Nixdorf Informationssysteme AG. © 1986, 1989, 1996, 1997 Sun Microsystems, Inc. © 1989, 1990, 1991 Transarc Corporation. This software and documentation are based in part on the Fourth Berkeley Software Distribution under license from The Regents of the University of California. OSF acknowledges the following individuals and institutions for their role in its development: Kenneth C.R.C. Arnold, Gregory S. Couch, Conrad C. Huang, Ed James, Symmetric Computer Systems, Robert Elz. © 1980, 1981, 1982, 1983, 1985, 1986, 1987, 1988, 1989 Regents of the University of California. Printed in the US NonStop Servlets for JavaServer Pages (NSJSP) 6.1 System Administrator’s Guide Glossary Index Examples Figures Tables Legal Notices What’s New in This Manual xv Manual Information xv New and Changed Information xv About This Manual xvii Who Should Read This Guide xvii Organization of This Guide xviii Related Manuals xix Online Resources xxi Notation Conventions xxii Abbreviations xxvii HP Encourages Your Comments xxx 1. Introduction to NSJSP Overview 1-2 NSJSP Product 1-2 Apache Tomcat - A Container for Java Servlets and JSP 1-2 The HP NonStop Servlet and JSP Container 1-2 Installing NSJSP 1-3 Configuring NSJSP 1-8 Management in NSJSP 1-9 Securing Web Applications 1-10 NSJSP Features 1-11 Architecture 1-13 Apache Tomcat Components 1-13 NSJSP Architecture 1-16 2. Installing NSJSP Prerequisites 2-1 Installing NSJSP from the CD 2-2 Running the IPSetup Program 2-2 Hewlett-Packard Company—596210-006 i Contents 3. Configuring NSJSP Running the setup Script 2-14 Creating an NSJSP Installation 2-16 Verifying the NSJSP Installation 2-18 NSJSP Installation Directory Structure 2-20 Creating an NSJSP Manager Installation 2-21 Verifying the NSJSP Manager Application Installation 2-23 Updating an NSJSP Installation 2-24 Removing an NSJSP Configuration 2-25 Support for Multiple NSJSP Installations in a Single iTP Secure WebServer Environment 2-26 3. Configuring NSJSP Overview 3-2 Configuration Files for the Server Classes 3-5 The Generic servlet.config File 3-6 The Installation-Specific servlet.config File 3-7 The nsjspadmin.config File 3-29 The filemaps.config File 3-32 The jdbc.config File 3-34 Configuration Files for the Servlet Container 3-36 The server.xml File 3-36 The context.xml File 3-58 The web.xml File 3-65 Virtual Hosts 3-72 Configuring Virtual Hosts 3-73 Session Management 3-74 Sessions in NSJSP 3-74 In-Memory Sessions (SessionBasedLoadBalancing = true) 3-74 Persistent Manager Sessions (SessionBasedLoadBalancing = false) 3-79 Mixed-Mode Sessions 3-87 Determining the Storage Capacity of the Persistent Store 3-91 Configuring the Manager Element 3-95 4. Managing NSJSP NSJSP Manager Application 4-1 Overview 4-1 NSJSP Manager Features 4-2 NSJSP Security 4-3 NSJSP Manager Operations 4-3 Admin Web Application 4-56 NonStop Servlets for JavaServer Pages (NSJSP) 6.1 System Administrator’s Guide—596210-006 ii Contents 5. Logging in NSJSP Overview and Architecture 4-57 Admin Web Application Features 4-59 Login and Security Considerations 4-59 Managing Admin Web Application Operations 4-62 Administering the Server 4-62 Administering a Service 4-64 Administering a Connector 4-66 Administering a Host 4-67 Administering a Context 4-69 Administering a Realm 4-71 Administering a Valve 4-72 Administering Resources 4-74 Administering User Definitions 4-79 Access Security Considerations 4-83 Persisting Changes to the server.xml File and Context Files 4-83 Manager Web Application 4-85 Operations Using the Command-line Interface 4-85 iTP Secure WebServer Operations 4-85 Server Class Operations 4-86 Manual Deployment and Undeployment of Web Applications 4-90 Deploying Applications at Startup 4-90 Deploying Applications on a Running NSJSP Server 4-91 Comparison of the Management Applications 4-92 Comparison of Architectures 4-92 Comparison of Features 4-98 Comparison of Management Application Access Roles 4-100 Single Point of Management Using the NSJSP Manager 4-100 The Architecture of the NSJSP Manager 4-104 5. Logging in NSJSP Logging Architecture 5-1 Loggers 5-1 Handlers 5-2 Formatters 5-2 Log Manager 5-3 Apache Tomcat Enhancements to the Logging Architecture 5-4 NSJSP Enhancements to the Logging Architecture 5-5 NSJSP Formatter 5-5 NSJSP Log Handler 5-5 NonStop Servlets for JavaServer Pages (NSJSP) 6.1 System Administrator’s Guide—596210-006 iii Contents 6. Debugging NSJSP Log Rollover 5-6 Logging Configuration 5-9 Configuring Handlers 5-10 Configuring Loggers 5-13 Configuring the NSJSP Formatter Class 5-14 Configuring for Log Rollover 5-15 Configuring the logging.properties File 5-20 Configuring Logging for the NSJSP Container and Web Applications 5-24 Log Files Related to NSJSP 5-27 The out and err Log Files 5-27 Log File Created by JULI 5-28 Programming Considerations for Logging 5-28 LogFactory 5-28 Log 5-29 Commons Logging 5-30 6. Debugging NSJSP Debugging using Java Debugger tool 6-1 Debugging using Eclipse platform 6-2 7. Migrating to NSJSP 6.1 Comparison of NSJSP 5.0, NSJSP 6.0, and NSJSP 6.1 7-1 Comparing Installation Properties in NSJSP 5.0, NSJSP 6.0, and NSJSP 6.1 7-1 Comparing Configuration Properties in NSJSP 5.0, NSJSP 6.0, and NSJSP 6.1 7-4 Comparing Management Properties in NSJSP 5.0, NSJSP 6.0, and NSJSP 6.1 7-14 Comparing Logging Infrastructure in NSJSP 5.0, NSJSP 6.0, and NSJSP 6.1 7-15 Logging Configuration of Servlet Container Components 7-15 Comparing Miscellaneous Properties 7-18 Considerations for Migrating Web Applications from NSJSP 5.0 to NSJSP 6.1 7-19 Considerations for Migrating Web Applications from NSJSP 6.0 to NSJSP 6.1 7-26 Migrating the Session Store 7-27 Migrating to NSJSP Manager Application in NSJSP 6.1 7-27 Support for Multiple NSJSP Installations in a Single iTP Secure WebServer Environment 7-27 8. Security Considerations Securing Web Applications 8-1 Establishing a Secure Link 8-2 NonStop Servlets for JavaServer Pages (NSJSP) 6.1