B1WS-1087-03ENZ0(00)April 2014

Windows/Solaris/Linux

FUJITSU SoftwareInterstage Application Server

Java EE Operator's Guide

Preface

Purpose of this DocumentThis document introduces the environment builds and application operations for the development of Interstage Java EE applications.

This manual is intended for the following readers:

- People who operate applications using Java EE components

Intended Readers

It is assumed that readers of this document have some knowledge of the following:

- Basic knowledge of the OS used

- Basic knowledge about Java

- Basic knowledge about Web Service

- Basic knowledge about XML

- Basic knowledge about the Internet

- Basic knowledge about the relational database

- Basic knowledge about the transaction model (client/server model)

Structure of This Document

This manual is organized as shown below:

Chapter 1 Release Information

This chapter explains software requirements, limitations, and notes for the Java EE runtime environment.

Chapter 2 Functionality Provided in the Java EE Application

This chapter explains the functionality provided in the Java EE application.

Chapter 3 Java EE Application Development

This chapter explains the development of the Java EE application.

Chapter 4 Java EE Application Operation

This chapter explains the Java EE application operation method.

Chapter 5 Java EE Function Security

This chapter explains Java EE application security.

Chapter 6 Java EE Function Tuning

This chapter explains how to tune Java EE applications.

Chapter 7 List of Definition Items

This chapter explains the definition items for Java EE application operations.

Chapter 8 Running High Reliability Systems

This chapter explains how to run high-reliability systems.

Chapter 9 Maintenance (Resource Backup/migration of Resources to Another Server)

This chapter explains how to maintain the Java EE application operating environment.

Chapter 10 Java EE Operation Commands

This chapter explains the backup and restore commands used in maintenance of the Java EE application operating environment.

- i -

Chapter 11 Interstage Operation Management Service Commands

This chapter describes the Interstage Operation Management service commands.

Chapter 12 Backup Commands

This chapter explains the backup and restore commands used to maintain the Java EE application operating environment.

Chapter 13 Java EE Messages

This chapter explains the messages output when the Java EE functionality is used.

Chapter 14 Troubleshooting

This chapter explains how to solve problems in Java EE application operations.

Chapter 15 Samples

This chapter explains the procedures and notes on the use of the Java EE samples.

Appendix A Java DB

This appendix explains the Java DB.

Appendix B File Configuration

This appendix explains the file configurations.

Appendix C Tutorial

This appendix explains the flow for the developed deployment resources using the Interstage Java EE feature.

Conventions

Representation of Platform-specific Information

In the manuals of this product, there are parts containing content that relates to all products that run on the supported platform. In this case,an icon indicating the product platform has been added to these parts if the content varies according to the product. For this reason, referonly to the information that applies to your situation.

Indicates that this product (32-bit) is running on Windows.

Indicates that this product (64-bit) is running on Windows.

Indicates that this product (32/64-bit) is running on Windows.

Indicates that this product (32-bit) is running on Solaris.

Indicates that this product (64-bit) is running on Solaris.

Indicates that this product (32/64-bit) is running on Solaris.

Indicates that this product (32-bit) is running on Linux.

Indicates that this product (64-bit) is running on Linux.

Indicates that this product (32/64-bit) is running on Linux.

Terminology in this document

In this document, both machine property settings (Windows(R)) and Interstage startup environment variables (Solaris/Linux) may also bereferred to as "system environment variables".

Product Notation

The notation used in this document (shown below) corresponds to the product that supports the respective software.

Notation Explanation

RHEL5(x86) Interstage Application Server for Red Hat Enterprise Linux 5 (for x86)

- ii -

Notation Explanation

RHEL5(Intel64) Interstage Application Server for Red Hat Enterprise Linux 5 (for Intel64)

RHEL6(x86) Interstage Application Server for Red Hat Enterprise Linux 6 (for x86)

RHEL6(Intel64) Interstage Application Server for Red Hat Enterprise Linux 6 (for Intel64)

Export Controls

Exportation/release of this document may require necessary procedures in accordance with the regulations of the Foreign Exchange andForeign Trade Control Law of Japan and/or US export control laws.

Trademarks

Trademarks of other companies are used in this documentation only to identify particular products or systems.

Product Trademarks/Registered Trademarks

Microsoft, Active Directory, ActiveX, Excel, Internet Explorer, MS-DOS, MSDN, Visual Basic, Visual C++,Visual Studio, Windows, Windows NT, Windows Server, Win32 are either registered trademarks or trademarksof Microsoft Corporation in the United States and/or other countries.

Oracle and Java are registered trademarks of Oracle and/or its affiliates.

Other company and product names in this documentation are trademarks or registered trademarks of their respective owners.

Copyrights

Copyright 2010-2014 FUJITSU LIMITED

April 2014 Third Edition

November 2012 First Edition

- iii -

ContentsChapter 1 Release Information.................................................................................................................................................1

