IBM WebSphere Application Server V5.1 system management and configuration : WebSphere handbook series

2319 Pages·2004·23.315 MB·English

by  Carla Sadtler, et al

(cid:1)(cid:2)(cid:3)
WebSphere ApplicationServerNetworkDeployment,Version6
®

Administeringapplicationsandtheirenvironment
Note

Beforeusingthisinformation,besuretoreadthegeneralinformationunder“Notices”onpage2305.

Compilationdate:January20,2005

©CopyrightInternationalBusinessMachinesCorporation2004.Allrightsreserved.
US Governm entUsersRes trictedRigh ts–Use,d uplicationor disclos ure restric tedbyGS AADPScheduleContract
with IBMCorp.
Contents

How to send your comments. . . . . . . . . . . . . . . . . . . . . . . . . . . . xi

Chapter1. Overview and new features for administering applications and their environments . . 1

Overview of administering applications and their environments . . . . . . . . . . . . . . . . 2

Getting started with WebSphereApplication Server . . . . . . . . . . . . . . . . . . . . 3

Introduction: System administration . . . . . . . . . . . . . . . . . . . . . . . . . . 3

Introduction:Administrative console . . . . . . . . . . . . . . . . . . . . . . . . . 4

Introduction:Administrative scripting (wsadmin) . . . . . . . . . . . . . . . . . . . . . 4

Introduction:Administrative commands . . . . . . . . . . . . . . . . . . . . . . . . 5

Introduction:Administrative programs. . . . . . . . . . . . . . . . . . . . . . . . . 5

Introduction:Administrative configuration data . . . . . . . . . . . . . . . . . . . . . 6

Welcome to basic administrative architecture. . . . . . . . . . . . . . . . . . . . . . 6

Introduction: Servers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Introduction:Application servers . . . . . . . . . . . . . . . . . . . . . . . . . . 8

Introduction: Web servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

Introduction: Clusters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

Introduction: Environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

Introduction: Cell-wide settings. . . . . . . . . . . . . . . . . . . . . . . . . . . 11

Chapter2. How do I administer applications and their environments? . . . . . . . . . . . 13

Chapter3. Setting up the application serving environment. . . . . . . . . . . . . . . . 21

Planning the installation (diagrams). . . . . . . . . . . . . . . . . . . . . . . . . . 21

Planning to install Network Deployment . . . . . . . . . . . . . . . . . . . . . . . 23

Planning to install Web server plug-ins . . . . . . . . . . . . . . . . . . . . . . . 31

Planning to install WebSphereApplication Server Clients. . . . . . . . . . . . . . . . . 38

Planning to create application server environments . . . . . . . . . . . . . . . . . . . 39

Example: Choosing a topology for better performance . . . . . . . . . . . . . . . . . . 42

Queuing network. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43

Configuring the product after installation . . . . . . . . . . . . . . . . . . . . . . . . 47

firststeps command. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48

Using the Profile creation wizard . . . . . . . . . . . . . . . . . . . . . . . . . . 54

wasprofile command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96

Using the installation verification test . . . . . . . . . . . . . . . . . . . . . . . . 110

Configuring ports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113

Port number settings in WebSphereApplication Server versions. . . . . . . . . . . . . . 113

Communicating with Web servers . . . . . . . . . . . . . . . . . . . . . . . . . . 116

Web server plug-in properties settings . . . . . . . . . . . . . . . . . . . . . . . 118

Web server plug-in custom properties . . . . . . . . . . . . . . . . . . . . . . . 126

Web server plug-in configuration service properties settings . . . . . . . . . . . . . . . 127

Application Server property settings for a Web server plug-in . . . . . . . . . . . . . . . 127

Web server plug-in configuration properties . . . . . . . . . . . . . . . . . . . . . 129

Web server plug-in connections. . . . . . . . . . . . . . . . . . . . . . . . . . 131

Web server plug-in remote user information processing . . . . . . . . . . . . . . . . . 132

Web server plug-ins . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132

Checking your IBM HTTP Server version . . . . . . . . . . . . . . . . . . . . . . 132

Web server tuning parameters . . . . . . . . . . . . . . . . . . . . . . . . . . 133

Gskit install images files . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137

