Previous     Contents     Index     Next     
iPlanet Application Server Installation Guide



Chapter 4   Easy iPlanet Application Server Installations on Windows


This chapter describes how to install and configure the iPlanetTM Application Server for the Windows and SolarisTM platforms. It contains the following information

Read this chapter before using the ezsetup, Typical, or Express iPlanet Application Server installations. For any late breaking updates to these instructions, check the Release Notes at:

http://docs.iplanet.com/docs/manuals/ias.html

For more information about configuring your application server after installation, refer to the iPlanet Application Server Administrator's Guide.



The Easy Installation Options


The easiest iPlanet Application Server software installation options are as follows:

  • ezsetup; at most, a two step installation, which sets port numbers, usernames, and passwords to default values

  • Express; requires slightly more user input than ezsetup

  • Typical; requires more user input but yields an installation that is essentially the same as that performed by ezsetup



What You're Installing

The software you're installing for iPlanet Application Server, consists of a group or stack of components, including:

  • iPlanet Directory Server, Enterprise Edition 5.0 SP1

  • iPlanet Console, which has its own Administration Server

  • iPlanet Application Server and its subcomponents:

    • iPlanet Application Server Web Connector Plug-in component

    • iPlanet Application Server Core Server Component

    • iPlanet Application Server Administration Tool

    • iPlanet Application Server Deployment Tool

    • PointBase Database Server

      Installs the required PointBase files/packages when you select the Application Server core components.

See Chapter 1 "Getting Started", for an overview of the iPlanet Application Server features and components. For more specific information about any of the other server or components, check the iPlanet Web site at:

http://docs.iplanet.com/



Using Easy Installation Options on Windows


This section describes the easy installation options for Windows NT/2000 platforms.

The following topics are included in this section:


Running ezSetup on Windows

The standalone ezsetup application performs an automated iPlanet Application Server installation and sets the default values given in Table 4-1.

Ensure you have met all the conditions listed in"Prerequisites for Installation".


Note
  • This installation is not intended for working developers or production environments. ezSetup is meant for evaluation purposes only.

  • You must not have an existing installation of iPlanet Directory Server on the machine on which you are running ezSetup.

  • You should have a fixed IP address and a valid DNS domain name for the machine on which you plan to run ezSetup.



To Run esZetup

  1. From the ezSetup directory, double-click ezSetup.exe.

  2. Click Next at the Welcome Screen.

  3. Click Yes to accept the License Agreement.

    You must accept the license agreement to continue with the installation.

  4. Click Continue if you meet the recommendations mentioned in the Pre-requisites screen.



  5. Click OK to select the default installation path or click the ellipsis (...) to browse through your computers' folders to select another directory.

    If you have multiple Web server instances running, you will be prompted to select the Web server instance to associate with iPlanet Application Server and click OK.



  6. Enter the product key and Click OK.

    iPlanet Application Server installs without any further prompts.


    Table 4-1    Default values assigned for username and password

    Component

    Username

    Password

    Configuration Server Administrator  

    admin  

    admin  
    Directory Manager

     

    Directory Manager  

    DManager  
    iPlanet Administration Server

     

    admin  

    admin  


    Table 2    Default port number values

    Component

    Port Number

    Directory Server  

    389  

    Administrative Server (KAS)  

    10817  

    Executive Server (KXS)  

    10818  

    Java Server (KJS) on Windows

    On Solaris, this port is used for the CGI to Executive Server (KXS) communication.  

    10819  

    Java Server (KJS) on Solaris

    On Windows, this port is used for the C++ Server (KCS).  

    10820  

    C++ Server (KCS) on Solaris  

    10821  

    PointBase database engine  

    9092  


Running the Wizard Installation

The iPlanet Application Server Installation Wizard's Express and Typical installation options both require very little user input. The first six (6) screens of all the Wizard Installations are the same.


Note A Web server and browser must be installed and running before you begin iPlanet Application Server installation. iPlanet Web Server, Enterprise Edition 6.0 SP2b is available on the product CD.