1.1 Software Requirements........................................................................................................................................................................11.1.1 JRE/JDK Version..........................................................................................................................................................................11.1.2 Application Development Environment.......................................................................................................................................11.1.3 Database........................................................................................................................................................................................11.1.4 Web Server...................................................................................................................................................................................31.1.5 High Availability..........................................................................................................................................................................31.1.6 Management Console...................................................................................................................................................................31.1.7 Operation/Management................................................................................................................................................................4

1.2 Restrictions..........................................................................................................................................................................................41.2.1 Restrictions on Application Operations........................................................................................................................................41.2.2 Applications in the IPv6 Environment..........................................................................................................................................61.2.3 Security Functions........................................................................................................................................................................61.2.4 Restrictions on Commands...........................................................................................................................................................61.2.5 Restrictions on Interstage Java EE Admin Console.....................................................................................................................7

1.3 Notes on Interstage Operation.............................................................................................................................................................81.3.1 Differences with GlassFish...........................................................................................................................................................8

1.3.1.1 Differences in Deployment....................................................................................................................................................91.3.2 Notes About Using Windows Server® 2003................................................................................................................................91.3.3 Notes on Interstage Java EE Admin Console Operation..............................................................................................................91.3.4 Notes About Deployment...........................................................................................................................................................121.3.5 Notes About Web Applications..................................................................................................................................................151.3.6 Notes About EJB........................................................................................................................................................................191.3.7 Notes About JPA........................................................................................................................................................................191.3.8 Notes on the Connector Function...............................................................................................................................................201.3.9 Notes About JMS........................................................................................................................................................................201.3.10 Notes Related to Date/time.......................................................................................................................................................221.3.11 Notes on the Java EE Password................................................................................................................................................231.3.12 Notes on Application Security..................................................................................................................................................231.3.13 Notes on the Web Service/Web Service Client........................................................................................................................231.3.14 Notes on Repository Synchronization......................................................................................................................................241.3.15 Notes on Resource Access Privileges when the Service Operator User has been Changed....................................................241.3.16 Notes About Using Cluster Service Linkage............................................................................................................................251.3.17 Notes on Log File Rotation.......................................................................................................................................................251.3.18 Notes on Using 'root' in Solaris................................................................................................................................................25

Chapter 2 Functionality Provided in the Java EE Application.................................................................................................262.1 Overall Configurations......................................................................................................................................................................26

2.1.1 Interstage Java EE Operating Environment................................................................................................................................262.1.2 JREJDK/JRE Used by Java EE..................................................................................................................................................272.1.3 Java EE Common Directory.......................................................................................................................................................272.1.4 Repository Synchronization........................................................................................................................................................282.1.5 Initializing the Java EE Environment.........................................................................................................................................292.1.6 User Name and Password Used in the Java EE Environment....................................................................................................312.1.7 Customizing a Service Operator User .......................................................................................................................................31

2.2 Interstage Java EE DAS Service........................................................................................................................................................312.2.1 Interstage Java EE DAS Service File Configuration..................................................................................................................322.2.2 Interstage Java EE DAS Service Log Files................................................................................................................................332.2.3 Interstage Java EE DAS Service Instance Names and Definition Information..........................................................................332.2.4 Differences with the IJServer Cluster.........................................................................................................................................33

2.3 Interstage Java EE Node Agent Service............................................................................................................................................342.3.1 Interstage Java EE Node Agent Service File Configuration.......................................................................................................342.3.2 Interstage Java EE Node Agent Service Log Files.....................................................................................................................35

2.4 IJServer Cluster..................................................................................................................................................................................352.4.1 IJServer Cluster Operating Environment....................................................................................................................................35

- iv -

2.4.2 IJServer Cluster File Configuration............................................................................................................................................352.4.3 IJServer Cluster Multiple Process Configurations......................................................................................................................382.4.4 The Life-and-death Monitoring of the Java VM Process...........................................................................................................392.4.5 Degeneration...............................................................................................................................................................................402.4.6 Controlling Insufficient Space in the Java Heap/Permanent Generation Space.........................................................................412.4.7 Monitoring the Maximum Processing Time for Application and Response Monitoring...........................................................412.4.8 Alert Monitoring.........................................................................................................................................................................43

2.5 Functionality Provided in Web Container.........................................................................................................................................432.5.1 Servlet 2.5...................................................................................................................................................................................432.5.2 JSP 2.1........................................................................................................................................................................................442.5.3 Error Page...................................................................................................................................................................................452.5.4 JSP Precompile...........................................................................................................................................................................462.5.5 JSP Operations Using Java Standard Edition 6..........................................................................................................................47

2.6 About Session Recovery....................................................................................................................................................................482.6.1 Session Recovery Functionality..................................................................................................................................................48

