Sun ONE logo    
iPlanet Application Server, Enterprise Pro Edition, Version 6.5 Release Notes



Release Notes for iPlanet™ Application Server (iAS EPE)

Enterprise Pro Edition, Version 6.5

Updated November 27, 2002




These release notes contain important information available at the time of the release of iPlanet Application Server, Enterprise Pro Edition, Version 6.5 (iAS EPE). New features and enhancements, known problems, and other information are addressed here. Read this document before you begin using iAS EPE.

An electronic version of these release notes can be found at the Sun™ documentation website: http://docs.sun.com. Check the web site after installing your software and periodically thereafter to view the most up-to-date release notes and manuals.

These release notes contain the following sections:

Document Revision History

This document has changed since the initial iPlanet Application Server Enterprise Editon 6.5 release.

Table 1 shows the revision history for this document, and lists the affected sections.

Table 1    iAS EPE, 6.5 Release Notes Revision History

Release Date

Affected Sections

August, 2002

 

Original release of this document

 

October, 2002

 

Corrected URL references to Unified Integration Framework product documentation

 

November 27, 2002

 

Added the following sections:
Document Revision History
Product Certification of iAS EPE 6.5 Products on iAS EE 6.5 SP1
Upgrading to iPlanet Application Server 6.5 SP1

 

Product Certification of iAS EPE 6.5 Products on iAS EE 6.5 SP1

The following iAS EPE 6.5 products have been certified to run on iPlanet Application Server, Enterprise Edition, 6.5 SP1.

Refer to the Release Notes for each product for information specific to operation with iAS EE, 6.5 SP1. Each Release Note document should contain a revision history table similar to the one included in this document.

General Information

iPlanet Application Server, Enterprise Pro Edition, Version 6.5 contains the following bundled iPlanet products:

You can locate the release notes and manuals for each bundled product at the following URLs:

Supported Systems and Software

The following operating systems and software are supported with this release of iAS EPE. If you are running non-supported versions of these products, you must upgrade to a supported version.

Table 2    Supported Operating Systems and Software 

Product Type

Supported Versions

Operating Systems

 

Solaris™ 2.6, 2.8

Windows NT, SP6A

Windows 2000 Advanced Edition

Windows 2000 Server Edition SP2

Windows 2000 Professional Edition

 

Web Servers

 

iPlanet Web Server, Enterprise Edition 4.1, SP 7

iPlanet Web Server, Enterprise Edition 6.0, SP1

iPlanet Web Server, Enterprise Edition 6.0, SP2B

 

Directory Servers

 

iPlanet Directory Server 5.0, SP1

iPlanet Directory Server 5.1

 

Application Server

 

iPlanet Application Server Enterprise Edition 6.5 Maintenance Update 2 (MU2)1

 

Database Servers and Clients

 

Oracle 8.1.6, 8.1.7, 9i Servers, Oracle 8.1.7, 9i Clients

Sybase 11.9.2, 12 Servers, Sybase Open/Client System 12

Informix 9.2 Server, Informix SDK 2.7 UC3 Client

 

Third-party JDBC Drivers

 

Oracle 8.1.7: Type 2 and Type 4

Sybase jConnect for JDBC 5.2 Type 4

Informix JDBC v2.1 Type 4

 

Web Browsers

 

Netscape 4.7x

Microsoft Internet Explorer 5.x, 6.0

 
1 The iPlanet Application Server 6.5 Maintenance Update 2 is shipped only to customers who have purchased iPlanet Application Server, Enterprise Pro Edition 6.5. For more information about this Maintenance Update patch, see the section "Required Patches" in the iPlanet Process Manager, 6.5 Release Notes.

Installation Instructions

You may have previously installed versions of any one of the products bundled with this release of iAS EPE on your machine or network, which may or may not affect your installation strategy. The following scenarios can help you to install the products in the correct order. Be sure to follow installation instructions for your particular operating system and read the Release Notes.


Note

If you are upgrading to iPlanet Application Server 6.5 SP1, see the following section, Upgrading to iPlanet Application Server 6.5 SP1.

Table 3    Installation Scenario Matrix

Currently Installed Product(s)