Plug-ins: Resources for learning . . . . . . . . . . . . . . . . . . . . . . . . . 137

Web server plug-in tuning tips . . . . . . . . . . . . . . . . . . . . . . . . . . 137

Tuning Web servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139

Setting up the administrative architecture . . . . . . . . . . . . . . . . . . . . . . . 139

Cells. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139

© Copyright IBM Corp. 2004 iii
Configuring cells . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140

Deployment managers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145

Configuring deployment managers. . . . . . . . . . . . . . . . . . . . . . . . . 145

Node . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148

Managing nodes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149

Node group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155

Managing node groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157

Managing node group members . . . . . . . . . . . . . . . . . . . . . . . . . 159

Administration service settings . . . . . . . . . . . . . . . . . . . . . . . . . . 160

Node agents. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167

Managing node agents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167

Remote file services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170

Configuring remote file services. . . . . . . . . . . . . . . . . . . . . . . . . . 170

Administrative agents: Resources for learning . . . . . . . . . . . . . . . . . . . . 173

Configuring the environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174

Virtual hosts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174

Configuring virtual hosts . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177

Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180

Configuring WebSphere variables . . . . . . . . . . . . . . . . . . . . . . . . . 181

Shared library files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184

Managing shared libraries. . . . . . . . . . . . . . . . . . . . . . . . . . . . 184

Environment: Resources for learning . . . . . . . . . . . . . . . . . . . . . . . . 191

Working with server configuration files . . . . . . . . . . . . . . . . . . . . . . . . 191

Configuration documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192

Configuration document descriptions . . . . . . . . . . . . . . . . . . . . . . . . 193

Object names . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195

Configuration repositories . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195

Handling temporary configuration files resulting from session timeout . . . . . . . . . . . . 196

Changing the location of temporary configuration files . . . . . . . . . . . . . . . . . 196

Changing the location of backed-up configuration files . . . . . . . . . . . . . . . . . 197

Changing the location of temporary workspace files . . . . . . . . . . . . . . . . . . 197

Backing up and restoring administrative configurations . . . . . . . . . . . . . . . . . 197

Transformation of configuration files . . . . . . . . . . . . . . . . . . . . . . . . 198

Server configuration files: Resources for learning . . . . . . . . . . . . . . . . . . . 198

Administering application servers . . . . . . . . . . . . . . . . . . . . . . . . . . 198

Application servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199

Creating application servers . . . . . . . . . . . . . . . . . . . . . . . . . . . 200

Managing application servers . . . . . . . . . . . . . . . . . . . . . . . . . . 202

Creating generic servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219

Configuring transport chains . . . . . . . . . . . . . . . . . . . . . . . . . . . 221

Custom services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237

Developing custom services . . . . . . . . . . . . . . . . . . . . . . . . . . . 237

Process definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240

Defining application server processes . . . . . . . . . . . . . . . . . . . . . . . 240

Java virtual machines (JVMs) . . . . . . . . . . . . . . . . . . . . . . . . . . 252

Using the JVM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252

Preparing to host applications . . . . . . . . . . . . . . . . . . . . . . . . . . 259

Java memory tuning tips . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260

Configuring multiple network interface card support . . . . . . . . . . . . . . . . . . 264

Tuning application servers. . . . . . . . . . . . . . . . . . . . . . . . . . . . 265

Web services client to Web container optimized communication . . . . . . . . . . . . . . 266

Application servers: Resources for learning . . . . . . . . . . . . . . . . . . . . . 267

Balancing workloads with clusters . . . . . . . . . . . . . . . . . . . . . . . . . . 268

Clusters and workload management . . . . . . . . . . . . . . . . . . . . . . . . 268

Clusters and node groups. . . . . . . . . . . . . . . . . . . . . . . . . . . . 269

Workload management (WLM) for distributed platforms . . . . . . . . . . . . . . . . . 270

iv IBMWebSphereApplicationServerNetworkDeployment,Version6: Administeringapplicationsandtheirenvironment
Creating clusters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271

Creating cluster members . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276

Creating backup clusters . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278

Starting clusters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 282

Stopping clusters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283

Replicating data across application servers in a cluster . . . . . . . . . . . . . . . . . 283

Deleting clusters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296

Deleting cluster members . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296