2.6.1.1 Session Backup....................................................................................................................................................................492.6.1.2 Session Recovery.................................................................................................................................................................522.6.1.3 Enabling/Disabling Session Recovery in the URI...............................................................................................................532.6.1.4 Session Recovery Monitoring..............................................................................................................................................552.6.1.5 Web Server Connector Fault Monitoring............................................................................................................................552.6.1.6 Maximum Number of Sessions that are Retained in the Session Registry Server..............................................................552.6.1.7 Session Serialization............................................................................................................................................................562.6.1.8 Clearing All Sessions...........................................................................................................................................................572.6.1.9 Session Recovery Log.........................................................................................................................................................572.6.1.10 Destroying Expired (Timed Out) Session Registry Server Sessions.................................................................................572.6.1.11 Controlling Access to the Session Registry Server...........................................................................................................572.6.1.12 Controlling Access to the Session Registry Client............................................................................................................58

2.6.2 Session Recovery Scope.............................................................................................................................................................582.7 HTTP Service....................................................................................................................................................................................60

2.7.1 HTTP Listener............................................................................................................................................................................602.7.2 HTTP Access Log.......................................................................................................................................................................602.7.3 HTTP Trace Log.........................................................................................................................................................................60

2.8 Functionality Provided in EJB...........................................................................................................................................................602.8.1 Session Bean Runtime Environment..........................................................................................................................................612.8.2 Message-driven Bean Runtime Environment.............................................................................................................................622.8.3 Load Balancing Using the EJB Dispatcher Feature....................................................................................................................64

2.8.3.1 Adding/deleting Dispatch Target Enterprise JavaBeans.....................................................................................................652.8.3.2 Dispatch Target Enterprise JavaBeans................................................................................................................................662.8.3.3 Dispatch Operations using Commands, and Status Display................................................................................................672.8.3.4 EJB Dispatcher Logs...........................................................................................................................................................67

2.9 Time Monitoring Functionality that can be Used in the EJB Container...........................................................................................702.9.1 Non-communication Time Monitoring Functionality for the Stateful Session Bean Instance...................................................722.9.2 Transaction Completion Time Monitoring Functionality for the EJB Container.......................................................................732.9.3 EJB Timer Service......................................................................................................................................................................73

2.10 EJB/JTA Method Logs....................................................................................................................................................................772.10.1 Definition Detail.......................................................................................................................................................................822.10.2 Command Detail.......................................................................................................................................................................82

2.11 Functionality Provided in JPA.........................................................................................................................................................832.11.1 JPA Runtime Environment.......................................................................................................................................................842.11.2 Persistence Provider Settings....................................................................................................................................................842.11.3 Supported Database and Settings..............................................................................................................................................852.11.4 Supporting Java Data Types and DBMS SQL Data Types Defined in the Entity....................................................................872.11.5 Functionality for the Automatic Generation of Primary Key Values.......................................................................................882.11.6 Functionality for the Automatic Generation of Database Tables.............................................................................................902.11.7 Lock Functionality for the Line................................................................................................................................................942.11.8 SQL Log Functionality.............................................................................................................................................................95

2.12 ORB (Object Request Broker)/RMI-IIOP.......................................................................................................................................96

- v -

2.13 Application Client Container...........................................................................................................................................................972.14 JNDI.................................................................................................................................................................................................98

2.14.1 Naming Service.......................................................................................................................................................................1002.14.2 Environment Naming Context................................................................................................................................................1042.14.3 Differences in Specifications between Naming Service and Environment Naming Context.................................................1122.14.4 Other Naming Services Linkage Feature................................................................................................................................1132.14.5 Object Reference Cache Feature.............................................................................................................................................114

2.15 Transaction Control.......................................................................................................................................................................1152.15.1 Local Transactions and Global Transactions..........................................................................................................................1162.15.2 How to Control Transactions..................................................................................................................................................1192.15.3 2-phase Commit Protocol.......................................................................................................................................................1192.15.4 Managing Transaction Resources...........................................................................................................................................1202.15.5 Transaction Log......................................................................................................................................................................1212.15.6 Transaction Monitoring and Freeze Functionality..................................................................................................................121

2.16 Connection Pool.............................................................................................................................................................................1222.17 Database Connection/JDBC..........................................................................................................................................................1242.18 Time Monitoring Functionality that can be Used at the Time of Database Connection...............................................................1252.19 JMS Functions that are Provided...................................................................................................................................................126

2.19.1 Message Broker......................................................................................................................................................................1272.19.2 Message Broker Functions......................................................................................................................................................1282.19.3 Physical Storage Destination Management............................................................................................................................1282.19.4 Connection Service.................................................................................................................................................................1322.19.5 Port Mapper............................................................................................................................................................................1332.19.6 Routing Service.......................................................................................................................................................................1332.19.7 Persistence Service.................................................................................................................................................................1342.19.8 High Reliability Function.......................................................................................................................................................1342.19.9 Predelivery..............................................................................................................................................................................136

2.20 Functionality Provided in the Connector.......................................................................................................................................1402.20.1 Definition of the Connector Connection Pool and Connector Resources..............................................................................1402.20.2 Outbound/resource Adapter Transaction Control...................................................................................................................1412.20.3 Connections with Message-driven Bean.................................................................................................................................1412.20.4 Definition of Managed Object Resources...............................................................................................................................1422.20.5 JavaBean Configurations........................................................................................................................................................1422.20.6 Execution of Work when the Thread Pool is Used.................................................................................................................143

