Contents
- Before You Begin
- System Requirements
- Installing the iPlanet Application Server Developer Pack
- Running the Tutorial
- Related Documentation
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:
- iPlanet Application Server Version 6.0 Service Pack 3
- Forte for Java Version 3.0 Enterprise EditionTM (which requires installation of the Java Developer Kit Version 1.3.1)
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 3iPlanet Application ServerTM
Version 6.0 Service Pack 3Database 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.
- Logged on as Administrator or have administrator privileges
- iPlanet Application Server Version 6.0 Service Pack 3 is installed on the local machine
- Forte for Java Version 3.0 Enterprise Edition IDE is installed on the local machine
- Adequate available disk space of at least 8 MB
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:
- Insert the Developer Pack iPlanet Application Server Integration Tool CD in the CD-ROM drive.
- Navigate to the Forte_for_Java\Windows\iASPlugin directory.
- Double-click on the
install.exe
.- Review and accept the License Agreement.
- Verify the directory path to the location of:
- iPlanet Application Server
- Forte for Java
- Available disk space
- Select Install to install the Developer Pack iPlanet Application Server Integration Tool; or Cancel to quit the installation process.
- Select OK to complete the installation process.
To install the iPlanet Application Server Integration Tool on a Solaris system:
The installation displays an "installation complete" message.
- Insert the Developer Pack iPlanet Application Server Integration Tool CD in the CD-ROM drive.
- Open a terminal window and locate the CD-ROM drive.
- Navigate to the Forte_for_Java/Solaris/iASPlugin/iplanet_asee.zip file.
- Copy the iplanet_asee.zip file to a directory where you have write privileges.
- Unzip the file by typing: unzip iplanet_asee.zip.
- Type the following command to launch the installer: ./install
- Review the License Agreement when prompted.
- When prompted, identify the path to the iPlanet Application Server installation directory.
- When prompted, identify the path to the Forte for Java installation directory.
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:
- Navigate to the <ForteInstallDir>\iplanet\Samples\db directory.
- 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:
The script creates a table named obcustomer.
- Navigate to the <ForteInstallDir>/iplanet/Samples/db directory.
- Execute the load_ora.sh script.
- 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.
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.