Tuning a workload management configuration . . . . . . . . . . . . . . . . . . . . 296

Workload management run-time exceptions . . . . . . . . . . . . . . . . . . . . . 297

Clustering and workload management: Resources for learning . . . . . . . . . . . . . . 297

Setting up a high availability environment . . . . . . . . . . . . . . . . . . . . . . . 298

High availability manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . 300

High availability network components. . . . . . . . . . . . . . . . . . . . . . . . 301

Transport protocol for a high availability manager . . . . . . . . . . . . . . . . . . . 302

Creating a new core group . . . . . . . . . . . . . . . . . . . . . . . . . . . 303

Changing a core group’s configuration . . . . . . . . . . . . . . . . . . . . . . . 311

Changing the configuration of a high availability group . . . . . . . . . . . . . . . . . 313

Creating a policy for a high availability group . . . . . . . . . . . . . . . . . . . . . 316

Changing the policy of a high availability group . . . . . . . . . . . . . . . . . . . . 323

Adding members to a core group . . . . . . . . . . . . . . . . . . . . . . . . . 324

Routing high availability group work to a different server. . . . . . . . . . . . . . . . . 326

Configuring the core group bridge service . . . . . . . . . . . . . . . . . . . . . . 328

Chapter4. Using the administrative clients . . . . . . . . . . . . . . . . . . . . . 349

Using the administrative console . . . . . . . . . . . . . . . . . . . . . . . . . . 349

Starting and stopping the administrative console . . . . . . . . . . . . . . . . . . . 349

Setting the session timeout for the administrative console . . . . . . . . . . . . . . . . 352

Administrative console areas. . . . . . . . . . . . . . . . . . . . . . . . . . . 353

Specifying console preferences. . . . . . . . . . . . . . . . . . . . . . . . . . 359

Accessing help and product information from the administrative console. . . . . . . . . . . 362

Administrative console: Resources for learning . . . . . . . . . . . . . . . . . . . . 363

Using scripting (wsadmin) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 364

Getting started with scripting . . . . . . . . . . . . . . . . . . . . . . . . . . . 365

Deploying applications using scripting . . . . . . . . . . . . . . . . . . . . . . . 433

Managing deployed applications using scripting . . . . . . . . . . . . . . . . . . . . 435

Configuring servers with scripting . . . . . . . . . . . . . . . . . . . . . . . . . 462

Configuring connections to Webservers with scripting. . . . . . . . . . . . . . . . . . 479

Managing servers with scripting. . . . . . . . . . . . . . . . . . . . . . . . . . 480

Clustering servers with scripting. . . . . . . . . . . . . . . . . . . . . . . . . . 489

Configuring security with scripting . . . . . . . . . . . . . . . . . . . . . . . . . 493

Configuring data access with scripting . . . . . . . . . . . . . . . . . . . . . . . 495

Configuring messaging with scripting . . . . . . . . . . . . . . . . . . . . . . . . 511

Configuring mail, URLs, and resource environment entries with scripting. . . . . . . . . . . 524

Troubleshooting with scripting . . . . . . . . . . . . . . . . . . . . . . . . . . 537

Scripting reference material . . . . . . . . . . . . . . . . . . . . . . . . . . . 540

UsingAnt to automate tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . 809

ws_ant command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 810

Ant tasks for deployment and server operation . . . . . . . . . . . . . . . . . . . . 810

Ant tasks for building application code . . . . . . . . . . . . . . . . . . . . . . . 810

Using administrative programs (JMX). . . . . . . . . . . . . . . . . . . . . . . . . 810

Creating a custom Java administrative client program using WebSphereApplication Server

administrative JavaAPIs . . . . . . . . . . . . . . . . . . . . . . . . . . . 811

Extending the WebSphereApplication Server administrative system with custom MBeans . . . . 816

Developing administrative programs for multiple Java 2 Platform, Enterprise Edition application

servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 821

Contents v
Deploying and managing a custom Java administrative client program with multiple Java 2

Platform, Enterprise Edition application servers . . . . . . . . . . . . . . . . . . . 824

Migrating Java Management Extensions V1.0 to Java Management Extensions V1.2 . . . . . . 825

Java Management Extensions interoperability . . . . . . . . . . . . . . . . . . . . 825

