Sun ONE logo     Index      Next     
Sun ONE Application Server 7, Update 1 Administrator's Guide
Updated: March 24, 2003


About This Guide

What's In This Guide?
How This Guide Is Organized
Server Basics and Administering Global Settings
Managing an Individual Server Instance
Managing HTTP Server Features and Virtual Servers
Documentation Conventions
General Conventions
Conventions Referring to Directories
Product Line Overview
Platform Edition
Standard Edition
Enterprise Edition
Using the Documentation
Product Support

Server Basics and Administering Global Settings

Getting Started with Sun ONE Application Server Administration

About Sun ONE Application Server
Configuring the Bundled Solaris Version
Creating an Administrative Domain
Starting the Administration Server
Creating an Application Server Instance
Deploying Applications
Using the Administration Interface
Accessing the Administration Interface
Using Tabs
Using Buttons
Accessing Online Help
Exiting the Administration Interface
Using the Command-line Interface
Accessing the Administration Server
Accessing Application Server Instances
Using Sun ONE Studio
About Configuration Files
Using the License Commands

Setting Administration Server Preferences

About the Administration Server
Starting the Administration Server
Using the startserv Script
Using the Command-Line Interface
Using the Services Window (Windows)
Using the Start Menu (Windows)
Shutting Down the Administration Server
Shutting Down Using the Administration Interface
Shutting Down Using the stopserv Script
Shutting Down Using the Command-Line Interface
Shutting Down Using the Services Window (Windows)
Accessing the Administration Server Settings
Viewing Administration Server Control Settings
Applying Changes to the Administration Server
Editing HTTP Listener Settings for the Administration Server
Setting SNMP, Logging, and Security Preferences

Configuring Administrative Domains

About Administrative Domains
Implementing Administrative Domains
Directory Structure
Process/Port Structure
Configuring Domains
Creating Domains
Example: creating a domain in the default location
Example: creating a domain somewhere other than the default location
Example: creating a domain for another user (UNIX only)
User Permissions on UNIX Platforms
Deleting Domains
Example: deleting a domain
Listing Domains
Example: listing the domains on a local machine
Example: listing the domains on the local machine using the remote option:
Starting Domains
Example: starting the only domain on a machine:
Stopping Domains
Example: Stopping all instances in a domain except for the admin server instance.
Recreating the Domain Registry

Managing an Individual Server Instance

Using Application Server Instances

About Application Server Instances
Starting and Stopping an Application Server Instance
Using the Start and Stop Buttons in the Administration Interface
Using the start-instance and stop-instance Commands
Using the Windows Services (Windows)
Using the startserv and stopserv Scripts
Starting the Application Server Instance in Debug Mode
Setting the Termination Timeout
Restarting an Application Server Instance Automatically (UNIX)
About Restarting Automatically
Restarting Automatically with /etc/inittab (UNIX)
Restarting Automatically with the System RC Scripts (UNIX)
Restarting an Application Server Instance Manually (UNIX)
Restarting the Server Instance Using the Restart Button (UNIX)
Restarting the Server Instance Using the restart-instance Command (UNIX)
Restarting the Server Instance Using the restartserv Script (UNIX)
About the Watchdog
Adding an Application Server Instance
Deleting an Application Server Instance
Applying Changes to an Application Server Instance
Viewing Application Server Instance Status
Configuring JVM Settings
Configuring General Settings
Configuring Path Settings
Configuring JVM Options
Configuring the JVM Profiler
Configuring JVM Settings Using the Command-Line Interface
Configuring Logging Setting and Monitoring Settings
Changing Application Server Instance Advanced Settings

Using Logging

