Default Paths and File Names | Sun Microsystems 820434310 guide

Preface

TABLE P–1Books in the Enterprise Server Documentation Set		(Continued)
Book Title	Description

High Availability Administration	Setting up clusters, working with node agents, and using load balancers.
Guide

Administration Reference	Editing the Enterprise Server configuration file,domain.xml.

Performance Tuning Guide	Tuning the Enterprise Server to improve performance.

Reference Manual	Utility commands available with the Enterprise Server; written in man page style. Includes
	the asadmin command line interface.

Default Paths and File Names

The following table describes the default paths and file names that are used in this book.

TABLE P–2Default Paths and File Names

Placeholder	Description	Default Value

as-install	Represents the base installation directory for	SolarisTM and Linux installations, non-root user:
	Enterprise Server.	user’s-home-directory/SUNWappserver
		user’s-home-directory/SUNWappserver
		Solaris and Linux installations, root user:
		/opt/SUNWappserver
		Windows, all installations:
		SystemDrive:\Sun\AppServer

domain-root-dir	Represents the directory containing all	All installations:
	domains.	as-install/domains/
		as-install/domains/

domain-dir	Represents the directory for a domain.	domain-root-dir/domain-dir
	In configuration files, you might see
	domain-dirrepresented as follows:
	${com.sun.aas.instanceRoot}

instance-dir	Represents the directory for a server instance.	domain-dir/instance-dir

samples-dir	Represents the directory containing sample	as-install/samples
	applications.

docs-dir	Represents the directory containing	as-install/docs
	documentation.

14	Sun GlassFish Enterprise Server 2.1 Performance Tuning Guide • January 2009

Image 14

Sun Microsystems 820434310 manual Table P-2Default Paths and File Names

Contents