Managed object metadata. . . . . . . . . . . . . . . . . . . . . . . . . . . . 826

Managing applications through programming . . . . . . . . . . . . . . . . . . . . . 827

Using command line tools. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 852

Example: Security and the command line tools . . . . . . . . . . . . . . . . . . . . 853

startServer command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 853

stopServer command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 854

startManager command. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 855

stopManager command. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 857

startNode command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 858

stopNode command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 859

addNode command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 861

serverStatus command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 865

removeNode command. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 866

cleanupNode command. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 867

syncNode command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 868

backupConfig command . . . . . . . . . . . . . . . . . . . . . . . . . . . . 869

restoreConfig command . . . . . . . . . . . . . . . . . . . . . . . . . . . . 870

EARExpander command . . . . . . . . . . . . . . . . . . . . . . . . . . . . 871

GenPluginCfg command . . . . . . . . . . . . . . . . . . . . . . . . . . . . 872

Chapter5. Starting and stopping quick reference . . . . . . . . . . . . . . . . . . . 875

Chapter6. Class loading. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 877

Class loaders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 877

Configuring class loaders of a server. . . . . . . . . . . . . . . . . . . . . . . . . 881

Class loader collection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 882

Class loader ID. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 882

Class loader mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 882

Class loader settings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 883

Configuring application class loaders. . . . . . . . . . . . . . . . . . . . . . . . . 883

Configuring Web module class loaders . . . . . . . . . . . . . . . . . . . . . . . . 884

Configuring class preloading . . . . . . . . . . . . . . . . . . . . . . . . . . . . 885

Class loading: Resources for learning . . . . . . . . . . . . . . . . . . . . . . . . 886

Chapter7. Deploying and administering applications . . . . . . . . . . . . . . . . . 889

Enterprise (J2EE) applications . . . . . . . . . . . . . . . . . . . . . . . . . . . 889

System applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 889

Installing application files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 890

Installable module versions . . . . . . . . . . . . . . . . . . . . . . . . . . . 891

Ways to install applications or modules . . . . . . . . . . . . . . . . . . . . . . . 892

Installing application files with the console . . . . . . . . . . . . . . . . . . . . . . 893

Example: Installing an EAR file using the default bindings . . . . . . . . . . . . . . . . 903

Installing J2EE modules with JSR-88. . . . . . . . . . . . . . . . . . . . . . . . 904

Customizing modules using DConfigBeans . . . . . . . . . . . . . . . . . . . . . 905

Enterprise application collection. . . . . . . . . . . . . . . . . . . . . . . . . . . 906

Name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 907

Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 907

Enterprise application settings . . . . . . . . . . . . . . . . . . . . . . . . . . 908

Configuring an application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 911

Application bindings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 913

Mapping modules to servers . . . . . . . . . . . . . . . . . . . . . . . . . . . 917

Starting and stopping applications . . . . . . . . . . . . . . . . . . . . . . . . . . 918

vi IBMWebSphereApplicationServerNetworkDeployment,Version6: Administeringapplicationsandtheirenvironment
Disabling automatic starting of applications . . . . . . . . . . . . . . . . . . . . . 919

Target mapping collection . . . . . . . . . . . . . . . . . . . . . . . . . . . . 919

Exporting applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 920

Exporting DDLfiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 921

Updating applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 921

Ways to update application files. . . . . . . . . . . . . . . . . . . . . . . . . . 924

Preparing for application update settings . . . . . . . . . . . . . . . . . . . . . . 925

Hot deployment and dynamic reloading . . . . . . . . . . . . . . . . . . . . . . . 929

Uninstalling applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 937

Removing a file. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 938

Deploying and administering applications: Resources for learning . . . . . . . . . . . . . . 938

Chapter8. Developing WebSphere applications. . . . . . . . . . . . . . . . . . . . 941

Web applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 941

Task overview: Developing and deploying Web applications . . . . . . . . . . . . . . . 941

Task overview: Managing HTTP sessions . . . . . . . . . . . . . . . . . . . . . . 978

Modifying the default Web container configuration . . . . . . . . . . . . . . . . . . . 993

Configuring session management by level . . . . . . . . . . . . . . . . . . . . . . 998