About Logging
Logging on the UNIX and Windows Platform
Default Logging in server.log
Example of server.log
Logging Using syslog
Configuring syslog
To configure syslog:
Example of syslog messages
Logging Using the Windows eventlog
Using Log Levels
About Log Levels
Log Levels Used for syslog Configuration
About Virtual Servers and Logging
About Loggers
About Client Side Logging
Redirecting Application and Server Log Output
Log File Management
Internal-daemon Log Rotation
Scheduler Based Log Rotation
Rotation Using Solaris logadm Utility
Rotation Using Solaris "cron" Utility
About the crontab Entry Format
Using the Solaris cron Utility to Schedule Execution of logadm
Configuring Logging Through the Command-line Interface
Configuring Logging Through the Administration Interface
Configuring the Log Service
Configuring Logging for Application Server Components and Subsystems
To Specify a Log Level
To Specify a Log File: (Virtual Server)
To Specify a Transaction Log Location: (Java Transaction Service)
Configuring the Directives for Error Logging
Viewing the Access Log File
Viewing the Event Log File
Setting Log Preferences
Running the Log Analyzer
Viewing Events (Windows 2000 Pro)

Monitoring the Sun ONE Application Server

About Monitoring the Sun ONE Application Server
HTTP Server Monitoring
Application Components and Subsystems Monitoring
Monitoring for Container Subsystems
Monitoring for the ORB Service
Monitoring for the Transaction Service
Quality of Service (QOS)
Extracting Monitoring Data Using the CLI
The list --monitor Command
The get --monitor Command
CLI Name Mapping
Petstore Example
Monitorable Object Types
Monitorable Attribute Names
HTTP Server Monitorable Objects
Monitorable HTTP Server Elements
Monitorable HTTP Server Attributes
Administering the Transaction Service Using the CLI
Using HTTP Quality of Service
Quality of Service Example
Configuring Quality of Service (QOS)
Required Changes to the obj.conf File
Known Limitations to Quality of Service
About SNMP
Network Management Station (NMS)
Management Information Base (MIB) Objects
SNMP Messages
SNMP Trap Destinations
SNMP Agent Community
Setting Up SNMP
Using a Proxy SNMP Agent (UNIX/Linux)
Installing the Proxy SNMP Agent
Starting the Proxy SNMP Agent
Restarting the Native SNMP Daemon
Installing the SNMP Master Agent
Enabling and Starting the SNMP Master Agent
Starting the Master Agent on Another Port
Manually Configuring the SNMP Master Agent
Editing the Master Agent CONFIG File
Defining sysContact and sysLocation Variables
Configuring the SNMP Subagent
Starting the SNMP Master Agent
Manually Starting the SNMP Master Agent
Starting the SNMP Master Agent Using the Admin Server
Enabling the Subagent

Configuring the Web Server Plugin

About the Web Server Plugin
Handling Client Requests
HTTP Basics
Steps in the Request Handling Process
Web Server Plugin Configuration
The Web Server Plugin SAF Reference
Using the Web Server Plugin
Configuring Microsoft IIS To Use the Web Server Plugin
Configuring the Web Server Plugin for IIS
Configuring IIS to Use the Web Server Plugin
Configuring Multiple Server Pools
Sample File
Configuring the Web Server Plugin to Use With Apache Server

Configuring J2EE Containers

About the Web Container
Understanding the Web Container's Role
Web Application Configuration
Virtual Server Attributes
Web-module Attributes
Web Application Deployment
Dynamic Re-deployment and Hot Deployment
Single Sign-on Facility
Logging the Web Container
About the EJB Container
Understanding the EJB Container's Role
Types of Enterprise Java Beans
About Message-driven Beans
Configuring the EJB Container
Performing General Configuration
Configuring EJB Settings
Configuring MDB Pool Settings

Using Transaction Services

What Is a Transaction?
Transactions in J2EE
Transactional Resource Managers
JMS Providers
J2EE Connectors
Local and Distributed Transactions
Container-Managed Transactions
Transaction Attributes
Attribute Summary
Setting Transaction Attributes
Rolling Back a Container-Managed Transaction
Synchronizing a Session Bean's Instance Variables
Methods Not Allowed in Container-Managed Transactions
Bean-Managed Transactions
Transaction Service Administration
Administering Transactions Using the Administration Interface
Administering Transactions Using the Command-Line Interface
Listing In-Flight Transactions
Managing Transactions
Freezing the Transaction Service
Monitoring Transactions