To Upgrade to iAS EPE 6.5, Windows or Solaris1

None

 

Scenario 1: Clean Install

 

iPlanet Application Server 6.0, SPx

iPlanet Process Manager 6.0, SPx

 

Scenario 2: Backup iAS and iPM Applications, Uninstall Previous Versions, and Reinstall

 

iPlanet Application Server 6.5

No iPlanet Process Manager

 

Scenario 3: iAS Upgrade and iPM Install

 
1 UIF and Enterprise Connectors users who do not need to use Process Manager should follow the installation and upgrade instructions described in the UIF and Enterprise Connectors Release Notes and documentation at the following location: http://docs.sun.com/prod/s1.entconn65. Process Manager users who do not need to use Enterprise Connectors can skip the UIF installation instructions in the scenarios described in Table 2.

Currently, there is no upgrade path for previous versions of iAS and iPM. If you have installed versions of either iAS 6.0, SPx or iPM 6.0, SPx, you must uninstall these versions and follow "Scenario 2: Backup iAS and iPM Applications, Uninstall Previous Versions, and Reinstall." After installing all necessary software, you must redeploy any previously deployed iAS and iPM applications.

If you have installed iAS EE 6.5, you should follow "Scenario 3: iAS Upgrade and iPM Install."

Scenario 1: Clean Install

Note that it is important to install the bundled software components in the correct order, as follows:

To perform an Install of iAS EPE

  1. Install iPlanet Web Server Enterprise Edition 6.0 SP2.

    2. The iPlanet Web Server 6.0 SP2 Release Notes are at the following location: http://docs.sun.com/coll/S1_ipwebsrvree60sp2_en/

  2. Install iPlanet Directory Server 5.1, iPlanet Application Server Enterprise Editon 6.5, and iPlanet Process Manager 6.5.

    3. The installation disk for iPM contains a unified install, which includes the installation of the Directory Server, the Application Server, and Process Manager. Make sure to read the release notes for each product before installing.

    The iPlanet Directory Server 5.1 Release Notes are at the following location: http://docs.sun.com/coll/S1_ipDirectoryServer_51/

    The iPlanet Application Server Enterprise Edition 6.5 Release Notes are at the following location: http://docs.sun.com/coll/S1_ipappsrvree65_en/

    The iPlanet Process Manager 6.5 Release Notes are at the following location: http://docs.sun.com/coll/S1_ProcessManager_65/

  3. Install Unified Integration Framework 6.5.

    4. The Unified Integration Framework 6.5 Release Notes and Developer's Guide are at the following location: http://docs.sun.com/prod/s1.entconn65

    The installation instructions for UIF are in the iPlanet Unified Integration Framework Developer's Guide. You must install the Unified Integration Framework on the same machine or network cluster as the Application Server.

  4. Install any required patches.

    5. The iPlanet Process Manager 6.5 Release Notes contain instructions for the installation of additional required patches for Process Manager. See the individual release notes for other bundled products to determine if any other patches are required.

Scenario 2: Backup iAS and iPM Applications, Uninstall Previous Versions, and Reinstall

Note that it is important to install the bundled software components in the correct order, as follows:

