Previous     Contents     Index     DocHome     Next     
iPlanet Application Server Installation Guide



Chapter 3   Easy iPlanet Application Server Installations


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 4.13

  • 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 3-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 3-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  

    CXS engine  

    9091  

    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. You can download the iPlanet Web Server, Enterprise Edition 4.1 SP7 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 34 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 68".

For information on Custom installation, see Chapter 5 "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 60, before you start the following procedure. Click Next after each step.


Note A Web server and Web browser must be installed and running before you begin iPlanet Application Server installation. You can download iPlanet Web Server, Enterprise Edition 6.0 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.0 > 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 161.


    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 so the new settings can take effect.


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 60, 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.0 > 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 88.



Using the Easy Installation Options for Solaris


Before you begin installing check to see that you satisfy the system requirements. Once these are satisfied, you can follow your choice of the various installation procedures.

This section includes the following topics:


Running ezSetup on Solaris

The ezSetup application requires almost no user input because it assigns default values for the iPlanet Application Server's component's usernames and passwords.

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

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


Note This installation is not intended for working developers or production environments.


Before you start the ezSetup installation program, make sure that the Web server is installed and running.


To Run ezSetup

  1. Log in as root.

  2. Mount the CD-ROM on, for example, /cdrom/cdrom0

  3. At the shell prompt, run the following command:

    /cdrom/cdrom0/solaris/ezSetup

    If you have downloaded the tar file, untar the file and in the temporary directory you have created, type:

    ./ezSetup

  4. Enter y and press Enter to accept the License Agreement. You must accept the license agreement to continue with the installation.

  5. You will be prompted to install the required patch level for the version of Solaris you are running. Enter y and press Enter.



    For more information on the required patches, see "Minimum System Requirements". For any updates to the patch requirements, see the Release Notes at http://docs.iplanet.com/docs/manuals/ias.html

  6. Enter the iPlanet Application Server installation directory.

  7. When prompted for the web server's installation location, enter the full path where the Web server is installed.



  8. Type-in the product key and press Enter

    The server files will now be extracted to the installation directory you have specified. After all the files have been extracted, the installer generates a report of the port numbers assigned.


    Note Record or print the port number report as the port numbers are required to administer the iPlanet Application Server.


  9. Go to the installation directory and execute the startconsole -a http://<servername>:<port_number> command (printed at the end of the port number report) to start the iPlanet Administration Console.

    Table 3-3    Default values assigned for username and password

    Component

    username

    password

    Configuration server administrator  

    admin  

    admin  
    Directory manager

     

    Directory Manager  

    DManager  
    iPlanet Application Server Administration Server

     

    admin  

    admin  


    Table 3-4   

    Component

    Port Numbers

    Directory Server  

    389  

    Administrative Server (KAS)  

    10817  

    Executive Server (KXS)  

    10818  

    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  

    CXS engine  

    9091  

    PointBase database engine  

    9092  


Starting Solaris Installations

During iPlanet Application Server installation on the Solaris platform, use the following keystroke commands:

  • Enter key; accepts that screen's default setting and goes to next screen.

  • CTL+B; goes back to the previous screen within an installation section, as defined by the title at the top of the screen. You cannot use CTL+B to go back to a screen in a different section.

  • CTL+C; exits the installation. Once exited, the installer starts over at the beginning.

  • Comma (,) delineated list; specifies more than one item.


    Note A Web server and Web browser must be installed and running before you begin iPlanet Application Server installation. You can download iPlanet Web Server, Enterprise Edition 4.13 from:
    http://www.iplanet.com/downloads/download/



To Begin Installation

The following six steps are common to all the Solaris installations.

  1. Login as root.

  2. Insert the product CD in the CD-ROM drive.

  3. Mount the CD-ROM on, for example, /cdrom/cdrom0

  4. At the shell prompt, run the following command:

    /cdrom/cdrom0/solaris/setup

    If you have downloaded the tar file, untar the file and in the temporary directory you have created, type:

    ./setup

    The Tips screen appears.

  5. Press Enter.

    The License Agreement screen appears.

  6. You must enter y to continue.

  7. Press Enter to accept the default; install the iPlanet Servers group unless you select the iPlanet Console instead.

    If you select iPlanet Console (formerly Netscape Console), the iPlanet Console is installed as a standalone application, which can be used from any machine to administer your iPlanet Application Server configuration.

The next screen allows you to choose the installation type. The Express Installation is described next. For a description of the typical installer, see "Running the Typical Installation" on page 82.


Running the Express Installation

