Fujitsu Interstage Application Server User Manual

Interstage Application Server

V6.0

Product Notes

Trademarks

Trademarks of other companies are used in this user guide only to identify particular products or systems:

Product Trademark/Registered Trademark

Microsoft, Visual Basic, Visual C++, Windows, Windows NT, Internet Information

Registered trademarks of Microsoft Corporation in the U.S.A. and other countries

Server, and Internet Explorer Sun, Solaris, Java, and other trademarks

containing Java

Trademarks of Sun Microsystems, Inc., in the U.S.A. and other countries

UNIX Registered trademark in the U.S.A. and other

countries, licensed exclusively through X/Open Company Ltd.

Netscape, Netscape FastT rack Server, Netscape Enterprise Server , and Netscape Navigator

CORBA, Object Management Group, OMG, OMG IDL, IIOP, Object Request Broker, and ORB

Registered trademarks of Netscape Communications Corporation in the U.S.A. and other countries

Trademarks or registered trademarks of Object Management Group Inc. in the U.S.A. and other countries

Interstage and ObjectDirector Registered trademarks of Fujitsu Limited

This document contains technology relating to strategic products controlled by export control laws of the producing and/ or exporting countries. This document or a portion thereof should not be exported (or re-exported) without authorization from the appropriate government authorities in accordance with such laws.

Fujitsu Limited

First Edition (November 2003)

The contents of this manual may be revised without prior notice.

Preface

Purpose of this Document

This manual provides additional information on the use of Interstage Application Server

Note

Throughout this manual Interstage Application Server is referred to as Interstage.

Who Should Read this Document?

This document is intended for users installing and operating Interstage Application Server. It is assumed that readers of this manual have a basic knowledge of:

• The Internet

• Apache

• Windows NT® ,Windows® 2000 and Windows 2003™ Server

• UNIX

• Linux

iii

Product Notes - Preface

Organization of this Document

This document is organized as follows:

• Chapter 1 - Supported Software This chapter describes the supported software for application development and application

execution. It also describes the client-side software products required to use client applications.

• Chapter 2 - Restrictions This chapter describes the restrictions on some Interstage functions.

• Chapter 3 - Notes on Interstage Operation This chapter provides notes about the operation of Interstage.

Functions that are not Supported by the Linux Version

The following functions are not supported by the Linux version. To use those functions, use the Windows version or Solaris™ Operating Environment version.

• Multi System (available only in the Solaris™ Operating Environment version)

• Cluster System

• Web Server (InfoProvider Pro)

• HTML Page Editing Service

• ebXML Message Service

• MessageQueueDirector

• MQ Communication Service

• InfoDirectory

• COBOL Web Subroutine

• COBOL/OOCOBOL development and execution environment (available on the Windows client)

• Firewall linkage function (proxy linkage and HTTP tunneling) and SSL linkage function of CORBA

applications

• SMEE2 library (The SMEE3 library is available.)

• Online access management function

• Performance monitoring tool (real-time monitoring function of performance information)

• User authentication and access control of the Component Transaction Service

• AIM linkage function

Table of Content s

Chapter 1 Supported Software

Software Products Required for Application Development.............................................................1-2

J2EE (Exclude Security)............................................................................................................1-2

Security......................................................................................................................................1-3

Operation / Administration.........................................................................................................1-4

Framework.................................................................................................................................1-5

Other Functions .........................................................................................................................1-5

Software Products Required for Application Execution..................................................................1-7

J2EE (Exclude Security)............................................................................................................1-7

Security......................................................................................................................................1-8

Operation / Administration.........................................................................................................1-8

Framework...............................................................................................................................1-10

Portal Component....................................................................................................................1-10

Other Functions .......................................................................................................................1-11

Client-side Software Products Required to Use Client Applications.............................................1-12

J2EE (Exclude Security)..........................................................................................................1-12

Security....................................................................................................................................1-13

Framework...............................................................................................................................1-13

Other Functions .......................................................................................................................1-14

Chapter 2 Restrictions

Restrictions on Interstage HTTP Server.........................................................................................2-2

Restrictions on InfoProvider Pro.....................................................................................................2-3

Restrictions on the J2EE Service ...................................................................................................2-4

Restrictions on the Servlet Service.................................................................................................2-5

Restrictions on the EJB Service .....................................................................................................2-6

Restrictions on the SOAP Service................................................................................................2-11

Restrictions on the CORBA Service.............................................................................................2-13

Restrictions on IDL Definitions.................................................................................................2-13