2.21 Time Monitoring Functionality that can be Used in the Connector..............................................................................................1432.22 Group Management Service..........................................................................................................................................................1432.23 Class Loader..................................................................................................................................................................................144

2.23.1 Class Loader Configuration....................................................................................................................................................1452.23.2 Classification of Class Loaders...............................................................................................................................................1462.23.3 Changing the Transfer Model of Web Class Loader..............................................................................................................1482.23.4 Setting Classes Used by IJServer Cluster...............................................................................................................................1492.23.5 Setting the XML Parser..........................................................................................................................................................1502.23.6 Note About the Use of the Class Loader................................................................................................................................150

2.24 Lifecycle Module...........................................................................................................................................................................1512.24.1 Design Procedure for the Lifecycle Module...........................................................................................................................1522.24.2 Operation Procedure for the Lifecycle Module......................................................................................................................153

2.25 J2EE/Java EE Linkage Function....................................................................................................................................................1532.25.1 Calling an Application in a Java EE Runtime Environment from a J2EE Runtime Environment.........................................1532.25.2 Calling an Application in a J2EE Runtime Environment from a Java EE Runtime Environment.........................................154

2.26 CORBA Service Application Call.................................................................................................................................................1552.27 Time Monitoring Features that can be Used in IIOP Communication..........................................................................................157

2.27.1 IIOP Connection Wait Time Monitoring Feature...................................................................................................................1572.27.2 IIOP Communication Server Method Recovery Time Monitoring Feature...........................................................................1632.27.3 IIOP Communication Socket Send/Receive Wait Time Monitoring Feature.........................................................................1642.27.4 IIOP Communication Client Non-communication Monitoring Feature.................................................................................167

Chapter 3 Java EE Application Development.......................................................................................................................168

- vi -

3.1 Creating the Application..................................................................................................................................................................1683.1.1 Preparatory Tasks for Java EE Applications............................................................................................................................1683.1.2 Developing Web Service Applications.....................................................................................................................................1683.1.3 Developing Web Service Client Applications..........................................................................................................................1723.1.4 Data Types that can be Used in Web Service Communication................................................................................................1753.1.5 WSDL Descriptions that are Used in the Web Service/Web Service Client............................................................................1843.1.6 Creating the Client Application................................................................................................................................................1853.1.7 How to Use JNDI......................................................................................................................................................................1863.1.8 Creating Applications that Connect to the Database................................................................................................................1863.1.9 Creating the Lifecycle Module.................................................................................................................................................1893.1.10 How to Create J2EE/Java EE Linked Applications................................................................................................................1923.1.11 Environment Settings for Access to Shared Network Resources...........................................................................................1933.1.12 How to Call CORBA Service applications from Java EE Applications.................................................................................1943.1.13 Creating Web Applications when Using Session Recovery...................................................................................................1973.1.14 Notes About Integration with IPCOM....................................................................................................................................200

3.2 Deployment Descriptor....................................................................................................................................................................2013.2.1 Notes on the Deployment Descriptor (web.xml)......................................................................................................................2023.2.2 Deployment Descriptor Regulated by the Java EE Rules.........................................................................................................205

3.2.2.1 Java EE Application Deployment Descriptor (application.xml).......................................................................................2053.2.2.2 Web Application Deployment Descriptor (web.xml)........................................................................................................2073.2.2.3 Default Mime Types..........................................................................................................................................................226

3.2.3 Interstage Deployment Descriptor............................................................................................................................................2303.2.3.1 Interstage Application Deployment Descriptor (sun-application.xml)..............................................................................2303.2.3.2 Interstage Web Application Deployment Descriptor (sun-web.xml)................................................................................2313.2.3.3 Interstage EJB Application Deployment Descriptor (sun-ejb-jar.xml).............................................................................2333.2.3.4 Interstage CMP Mappings Deployment Descriptor (sun-cmp-mappings.xml).................................................................2373.2.3.5 Interstage Application Client Deployment Descriptor (sun-application-client.xml).........................................................2393.2.3.6 Interstage ACC Deployment Descriptor (sun-acc.xml).....................................................................................................2403.2.3.7 Tag and Description of the Interstage Deployment Descriptor.........................................................................................241

3.3 Application Debugging....................................................................................................................................................................2573.3.1 Debugging Using the Application Debug Information.............................................................................................................2583.3.2 Debugging Using the Debugger...............................................................................................................................................2583.3.3 Debugging Using the Thread Stamp.........................................................................................................................................2583.3.4 Debugging Using the Java Method Trace.................................................................................................................................258

Chapter 4 Java EE Application Operation............................................................................................................................2604.1 Operations Using Interstage Java EE Admin Console....................................................................................................................260

4.1.1 How to Use the Interstage Java EE Admin Console................................................................................................................2624.2 Operations Using Commands..........................................................................................................................................................2634.3 Interstage Java EE DAS Service Operations...................................................................................................................................263