Configuring Naming and Resources

About J2EE Naming Services and Resources
JDBC Datasources
Java Mail Sessions
JMS Destinations
About Java Naming and Directory Interface (JNDI)
JNDI Architecture
J2EE Naming Services
Naming References and Binding Information
Naming References in J2EE Standard Deployment Descriptor
Application Environment Entries
EJB References
References to Resource Manager Connection Factories
Resource Environment References
UserTransaction References
Initial Naming Context
COSNaming Service
JNDI Connection Factories
To Create a Custom Resource
To Create an External JNDI Resource
Accessing External JNDI Repositories
Mapping Application Resource References
About URL Connection Factory Resources
Mapping Application Resource Environment References
Mapping EJB References
About Persistence Manager Resources
What is Persistence?
The Role of the Persistence Manager
Pre-Deployment Bean Configuration
Creating a New Persistence Manager
About JDBC Resources
About the JDBC API
What Does The JDBC API Do?
About Database Access Models
About JDBC Datasources
Properties Of a DataSource Object
Registering a JDBC Resource
About JDBC Connections
Configuring JDBC Connection Pools
About Connection Pooling
Monitoring JDBC Connection Pooling
About Connection Sharing
About JDBC Transactions
About Java Mail Resources
About the JavaMail Message-handling Process
About the Architectural Components of JavaMail
The Message Class
Message Storage and Retrieval
Message Composition and Transport
About JavaBeans Activation Framework (JAF)
About JavaMail Configuration Parameters
J2EE Deployment Descriptor for JavaMail Session References
Entries in Sun ONE Application Server Deployment Descriptor
Creating a New JavaMail Session
Configuring Advanced Resource Properties

Using the JMS Service

About JMS
Basic Messaging System Concepts
Message Service Architecture
Message Delivery Models
The JMS Specification
JMS Message Structure
JMS Programming Model
Administered Objects: Provider Independence
Message-driven Beans
The Built-in JMS Service
About Sun ONE Message Queue (MQ)
MQ Message Server
MQ Client Runtime
MQ Administered Objects
MQ Administration Tools
Integration of MQ with Sun ONE Application Server
Architecture of the Built-in JMS Service
Disabling the Built-in JMS Service
Administration of the Built-in JMS Service
Configuring the JMS Service
Managing Physical Destinations
Create a Queue or Topic Destination
List Physical Destinations
Delete a Physical Destination
Managing Administered Object Resources
Administered Object Attributes
Administered Object Resource Management Tasks
Administering the Built-in JMS Service Using the Command-Line Interface

Configuring the Server For Corba/IIOP Clients

About Support for CORBA/IIOP Clients
About Interoperabillity
About the ORB
About the RMI/IIOP Functionality
About the Authentication Process
Configuring the ORB
To Perform General ORB Configuration
To Configure IIOP Listener For the ORB

Deploying Applications

About J2EE Modules
About J2EE Applications
J2EE Standard Descriptors
Sun ONE Application Server Descriptors
Naming Standards
Deployment Directory Structure
Runtime Environments
Module Runtime Environment
Application Runtime Environment
Configuring server.xml To Use FastJavac Compiler
About Classloaders
Deploying Modules and Applications
Deployment Names and Errors
The Deployment Life Cycle
Dynamic Deployment
Disabling a Deployed Application or Module
Dynamic Reloading
Tools for Deployment
The asadmin Utility
The Administration Interface
Sun ONE Studio
Deployment of Module or Application
Deploying a WAR Module
Deploying an EJB JAR Module
Deploying a Lifecycle Module
The asadmin Utility
The Administration Interface
Deploying an RMI/IIOP Client
Deploying a J2EE CA Resource Adapter
Deploying Static Content
Access to Shared Frameworks
The Application Deployment Descriptor Files