Restrictions on IDL Compilation ..............................................................................................2-17

Restrictions on C and C++ Programming................................................................................2-17

Product Notes - Table of Contents

Restrictions on Java Programming..........................................................................................2-18

Restrictions on the Naming Service.........................................................................................2-18

Restrictions on the CORBA Service........................................................................................2-19

Restrictions on the Event Service.................................................................................................2-20

Restrictions on the Component Transaction Service....................................................................2-21

Restrictions on the Database Linkage Service.............................................................................2-22

Restrictions on the Locale of Languages ................................................................................2-22

Restrictions on InfoDirectory.........................................................................................................2-23

Restrictions on the InfoDirectory Administration Tool..............................................................2-23

Restrictions on the JNDI..........................................................................................................2-23

Restrictions on JDK/JRE...............................................................................................................2-24

Restrictions on the Portal Component..........................................................................................2-25

Restrictions on Scripts in Contents..........................................................................................2-25

Restrictions on the Alternative Logon Function.......................................................................2-26

Restrictions on the Load Distribution Environment..................................................................2-27

Restrictions on Using Netscape 4.6/4.7...................................................................................2-27

Restrictions on Using Web USP (List of URLs to be Excluded With Form Authentication

Inherited)..................................................................................................................................2-28

Access from PC to Secure Site (HTTPS)................................................................................2-28

Restrictions on Using the Brick Automatic Update Function...................................................2-28

Restrictions on Other Functions....................................................................................................2-29

Chapter 3 Notes on Interstage Operation

Common Notes for Interstage.........................................................................................................3-2

About Netscape 6 ......................................................................................................................3-2

About the Cross-Site Scripting Problem....................................................................................3-2

Using the JSSE Function...........................................................................................................3-3

Monitor Screen Colors...............................................................................................................3-4

Setting Port Numbers Used for Individual Services...................................................................3-5

Notes on the Interstage Operation Tool ..........................................................................................3-9

Version Level of Each Service Performing the Operation.........................................................3-9

Notes on the Interstage Integration Commands...........................................................................3-10

Dealing with Abnormal Command Termination........................................................................3-10

Starting and Stopping Services................................................................................................3-10

Note on Stopping Interstage....................................................................................................3-10

Notes on the InfoProvider Pro.......................................................................................................3-11

Notes on the Interstage HTTP Server...........................................................................................3-12

Authority to Use the Interstage HTTP Server..........................................................................3-12

Product Notes - Table of Contents

Notes on Operating Interstage HTTP Server ..........................................................................3-12

Notes on J2EE..............................................................................................................................3-13

Notes on the Servlet Service ........................................................................................................3-15

Notes on Using the EJB Service...................................................................................................3-16

Version of Java Development Kit/Java Runtime Environment................................................3-16

Notes on the EJB Customize Tool...........................................................................................3-16

When Operating with WorkUnits..............................................................................................3-18

When Interstage JDBC Driver is Used....................................................................................3-19

Note on Class Names..............................................................................................................3-22

Starting EJB Applications.........................................................................................................3-22

About the EJB Application Process.........................................................................................3-22

Notes on SOAP Service................................................................................................................3-23

When Encryption Communication by SSL is Used..................................................................3-23

When Session Recovery Function of Servlet Service is Used................................................3-23

When J2EE Management Tool or J2EE Deployment Tool is Used.........................................3-23

Notes on the CORBA Service.......................................................................................................3-24

Notes on Installation and Environment Settings......................................................................3-24

Notes about Setting Applications.............................................................................................3-25

Notes on the IDL Compiler ......................................................................................................3-26

Notes on the Java Environment...............................................................................................3-26

Notes on SSL communication .................................................................................................3-26

Notes on the Event Service ..........................................................................................................3-27

Note on Reinitializing Interstage..............................................................................................3-27

Notes on SSL Communication.................................................................................................3-27

Note on Unit Generation..........................................................................................................3-27

Note on Persistent Channel Applications ................................................................................3-28

Notes on Multi-IP Address Operation ......................................................................................3-28

Notes on the Component Transaction Service.............................................................................3-29

Note on Messages in Windows® 2000 ...................................................................................3-29

About CORBA Service Termination using the isstop Command.............................................3-29

Monitoring during Interstage Operation...................................................................................3-29

Notes on the Database Linkage Service......................................................................................3-30

Notes on OTS Command Execution .......................................................................................3-30

Notes on the Use of Oracle .....................................................................................................3-30

Notes on Development using Functions for the Java Language Provided by the Database

