Previous     Contents     Index     Next     
iPlanet Application Server Installation Guide



Chapter 3   Easy iPlanet Application Server Installations on Solaris


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


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-1    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-2   

    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  

    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. iPlanet Application Server 6.0 SP2b is available on the product CD.

    You can also download iPlanet Web Server, Enterprise Edition 4.1 Spa7 or later, or 6.0 SP1 or later, 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 51.


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.



    You should have already set up this user and group 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.

  7. The installer will now check your Solaris system for the essential patches required for your version of Solaris.

    For installation to succeed, and for the proper functioning of the application server, certain patches must be installed in your system. These required patches are listed in the Release Notes,which is available at http://docs.iplanet.com/docs/manuals/ias.htm. The list of required patches is also available in Chapter 2, "Preparing to Install", in iPlanet Application Server Installation Guide.

    If any of these mandatory patches are missing, the installer will generate a temporary file containing the missing patches. You will see the following message in your console:



If you get this message, you must apply the missing patches and reboot your system, and then reinstall iPlanet Application Server.

If all the required patches are already installed, then the installation will proceed with the following steps.


Configuring Directory Server

Within the iPlanet Application Server installation there are several panels having to do with installing and configuring the Directory Suite.


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.


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 147, 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 147, 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     Next     
Copyright © 2002 Sun Microsystems, Inc. All rights reserved.

Last Updated March 12, 2002