You can also download iPlanet Web Server 4.1 SP7 or later, or 6.0 or later, from:
http://www.iplanet.com/downloads/download/

The web server and browser need not be present on the same machine if you are performing a Webless installation. For more information, see "Webless Installations"



To Start the Wizard Installation

  1. Ensure conditions in "Prerequisites for Installation" on page 29 are met.

  2. If you are installing from a CD-ROM, the installation wizard should start automatically when the CD is inserted in the CD-ROM drive. If it does not, browse the CD-ROM drive to locate and launch the file: setup.exe.

  3. Click Next after the Welcome screen appears.

  4. Click Yes to accept the license agreement.

    You must accept the License agreement to continue.

  5. Click Next to install the iPlanet Server and core components.

    Select the iPlanet Administration Console to install it as a standalone application. Selecting the iPlanet Server and core components will install the Administration Console by default on the same machine on which you are installing the application server.

  6. Choose the type of installation and click Next.

Following is a description of the Express installation. For information on Typical installation, see "Running the Typical Installation" on page 74".

For information on Custom installation, see Chapter 6 "Advanced Installations for Windows."


Running the Express Installation

Since the first steps of the Installation wizard are the same for all of its options, execute the steps in, "Running the Wizard Installation" on page 66, before you start the following procedure. Click Next after each step.


Note A Web server and browser must be installed and running before you begin iPlanet Application Server installation. iPlanet Web Server, Enterprise Edition 6.0 SP2b is available on the product CD.

You can also download iPlanet Web Server 4.1 SP7 or later, or 6.0 or later, from:
http://www.iplanet.com/downloads/download/

The web server and browser need not be present on the same machine if you are performing a Webless installation. For more information, see "Webless Installations"



To Start the Express Installation

  1. Select Express as the type of installation to perform and click Next.

  2. Click Next on the Location of Installation panel to accept the default pathway, or click the ellipsis (...) to browse through your computers' folders and select another directory. Do not use a directory name that includes spaces.

    The Components to Install screen appears.



  3. Click Next to accept the default choices on the Components to Install panel. The default choices indicate those installed during a full installation.

    Click the Change button to further refine your choices. This displays the subcomponents associated with each component selected.

    Your selections at the component level of the Components to Install panel enable you to:

    • Deselect the Directory Suite component if you already have a directory service available.

    • Deselect Administration Services if you don't want the iPlanet Administration Console.


      Note The nsPerl and PerLDAP components are required by the directory server component.To deselect them, you must first deselect the iPlanet Directory Suite component.


      iPlanet Application Server bundles the PointBase database server, which is installed by default. If you do not want to install PointBase, select iPlanet Application Server 6.5 > Change, and uncheck the box next to PointBase Database Server.

Within the iPlanet Application Server installation there are several panels pertaining to installing and configuring iPlanet Directory Server 5.0 SP1. The Express Installation Wizard panels set up the following:

      • Administrator for the configuration directory.

      • Administrator for the directory server. This "superuser" has the default Distinguished Name (DN) of Directory Manager.

    The Configuration Directory Server is the part of the Directory Server used to store configuration information. The Directory Server also stores directory data. For an overview of the various functions of the Directory Server, see the iPlanet Directory Server Installation Guide.


    Note
    • If you don't install directory server with iPlanet Application Server, you must designate an existing directory server as the configuration directory. The directory server you designate as the configuration directory must contain the data tree: o=NetscapeRoot.


    The following steps configure the directory server:

  1. Assign the Administrator ID and Password for the configuration directory, on the Directory Server 5.0 panel. Click Next.

    The default username is admin.

    For more information about the Configuration Directory Server, see iPlanet Directory Server Deployment Guide, on the Web at: http://docs.iplanet.com/docs/manuals/directory.html

  2. Enter the Directory Manager DN or keep the default, and click Next.

    The Directory Manager's Distinguished Name is the special directory entry to which access control does not apply. You can think of the Directory Manager as your directory's super user.

    In most cases, it is best to keep the default value, which is set to the common name of Directory Manager, as follows: cn=Directory Manager

  3. Enter the Directory Manager's password; it must be at least 8 characters long. Click Next.

  4. Enter the product key and click Next.

    The product key is in the Welcome Letter you received with the iPlanet Application Server CD. You must enter this number correctly for installation to continue.

  5. Select the type of Web Server installed. If you have multiple Web server instances running, then select one from the drop-down menu to locate an instance to associate with iPlanet Application Server.

    Select None if you do not have a Web server installed. This causes iPlanet Application Server Installer to continue without installing the Web Connector plug-in. This is referred to as a "webless" installation. For more information, see "Installing the Web Connector Plug-in" on page 150.


    Note The Webless type of installation is necessary if your Web server is installed on a remote machine. After you are finished installing iPlanet Application Server, you must go to that machine and install the Web connector.

    For more information, see "Installing the Web Connector Plug-in".


  6. Enter an Administrator Username and Password. This sets up the user name and password for the iPlanet Administration Server Console.

  7. Select Yes on the Internationalization panel to enable support for standard Java internationalization. Click Next.

    The Configuration Summary screen with all your settings will now be displayed.

  8. Click Install to complete the installation.

    If you want to change any of the settings, click Back to page back through the panels and correct them.