4.3.1 Operations.................................................................................................................................................................................2634.3.2 Changing the Settings...............................................................................................................................................................2644.3.3 Environment Variable Settings.................................................................................................................................................2644.3.4 Deploying the Application........................................................................................................................................................2654.3.5 Creating the Resources.............................................................................................................................................................2654.3.6 Application Operations.............................................................................................................................................................265

4.3.6.1 Executing Web Applications.............................................................................................................................................2654.3.7 Automatic Startup/Stop of a Service........................................................................................................................................265

4.4 Interstage Java EE Node Agent Service Operations........................................................................................................................2664.4.1 Operations.................................................................................................................................................................................2664.4.2 Changing the Settings...............................................................................................................................................................2674.4.3 Environment Variable Settings.................................................................................................................................................2674.4.4 Automatic Start/Stop of a Service............................................................................................................................................268

4.5 IJServer Cluster Operations.............................................................................................................................................................2684.5.1 Creating/deleting the IJServer Cluster......................................................................................................................................2684.5.2 Managing the Settings..............................................................................................................................................................2694.5.3 Adding/deleting the Server Instance.........................................................................................................................................270

- vii -

4.5.4 Starting/Stopping/Displaying the Operational Status of the IJServer Cluster..........................................................................2724.5.5 Starting/Stopping/Displaying the Operational Status of the Server Instance...........................................................................2724.5.6 Recovering a "Partially Running" IJServer Cluster..................................................................................................................2734.5.7 Automatic Start/stop of an IJServer Cluster.............................................................................................................................2744.5.8 Executing Operations at the Same Time...................................................................................................................................274

4.6 Deploying Applications...................................................................................................................................................................2764.6.1 Overview of Java EE Deployment............................................................................................................................................2774.6.2 Procedure for Deploying Applications.....................................................................................................................................2784.6.3 Verifying the Application.........................................................................................................................................................2784.6.4 Deploying Applications that have been Expanded into a Directory.........................................................................................2794.6.5 Procedure for Undeploying Applications.................................................................................................................................2804.6.6 Displaying a List of Deployed Applications.............................................................................................................................2804.6.7 Setting the Environment for Applications that have already been Deployed...........................................................................2814.6.8 Reference to Deployment Descriptors of Applications that have already been Deployed.......................................................2814.6.9 Expanding Applications............................................................................................................................................................2824.6.10 Canceling Application Expansion..........................................................................................................................................2824.6.11 Displaying a List of Expanded Applications..........................................................................................................................2824.6.12 Changing the Activity State of Applications..........................................................................................................................2834.6.13 Redeploying Applications.......................................................................................................................................................2844.6.14 Auto-reloading Applications...................................................................................................................................................285

4.7 Preparatory Tasks for Web Container Operations...........................................................................................................................2874.7.1 Operations for Accessing Web Applications............................................................................................................................287

4.7.1.1 Operation Configurations Determined by Differences in Communication Paths.............................................................2874.7.1.2 Operation Configurations Determined by Differences in the Number of Concurrent Processes......................................288

4.7.1.2.1 Operations Involving a Single Process.......................................................................................................................2884.7.1.2.2 Operations based on Concurrent Processes on a Single Machine..............................................................................2894.7.1.2.3 Operations involving Multiple Machines...................................................................................................................290

4.7.1.3 Operation Configurations that Use an SSL Accelerator....................................................................................................2914.7.1.4 Changing the Operation Configuration for Accessing Web Applications........................................................................292

4.8 Preparations for Operations Performed via a Web Server...............................................................................................................2944.8.1 Setting the Web Server Environment.......................................................................................................................................294

4.8.1.1 Setting the Interstage HTTP Server Environment.............................................................................................................2944.8.1.2 Setting the Microsoft(R) Internet Information Services 6.0 Environment........................................................................2944.8.1.3 Setting the Microsoft(R) Internet Information Services 7.0/7.5/8.0 Environment............................................................297

4.8.2 Connecting the Web Server and the IJServer Cluster...............................................................................................................3014.8.2.1 Running the Web Server and the IJServer Cluster on the Same Machine........................................................................3024.8.2.2 Running the Web Server and the IJServer Cluster on Different Machines.......................................................................3034.8.2.3 Web Server Connector Logs..............................................................................................................................................3044.8.2.4 Combining the IJServer (J2EE) and the IJServer Cluster..................................................................................................3044.8.2.5 Changing the [Run the Web Server and the WorkUnit on the Same Machine] System Environment Setting.................305

4.9 Request Distribution Control by Web Server Connector................................................................................................................3064.9.1 Distributing Procedure and Viewing the Status Using the Commands....................................................................................3064.9.2 Monitoring Web Server Connector Faults................................................................................................................................308

4.10 How to Operate Session Recovery................................................................................................................................................3144.10.1 Overview of the Session Recovery Settings...........................................................................................................................3144.10.2 Session Registry Server Settings............................................................................................................................................315