To perform an iAS and iPM Application Backup, Uninstall, and Reinstall

  1. Back up any existing iAS and iPM applications by saving them to a local directory.

    2. Do not delete application information for iPlanet Process Manager applications. The iPlanet Process Manager 6.5 Release Notes contain a section called "Migration of iPM 6.0 Application Data to iPM 6.5." The iPlanet Application Server Migration Guide contains instructions for migrating Application Server applications.

  2. Uninstall iAS and iPM, following the instructions contained in the Installation Guide for each product.

  3. Uninstall and migrate data for any other bundled product you want to upgrade or replace with this installation.

    4. This information is generally contained in the Installation Guide or Migration Guide for each product.

  4. Install iPlanet Web Server Enterprise Edition 6.0 SP2.

    5. The iPlanet Web Server 6.0 SP2 Release Notes are at the following location: http://docs.sun.com/coll/S1_ipwebsrvree60sp2_en/

  5. Install iPlanet Directory Server 5.1, iPlanet Application Server Enterprise Editon 6.5, and iPlanet Process Manager 6.5.

    6. The installation disk for iPM contains a unified install, which includes the installation of the Directory Server, the Application Server, and Process Manager. Make sure to read the release notes for each product before installing.

    The iPlanet Directory Server 5.1 Release Notes are at the following location: http://docs.sun.com/coll/S1_ipDirectoryServer_51/

    The iPlanet Application Server Enterprise Edition 6.5 Release Notes are at the following location: http://docs.sun.com/coll/S1_ipappsrvree65_en/

    The iPlanet Process Manager 6.5 Release Notes are at the following location: http://docs.sun.com/coll/S1_ProcessManager_65/

  6. Install Unified Integration Framework 6.5.

    7. The Unified Integration Framework Release Notes and Developer's Guide are at the following location: http://docs.sun.com/prod/s1.entconn65

    The installation instructions for UIF are in the Unified Integration Framework Developer's Guide. You must install the Unified Integration Framework on the same machine or network cluster as the Application Server.

  7. Install any required patches.

    8. The iPlanet Process Manager 6.5 Release Notes contain instructions for the installation of additional required patches for Process Manager. See the individual release notes for other bundled products to determine if any other patches are required.

  8. Redeploy iAS and iPM applications and follow migration instructions to connect to application data.

    9. The iPlanet Process Manager 6.5 Release Notes contain a section called "Migration of iPM 6.0 Application Data to iPM 6.5." The iPlanet Application Server Migration Guide contains instructions for migrating Application Server applications.

Scenario 3: iAS Upgrade and iPM Install

Perform this upgrade and installation if you already have iPlanet Application Server, Enterprise Edition, 6.5 installed. You do not have to backup deployed iAS applications before performing an iAS upgrade. You should already be using iPlanet Web Server Enterprise Edition 6.0 SP2 and iPlanet Directory Server 5.1 if you are running iPlanet Application Server, Enterprise Edition, 6.5.

To perform an iAS Upgrade and iPM Installation

  1. Install any required patches.

    2. The iPlanet Process Manager 6.5 Release Notes contain instructions for the installation of additional required patches for Process Manager. See the individual release notes for other bundled products to determine if any other patches are required.

  2. Install iPlanet Process Manager 6.5 components.

    3. Follow the instructions in the iPlanet Process Manager Installation Guide, at the following location: http://docs.sun.com/coll/S1_ProcessManager_65/.

  3. Install Unified Integration Framework 6.5.

    4. The Unified Integration Framework 6.5 Release Notes and Developer's Guide are located at the following URL: http://docs.sun.com/prod/s1.entconn65

    The installation instructions for UIF are in the Unified Integration Framework Developer's Guide. You must install the Unified Integration Framework on the same machine or network cluster as the Application Server.

Upgrading to iPlanet Application Server 6.5 SP1

You may have previously installed versions of any one of the products bundled with this release of iAS EPE on your machine or network, which may or may not affect your installation strategy. The following scenarios can help you to install the products in the correct order. Be sure to follow installation instructions for your particular operating system and read the Release Notes.

Table 4    Upgrade Installation Scenarios 

Currently Installed Products

To Upgrade to iAS EPE 6.5 SP1, Windows or Solaris

iPlanet Application Server 6.0 SPx

iPlanet Process Manager 6.0 SPx

 

Scenario 4: Backup iAS and iPM Applications, Uninstall Previous Versions, and Reinstall

 

iPlanet Application Server 6.5

iPlanet Process Manager 6.5

 

Scenario 5: iAS Upgrade

 

Scenario 4: Backup iAS and iPM Applications, Uninstall Previous Versions, and Reinstall

Note that it is important to install the bundled software components in the correct order, as follows:

To perform an iAS and iPM Application Backup, Uninstall, and Reinstall

  1. Back up any existing iAS and iPM applications by saving them to a local directory.

    2. Do not delete application information for iPlanet Process Manager applications. The iPlanet Process Manager 6.5 Release Notes contain a section called "Migration of iPM 6.0 Application Data to iPM 6.5." The iPlanet Application Server Migration Guide contains instructions for migrating Application Server applications.

  2. Uninstall iAS and iPM, following the instructions contained in the Installation Guide for each product.

  3. Uninstall and migrate data for any other bundled product you want to upgrade or replace with this installation.

    4. This information is generally contained in the Installation Guide or Migration Guide for each product.

  4. Install iPlanet Web Server Enterprise Edition 6.0 SP2.

    5. The iPlanet Web Server 6.0 SP2 Release Notes are at the following location: http://docs.sun.com/coll/S1_ipwebsrvree60sp2_en/

  5. Install iPlanet Directory Server 5.1 and iPlanet Application Server Enterprise Editon 6.5 SP1.

    6. The Application Server installation program contains a unified install, which includes the installation of the Directory Server, and the Application Server. Read the release notes for each product before installing.

    The iPlanet Directory Server 5.1 Release Notes are at the following location: http://docs.sun.com/coll/S1_ipDirectoryServer_51/

    The iPlanet Application Server Enterprise Edition 6.5 SP1 Release Notes are at the following location: http://docs.sun.com/coll/S1_ipappsrvree65_en/

  6. Install iPlanet Process Manager 6.5 using the iAS EPE 6.5 CD.

    7. Select only the iPlanet Process Manager 6.5 components during installation. For detailed installation instructions, see the iPlanet Process Manager Installation Guide.

    The iPlanet Process Manager 6.5 Release Notes are at the following location: http://docs.sun.com/coll/S1_ProcessManager_65/

  7. Install Unified Integration Framework 6.5.

    8. The Unified Integration Framework Release Notes and Developer's Guide are at the following location: http://docs.sun.com/prod/s1.entconn65

    The installation instructions for UIF are in the Unified Integration Framework Developer's Guide. You must install the Unified Integration Framework on the same machine or network cluster as the Application Server.

  8. Redeploy iAS and iPM applications and follow migration instructions to connect to application data.

    9. The iPlanet Process Manager 6.5 Release Notes contain a section called "Migration of iPM 6.0 Application Data to iPM 6.5." The iPlanet Application Server Migration Guide contains instructions for migrating Application Server applications.

Scenario 5: iAS Upgrade

Perform this upgrade if you already have iPlanet Application Server, Enterprise Edition, 6.5 installed with iAS EPE 6.5 bundled products.

You do not have to backup deployed iAS or iPM applications before performing an iAS upgrade. You should already be using iPlanet Web Server Enterprise Edition 6.0 SP2 and iPlanet Directory Server 5.1 if you are running iPlanet Application Server, Enterprise Edition, 6.5.

To perform an iAS Upgrade

  1. Install the iAS EE, 6.5 SP1 upgrade.

    2. The instructions for performing an upgrade from iAS EE, 6.5 to iAS EE, 6.5 SP1 are in the iPlanet Application Server Enterprise Edition, 6.5 SP1 Release Notes at the following location:

    http://docs.sun.com/db/coll/S1_65sp1ee

iAS EPE Sample Application

The iAS EPE Sample Application consists of:

The iAS EPE Sample Application provides an example of how a Process Manager application can interact with an Enterprise Information System (EIS) using a custom activity. A Stubbed Connector is shipped with this sample application. The Stubbed Connector simulates a real connector and implements the protocol required by Unified Integration Framework (UIF). It returns hard-coded values for queries made from an iPM application custom activity. You can download this sample application from the following location: http://developer.iplanet.com/appserver/samples

The file GetEmployeeDetails.java, discussed in the documentation that ships with the sample application, is placed in the following location when you unzip the VacationRequest application:

on NT: EPE\sampleApp\src\com\iplanet\epe\sample\GetEmployeeDetails.java

on Solaris: EPE/sampleapp/src/com/iplanet/epe/sample/GetEmployeeDetails.java

Known Problems

For known problems related to specific iAS EPE bundled products, please read the release notes for each product.

How to Report Problems

If you have problems with iAS EPE, contact iPlanet customer support using one of the following mechanisms:

So that we can best assist you in resolving problems, please have the following information available when you contact support:

For More Information

Useful information can be found at the following Internet locations:


Copyright 2002 Sun Microsystems, Inc. All rights reserved.


Part Number 816-6382-10

Last Updated December 06, 2002