Sun GlassFish Enterprise Server 2.1 Performance Tuning Guide Sun Microsystems, Inc Network Circle Santa Clara, CA 090304@21990 Contents Tuning the Enterprise Server 100 Tuning for High-Availability Figures Page Tables Page Examples Page Sun GlassFish Enterprise Server Documentation Set Table P-1Books in the Enterprise Server Documentation Set Default Paths and File Names Table P-2Default Paths and File Names Typographic Conventions Symbol ConventionsSymbol Conventions Table P-3Typographic Conventions Sun Welcomes Your Comments Documentation, Support, and TrainingThird-Party Web Site References 1Performance Tuning Roadmap Process Overview Performance Tuning Sequence Performance Tuning Roadmap Understanding Operational Requirements Application Architecture Client-Side Presentation Encryption User Authentication and AuthorizationSecurity Requirements Hardware Resources General Tuning Concepts Administration Capacity Planning 2Factors That Affect Performance User Expectations To Determine Capacity Further Information Use StringBuffer to Concatenate Strings Java Programming GuidelinesAvoid Serialization and Deserialization Declare Methods as final Only If Necessary String str = testing str = str + abcAssign null to Variables That Are No Longer Needed Declare Constants as static final Declare Method Arguments final Java Server Page and Servlet TuningSynchronize Only When Necessary Use DataHandlers for Soap Attachments Avoid Shared Modified Class Variables Suggested Coding PracticesGeneral Guidelines Http Session Handling Optimize SSL Configuration and Deployment TipsDisable Security Manager Monitoring EJB Components EJB Performance TuningGoals Following is a sample of the monitoring output Asadmin get -m monitorableObject Monitoring Individual EJB Components Use Caching General GuidelinesUse High Performance Beans Use the Appropriate Stubs Using Local and Remote InterfacesCache and Pool Tuning Tips Remove Unneeded Stateful Session Beans Using Pass-By-Reference Semantics Prefer Local Interfaces Improving Performance of EJB Transactions Use the Least Expensive Transaction Attribute Using Special TechniquesConfigure Jdbc Resources as One-Phase Commit Resources Version Consistency Entity-mapping cmp-field-mapping Request Partitioning To enable request partitioningWhen new.VCVERSIONNUMBER = old.VCVERSIONNUMBER Declare Cmp-field-mapping consistency Stateful Session Beans Tuning Tips for Specific Types of EJB ComponentsEntity Beans Read-Only Entity Beans Checkpoint only when neededStateless Session Beans Pre-fetching Container Managed Relationship CMR Beans Refresh period OrderTable.OrderID = OrderLineTable.OrderLineOrderID Encapsulate Business Logic in Entity EJB Components Jdbc and Database AccessUse Jdbc Directly Close Connections Use getConnection Tuning Message-Driven BeansAsadmin set server.mdb-container.max-pool-size = value Tune the Message-Driven Bean’s Pool Size Cache Bean-Specific Resources Limit Use of JMS Connections Tuning the Enterprise Server Deployment Settings Disable Dynamic Application Reloading Logger SettingsDisable Auto-deployment Use Pre-compiled JavaServer Pages Session Properties Session Timeout Web Container SettingsGeneral Settings Log Levels Disable Dynamic JSP Reloading Manager Properties Reap Interval Monitoring the EJB Container EJB Container SettingsTuning the EJB Container Overview of EJB Pooling and Caching Tuning the EJB Pool EJB Pool Settings Tuning the EJB Cache EJB Cache Settings Pool and Cache Settings for Individual EJB Components Commit Option Determining the best commit option Monitoring the Transaction Service Java Message Service SettingsTransaction Service Settings Viewing Monitoring Information Asadmin get -m serverInstance.transaction-service Tuning the Transaction ServiceDisable Distributed Transaction Logging Recover On Restart Automatic Recovery Http Service SettingsMonitoring the Http Service Keypoint Interval Property name=statsProfilingEnabled value=false EnabledList --user admin --port DNS Cache Information dns Limit DNS Lookups to Asynchronous HitRatioCaching DNS Entries NameLookups File Cache Information file-cache Keep Alive keep-alive Connection Queue Tuning the Http ServiceAccess Log Request Processing Initial Thread Count Request TimeoutThread Count Max Connections Keep AliveBuffer Length Http File Cache DNS Lookup EnabledHttp Protocol Time Out Max Age Max Files CountHash Init Size Small/Medium File Size and File Size Limit Acceptor Threads Tuning Http Listener SettingsNetwork Address How a Client Connects to the ORB ORB SettingsOverview Monitoring the ORB Connection Statistics Tuning the ORB3Tunable ORB Settings Thread Pools Tunable ORB Parameters ORB Thread Pool Parameters Controlling connections between client and server ORB Using multiple connectionsClient ORB Properties Load Balancing Thread Pool SizingExamining Iiop Messages Improving ORB Performance with Java Serialization To Enable Java Serialization Thread Pool SettingsTuning Thread Pools Unix /Linux only Using JSG for Application Clients Resources Jdbc Connection Pool SettingsTuning Jdbc Connection Pools Monitoring Jdbc Connection Pools 4Connection Pool Sizing Pool Size SettingsTimeout Settings Isolation Level Settings Connection Validation Settings Connector Connection Pool Settings Transaction Support Testpool Page Tuning the Java Runtime System Java Virtual Machine Settings Tuning the Garbage Collector Managing Memory and Garbage Collection Additional Information Choosing the Garbage Collection AlgorithmTo use the CMS collector Other Garbage Collector Settings Tracing Garbage Collection 1Maximum Address Space Per Process Tuning the Java HeapGuidelines for Java Heap Sizing Heap Tuning Parameters Xmsvalue Xmxvalue Survivor Ratio Sizing Example 4-1Heap Configuration on SolarisRebasing DLLs on Windows Enter this command rebase -b 0x6000000 *.dll To rebase the Application Server’s DLLs For more information on tuning the JVM, see Page Server Scaling Processors Networking MemoryDisk Space Tuning Parameters Netstat -nP tcpwc -l Sizing the Connection Hash TableNdd -get /dev/tcp tcpconnhash Linux Configuration File Descriptor Setting Tuning for Solaris on File Descriptors on IP Stack Settings on IP Stack Settings File Descriptors Tuning for Linux platforms Session required /lib/security/pamlimits.so Virtual MemorySoft Nofile 65535 Hard To tune the TCP/IP settings Disk I/O SettingsTCP/IP Settings Network Interface Tuning UltraSPARC T1-Based Systems Tuning Operating System and TCP Settings 2Tuning 64-bit Systems for Performance Benchmarking Start Options Disk ConfigurationNetwork Configuration 106 Calculating Hadb Data Device Size Tuning HadbDisk Use Tuning Data Device Size Hadbm set TotalDatadeviceSizePerNode Beware last flush/fputs took too long Memory AllocationPlacing Hadb files on Physical Disks Vmstat -S NodeNo TotalSize FreeSize Usage 512 504 PerformanceDataBufferPoolSize Hadbm set DataBufferPoolSize Tuning DataBufferPoolSizeLogBufferSize Hadbm resourceinfo --logbuf Tuning LogBufferSizeInternalLogbufferSize Node No Avail Free Size Hadbm resourceinfo --nilogbuf Tuning InternalLogbufferSizeNumberOfLocks Hadbm set InternalLogbufferSize Summary Tuning NumberOfLocksCalculating the number of locks Load Balancer timeouts TimeoutsJdbc connection pool timeouts Node No Avail Free Waits 50000 Hadb timeouts Tuning the Enterprise Server for High-AvailabilityOperating System Configuration No space left on device Time-based Tuning Session Persistence FrequencyWeb-method Session Session Persistence ScopeSession Size Modified-session Configuring the Jdbc Connection Pool Checkpointing Stateful Session Beans Configuring the Load Balancer Enabling the Health Checker Tuning for High-Availability 121 122 Index Index 125 Monitoring transaction service Session timeout 128