iPlanetTM Application Server
Developer Pack Version 6.0 Service Pack 1

Integration with Forte for Java Version 3.0 Enterprise Edition

iPlanet Application Server Integration Tool

Installation Instructions

Contents

Before You Begin

Before you install the Developer Pack iPlanet Application Server Integration Tool with Forte for Java Version 3.0 Enterprise Edition tool, you need to install:

System Requirements

The hardware and software requirements for installing and running the Developer Pack are as follows:

  Windows NT/2000 Machine SolarisTM Machine
Operating System: 350MHz Intel Pentium IITM, NT Version 4.0 with Service Pack 5, or Windows 2000 PE (minimum)
450 MHz Intel Pentium IIITM, NT Version 4.0 with Service Pack 5, or Windows 2000 PE (recommended)		 SolarisTM 8, UltraTM 10 (minimum)
SolarisTM 8, UltraTM 60 (recommended)
Memory: per CPU: 512 MB per CPU: 512 MB
Available disk space: per CPU: 5 MB (minimum)
8 MB (recommended)		 5 MB (minimum)
8 MB (recommended)
Web server: iPlanet Web Server Enterprise EditionTM Version 6.0 Service Pack 1 iPlanet Web Server Enterprise EditionTM Version 6.0 Service Pack 1
Application server: iPlanet Application ServerTM
Version 6.0 Service Pack 3		 iPlanet Application ServerTM
Version 6.0 Service Pack 3
Database connectivity: (optional)
Database Vendor JDBC Driver
Pointbase Network Server Version 3.5 (bundled with iPlanet Application Server 6.0 SP3)
Oracle Oracle8i 8.1.6.0.1 (Type 4 and Type 2 drivers)
Merant (Intersolv) SequeLink Java Edition v5.0 (with Oracle and MSSQL only)
Sybase jConnect 5.2 (Type 4 driver)
IBM DB2 IBM DB2 7.1 JDBC Client
Informix Informix JDBC v2.1 (Type 4 driver)
MS SQL 7 ODBC 3.5.1

Installing the iPlanet Developer Pack Application Server Integration Tool

The iPlanet Application Server Integration Tool installer checks for the following before initiating the installation process: If any of the above items are not properly installed or set, you will be prompted to resolve these issues before installing the iPlanet Application Server Integration Tool.

Additionally, you must exit the Forte for Java IDE before installing the iPlanet Application Server Integration Tool.

To install the iPlanet Application Server Integration Tool on a Windows NT/2000 system:

  1. Insert the Developer Pack iPlanet Application Server Integration Tool CD in the CD-ROM drive.
  2. Navigate to the Forte_for_Java\Windows\iASPlugin directory.
  3. Double-click on the install.exe.
  4. Review and accept the License Agreement.
  5. Verify the directory path to the location of:
    • iPlanet Application Server
    • Forte for Java
    • Available disk space
  6. Select Install to install the Developer Pack iPlanet Application Server Integration Tool; or Cancel to quit the installation process.
  7. Select OK to complete the installation process.

To install the iPlanet Application Server Integration Tool on a Solaris system:

  1. Insert the Developer Pack iPlanet Application Server Integration Tool CD in the CD-ROM drive.
  2. Open a terminal window and locate the CD-ROM drive.
  3. Navigate to the Forte_for_Java/Solaris/iASPlugin/iplanet_asee.zip file.
  4. Copy the iplanet_asee.zip file to a directory where you have write privileges.
  5. Unzip the file by typing: unzip iplanet_asee.zip.
  6. Type the following command to launch the installer: ./install
  7. Review the License Agreement when prompted.
  8. When prompted, identify the path to the iPlanet Application Server installation directory.
  9. When prompted, identify the path to the Forte for Java installation directory.
The installation displays an "installation complete" message.

Running the Tutorial

Before you can use the iPlanet Developer Pack Application Server Tutorial to create a Container Managed Persistence EJB, you must have an Oracle database setup. A database table setup script is provided to assist you in this process. The script is located in the <ForteInstallDir>\iplanet\Samples\db directory.

Additionally, you can use the Pointbase database that is available with Forte for Java and the iPlanet Application Server. However, you will need to modify the tutorial sample code to identify the Pointbase database instead of the Oracle database.

To setup the database table from an NT or Windows 2000 machine:

  1. Navigate to the <ForteInstallDir>\iplanet\Samples\db directory.
  2. Execute the load_ora.bat script with the following parameters:

    • datasource name
    • database user name
    • database password

    For example: load_ora.bat dbSol0 iplanet iplanet

    The script creates a table named obcustomer.

To setup the database table from a Solaris machine:

  1. Navigate to the <ForteInstallDir>/iplanet/Samples/db directory.
  2. Execute the load_ora.sh script.
  3. When prompted identify the following variables:

    • ORACLE_HOME directory
    • ORACLE_SID
    • username
    • password

      If the specified username is not found in the database, the script prompts you to create one.

The script creates a table named obcustomer.

Related Documentation

The iPlanet Developer Pack documentation can be found at: http://docs.iplanet.com/

Select the iPlanet Developer Pack link to access the latest documentation including the most up-to-date Release Notes.

Copyright © 2001, Sun Microsystems Inc. All rights reserved.
Copyright © 2001, Netscape Communications Corporation. All rights reserved.

Sun, Sun Microsystems, the Sun logo, Java, iPlanet, and the Sun, Java, and iPlanet-based trademarks and logos are trademarks or registered trademarks of Sun Microsystems, Inc. in the U.S. and other countries.

Netscape and the Netscape N logo are registered trademarks of Netscape Communications Corporation in the U.S. and other countries. Other Netscape logos, product names, and service names are also trademarks of Netscape Communications Corporation, which may be registered to other countries.