4.10.2.1 Creating the IJServer Cluster for the Session Registry Server (Using the Interstage Java EE Admin Console)............3174.10.2.2 Creating the IJServer Cluster for the Session Registry Server (Using the asadmin Command).....................................3194.10.2.3 Deploying Session Registry Server (Using the Interstage Java EE Admin Console).....................................................3204.10.2.4 Deploying Session Registry Server (Using the asadmin Command)..............................................................................3214.10.2.5 Session Registry Server Environment Settings...............................................................................................................321

4.10.3 Session Registry Client Settings.............................................................................................................................................3234.10.4 Session Recovery Tuning.......................................................................................................................................................330

4.10.4.1 Settings for each Timeout Value.....................................................................................................................................3314.10.4.2 Settings for Session Registry Server Concurrency..........................................................................................................3324.10.4.3 Examples of the IP Address and Port Number Settings..................................................................................................333

4.10.5 Operations...............................................................................................................................................................................336

- viii -

4.10.5.1 Session Registry Server Operations and References.......................................................................................................3364.10.5.2 Changing the Session Registry Server Start User ...........................................................................................................3374.10.5.3 Isolating a Machine..........................................................................................................................................................3374.10.5.4 Multiple Session Registry Server Operations..................................................................................................................3384.10.5.5 Restarting the Session Registry Server............................................................................................................................3384.10.5.6 Backing up and Restoring the Session Registry Server Resources.................................................................................338

4.11 Java EE Application Client Operations.........................................................................................................................................3394.11.1 Setting the Java EE Application Client Environment.............................................................................................................3394.11.2 Java EE Application Client Operation....................................................................................................................................340

4.12 Procedure when the Web service is Used......................................................................................................................................3424.12.1 Deploying Web Service Applications.....................................................................................................................................3424.12.2 Customizing the Web Service Operating Environment..........................................................................................................343

4.13 Procedure when the Web Service Client is Used..........................................................................................................................3444.13.1 Web Service Client Operating Environment..........................................................................................................................3444.13.2 Executing the Web Service Client..........................................................................................................................................344

4.14 Setting the JNDI Environment.......................................................................................................................................................3454.14.1 Setting Environment Variables...............................................................................................................................................3454.14.2 Settings When the Initial Context is Generated......................................................................................................................3454.14.3 Settings for Connections from the Client to the Server..........................................................................................................3464.14.4 Cache Settings for Object References....................................................................................................................................347

4.15 Preparatory Tasks for Resource Definitions..................................................................................................................................3484.15.1 Procedure when JMS is Used.................................................................................................................................................3484.15.2 Procedure when JavaMail is Used..........................................................................................................................................3484.15.3 Procedure when JDBC is Used...............................................................................................................................................3484.15.4 Procedure when the Connector is Used..................................................................................................................................3484.15.5 Procedure when other Resources are Used.............................................................................................................................348

4.15.5.1 The Method that is Used to Define Custom Resources...................................................................................................3494.15.5.2 The Method that is Used to Define External Resources..................................................................................................350

4.15.6 Procedure for Changing the Resource Status.........................................................................................................................3514.15.7 Procedure for Selecting the Target that Uses the Resources..................................................................................................353

4.16 Setting the Database Environment.................................................................................................................................................3534.16.1 Setting the JDBC Driver Environment...................................................................................................................................3544.16.2 Java DB JDBC Driver (Type 4)..............................................................................................................................................3574.16.3 Oracle Thin JDBC Driver (Type 4)........................................................................................................................................3594.16.4 Oracle OCI JDBC Driver (Type 2).........................................................................................................................................3614.16.5 Symfoware JDBC Driver (Type 2).........................................................................................................................................3634.16.6 Microsoft(R) SQL Server(TM) JDBC Driver (Type 4)..........................................................................................................3674.16.7 Ping Functionality...................................................................................................................................................................368

4.17 JMS Operation Methods................................................................................................................................................................3694.17.1 Design Methods......................................................................................................................................................................3694.17.2 Operating the Message Broker...............................................................................................................................................3704.17.3 Preparation for Sending/Receiving JMS Messages................................................................................................................3764.17.4 Operating JMS Client Applications........................................................................................................................................3774.17.5 Message Broker Log...............................................................................................................................................................3794.17.6 Access Logs for the Message Broker.....................................................................................................................................380

4.18 Connector Operation Method........................................................................................................................................................3864.18.1 Deploying the Connector Module and Creation of Resource Definitions..............................................................................3864.18.2 Undeploying the Connector Module and Deleting Resource Definitions..............................................................................388

4.19 Relationship between JMS Resources and Connector Resources.................................................................................................3894.20 J2EE/Java EE Linkage Configuration...........................................................................................................................................391

4.20.1 Calling an Application in a Java EE Runtime Environment from a J2EE Runtime Environment.........................................3914.20.2 Calling an Application in a J2EE Runtime Environment from a Java EE Runtime Environment.........................................392

