HP WebQoS Peak for Solaris™ Concepts and Operation Guide Edition 1 E1199 U.S.A. © Copyright 1999, Hewlett-Packard Company.
Legal Notices The information in this document is subject to change without notice. Hewlett-Packard makes no warranty of any kind with regard to this manual, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose. Hewlett-Packard shall not be held liable for errors contained herein or direct, indirect, special, incidental or consequential damages in connection with the furnishing, performance, or use of this material. Warranty.
©copyright 1980, 1984, 1986 Novell, Inc. ©copyright 1986-1992 Sun Microsystems, Inc. ©copyright 1985-86, 1988 Massachusetts Institute of Technology. ©copyright 1989-93 The Open Software Foundation, Inc. ©copyright 1986 Digital Equipment Corporation. ©copyright 1990 Motorola, Inc. ©copyright 1990, 1991, 1992 Cornell University ©copyright 1989-1991 The University of Maryland ©copyright 1988 Carnegie Mellon University Trademark Notices. UNIX is a registered trademark of The Open Group.
Contents 1. Overview What is HP WebQoS Peak? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .10 Viewing the Server Statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .10 What is a Session? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .10 When Does a Web Server Become Overloaded? . . . . . . . . . . . . . . . . . .10 How Does HP WebQoS Work? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11 2.
Contents Stopping HP WebQoS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32 4. Removing HP WebQoS Peak Removing HP WebQoS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34 A. HP WebQoS Configurable Parameters HP WebQoS Configurable Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . 36 Defaults Already Configured in config.ac . . . . . . . . . . . . . . . . . . . . . .
Printing History The manual printing date and part number indicate its current edition. The printing date will change when a new edition is printed. Minor changes may be made at reprint without changing the printing date. The manual part number will change when extensive changes are made. Manual updates may be issued between editions to correct errors or document product changes. To ensure that you receive the updated or new editions, you should subscribe to the appropriate product support service.
1 Overview HP Web Quality of Service (HP WebQoS) is a web-based solution that provides the quality of service needed to operate and maintain your web applications.
Overview What is HP WebQoS Peak? What is HP WebQoS Peak? HP WebQoS Peak is a software plug-in (module), which runs inside an HTTP server. The HTTP server currently supported is Netscape Enterprise Server. HP WebQoS can be configured to make certain decisions based on changing system conditions. For example, it can admit, reject, or defer new sessions based on system load, or to end active sessions based on the interval between requests and/or the length of a session.
Overview What is HP WebQoS Peak? How Does HP WebQoS Work? HP WebQoS monitors the resources and the number of arriving sessions on the web server. Based on available resources and how HP WebQoS is configured, it will accept, defer, reject or redirect a session. HP WebQoS makes sure the web server does not become overloaded by deferring, rejecting or redirecting any new sessions for which it does not have resources. It also allows an admitted session to be completed.
Overview What is HP WebQoS Peak? 12 Chapter 1
2 Installing HP WebQoS Peak 13
Installing HP WebQoS Peak Installing HP WebQoS Installing HP WebQoS You can install HP WebQoS Peak for Solaris from the HP Software Depot web page (http://software.hp.com) or from CD. To install HP WebQoS Peak after purchasing and downloading the software from HP Software Depot, do the following: 1. Go to the directory in which the tar package was downloaded. For example, type cd /tmp 2. Type tar -xvf HPWbQoSPk.tar to extract the software package. 3.
3 Configuring HP WebQoS Peak 15
Configuring HP WebQoS Peak Configuring HP WebQoS Configuring HP WebQoS To successfully configure HP WebQoS Peak on Solaris, do the following: 1. Install and configure your Netscape Enterprise Server. 2. Run the setup script. 3. Set the HP WebQoS configurable parameters. Installing and Configuring Your Netscape Enterprise Server You must install, configure, and enable CGI on your Netscape Enterprise Server before you run the setup script.
Configuring HP WebQoS Peak Configuring HP WebQoS Setting the HP WebQoS Configurable Parameters You can edit the configuration parameters in two different ways: • You can access the HP WebQoS Peak Session Settings administration web page from the URL http://system_name/hpac/. Your Netscape Enterprise Server must be running to access this page. Use the same user and password that you configured for your Netscape Administration Server to access this page.
Configuring HP WebQoS Peak Configuring HP WebQoS 18 Chapter 3
Configuring HP WebQoS Peak Configuring HP WebQoS The following sections describe the parameters that can be set using the HP WebQoS Peak Session Settings administration web page. See “HP WebQoS Configurable Parameters” on page 36 for a list of the available configurable parameters for the Netscape server and a list of defaults already configured in config.ac. Admission Control Determine when to admit a session. The default value is to always admit all sessions.
Configuring HP WebQoS Peak Configuring HP WebQoS Table 3-1 HP WebQoS Peak Configurable Parameters: Admission Control Parameter Description Response Time The maximum amount of time, in seconds, it takes for the server to respond to a request. Can be used with load to control session admission. If the average server response time is less than the specified threshold, all sessions are admitted.
Configuring HP WebQoS Peak Configuring HP WebQoS 2. If idle is greater than zero, then set the threshold to (100 - idle)/100. If idle equals zero, then set the threshold to the first listed load average. Using the above sample output, you would set the load threshold to (100-99.1)/100 or .009. Run top when performance is both poor and acceptable to determine an acceptable load level. Redirection Determine if sessions should be redirected and to where they are redirected.
Configuring HP WebQoS Peak Configuring HP WebQoS Deferral/Rejection If redirection is disabled or the redirect request is not accepted, the session is deferred to the allocation page. Table 3-3 HP WebQoS Configurable Parameters: Deferral/Rejection Parameter Description Minimum Exclusion Time The minimum amount of time, in seconds, that a customer is excluded. After the initial exclusion, the customer is prevented from returning to the site for the specified amount of time.
Configuring HP WebQoS Peak Configuring HP WebQoS Table 3-3 HP WebQoS Configurable Parameters: Deferral/Rejection Parameter Description Allocate sessions The number of deferred sessions alloted per minute that the server accepts after the minimum exclusion time has elapsed. If the number of sessions exceeds the number of sessions that can be allocated in one minute, the sessions are allocated to the next minute. Allocations are equally spaced within each minute.
Configuring HP WebQoS Peak Configuring HP WebQoS Table 3-3 HP WebQoS Configurable Parameters: Deferral/Rejection Parameter Description Maximum Deferral Time The maximum amount of time, in seconds, a customer is deferred. If the deferral time is greater than the specified maximum deferral time, the customer is served the "Server Temporarily Unavailable" page. This value must be greater than the minimum exclusion time.
Configuring HP WebQoS Peak Configuring HP WebQoS Creating an Allocation Page for Redirected Sessions The following is the default allocation page served to the user and can be modified: Example 3-2 Server Busy We are sorry our server is adequate levels of service serve you at this time. We line and will serve you as busy, and in order to ensure to our current visitors, we cannot have allocated you a position in soon as we can. You will automatically enter the site in 1:23 (minutes:seconds).
Configuring HP WebQoS Peak Configuring HP WebQoS Expiration Determine when to end a session. For the default, the interval between requests is set to 600 seconds (10 minutes) and the session duration is disabled. Table 3-4 HP WebQoS Peak Configurable Parameters: Expiration Parameter Description Interval between Requests The maximum amount of time, in seconds, allowed between requests within a session. Session Duration The maximum amount of time, in seconds, of a session.
Configuring HP WebQoS Peak Configuring HP WebQoS Logging HP WebQoS Information Saving HP WebQoS Information HP WebQoS decisions can be saved to the server access log. To include them, do the following: 1. Start the Netscape Administration Server. 2. Select the server to configure. 3. Click on Server Status. 4. Select Log Preferences. 5. Enter the name of the new access logfile to create (Netscape does not let you change the format of a logfile that is in use). 6.
Configuring HP WebQoS Peak Configuring HP WebQoS logged to a file. To log the statistics to a file add the following lines to /server_root/config/hpac/config.ac: log.file filename log.interval seconds Where filename is the name of the file to which to save the statistics and seconds is how often the statistics are saved (in seconds). The log.interval default is 60 seconds. Restart the web server for the changes to take effect.
Configuring HP WebQoS Peak Configuring HP WebQoS Isolating Virtual Web Sites’ Statistics HP WebQoS can be configured to balance traffic between virtual web sites hosted by a web server allowing each site to share the system’s resources equally. Configuring Isolation Statistics To configure isolation statistics, configure the isolate.pattern parameter in the /server_root/config/hpac/config.ac configuration file of the web server. The isolate.pattern parameter allows you to monitor each site’s traffic.
Configuring HP WebQoS Peak Configuring HP WebQoS 1. Select a common directory in which all document roots will exist, either physically or as a link. For instance, say that /web_pages is the common directory in which all the document roots will exist. Company X’s document root already exists physically in this directory. However, you must create a link to the other two company’s document roots in this directory.
Configuring HP WebQoS Peak Configuring HP WebQoS Table 3-8 Isolation Statistics Statistic Description Priority The priority given to a virtual web site. There are two priorities that can be assigned: basic (low) and priority (high). If a web site is using more than its fair share of the CPU, it will be given a basic priority.
Configuring HP WebQoS Peak Starting HP WebQoS Starting HP WebQoS HP WebQoS is enabled after you have run the setup script (see “Running the Setup Script” on page 16 for more information). If you have stopped HP WebQoS, then you can start it again by configuring and specifying the load from the HP WebQoS Peak Session Settings administration web page. Re-Enabling the HP WebQoS Peak Session Settings Page To re-enable the HP WebQoS Peak Session Settings administration web page, do the following: 1.
4 Removing HP WebQoS Peak 33
Removing HP WebQoS Peak Removing HP WebQoS Removing HP WebQoS To remove HP WebQoS, do the following: 1. Type /opt/webqospk/setup -r You can remove any or all instances of HP WebQoS installed on your system. 2. If you removed all instances of HP WebQoS on your system, you can also remove the software package by typing pkgrm HPWbQoSPk. To verify that the package has been removed, type pkginfo | grep HPWbQoSPk. No information should be returned.
A HP WebQoS Configurable Parameters 35
HP WebQoS Configurable Parameters HP WebQoS Configurable Parameters HP WebQoS Configurable Parameters You can modify the behavior of the HP WebQoS modules by setting the appropriate parameters in your Netscape configuration file: /server_root/config/hpac/config.ac. Table A-1 HP WebQoS Configurable Parameters for Netscape Parameter Range/Type Default Description admit.always N/A N/A Configures HP WebQoS to always accept sessions. admit.
HP WebQoS Configurable Parameters HP WebQoS Configurable Parameters Table A-1 HP WebQoS Configurable Parameters for Netscape Parameter Range/Type Default Description deferral.message string We are sorry our server is busy, and in order to ensure adequate levels of service to our current visitors, we cannot serve you at this time. We have allocated you a position in line and will serve you as soon as we can. . Part of the allocation page message served when a session is rejected. deferral.
HP WebQoS Configurable Parameters HP WebQoS Configurable Parameters Table A-1 HP WebQoS Configurable Parameters for Netscape Parameter Range/Type Default Description load.damping 0.0 <= x <= 1.0 0.2 The damping factor used to compute the web server load. Larger values make the controller more responsive to recent activity. log.file string N/A The full path name of the HP WebQoS log file. The statistics from the HP AdmissionControl Statistics web page are logged to this file. log.
HP WebQoS Configurable Parameters HP WebQoS Configurable Parameters Table A-1 HP WebQoS Configurable Parameters for Netscape Parameter Range/Type Default Description reject.future.rate 1 <= n (integer) 10 Set the number of sessions that can be admitted each minute. reject.page N/A N/A Sets the response to a rejected session to a customizable web page. reject.page.path string N/A The full path and file name of the customizable web page. Defaults Already Configured in config.
HP WebQoS Configurable Parameters HP WebQoS Configurable Parameters 40 Appendix A