Configuring session tracking . . . . . . . . . . . . . . . . . . . . . . . . . . . 999

Configuring session tracking for WirelessApplication Protocol (WAP) devices . . . . . . . . 1004

Configuring for database session persistence . . . . . . . . . . . . . . . . . . . . 1004

Configuring memory-to-memory replication for the peer-to-peer mode (default memory-to-memory

replication) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1007

Configuring memory-to-memory replication for the client/server mode . . . . . . . . . . . 1008

EJB applications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1010

Task overview: Using enterprise beans in applications . . . . . . . . . . . . . . . . . 1010

Using access intent policies. . . . . . . . . . . . . . . . . . . . . . . . . . . 1015

Managing EJB containers . . . . . . . . . . . . . . . . . . . . . . . . . . . 1024

Deploying EJB modules . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1036

Client applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1038

Using application clients . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1038

Running application clients . . . . . . . . . . . . . . . . . . . . . . . . . . . 1050

InstallingApplication Client for WebSphereApplication Server . . . . . . . . . . . . . . 1068

Deploying J2EE application clients on workstation platforms. . . . . . . . . . . . . . . 1073

Web services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1151

Implementing Web services applications . . . . . . . . . . . . . . . . . . . . . . 1151

Deploying Web services . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1163

Configuring Web service client bindings . . . . . . . . . . . . . . . . . . . . . . 1165

Configuring the scope of a Web service port. . . . . . . . . . . . . . . . . . . . . 1168

Web Services Invocation Framework (WSIF): Enabling Web services . . . . . . . . . . . 1170

Getting started with UDDI Registry . . . . . . . . . . . . . . . . . . . . . . . . 1174

Planning to use Web services . . . . . . . . . . . . . . . . . . . . . . . . . . 1176

Setting up and deploying a new UDDI Registry. . . . . . . . . . . . . . . . . . . . 1180

Publishing WSDLfiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1191

Configuring endpoint URLinformation for JMS bindings . . . . . . . . . . . . . . . . 1194

Configuring Web services applications with the wsadmin tool . . . . . . . . . . . . . . 1196

WSIF system management and administration. . . . . . . . . . . . . . . . . . . . 1196

Using the UDDI Registry. . . . . . . . . . . . . . . . . . . . . . . . . . . . 1203

Removing and reinstalling UDDI Registry. . . . . . . . . . . . . . . . . . . . . . 1307

Configuring the UDDI RegistryApplication . . . . . . . . . . . . . . . . . . . . . 1309

Managing the UDDI Registry . . . . . . . . . . . . . . . . . . . . . . . . . . 1313

Data access resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1325

Task overview:Accessing data from applications . . . . . . . . . . . . . . . . . . . 1325

Deploying data access applications . . . . . . . . . . . . . . . . . . . . . . . . 1355

Messaging resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1443

Learning about messaging with WebSphereApplication Server. . . . . . . . . . . . . . 1443

Contents vii
Installing and configuring a JMS provider. . . . . . . . . . . . . . . . . . . . . . 1454

Using asynchronous messaging . . . . . . . . . . . . . . . . . . . . . . . . . 1456

Using JMS resources of WebSphere MQ. . . . . . . . . . . . . . . . . . . . . . 1456

Using JMS resources of a generic provider . . . . . . . . . . . . . . . . . . . . . 1524

Maintaining Version 5 default messaging resources . . . . . . . . . . . . . . . . . . 1532

Administering support for message-driven beans . . . . . . . . . . . . . . . . . . . 1565

Mail, URLs, and other J2EE resources. . . . . . . . . . . . . . . . . . . . . . . . 1581

Using mail . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1581

Using URLresources within an application . . . . . . . . . . . . . . . . . . . . . 1585

Resource environment entries . . . . . . . . . . . . . . . . . . . . . . . . . . 1588

Configuring mail providers and sessions . . . . . . . . . . . . . . . . . . . . . . 1592

Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1598

Securing applications and their environments . . . . . . . . . . . . . . . . . . . . 1598

Planning to secure your environment . . . . . . . . . . . . . . . . . . . . . . . 1599

Implementing security considerations at installation time . . . . . . . . . . . . . . . . 1611

Integrating IBM WebSphereApplication Server security with existing security systems . . . . . 1616