Before you begin installing iPlanet Application Server, ensure you have met all the conditions listed in"Prerequisites for Installation".

  1. Enter 1 to select Express Installation.

  2. Press Enter to accept the default installation directory: /usr/iplanet/ias6

    If you enter a different location, do not include spaces in the path name.


    Note You must have at least 400 MB available on this drive to install. All components are installed in this directory


  3. On the iPlanet Server Products Components panel, the default choice of [All] indicates which components are installed during a full install of iPlanet Application Server. You may choose to:

    • Keep the default selection. If you choose [All], the sub-components of the selected components are listed in subsequent screens, so that you can further refine your choices.

    • Enter 1,3,4 to not install the Directory Suite component if you already have a directory service available.


      Note
      • The Directory Component should not be selected if you intend to install multiple instances of iPlanet Application Server. For more information, see "Installing Multiple Instances on Solaris".

      • 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.


    • Enter 1,2,4 to not install the Administration Services component if you don't want the iPlanet Administration Console.

    • Enter 4 to install only the iPlanet Application Server.

  4. Type in the system user and group names.

    This user and group should be set up prior to running the installation program. Typically, this user and group should be the same as the user and group used for the web server installation.

    Specify a user that has no privileges elsewhere on the system to avoid access to restricted servers, such as the configuration Directory Server.

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

  • Administrator for the Configuration Directory Server

  • Administrator for the Directory Server directory data; this "superuser" is identified by the Directory Manager Distinguished Name (DN)

These panels and their function are described in the following procedures.

  1. Assign the Administrator ID and password for the configuration directory.

    Press Enter to accept default username as admin,or type in a username and press Enter. Enter a password: it can contain letters and numbers.

    The Configuration Directory Server is the part of the Directory Server used to store configuration information. The Directory Server also stores directory
    data.


Note This ID and password is used to login to the iPlanet Administration Console and to uninstall iPlanet Application Server and the Directory Server.



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

  1. Assign the Directory Manager's Distinguished Name.

    Keep the default DN value Directory Manager, which is set to the common name of Directory Manager (cn=Directory Manager). Or, if necessary, enter a different Directory Manager name. Enter a password for the Directory Manager that is at least 8 characters long.



The Directory Manager's Distinguished Name is the special directory entry for the administrator of the Directory Server. Access control does not apply to the Directory Manager.

The Directory Server is now configured for installation.

  1. Enter the Product Key; it's is in the Welcome letter you received with iPlanet Application Server.

    You must enter this number correctly for installation to continue.

  2. Enter the full path to your running Web server instance.

    The iPlanet Application Server Web Connector Plug-in will now be installed and configured to the Web Server instance that is identified here.

  3. Enter a user name and password for the iPlanet Application Server's Administration Server.


    Note Record the username and password. After installation, you'll need them to register iPlanet Application Server with the iPlanet Application Server Administration Tool.


  4. Enter Y to enable standard Java internationalization for iPlanet Application Server applications, otherwise accept the default.

    The iPlanet Application Server installation is now ready to extract the required files and installs them in your system.

  5. Press Enter to extract the components to install.

    Here, you may be prompted to change the ownership of iPlanet Application Server files if the owner and group are different.

    Type Y and press Enter if you want to change the group permission of iPlanet Application Server files to that of the user you are installing as. You must be the super user or logged in as that user to change permissions.

    After all the files have been extracted, the installer generates a report of the port numbers assigned.


    Note Record or print the port number report as the port numbers are required to administer iPlanet Application Server.


  6. To start the iPlanet Administration Console, go to the installation directory and execute the command (printed at the end of the port number report):

    startconsole -a http://<servername>:<port_number> command


Running the Typical Installation

Before beginning iPlanet Application Server installation:


To Run the Typical Installer

  1. Enter 2 to select the Typical Installation type.

  2. Press Enter to accept the default installation directory: /usr/iplanet/ias6

    If you enter a different location, do not include spaces in the path name.


    Note You must have at least 400 MB available on this drive to install. All components are installed in this directory


  3. On the iPlanet Server Products Components panel, the default choice of [All] indicates which components are installed during a full installation of iPlanet Application Server. You may choose to:

    • Keep the default selection. If you choose [All], the sub-components of the selected components are listed in subsequent screens, so that you can further refine your choices.

    • Enter 1,3,4 to not install the Directory Suite component if you already have a directory service available.


      Note
      • The Directory Server Component should not be selected if you intend to install multiple instances of iPlanet Application Server. For more information, see "Installing Multiple Instances on Solaris".

      • 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.


    • Enter 1,2,4 to not install the Administration Services component if you don't want the iPlanet Administration Console.

    • Enter 4 to install only the iPlanet Application Server.

      The components selected here have multiple sub-components. Press Enter in each screen to accept the default sub-components.

  4. Press Enter in each subsequent screen to accept the default sub-components.

  5. Press Enter to accept the default name of the computer you are installing on.

  6. Type in the system user and group names.

    This user and group should be set up prior to running the installation program. Typically, this user and group should be the same as that which installed the web server.

    Specify a user that has no privileges elsewhere on the system to avoid access to restricted servers, such as the configuration Directory Server.