4.21 J2EE/Java EE Linkage Operation..................................................................................................................................................3934.21.1 Calling an Application in a Java EE Runtime Environment from a J2EE Runtime Environment.........................................3934.21.2 Calling an Application in a J2EE Runtime Environment from a Java EE Runtime Environment.........................................393

4.22 Java EE Application Logs..............................................................................................................................................................3934.22.1 Server Log...............................................................................................................................................................................395

- ix -

4.22.2 Java VM Log..........................................................................................................................................................................3964.22.3 HTTP Access Log...................................................................................................................................................................3974.22.4 IIOP Access Log.....................................................................................................................................................................4004.22.5 HTTP Trace Logs...................................................................................................................................................................4104.22.6 Rotation of the Log File..........................................................................................................................................................412

4.23 Control for Dispatching Requests via IIOP Communications.......................................................................................................4154.23.1 System Design........................................................................................................................................................................415

4.23.1.1 Notes on Tuning the EJB Dispatcher Feature..................................................................................................................4174.23.1.2 Types of Enterprise JavaBeans that Can be Used with IPCOM Linkage........................................................................417

4.23.2 Load Balancing and Failover Algorithms...............................................................................................................................4184.23.2.1 If a Load Balancing Function is not Used.......................................................................................................................4184.23.2.2 Load Balancing Based on the EJB Dispatcher Feature...................................................................................................4184.23.2.3 Load Balancing Based on the Group Management Service............................................................................................421

4.23.3 Settings for the Server.............................................................................................................................................................4234.23.3.1 If a Load Balancing Function is not Used.......................................................................................................................4234.23.3.2 Load Balancing Based on the EJB Dispatcher Feature...................................................................................................4244.23.3.3 Load Balancing Based on the Group Management Service............................................................................................424

4.23.4 Settings for the Client (the Caller)..........................................................................................................................................4254.23.4.1 If a Load Balancing Function is not Used.......................................................................................................................4254.23.4.2 Load Balancing Based on the EJB Dispatcher Feature...................................................................................................4264.23.4.3 Load Balancing Based on the Group Management Service............................................................................................427

4.23.5 Failover Settings for Object References.................................................................................................................................4284.24 IIOP Communication Load Balancing Using IPCOM..................................................................................................................428

4.24.1 Using No Load Balancer or Using Load Balancing based on the EJB Dispatcher Feature...................................................4284.24.2 Using Load Balancing Based on the Group Management Service.........................................................................................434

4.25 Operations where Enterprise JavaBeans are Accessed..................................................................................................................4384.25.1 Accessing Session Beans........................................................................................................................................................4384.25.2 Accessing Message-driven Beans...........................................................................................................................................441

4.26 Symfoware Audit Trails.................................................................................................................................................................4414.26.1 Design Method........................................................................................................................................................................4414.26.2 Operating Method...................................................................................................................................................................441

Chapter 5 Java EE Function Security...................................................................................................................................4435.1 Java EE Operating Environment Security Function........................................................................................................................443

5.1.1 Java EE Operating Environment Roles....................................................................................................................................4435.1.2 IJServer Cluster Process Execution Privileges.........................................................................................................................4445.1.3 Login Authentication................................................................................................................................................................4455.1.4 Privileges and Authenticated Users..........................................................................................................................................4455.1.5 Registering the Administrator User..........................................................................................................................................447

5.1.5.1 Realm for Login Authentication........................................................................................................................................4485.1.5.2 Changing the Realm Type.................................................................................................................................................4485.1.5.3 OS Realm Settings.............................................................................................................................................................4485.1.5.4 File Realm Settings............................................................................................................................................................4505.1.5.5 ldap Realm Settings...........................................................................................................................................................4525.1.5.6 Notes on Updating Admin-realm and Administrator User Information............................................................................454

5.1.6 Specifying the Administrator User...........................................................................................................................................4555.1.6.1 Login Authentication when the Interstage Java EE DAS Service /Interstage Java EE Node Agent Service Starts Up. . .4555.1.6.2 Login Authentication for the asadmin Command..............................................................................................................456

5.2 Java EE Application Security Functionality....................................................................................................................................4575.2.1 Authentication...........................................................................................................................................................................4575.2.2 Authorization............................................................................................................................................................................4585.2.3 SSL............................................................................................................................................................................................459

5.2.3.1 Communication that can Use SSL.....................................................................................................................................4595.2.3.2 Keystore Settings...............................................................................................................................................................461

5.2.4 User/group/role.........................................................................................................................................................................4645.2.5 Realm........................................................................................................................................................................................4645.2.6 Requests for the Guarantee of Communication Data between the Client and the Web Server................................................465

- x -

5.2.7 Spreading Authentication Information to the EJB Container...................................................................................................4655.2.8 Security Manager......................................................................................................................................................................467

