Preface


This preface describes the iAS documentation set and illustrates what you can expect to find in this Migration Guide.

This preface contains the following sections:

• Using the Documentation

• About This Guide

• How This Guide Is Organized

• Documentation Conventions

• Related Information

Using the Documentation

---

The following table lists the tasks and concepts that are described in the iPlanet Application Server (iAS) and iPlanet Application Builder (iAB) printed manuals and online read-me file. If you are trying to accomplish a specific task or learn more about a specific concept, refer to the appropriate manual.

Note that the printed manuals are also available as online files in PDF and HTML format.

Table 0-1

For information about	See the following	Shipped with
Late-breaking information about the software and the documentation	readme.htm	iAS 6.0, iAB 6.0
Installing iPlanet Application Server and its various components (Web Connector plug-in, iPlanet Application Server Administrator), and configuring the sample applications	Installation Guide	iiAS 6.0
Installing iPlanet Application Builder.	install.htm	iAB 6.0
Basic features of iAS, such as its software components, general capabilities, and system architecture.	Overview	iAS 6.0, iAB 6.0
Administering one or more application servers using the iPlanet Application Server Administrator Tool to perform the following tasks: Deploying applications with the Deployment Manager tool Monitoring and logging server activity Setting up users and groups Administering database connectivity Administering transactions Load balancing servers Managing distributed data synchronization	Administration & Deployment Guide	iAS 6.0
Migrating your applications to the new iPlanet Application Server 6.0 programming model from the Netscape Application Server version 2.1, including a sample migration of an Online Bank application provided with iPlanet Application Server	Migration Guide	iiAS 6.0, iAB 6.0
Creating iAS 6.0 applications within an integrated development environment by performing the following tasks: Creating and managing projects Using wizards Creating data-access logic Creating presentation logic and layout Creating business logic Compiling, testing, and debugging applications Deploying and downloading applications Working with source control Using third-party tools	User's Guide	iAB 6.0
Creating iAS 6.0 applications that follow the new open Java standards model (Servlets, EJBs, JSPs, and JDBC), by performing the following tasks: Creating the presentation and execution layers of an application Placing discrete pieces of business logic and entities into Enterprise Java Bean (EJB) components Using JDBC to communicate with databases Using iterative testing, debugging, and application fine-tuning procedures to generate applications that execute correctly and quickly	Programmer's Guide (Java)	iiAB 6.0
Using the public classes and interfaces, and their methods in the iPlanet Application Server class library to write Java applications	Server Foundation Class Reference (Java)	iAS 6.0
Using the public classes and interfaces, and their methods in the iPlanet Application Server class library to write C++ applications	Server Foundation Class Reference (C++)	Order separately

About This Guide

---

This guide describes how to migrate applications from iPlanet Application Server 2.1 and 4.0 to iAS 6.0.

How This Guide Is Organized

---

This guide is organized into three chapters, as follows:

• Chapter 1 "Migration Overview

• Chapter 2 "Running NAS 2.1 Applications on iAS 6.0

• Chapter 3 "Reimplementing Your NAS 2.1 Application

• Chapter 4 "Running NAS 4.0 Applications on iAS 6.0

• Chapter 5 "NetDynamics to iAS 6.0

In addition, there is a complete code walkthrough of an example migration using the Online Bank sample application from NAS 4.0 to 6.0. This is available online. Check the iPlanet web site support area for more migration details:

Documentation Conventions

File and directory paths are given in Windows format (with backslashes separating directory names). For Unix versions, the directory paths are the same, except that slashes are used instead of backslashes to separate directories.

This guide uses URLs of the form:

http://server.domain/path/file.html

In these URLs, server is the name of server on which you run your application; domain is your Internet domain name; path is the directory structure on the server; and file is an individual filename. Italic items in URLs are placeholders.

This guide uses the following font conventions:

• The monospace font is used for sample code and code listings, API and language elements (such as function names and class names), file names, pathnames, directory names, and HTML tags.

• Italic type is used for book titles, emphasis, variables and placeholders, and words used in the literal sense.

Related Information

---

Specifications related to the iAS 6.0 programming model are provided in the docs directory on your installation CD. However, always refer to the online documentation first as this may have been updated since you have received the product.

The official specifications are maintained at the following URLs. Note that these sites do not necessarily contain the versions of these specifications that are supported by iAS. See the index listed above for links to specification versions supported by iAS.

Servlets	http://java.sun.com/products/servlet
JavaServer Pages (JSPs)	http://java.sun.com/products/jsp
Enterprise JavaBeans (EJBs)	http://java.sun.com/products/ejb
Java Naming and Directory Interface (JNDI)	http://java.sun.com/products/jndi
Java Database Connectivity (JDBC)	http://java.sun.com/products/jdbc

Additionally, we recommend the following resources:

Programming with Servlets and JSPs
Java Servlet Programming, by Jason Hunter with William Crawford, O'Reilly Publishing

Java Threads, 2nd Edition, by Scott Oaks & Henry Wong, O'Reilly Publishing

The web site http://www.servletcentral.com

Programming with EJBs
Enterprise JavaBeans, by Richard Monson-Haefel, O'Reilly Publishing

The web site http://ejbhome.iona.com

Programming with JDBC
Database Programming with JDBC and Java, by George Reese, O'Reilly Publishing

JDBC, by Graham Hamilton, Rick Cattell, Maydene Fisher