Within the iPlanet Application Server installation there are several panels pertaining to installing and configuring the Directory Suite. The Typical Installation Wizard panels set up the:

  • Administrator for the Configuration Directory Server

  • Administrator for the Directory Server directory data; this "superuser" is identified by the Directory Manager Distinguished Name (DN).

    These panels and their function are described in the following procedures.

  • Press Enter to register iPlanet Application Server's configuration information with the directory server instance that you are installing.

    The default choice is No, so that the Directory Server instance being installed currently is registered for use by iPlanet Application Server.

    Enter Yes if you want to specify an existing directory server to hold the configuration information. You must provide the fully qualified domain name (hostname.domain.com) and the port number of the directory server.


    Tip The Configuration Directory Server is the part of the Directory Server used to store configuration information. The Directory Server also stores directory data.


  • Press Enter to register iPlanet Application Server's data storage, such as user and group information, with the Directory Server instance installed with this installation of iPlanet Application Server.

    Enter Yes to register with an existing directory server. You will be prompted for the host, port, suffix, and bind DN to use for that directory server.

  • Press Enter to set the listener port for the Directory Server by default to the standard port number: 389. For more information, see "Configuring Port Numbers" on page 154, in Appendix A.

  • Press Enter to set the unique identifier for the Directory Server by default to the name of the computer it's being installed on.

    To enter a different name type the name and press Enter.

  • Assign the Administrator ID and password for the configuration directory.

    • Press Enter to accept default username as admin,or type in a username and press Enter.

    • Enter a password; it can contain letters and numbers.


      Note Record and keep the Configuration Directory Administrator ID and password for future reference. They are required to login to the iPlanet Administration Console and to uninstall the iPlanet Application Server and the Directory Server.


  • Enter the data information tree suffix for your organization.



    For example, if an organization uses the distinguished name service (DNS) of sales.sun.com, then a reasonable suffix for identifying that organizations' data is: dc=sales, dc=sun, dc=com.

  • Enter a distinguished name (DN) for the directory server's administrator. The default value is Directory Manager (cn=Directory Manager).

    Enter a password for the Directory Manager that is at least 8 characters long.

    The Directory Manager's Distinguished Name is the special directory entry for the administrator of the Directory Server. Access control does not apply to the Directory Manager.

  • Enter 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.

    As a Directory Server may store Configuration information for multiple domains, the Administration Domain is used to keep these separate. Enter an administration domain to use for keeping software configuration information stored in the Configuration Directory Server distinct from other such information.

    The Directory Server is now configured for installation.

  • Set the port number of the iPlanet Administration Console's administration server. By default it is set to a random unused port number between 1024 and 65535. For more information, see "Configuring Port Numbers" on page 154, in Appendix A.

  • Enter the name of the user who will have the privilege to write configuration information to the Directory Server using iPlanet Console. By default, this is set to: root

  • Enter the product key at the prompt.

    The Product Key is in the welcome letter you received with iPlanet Application Server. You must enter this number correctly for installation to continue.

  • Enter the full path of the Web server instance that is already installed and running.

    The iPlanet Application Server Web connector will be installed and configured to the Web Server instance that is identified here.

  • Enter the username and password to use for the iPlanet Application Server Administration Tool.


    Note Record the username and password. After installation, you'll need them to register iPlanet Application Server with the iPlanet Application Server Administration Tool.


  • Enter Y to enable standard Java internationalization for iPlanet Application Server applications, otherwise accept the default.

    The iPlanet Application Server installation is now ready to complete the installation.

  • Press Enter to start copying the installation files.

    Here, you may be prompted to change the ownership of iPlanet Application Server files if the owner and group are different.

    Type Y and press Enter if you want to change the group permission of iPlanet Application Server files to that of the user you are installing as. You must be the superuser or logged in as that user to change permissions.

    After all the files have been extracted, the installer generates a report of the port numbers assigned.


    Note Record or print the port number report as the port numbers are required to administer the iPlanet Application Server.


  • To start the iPlanet Administration Console, go to the installation directory and execute the command (printed at the end of the port number report):

    startconsole -a http://<servername>:<port_number>



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     DocHome     Next     
Copyright © 2001 Sun Microsystems, Inc. Some preexisting portions Copyright © 2001 Netscape Communications Corp. All rights reserved.

Last Updated November 22, 2001