5.3 Method of Operation Using the Security Functionality...................................................................................................................4685.3.1 Role and Role Base Access Restriction Settings......................................................................................................................4685.3.2 Mapping a Role to the User/group............................................................................................................................................4685.3.3 Creating the Realm...................................................................................................................................................................4695.3.4 Default Realm Settings.............................................................................................................................................................4695.3.5 ldap Realm Settings..................................................................................................................................................................4705.3.6 File Realm Settings...................................................................................................................................................................4715.3.7 When the Application Developer/Person Responsible for Deployment/System Administrator are the Same Person.............4725.3.8 Security Manager Operations...................................................................................................................................................473

5.3.8.1 Enabling and Disabling Security Manager........................................................................................................................4735.3.8.2 Editing the Policy File.......................................................................................................................................................4735.3.8.3 Application Access Privileges Settings.............................................................................................................................474

5.4 Web Service Security Settings.........................................................................................................................................................4755.5 Web Service Client Security Settings..............................................................................................................................................4755.6 Authentication Information at the Time of Resource Access..........................................................................................................4765.7 JMS Security Function.....................................................................................................................................................................479

5.7.1 Users and Groups......................................................................................................................................................................4795.7.2 Access Control Properties File.................................................................................................................................................4795.7.3 Authentication Method for Using JMS from an Application...................................................................................................483

5.8 Symfoware Audit Trails...................................................................................................................................................................4845.8.1 Executing Symfoware Audit Trails..........................................................................................................................................4855.8.2 Output Information Content......................................................................................................................................................485

5.8.2.1 Correspondence with the Symfoware Audit Log..............................................................................................................4855.8.2.2 Information Recorded for the Various Operations............................................................................................................486

Chapter 6 Java EE Function Tuning.....................................................................................................................................4876.1 Interstage Java EE DAS Service Tuning.........................................................................................................................................4876.2 Interstage Java EE Node Agent Service Tuning..............................................................................................................................4906.3 IJServer Cluster Tuning...................................................................................................................................................................491

6.3.1 Multiple Process Operations.....................................................................................................................................................4916.3.2 Java VM Heap and Permanent Area Size.................................................................................................................................4916.3.3 Number of Garbage Collections...............................................................................................................................................4926.3.4 Application Timeout.................................................................................................................................................................4926.3.5 Setting the Group Management Service...................................................................................................................................492

6.4 Interstage Java EE Admin Console Tuning.....................................................................................................................................4936.4.1 Session Timeout........................................................................................................................................................................4936.4.2 Tuning the Maximum Size of the Uploaded File.....................................................................................................................4946.4.3 Port Number..............................................................................................................................................................................4946.4.4 Using SSL Communication......................................................................................................................................................495

6.5 Tuning for Deployment...................................................................................................................................................................4956.6 Web Container Tuning.....................................................................................................................................................................4966.7 Session Recovery Tuning................................................................................................................................................................5006.8 EJB Container Tuning.....................................................................................................................................................................502

6.8.1 Thread Pooling..........................................................................................................................................................................5026.8.2 Enterprise Bean Instance Caching............................................................................................................................................5056.8.3 Enterprise Bean Instance Pooling.............................................................................................................................................5066.8.4 Functionality that Prevents Data Copying Using Remote Access in the Same Java VM........................................................508

6.9 JPA Tuning......................................................................................................................................................................................5086.9.1 Persistence Context Cache........................................................................................................................................................5086.9.2 Shared Persistence Unit Cache.................................................................................................................................................510

6.10 Web Service Tuning......................................................................................................................................................................5136.11 Tuning the Database Linkage Environment..................................................................................................................................513

6.11.1 Number of Connections in the Pool........................................................................................................................................5136.11.2 Connection Verification..........................................................................................................................................................5156.11.3 Transaction Management........................................................................................................................................................517

- xi -

6.11.4 Detail Attributes......................................................................................................................................................................5176.12 Connector Tuning..........................................................................................................................................................................518

6.12.1 Number of Connections in the Pool........................................................................................................................................5186.12.2 Connection Verification..........................................................................................................................................................5206.12.3 Transaction Management........................................................................................................................................................5216.12.4 Shutdown Timeout..................................................................................................................................................................522

6.13 Port Tuning....................................................................................................................................................................................5226.14 Transaction Service Tuning...........................................................................................................................................................5246.15 ORB Tuning...................................................................................................................................................................................525

6.15.1 ORB........................................................................................................................................................................................5256.15.2 Notes on Communication Data Size.......................................................................................................................................528

6.16 Alert Monitoring Function Tuning ...............................................................................................................................................5306.17 Action when a Warning is Generated by the Alert Monitoring Function.....................................................................................530

6.17.1 Alert Monitoring Warning Messages (Java Heap).................................................................................................................5316.17.2 Alert Monitoring Warning Messages (Garbage Collection)...................................................................................................532

6.18 Interstage Java EE DAS Service Heap Size and Address Space...................................................................................................5346.19 Correlative Time Monitoring Function Relationships...................................................................................................................5376.20 Monitoring Information.................................................................................................................................................................541

6.20.1 Tip...........................................................................................................................................................................................5426.21 Performance Monitoring and Logging..........................................................................................................................................542

6.21.1 Procedures for Performance Monitoring........................................