Managing HTTP Server Features and Virtual Servers

Configuring HTTP Features

About the HTTP Features
Configuring the File Cache
Tuning Your Server for Performance
Configuring HTTP Quality of Service
Adding and Using Thread Pools
Editing Advanced Settings
Configuring MIME Types

Using Virtual Servers

Virtual Servers Overview
HTTP Listeners
Virtual Servers
Types of Virtual Servers
IP-Address-Based Virtual Servers
URL-Host-Based Virtual Servers
Default Virtual Server
The obj.conf File
Virtual Server Selection for Request Processing
Document Root
Using Sun ONE Application Server Features with Virtual Servers
Using SSL with Virtual Servers
Using Access Log Files and Server Log Files
Using Access Control with Virtual Servers
Using CGIs with Virtual Servers
Creating and Configuring HTTP Listeners
Creating an HTTP Listener
Editing HTTP Listener Settings
Deleting an HTTP Listener
Creating and Configuring Virtual Servers
Creating a Virtual Server
Required Settings
Optional General Settings
Web Application Settings
CGI Settings
HTTP Quality of Service Settings
Editing Virtual Server Settings
Editing General Settings Using the Administration Interface
Editing General Settings Using the Command-Line Interface
Editing CGI Settings
Editing Document Handling Settings, Document Directories Settings, and HTTP/HTML Settings
Deleting a Virtual Server
Deploying Virtual Servers
Example 1: Default Configuration
Example 2: Secure Server
Example 3: Intranet Hosting
Example 4: Mass Hosting

Managing Virtual Server Content

Changing the Document Root
Setting Additional Document Directories
Enabling Remote File Manipulation
Using htaccess
Restricting Symbolic Links (UNIX)
Customizing User Public Information Directories (UNIX)
Configuring Public Information Directories
Restricting Content Publication
Loading the Entire Password File on Startup
Setting the Document Preferences
Entering an Index Filename
Selecting Directory Indexing
Specifying a Server Home Page
Specifying a Default MIME Type
Customizing Error Responses
Changing the International Character Set
Setting the Document Footer
Configuring URL Forwarding
Setting up Server-Parsed HTML
Setting Cache Control Directives
Using Stronger Ciphers


Using the Command Line Interface

About the Command Line Interface
About the asadmin Utility
About Ant Tasks
About Other Command Line Utilities
Using asadmin
Understanding the Command Syntax
Boolean Options
Syntax Example
Using Singlemode and Multimode
Multiple Multimode
Using Interactive and Non-Interactive Options
Using the Environment Commands
Using the Password File Option
Running asadmin Locally or Remotely
Using Command Line Invocations
Using asadmin from the Command Line
Using asadmin with Input from a File (Script)
Using asadmin with Standard Input (Pipe)
Using Escape Characters
Escape Characters on UNIX in Singlemode
Escape Characters on Windows in Singlemode
Escape Characters on All Platforms in Singlemode
Escape Characters on All Platforms in Multimode
Using get and set Commands
get and set Command Examples
Getting and Setting Multiple Values Examples
Monitoring Using get and set Commands
Using Help
Viewing Output and Errors
Viewing the Exit Status
Viewing Usage
Security Considerations
Concurrent Access Considerations
Command Reference
List of Commands
List of Dotted Names and Attributes
Dotted Names Used in asadmin
Service Names
Resource Names
Application Names
Other Names
orb or iiop-service
orblistener or iiop-listener
http-listener or http-server.http-listener
server configuration (name of server instance)
Long and Short Option Formats, Default Values, and Environment Variable Equivalents

Third Party Copyright Notices



Index      Next     
Copyright 2003 Sun Microsystems, Inc. All rights reserved.