iPlanetTM Application Server Integration Tool

Integration with Forte for Java Version 2.0 Internet Edition

Installation Instructions

Developer Pack Version 6.0

Contents

Before You Begin

Before you install the iPlanet Application Server Developer Pack Integration with Forte for Java tool, you need to install:

System Requirements

The hardware and software requirements for installing and running the Integration Tool are as follows:

  Windows NT Machine SolarisTM Machine
Operating System: 350MHz Intel Pentium IITM, NT Version 4.0 with Service Pack 5 (minimum)
450 MHz Intel Pentium IIITM, NT Version 4.0 with Service Pack 5 (recommended) 		SolarisTM 8, UltraTM 10 (minimum)
SolarisTM 8, UltraTM 60 (recommended)
Memory: 1 per CPU: 256 MB with 256 MB swap (minimum)
512 MB (recommended)		 per CPU: 256 MB with 256 MB swap (min)
512 MB (recommended)
Available disk space: per CPU: 8 MB (minimum)
10 MB (recommended)		 8 MB (minimum)
10 MB (recommended)
Plus 60 MB required for customized JDK 1.3
Network software: TCP/IP TCP/IP
Web server: iPlanet Web Server Enterprise EditionTM Version 4.1 Service Pack 5
Microsoft Internet Information ServerTM Version 4.0		 iPlanet Web Server Enterprise EditionTM Version 4.1 Service Pack 5
Application server: iPlanet Application ServerTM
Version 6.0 Service Pack 2		 iPlanet Application ServerTM
Version 6.0 Service Pack 2
Database connectivity: (optional)
Database Vendor JDBC Driver
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

1 The memory requirements identified here are for the iPlanet Application Server Integration tool only. Consult the documentation for the Forte for Java and the iPlanet Application Server system requirements to identify the total memory requirements.

Installing the iPlanet Integration Tool

To install the iPlanet Integration Tool on a Windows NT system:

  1. Double-click on the install.exe in the iPlanet Integration Tool NT directory on the CD-ROM.
  2. Review and accept the License Agreement.
  3. Verify the directory path to the location of <iPlanetApplicationServerInstallDir> and the <ForteInstallDir>.
  4. Select Next or OK to install the integration tool; or Cancel to quit the installation process.

To install the iPlanet Integration Tool on a Solaris system:

  1. Insert the Integration Tool CD in the CD-ROM drive.
  2. Open a terminal window and locate the CD-ROM drive.
  3. Copy the iplanet_asie.zip file to a directory where you have write privileges.
  4. Unzip the file by typing: unzip iplanet_asie.zip.
  5. Type the following command to launch the installer: ./install
  6. When prompted, review and check the License Agreement.
  7. When prompted, identify the <iPlanetApplicationServerInstallDir>.
  8. When prompted, identify the <ForteInstallDir>.

    The installer appends the <ForteInstallDir> with the subdirectory iASPlugin.

  9. When prompted, begin to configure the debugging functionality.

    If you enter yes, you are further prompted to identify the JDK 1.3 installation directory.

    If you enter no, you will need to run the debugsetup script later to perform local/remote debugging. The debugsetup script is located in <ForteInstallDir>/iASPlugin/.

    When you enable the configuration of the debugging functionality the system creates a kjsdebug file and locates it in <ForteInstallDir>/iASPlugin/java/kjsdebug. If you run debugsetup later, when you are prompted for the location to copy the files, specify <ForteInstallDir>/iASPlugin/java. The kjsdebug script file will be copied to this directory location.

    To perform local/remote debugging on a Solaris machine, you must run the KJS engine in debug mode using this kjsdebug script. See the iPlanet Integration Tool Tutorial for information on local and remote debugging.

Running the Tutorial

Before you can run Part 7: Creating a Container Managed Persistence EJB of the tutorial, you must setup the oracle database. A database setup script is provided to assist you in this process. The script is located in the <ForteInstallDir>\iASPlugin\tutorial\db directory.

To setup the database from an NT machine:

  1. Create a datasource with the name dbsol0 in your database server (optional).
  2. Create a database user that has administrator privileges and identify a username and password of iplanet (optional).
  3. Verify that your %HOME% system environment variable is set properly; otherwise, messages will not be logged properly.

    The following messages will be written to your %HOME%\dbconn.cfg file: 

    DATASOURCE = dbsol0
DATABASE = %DBNAME%
USERNAME = %USER%
PASSWORD = %PSWD%

  4. Navigate to the <ForteInstallDir>\iASPlugin\tutorial\db directory.
  5. 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 and inserts the setup data.

To setup the database from a Solaris machine:

  1. Create a database with the name dbsol0 in your database server (optional).
  2. Create a database user that has administrator privileges and identify a username and password of iplanet (optional).
  3. Verify that your $HOME system environment variable is set properly; otherwise, messages will not be logged properly.

    The following messages will be written to your %HOME%/dbconn.cfg file: 

    DATASOURCE = dbsol0
DATABASE = $DBNAME
USERNAME = $USER
PASSWORD = $PSWD

  4. Navigate to the <ForteInstallDir>/iASPlugin/tutorial/db directory.
  5. Execute the load_ora.sh script.
  6. 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 and inserts the setup data.

Uninstalling the iPlanet Integration Tool

Prior to uninstalling the iPlanet Integration Tool, you should shut down Forte for Java IDE.

To uninstall the iPlanet Integration Tool on a Windows NT system:

  1. Locate the <ForteInstallDir>\iASPlugin\uninstall.exe.
  2. Double click on the uninstall.exe file to launch the uninstaller.

    Once uninstallation is complete, you will be prompted to delete the <ForteInstallDir>\iASPlugin directory and all its contents.

To uninstall the iPlanet Integration Tool on a Solaris system:

  1. Locate the <ForteInstallDir>/iASPlugin/uninstall directory.
  2. Type the following command to launch the uninstaller: ./uninstall.

    The uninstall program will prompt you to identify the <ForteInstallDir>

    Once uninstallation is complete, delete the <ForteInstallDir>\iASPlugin directory and all its contents.

Reinstalling

When reinstalling the iPlanet Integration Tool, you must:

  1. From the Tools menu, select Global Options.
  2. Select to open the Modules node.
  3. Select the iPlanet Application Server 6 subnode.
  4. In the Properties tab set the Enabled toggle switch to True.

Related Documentation

The iPlanet Integration Tool documentation can be found at: http://docs/iplanet.com/docs/manuals

Select the iPlanet Application Server 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.