This guide discusses adjustments you can make that may improve the performance of Sun JavaTM Systems Web Server 6.1. The guide provides tuning, scaling, and sizing tips and suggestions; possible solutions to common performance problems; and data from scalability studies. It also addresses miscellaneous configuration and platform-specific issues, and describes the perfdump performance utility and tuning parameters that are built into the server.
This preface contains the following topics:
This guide is intended for advanced administrators. Be sure to read this guide and other relevant server documentation before making any changes. Be very careful when tuning your server, and always back up your configuration files before making any changes.
The Sun Java System Web Server 6.1 SP12 manuals are available as online files in PDF and HTML formats at: http://docs.sun.com/app/docs/coll/1308.9
The following table lists the tasks and concepts described in the Sun Java System Web Server manuals.
Table P–1 Sun Java System Web Server Documentation Roadmap
For Information About |
See the Following |
---|---|
Late-breaking information about the software and documentation | |
Information about Sun Java System Web Server 6.1 FastCGI plug-in, including information about server application functions (SAFs), installation, configuration, technical notes, and pointers to additional resources. |
Sun Java System Web Server 6.1 SP12 FastCGI Plug-in Release Notes |
Information about Sun Java System Web Server 6.1 Reverse Proxy plug-in, including information about server application functions (SAFs), installation, configuration, technical notes, and pointers to additional resources. |
Sun Java System Web Server 6.1 SP12 Reverse Proxy Plug-in Release Notes |
Getting started with Sun Java System Web Server, including hands-on exercises that introduce server basics and features (recommended for first-time users) | |
Performing installation and migration tasks:
|
Sun Java System Web Server 6.1 SP12 Installation and Migration Guide Note: If you have the Sun Java Enterprise System 1 installed on your system and you want to upgrade the Sun Java System Web Server 6.1 that is part of Sun Java Enterprise System 1 to Sun Java System Web Server 6.1 SP11, you must use the Java Enterprise System (JES) installer to perform the upgrade. Do not use the separate component installer included with Sun Java System Web Server 6.1 SP11. |
Performing the following administration tasks:
| |
Using programming technologies and APIs to do the following:
| |
Creating custom Netscape Server Application Programmer’s Interface (NSAPI) plugins |
Sun Java System Web Server 6.1 SP12 NSAPI Programmer’s Guide |
Implementing servlets and JavaServer PagesTM (JSPTM) technology in Sun Java System Web Server |
Sun Java System Web Server 6.1 SP12 Programmer’s Guide to Web Applications |
Editing configuration files |
Sun Java System Web Server 6.1 SP12 Administrator’s Configuration File Reference |
Tuning Sun Java System Web Server to optimize performance |
Sun Java System Web Server 6.1 SP12 Performance Tuning, Sizing, and Scaling Guide |
This guide is organized as follows:
Chapter 1, Performance and Monitoring Overview
This chapter discusses server performance considerations and server performance monitoring.
Chapter 2, Tuning Sun Java System Web Server
This chapter describes specific adjustments to improve Sun Java System Web Server performance.
Chapter 3, Miscellaneous Performance Topics
This chapter describes miscellaneous performance topics, including discussion of magnus.conf and obj.conf settings that can be used to improve server performance.
Chapter 4, Common Performance Problems
This chapter discusses common web site performance problems, and offers tips and solutions.
Chapter 5, Platform-specific Issues and Tips
This chapter provides platform-specific tuning tips.
Chapter 6, Sizing and Scaling Your Server
This chapter examines the subsystems of your server, and provides recommendations for optimal performance.
Chapter 7, Scalability Studies
This chapter describes the results of scalability studies. You can use these studies as examples of how you might configure your system to best take advantage of Sun Java SystemWeb Server’s strengths.
This section describes the types of conventions used throughout this guide.
File and directory paths
These are given in UNIX® format (with forward slashes separating directory names). For Windows versions, the directory paths are the same, except that backslashes are used to separate directories.
URLs are given in the format:
http://server.domain/path/file.html
In these URLs, server is the server name where applications are run; domain is your Internet domain name; path is the server's directory structure; and file is an individual file name. Italic items in URLs are placeholders.
Font conventions include:
The monospace font is used for sample code and code listings, API and language elements (such as function names and class names), file names, path names, directory names, and HTML tags.
Italic monospace type is used for code variables.
Italic type is also used for book titles, emphasis, variables and placeholders, and words used in the literal sense.
Bold type is used as either a paragraph lead-in or to indicate words used in the literal sense.
Installation root directories are indicated by install_dir in this guide.
By default, the location of install_dir is as follows:
On UNIX-based platforms: /opt/SUNWwbsvr/
On Windows: C:\Sun\WebServer6.1
If you have problems with your system, contact customer support using one of the following mechanisms:
The online support web site at:
The telephone dispatch number associated with your maintenance contract
Please have the following information available prior to contacting support. This helps to ensure that our support staff can best assist you in resolving problems:
Description of the problem, including the situation where the problem occurs and its impact on your operation
Machine type, operating system version, and product version, including any patches and other software that might be affecting the problem
Detailed steps on the methods you have used to reproduce the problem
Any error logs or core dumps
The Sun web site provides information about the following additional resources:
Sun is interested in improving its documentation and welcomes your comments and suggestions. To share your comments, go to http://docs.sun.com and click Feedback.
The following table describes the typographic conventions that are used in this book.
Table P–2 Typographic Conventions
Typeface |
Meaning |
Example |
---|---|---|
AaBbCc123 |
The names of commands, files, and directories, and onscreen computer output |
Edit your .login file. Use ls -a to list all files. machine_name% you have mail. |
AaBbCc123 |
What you type, contrasted with onscreen computer output |
machine_name% su Password: |
aabbcc123 |
Placeholder: replace with a real name or value |
The command to remove a file is rm filename. |
AaBbCc123 |
Book titles, new terms, and terms to be emphasized |
Read Chapter 6 in the User's Guide. A cache is a copy that is stored locally. Do not save the file. Note: Some emphasized items appear bold online. |
The following table shows the default UNIX® system prompt and superuser prompt for the C shell, Bourne shell, and Korn shell.
Table P–3 Shell Prompts
Shell |
Prompt |
---|---|
C shell |
machine_name% |
C shell for superuser |
machine_name# |
Bourne shell and Korn shell |
$ |
Bourne shell and Korn shell for superuser |
# |