An Installation Progress indicator bar appears. After the installer finishes, reboot the machine.


Running the Typical Installation

As the first steps of the Installation wizard are the same for all of its options, execute the steps in, "Running the Wizard Installation" on page 66, before you start the following procedure. Click Next after each step.


To Run the Typical Installer

  1. Select Typical as the type of installation to perform.

  2. Click Next on the Location of Installation panel to accept the default pathway, or click the ellipsis (...) to browse through your computers' folders and select another directory. Do not use a directory name that includes spaces.

    The Components to Install screen appears.



  3. Click Next to accept the default choices on the Components to Install panel. The default choices indicate those installed during a full installation. Click the Change button to further refine your choices. This displays the subcomponents associated with each component selected.

    Your selections at the component level of the Components to Install panel enable you to:

    • Deselect the Directory Suite component if you already have a directory service available.

    • Deselect Administration Services if you don't want the iPlanet Administration Console.


      Note
      • The nsPerl and PerLDAP components are required by the directory server component.To deselect them, you must first deselect the iPlanet Directory Suite component.


      iPlanet Application Server bundles the PointBase database server, which is installed by default. If you do not want to install PointBase, select iPlanet Application Server 6.5 > Change, and uncheck the box next to PointBase Database Server.



Within the iPlanet Application Server installation there are several panels pertaining to installing and configuring iPlanet Directory Server 5.0 SP1. These panels and their function are described in the following steps.

  1. Select the directory server that will hold the configuration directory.

    The configuration directory contains the data tree used by the iPlanet Application Server. The Directory Server stores these configuration settings in the data tree: o=NetscapeRoot, under the suffix that you set up to identify your organization. Multiple server installations can store their configuration settings in this configuration directory.

    Choose one of the following options:

    • Set a new Directory Server (the one you are installing) as the configuration directory by keeping the default setting, or

    • Use an existing Directory Server by selecting "Use existing configuration Directory Server," and then fill in the information used to identify that server.


      Note
      • If you don't install the directory server with iPlanet Application Server, you must designate an existing directory server as the configuration directory. The directory server you designate as the configuration directory must contain the data tree: o=NetscapeRoot.


  2. Select the directory server that will store iPlanet Application Server Data.

The Directory Server gives you the option to distribute data amongst multiple Directory Server databases. It does this by using a plug-in that chains together distributed data. For more information, see iPlanet Directory Server Deployment Guide, which is available on the Web at: http://docs.iplanet.com/docs/manuals/directory.html

Choose one of the following options:

  • To store directory data in the newly installed Directory Server, select the default option.

  • To use an existing Directory Server for data storage, select that option and enter its general settings:

    • Host name and port number.

    • Default binding or Distinguished Name (DN). By default it's cn=Directory Manager.

    • Suffix: dc=sales, dc=sun, dc=com. For example, if the DNS name is sales.sun.com, then the suffix should be: dc=sales, dc=sun, dc=com.

  • Specify the Directory Server's General Settings