Linkage Service of Interstage 1.1 or Earlier ............................................................................3-31

Maximum Number of Resources for One Transaction............................................................3-31

Sample Provided with Database Linkage Service...................................................................3-31

CORBA Server Application is Operated using Multi Thread....................................................3-31

vii

Product Notes - Table of Contents

Notes on InfoDirectory ..................................................................................................................3-32

Setup Item Related to the Maximum Simultaneous Number of Clients Connected................3-32

Error Messages in the Event Log ............................................................................................3-32

Notes on JDK/JRE........................................................................................................................3-33

Notes on Java VM....................................................................................................................3-33

Notes on OutOfMemoryError Caused by a Permanent Area Shortage...................................3-33

Notes on java.lang.Object.wait()..............................................................................................3-33

Notes on the Return Value of java.beans.PropertyDescriptor.getWriteMethod()....................3-34

Notes on Portal Component..........................................................................................................3-35

Notes on Contents Use............................................................................................................3-35

Notes at Logon.........................................................................................................................3-35

Notes on Portal Component Server Operating Mode..............................................................3-35

Notes on USP Use...................................................................................................................3-37

Notes on Web USP Use.....................................................................................................3-37

Notes on Web To Host USP(S2K USP) Use ......................................................................3-37

Notes when Applying Port al Component Independent Authentication to Operation

Management............................................................................................................................3-37

Notes on Using Operation Management Tool Commands......................................................3-38

Notes on Portal Component Repository Database Operation.................................................3-38

About the Specification of Keep-alive between WebUSP and Back Server............................3-38

Notes when Using a Long Character String for Alias ..............................................................3-38

Notes on Using Administrative Console ..................................................................................3-39

Setting the Heap Size in the Java Execution Environment .....................................................3-39

Notes on Framework.....................................................................................................................3-40

Security on the Internet............................................................................................................3-40

Redistributable Files ................................................................................................................3-40

Index

viii

Chapter 1 Supported Software

This chapter describes the supported software.

1-1

Chapter 1: Supported Software

Software Products Required for Application Development

This section describes software products required for application development.

J2EE (Exclude Security)

Table 1-1 lists the J2EE (exclude security) products required for application development.

Table 1-1 J2EE (Exclude Security) Products Required for Application Development

No. Function Name Product Name Version

1 Development of J2EE

applications (*1)

2 Development of EJB applications

using databases.

*1) JDK1.1 and JDK1.2 are not applicable.

Any of Interstage Apworks (*2) Interstage Application Server Plus Developer

SymfoWARE® Server Enterprise Edition for Windows

Oracle8i Enterprise Edition R8.1.5 (*3)

Oracle9i Database Enterprise Edition

SQL Server 2000 (*3)

V5.0 or later V5.0.1 or later

V5.0 or later (*3)

R8.1.6 (*3) R8.1.7 (*3) Release1 (9.0.1) (*3)

1-2

*2) If the JSP remote debug function is to be used, the version of the Servlet service must match the

version of Apworks. For this reason, use V6.0.

*3) SymfoWARE Server Enterprise Edition or Oracle8i Enterprise Edition or Oracle9i Database

Enterprise Edition is required. Use the JDBC driver for JDK 1.2 when you use Symfoware Server Enterprise Edition and

Symfoware Server. Moreover, the JDBC driver for JDK1.2 can use the version of JDK/JRE by 1.2 or later. Do not download it though it is described, “The JNDI class library (jndi package) and JDBC2.0 Optional Package (javax.sql package) can be downloaded from the homepage of Javasoft of SUN Microsystems” in JDBC driver online manual of Symfoware when the JDBC driver for JDK1.2 is used.

Security

Table 1-2 lists the security products required for application development.

Table 1-2 Security Products Required for Application Development

Software Products Required for Application Development

Use the product since V4.0L10 when you use either Symfoware Server Enterprise Edition or Symfoware Server when you use the Symfoware with RDB2_TCP.

When the decentralized transaction function by JTS and JT A is used, Oracle8i Enterprise Edition R8.1.7 or Oracle 9i Database Enterprise Edition is required.

Use the Interstage JDBC Driver included while packaging the EJB Service when you use SQL Server. Refer to the associated software manual when using it. The software manual is in the following place.

Interstage installation folder\EJB\jdbc\fjisjdbc.txt

Interstage JDBC Driver can be used only with JDK/JRE1.3. Install the SQL Server client tool in the execution environment of Interstage JDBC Driver when the

installation environment of the execution environment of Interstage JDBC Driver and SQL Server is different.

