uCosminexus Application Server

Application Setup Guide

3020-3-Y13-10(E)


Contents

Notices
Summary of amendments
Preface

1. Overview of Application Setup
1.1 Purpose of setup
1.2 Managing J2EE resources
1.2.1 Types of J2EE resources to be managed
1.2.2 Setup for resource adapters
1.2.3 Setup for resource adapters included in J2EE applications
1.2.4 Setup for J2EE resources other than resource adapters
1.3 Managing J2EE applications
1.3.1 J2EE applications to be managed
1.3.2 Flow of J2EE application management
1.3.3 Setup used for managing the J2EE applications
1.4 Setup restrictions
1.4.1 Restrictions on the host used for setup
1.4.2 Restrictions based on the J2EE application status
1.4.3 Other restrictions

2. Interfaces Used for Application Setup
2.1 Functionality of server management commands

3. Basic Operations of Server Management Commands
3.1 Prerequisites for using the server management commands
3.2 Exclusive access control of server management commands
3.2.1 Types of server management commands
3.2.2 Exclusive access control of server management commands
3.2.3 Forced release of exclusive access control of server management commands
3.3 Customizing operation settings of server management commands
3.4 Settings for log acquisition of server management commands
3.5 Property settings using the property file
3.5.1 Procedure for setting the properties of a J2EE resource adapter
3.5.2 Procedure for setting the properties of a J2EE application
3.6 Provider URL specified using the server management commands
3.7 Description of server management commands in this manual

4. Setting Resource Adapter
4.1 Overview of Resource adapter settings
4.1.1 Available resource adapters
4.1.2 Overview of settings and operations
4.2 Settings for connecting to the database
4.2.1 Importing the DB Connector
4.2.2 Defining the DB Connector properties
4.2.3 Deploying the DB Connector
4.2.4 Testing the connectivity of DB Connector
4.2.5 Starting the DB Connector
4.2.6 Stopping the DB Connector
4.2.7 Undeploying the DB Connector
4.2.8 Exporting the DB Connector
4.3 Settings for connecting to the database (in the case of a cluster connection pool)
4.3.1 Overview of a cluster connection pool
4.3.2 Setting the DB Connector for a member resource adapter
4.3.3 Setting the DB Connector for a root resource adapter
4.3.4 Starting and stopping the DB Connector for a member resource adapter
4.3.5 Starting and stopping the DB Connector for a root resource adapter
4.3.6 Checking the state of the connection pool
4.3.7 Suspending the connection pool
4.3.8 Resuming the connection pool
4.4 Settings for connecting to other resources
4.4.1 Importing the resource adapter
4.4.2 Defining the resource adapter properties (for Connector 1.0)
4.4.3 Defining the resource adapter properties (for Connector 1.5)
4.4.4 Deploying the resource adapter
4.4.5 Testing the connectivity of a J2EE resource adapter
4.4.6 Starting the J2EE resource adapter
4.4.7 Stopping the J2EE resource adapter
4.4.8 Undeploying the J2EE resource adapter
4.4.9 Exporting the J2EE resource adapter
4.5 Displaying the state and list of J2EE resource adapters
4.5.1 Displaying the J2EE resource adapter state
4.5.2 Displaying the list of connection definition identifiers (outbound resource adapter)
4.5.3 Displaying the list of message listener types (Inbound resource adapter)
4.5.4 Displaying the list of property names required for activating the message listeners (Inbound resource adapter)
4.6 Displaying the list of resource adapters
4.6.1 Displaying the list of resource adapters
4.6.2 Displaying the list of connection definition identifiers (Outbound resource adapter)
4.6.3 Displaying the list of message listener types (Inbound resource adapter)
4.6.4 Displaying the list of property names required for activating the message listeners (Inbound resource adapter)
4.7 Checking the connection pool state
4.7.1 Displaying the connection pool state
4.7.2 Deleting the connection pools
4.8 Referencing and changing the resource adapter names registered in the JNDI name space
4.9 Deleting the resource adapter
4.10 Copying the resource adapter

5. Setting up Resource Adapters Included in J2EE Applications
5.1 Overview of settings of the resource adapters included in J2EE applications
5.1.1 Available resource adapters
5.1.2 Overview of settings and operations
5.2 Adding resource adapters to J2EE applications
5.3 Importing J2EE applications including resource adapters
5.4 Defining resource adapter properties
5.5 Testing the connectivity of resource adapters
5.6 Starting and stopping J2EE applications including resource adapters
5.7 Referencing the list of resource adapters included in J2EE applications
5.7.1 Referencing the list of resource adapters
5.7.2 Referencing the list of connection definition identifiers (outbound resource adapter)
5.7.3 Referencing the list of message listener types (inbound resource adapter)
5.7.4 Referencing the list of property names required for activating the message listener (inbound resource adapter)
5.8 Displaying and deleting the list of connection pools
5.8.1 Displaying the connection pool state
5.8.2 Deleting connection pools