Administering security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1624

Deploying secured applications . . . . . . . . . . . . . . . . . . . . . . . . . 1984

Naming and directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1995

Using naming . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1995

Configuring name servers . . . . . . . . . . . . . . . . . . . . . . . . . . . 2006

Configuring and viewing name space bindings. . . . . . . . . . . . . . . . . . . . 2006

Developing applications that use JNDI. . . . . . . . . . . . . . . . . . . . . . . 2010

Developing applications that use CosNaming (CORBANaming interface) . . . . . . . . . . 2025

Object Request Broker . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2030

Managing Object Request Brokers . . . . . . . . . . . . . . . . . . . . . . . . 2030

Transactions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2047

Configuring transaction properties for an application server . . . . . . . . . . . . . . . 2047

Configuring transaction properties for peer recovery. . . . . . . . . . . . . . . . . . 2056

Using the transaction service . . . . . . . . . . . . . . . . . . . . . . . . . . 2057

Managing active and prepared transactions . . . . . . . . . . . . . . . . . . . . . 2070

Managing transaction logging for optimum server availability. . . . . . . . . . . . . . . 2071

Interoperating transactionally between application servers. . . . . . . . . . . . . . . . 2074

Using one-phase and two-phase commit resources in the same transaction . . . . . . . . . 2075

WebSphere programming extensions . . . . . . . . . . . . . . . . . . . . . . . . 2078

ActivitySessions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2079

Application profiling. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2093

Asynchronous beans . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2105

Dynamic cache . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2122

Dynamic query . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2172

Internationalization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2201

Object pools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2211

Scheduler . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2217

Startup beans. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2242

Work area . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2243

Chapter9. Troubleshooting deployment . . . . . . . . . . . . . . . . . . . . . . 2269

Errors or problems deploying, installing, or promoting applications . . . . . . . . . . . . . 2269

Troubleshooting testing and first time run problems . . . . . . . . . . . . . . . . . . . 2273

Errors starting an application . . . . . . . . . . . . . . . . . . . . . . . . . . . 2274

The application does not start or starts with errors . . . . . . . . . . . . . . . . . . . 2278

Aweb resource does not display. . . . . . . . . . . . . . . . . . . . . . . . . . 2279

Cannot uninstall an application or remove a node or application server. . . . . . . . . . . . 2281

Chapter10. Troubleshooting administration. . . . . . . . . . . . . . . . . . . . . 2283

Administration and administrative console troubleshooting tips . . . . . . . . . . . . . . . 2283

viii IBMWebSphereApplicationServerNetworkDeployment,Version6: Administeringapplicationsandtheirenvironment
Installation completes but the administrative console does not start . . . . . . . . . . . . . 2285

Errors connecting to the administrative console from a browser . . . . . . . . . . . . . . 2286

When a single user that uses multiple instances of the Mozilla browser logs into the

administrative console, the first user ID that logs into the administrative console is the current

user. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2286

Auser on Mozilla browser Version 1.4 selects a check box on a collection table, presses Enter,

and receives an error. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2287

Auser on Mozilla browser Version 1.4 enters an invalid ID or password, presses Enter, and

receives an error message . . . . . . . . . . . . . . . . . . . . . . . . . . 2287

Web server plug-in troubleshooting tips . . . . . . . . . . . . . . . . . . . . . . . 2287

The server process does not start or starts with errors . . . . . . . . . . . . . . . . . . 2289

The stopServer.sh or administrative console stop server commandhangs and creates a Java core

dump (Red Hat Linux) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2290

Errors setting up multiserver environments . . . . . . . . . . . . . . . . . . . . . . 2291

Workload management component troubleshooting tips . . . . . . . . . . . . . . . . . 2293

Workload is not getting distributed . . . . . . . . . . . . . . . . . . . . . . . . . 2297

Problems starting or using the wsadmin command . . . . . . . . . . . . . . . . . . . 2300

Problems using tracing, logging or other troubleshooting features. . . . . . . . . . . . . . 2304

Notices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2305

Trademarks and service marks. . . . . . . . . . . . . . . . . . . . . . . . . . 2307

Contents ix
x IBMWebSphereApplicationServerNetworkDeployment,Version6: Administeringapplicationsandtheirenvironment