No. Function Name Product Name Version

1 SSL communication function of

Systemwalker PkiMGR (*1) V1.0

CORBA Service

*1) It is required on the server issuing certification. It is not required when you acquire certification

from Certificate issue organization. At the time of UTF-8 certificate creation, Systemwalker PkiMGR is required.

1-3

Chapter 1: Supported Software

Operation / Administration

Table 1-3 lists the operation/administration products required for application development.

Table 1-3 Operation/Administration Products Required for Application Development

No. Function Name Product Name Version

1 Real-time monitoring by

performance monitoring tool and operation management linked to

Systemwalker CentricMGR V5.0L20 or V5.0L30 or

later (*1)

Systemwalker

2 Automatic operation linked to

Systemwalker

Systemwalker OperationMGR V5.0L20 or V5.0L30 or

later (*2)

3 Interstage Operation Tool Microsoft® Internet Explorer

or Netscape® Communicator

4 Real-time monitoring function of

SNMP service Windows NT® 4.0 performance information by the Network Manager

5.01, 5.5, or 6.0

6 Series or 7 Series

Windows® 2000 (*3)

*1) If the version level of Systemwalker CentricMGR to be linked is V5.0L20, the following functions

cannot be used:

− Operation status monitoring of the EJB WorkUnit (for old version compatible environment)

− Displaying information on the multi object-resident objects

− Real-time monitoring of the application processing status

1-4

If the version level of Systemwalker CentricMGR is V10L10 or earlier, the following functions cannot be used:

− Monitoring of the CORBA WorkUnit operating status

− Monitoring of the Servlet container unit operating status (old version Servlet service)

− Real-time monitoring of the application processing status for the Implementation Repository of

the CORBA WorkUnit

− Real-time monitoring of the EJB application processing status of the EJB WorkUnit (for old version compatible environment)

− Information display of EJB applications on the Light EJB container (for old version compatible environment)

− Operating status monitoring of the Light EJB container (for old version compatible environment)

*2) If the version level of Systemwalker OperationMGR to be linked is V5.0L20, the EJB WorkUnit (for

old version compatible environment) cannot be operated automatically. The following functions also cannot be used if the version level of Systemwalker OperationMGR is

V10.0L10 or earlier.

− Automatic operation of the CORBA WorkUnit

− Automatic operation of the Light EJB container WorkUnit (for old version compatible

*3) The SNMP Service is a function provided by the operating system.

Framework

Table 1-4 lists the framework products required for application development.

Table 1-4 Framework Products Required for Application Development

No. Function Name Product Name Version

Software Products Required for Application Development

environment)

1 Using database linkage

components of the Framework function

2 Using XML linkage function of the

Framework function

3 Using Struts linkage function of

the Framework function

Other Functions

Table 1-5 lists the products required for application development (other functions).

Table 1-5 Products Required for Application Development (Other Functions)

No. Function Name Product Name Version

1 Development of applications of

the SOAP Service

Oracle Database Enterprise Edition / Standard Edition

Symfoware Server Enterprise Edition

Fujitsu XML Processor

- Fujitsu XML Library for Java

- Fujitsu XSLT Library for Java Struts 1.1

Interstage Apworks or Interstage Application Server Plus Developer (*1)

Release1(9.0.1) or Release2(9.2.0)

V5.0

V5.1.1

V6.0

2 Development of applications

using UDDI client

Interstage Apworks or Interstage Application Server Plus Developer (*1)

V6.0

1-5

Chapter 1: Supported Software

No. Function Name Product Name Version

3 Use of databases

Symfoware® Server Enterprise Edition for Windows

V2.0L10 or later

edition Oracle7 R7.3.4 (*2) Oracle8 Enterprise Edition R8.0.5 (*2) Oracle8i Enterprise Edition R8.1.5 or R8.1.6 (*2)

R8.1.7 Oracle9i Database Enterprise

Release1 (9.0.1) Edition

SQL Server 6.5 or 7.0

4 Development of applications

Microsoft® Visual C++ 5.0, 6.0, .NET

using LDAP SDK

5 Directory service (Only when you

Netscape Enterprise Server 3.5

use Netscape Enterprise Server as WWW server)

*1) JDK1.1 and JDK1.2 are not supported. *2) At the time of using SynfinityCLUSTER, it is required Symfoware Server Enterprise Edition V2.0L10

or later. At the time of using JTS or JTA, Oracle Database Enterprise Edition R8.1.7, R9.0.1 or R9.2.0 is

required.

1-6