6. Settings for J2EE Resources other than Resource Adapters
6.1 Overview of settings for J2EE resources other than resource adapters
6.1.1 Overview of settings for JavaBeans resources
6.1.2 Overview of mail configuration settings
6.1.3 Overview of common settings for J2EE resources
6.2 Settings for JavaBeans resources
6.2.1 Importing JavaBeans resources
6.2.2 Defining the HITACHI JavaBeans Resource Properties
6.2.3 Starting the JavaBeans resources
6.2.4 Stopping the JavaBeans resources
6.2.5 Deleting the JavaBeans resources
6.2.6 Displaying the state of JavaBeans resources
6.3 Settings for mail configuration
6.3.1 Creating a new mail configuration
6.3.2 Defining the mail configuration properties
6.3.3 Testing the mail configuration for connectivity
6.3.4 Deleting the mail configuration
6.3.5 Copying the mail configuration
6.4 Referencing the list of J2EE resources
6.5 Referencing and changing the J2EE resource names registered in the JNDI name space

7. Creating J2EE Applications
7.1 Overview of creating J2EE applications
7.2 Importing the Enterprise Beans (EJB-JAR)
7.3 Importing the servlet and JSP (WAR)
7.4 Importing resource adapters (RAR files)
7.5 Creating a new J2EE application
7.6 Adding library JAR files to the J2EE application
7.7 Referencing the list of library JAR files
7.8 Deleting the library JAR files from the J2EE application
7.9 Setting a reference library in the J2EE application

8. Importing and Exporting J2EE Applications
8.1 Importing the J2EE applications
8.1.1 Importing the J2EE applications that are in archive format
8.1.2 Importing the J2EE applications that are in exploded archive format
8.2 Exporting J2EE applications

9. Property Settings of J2EE applications
9.1 Overview of the property settings of J2EE applications
9.2 Property settings using the HITACHI Application Integrated Property File
9.3 Defining Enterprise Bean references
9.3.1 Defining other Enterprise Bean references
9.3.2 Defining mail configuration references
9.3.3 Defining resource adapter references
9.3.4 Defining resource environment references
9.4 Defining message references of Message-driven Beans
9.5 Defining transaction attributes
9.6 Defining CMP of an Entity Bean
9.6.1 CMP settings
9.6.2 Mapping CMP1.x and the database
9.6.3 Mapping CMP2.x and the database
9.7 Defining servlet and JSPreferences
9.7.1 Defining Enterprise Bean references
9.7.2 Defining mail configurationreferences
9.7.3 Defining resource adapterreferences
9.7.4 Defining resource environmentreferences
9.8 Defining servlet and JSP mapping
9.9 Filter settings
9.9.1 Adding a filter
9.9.2 Defining a filter mapping
9.9.3 Deleting a filter
9.10 Defining the runtime attributes of Enterprise Beans
9.10.1 Setting the runtime properties for Stateful Session Beans
9.10.2 Setting the runtime properties for Stateless Session Beans
9.10.3 Setting the runtime properties for Entity Beans
9.10.4 Setting the runtime properties for Message-driven Beans
9.11 Defining the runtime attributes of servlets and JSPs
9.11.1 Defining the context root of a J2EE application
9.11.2 Defining the control of the number of threads executed concurrently for each Web application
9.11.3 Defining the control of the number of threads executed concurrently for each URL group
9.11.4 Defining and monitoring the number of requests pending for each URL group
9.12 Setting the default character encoding
9.13 Referencing and changing the names registered in JNDI namespace
9.13.1 Referencing the J2EE application names
9.13.2 Referencing and changing the Enterprise Bean name
9.14 CTM scheduling
9.14.1 Scheduling the J2EE applications
9.14.2 Scheduling the Stateless Session Beans
9.15 Setting invocation order
9.15.1 Setting the invocation order for J2EE applications
9.15.2 Setting the invocation order for Enterprise Beans
9.15.3 Setting the invocation order for servlets and JSPs
9.16 Error notification settings for servlets and JSPs
9.17 Interceptor settings
9.18 Setting other properties

10. Executing J2EE Applications
10.1 Overview of J2EE application execution
10.2 Starting and stopping J2EE applications
10.2.1 Starting J2EE applications
10.2.2 Stopping J2EE applications
10.3 Referencing the list of J2EE applications
10.4 Deleting J2EE applications
10.5 Switching between J2EE applications
10.5.1 Applications in archive format
10.5.2 Applications in exploded archive format
10.6 Changing the J2EE application name
10.7 Acquiring the RMI-IIOP stubs and interfaces
10.8 Referencing the list of transactions

Appendix
A. Migrating from Server Plug-in
A.1 Operation management of a logical server
A.2 Operations of a resource adapter
A.3 Operations of a J2EE application
A.4 Settings of a resource adapter included in a J2EE application
A.5 Property settings of a J2EE application

Index