These settings consist of an identifier for the Directory Server's host machine, the port number of the LDAP communication port, and the data information tree suffix that is used to identify the root of the database tree for this iPlanet Application Server installation or the Directory Server.



The suffix is the entry at the top of the Directory Server data tree, below which iPlanet Application Server data is stored. For more information on standard directory suffixes, see the iPlanet Directory Server Administrator's Guide.

    • The Server Identifier is set to the local host (the computer on which you are installing the directory server.)

    • The default Server Port number is 389 (the standard LDAP port number); if the port is in use, a randomly generated number will be used.

    • The default domain name is set to the computer you're installing the Application Server on.

  1. Set up the directory server's Administration Domain.

    The default is set to the installation computer's domain. If you need to change this value, you should use a name that corresponds to the organizations that control the servers in each domain

    Since a Directory Server may store Configuration information for multiple domains, the Administration Domain is used to keep these separate. For more advanced configurations and information about using the Directory Server to store information about multiple domains, see the iPlanet Directory Server Administrator's Guide.

  2. Enter a Directory Administrator (Manager) user name and password.

  3. Click Next to use default Administrator Port Number.

  4. Enter the Directory Manager common name, or keep the default value, which is: cn=Directory Manager.

    The Directory Manager's Distinguished Name is the special directory entry to which access control does not apply. You can think of the Directory Manager as your directory's super user. On the Directory Manager Settings panel, enter a Directory Manager DN or keep the default.

  5. Enter the Directory Manager's password; it must be at least 8 characters long.

  6. Enter the Product Key; it's in the iPlanet Application Server Welcome letter.

  7. Indicate the Web Server type (which has been installed earlier), by choosing one of the following:

    • iPlanet Web Server

    • Microsoft Internet Information Server (IIS)

    • None. In this case a Webless installation take place. After you have finished with this installation you must install the Web Connector Plug-in. for more information see, "Installing the Web Connector Plug-in".

  8. Enter the user name and password for the iPlanet Administration server. Click Next.

    The Internationalization panel appears.

  9. Choose to either install or not install support for Internationalization, and click Next.

    The Configuration Summary panel appears.

  10. Click Install to complete the installation.

    If you want to change any of the settings, click Back to page back through the panels and correct them.

To finish, restart your computer so the new settings can take effect.

You can use a pre-installed application to verify that the iPlanet Application Server is running. For more information see, "Verifying Installation" on page 80.



Verifying Installation


The iPlanet Web site provides an application that verifies connectivity of your iPlanet Application Server installation. Since this basic application, which uses servlets and JSPs, does not rely on a database, it runs without any extra setup.

To Verify Installation, perform the following steps:

  1. Open your browser enter the following URL, and then click Enter:

    http://<yourwebserver>:<portnumber>/ias-samples/index.html

  2. Click the Quick Test link, under Sample Applications.

  3. Press the shift key and click on the browser's Reload button to ensure the application repeatedly returns a new HTML stream.



Using the Sample Applications

To better understand specific technology features provided by iPlanet Application Server, run the iPlanet Application Server Technology Samples.

To use the sample applications, perform the following steps:

  1. Start iPlanet Application Server.

  2. Open your browser, enter the following URL, and press Enter:

    http://<yourwebserver>:<portnumber>/ias-samples/index.html

  3. Select the iPlanet Application Server J2EE Application Samples link and select a specific sample application. Follow the application-specific setup instructions to establish the necessary database settings and to run the application.

After you become familiar with the iPlanet Application Server sample applications, run the Sun Samples, which are applications based on those found at http://www.java.sun.com. The Java Pet Store example in particular demonstrates how a popular J2EE application is deployed to iPlanet Application Server.

You can review the source code of the sample applications and associated J2EE XML Deployment Descriptors by browsing in the following location:

<installDir>/ias/ias-samples/

You can also find compile scripts at this site for experimenting with the sample code.


Previous     Contents     Index     Next     
Copyright © 2002 Sun Microsystems, Inc. All rights reserved.

Last Updated March 12, 2002