Chapter 1   Installing iPlanet Application Server


This chapter explains how to install iPlanet Application Server (iAS). It includes the following topics:

• Preparing for Installation

• Running the Installation Wizard

• Verifying Installation of the Application Server

• Using the Sample Applications

• Uninstalling iPlanet Application Server

Read this chapter carefully before installing iAS on Windows NT.

Refer to for more information about configuring your application server during and after installation.

Preparing for Installation

---

Before you begin installing iAS, be sure your system meets the following requirements.

System Requirements

Table 0.1

Component	Requirement
Computer/Operating system	PC running Microsoft Windows NT version 4.0 with Service Pack 5 Sun SPARC running Solaris 2.6 or Solaris 8
Memory	Per CPU: 64 MB minimum; 128 MB recommended
Available disk space	Total disk space: 200 MB NT, 400 MB Solaris, 800 MB Solaris if installing both NetDynamics and iAS 6.0 CD-ROM drive
Pre-installed software	One of the following web servers - iPlanet Web Server 4.1 Apache 1.36 (NT only) Microsoft Internet Information Server 4.0 (NT only) iAS Directory Server 4.0 (optional) One of the following web browsers - Netscape Communicator 4.5 Microsoft Internet Explorer 4.0 (NT only) Database connectivity software (see the following table)

Table 0.2

Database Client	Database Server
Oracle 8.1.5	Oracle 8.05, 8i, 7.3.4
Sybase 11.1.1	Sybase 11.9.2, 12
DB2 5.2	DB2 5.2, 6.1
ODBC 3.51	Microsoft SQL Server 7
Informix 2.10	Informix Server 7.3, 9.1.4

Pre-Installation Notes

Review the following notes before installing iAS 6.0:

• You cannot upgrade from an earlier release or version of iAS. If you are installing on a machine that has an earlier release already on it, even an earlier release of iAS 6.0, you must uninstall the earlier release prior to installing the current iAS 6.0 release. Follow the uninstallation instructions of the earlier release.

• Only one instance of iAS should run per machine. You should not install multiple instances of iAS on the same machine. As an exception on Solaris only, you can install an instance of both NetDynamics and iAS 6.0 on the same machine.

• Install and configure the web server and web browser before installing iAS. Know the full path of the web server.

• Know whether your web server runs on the machine where you are about to install iAS or whether it resides on another machine. If it is on another machine, you perform what is referred to as a "webless" installation of iAS.

• If you are performing a webless installation of iAS, know the type of web server you have and remember to install the Web Connector plug-in on the web server after you finish installing iAS.

• Install and configure all database servers before installing iAS.

• Your machine's root password is required in the following instances:
  • if Directory Server binds to the default port 389

  • if you specify during installation that iAS automatically starts upon reboot

  • if the web server is on the same machine as iAS and web server files are owned by root

• You can find iPlanet Directory Server documentation in the following location:

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

Running the Installation Wizard

---

After you've checked system requirements and made sure a web server and web browser are installed on your system, choose one of the following options:

• Installing iAS on NT
  • Using the Custom Installation Wizard

• Installing iAS on Solaris
  • Using the Custom Installation Wizard

  • Using the Silent Installation Feature

Installing iAS on NT

You must be logged on to Windows NT as a user with administrator privileges to install iAS.

You can choose from three install types: Typical, Express and Custom.

Table 0.3

Typical Install	Installs iAS with the most common settings and copies the most commonly used files. This is the default setup option.
Express Install	Copies the fewest number of files and features needed to work with iAS.
Custom Install	Allows the user to determine which iAS features to enable.

The following table shows which dialog boxes are displayed for each type of installation. Use this table in conjunction with Using the Custom Installation Wizard instructions.

Dialog Box	Custom	Typical	Express
Welcome	X	X	X
Software License Agreement	X	X	X
Select Server or Console Installation By default, the Netscape Servers radio button is checked.	X	X	X
Installation Type By default, the Typical radio button is checked.	X	X	X
Location of Installation The default install directory is c:\iPlanet\iAS6.	X	X	X
Components to Install By default, the following components are selected: Netscape Server Family Core Components Netscape Directory Suite Administration Services iPlanet Application Server 6.0	X	X
Directory Server 4.0 - 1 The iPlanet Directory Suite is installed on the same machine as iAS by default. This Directory Server instance acts as a "Configuration Server" for the iAS.	X	X
Directory Server 4.0 - 2 The Configuration Server stores data such as user and group information by default.	X	X
Directory Server 4.0 Server Settings Enter the following Configuration Server details: Server Identifier - The default server identifier is the machine name where the installation will run. Server Port - The default server port for communication is 389. Suffix - The default suffix for the server is of the form o=domain-name, where domain-name is the DNS domain name for the machine.	X	X
Directory Server 4.0 Administrator Enter the Administrator user name and password for the Configuration Server. The default Administrator user name is "admin".	X	X	X
Directory Server 4.0 Administration Domain The administration domain for the Configuration Server is of the form domain-name where domain-name is the DNS domain name for the machine.	X	X
Directory Server 4.0 Directory Manager Settings A Directory Manager identifies an administrative user whose access privileges are needed during certain Directory Server operations. Enter Directory Manager details: Directory Manager Distinguished Name (DN) is of the form cn=Directory Manager. Password for the Directory Manager.	X	X	X
Configure server for replication	X
Populate Database	X
Disable Schema Checking	X
Admin IP	X
Administration Server Authentication Enter the Administrator user name and password for the Administration Server. The default Administrator user name is "admin".	X	X
Administration Server Port Selection Enter the communication port for the Administration Server.	X
Confirm Configuration Directory Server Information Validate the Configuration Server information entered so far before proceeding in the installation process.	X
Global Configuration Name The iAS configuration parameters are stored under the Global Configuration Name on the Configuration Server. The default global configuration name is iasconfig.	X
iPlanet Application Server 6.0 Product Key	X	X	X
Web Server Type Enter the web server type and the web server instance name in the format https-machine_name.domain_name for iWS 4.1.	X	X	X
Number of Java and C++ Servers Enter the number of Java and C++ Server you want to run on this machine. By default, one Java and one C++ Server is configured.	X
Port Selections Enter the Administration Port, Executive Port, and the specified number of Java and C++ server ports.	X
iAS Administration Server Authentication Enter the Administration user name and password used to access the Administration Server.	X	X	X
Database Client Selection Enter the priorities of various database clients. The database with priority of 1 is the default database client for iAS.	X
Transaction Manager - 1 Global transactions are enabled by default.	X
Transaction Manager - 2 The default mirror directory root is install directory\CCS0\TXNMGR_MIRROR.	X
Transaction Manager - 3 Enter the Transaction Manager details for each of the Java servers. The default log volume disk name is of the form install directory\CCS0\TXNMGR\ENGn\logvol.	X
Resource Manager The Resource Manager must be configured to have database connectivity from within the iAS applications. Optionally, you can later run the DBSetup.Exe program from install directory\ias\bin to setup database connectivity.	X
Resource Manager Details Enter the Resource Manager details if you choose to set up Resource Manager during Custom Install.	X
Enable I18N Support	X	X
Cluster Configuration By default, iAS is not a part of a DSync Cluster.	X
Cluster Options If you choose to configure iAS as part of a DSync Cluster, enter the following details: The type of DSync server this iAS will be; either Sync Server or Sync Local. The number of servers in the cluster.	X
Sync Server Candidate for Cluster Enter details for the DSync server: The IP Address for DSync server The Executive server port The priority of this candidate	X
Configuration Summary	X

Using the Custom Installation Wizard

The following procedure describes how to install iAS using the Custom installation option:

1. Insert the iAS Install CD-ROM into the CD-ROM drive.

2. Click Start on the Windows NT taskbar and click Run, or choose File - Run from the Windows NT Program Manager and click the Run button.

3. Click Browse and go to the CD-ROM drive (for example, d:\).

4. Open the NT folder and run the file setup.exe.

5. Follow the instructions of the installation program.

6. When prompted to select Server or Console installation, click iPlanet Servers as shown in the following figure:

   
   
   

   This gives you the choice to install iPlanet Application Server, iPlanet Directory Server, Netscape Console, iPlanet Application Server Administration tool, and the Web connector plug-in. (Selecting Netscape Console installs Console as a stand-alone application.)

7. When prompted for the installation type, click Custom.

   
   
   

8. Select the installation directory as shown in the following figure:

   
   
   

   The default directory is c:\iPlanet\iAS6. Note that if you use the default, iPlanet Application Server is installed in c:\iPlanet\iAS6. You cannot use a directory name that includes spaces.

   Click Next.

9. To install iAS along with Directory Server, be sure the default selections are checked as shown in the following figure:

   
   
   

   • iPlanet Server Family Core Components

   • iPlanet Directory Suite

   • Administration Services

   • iPlanet Application Server 6.0

   Although iPlanet Directory Server 4.0 Synch Service is listed on the screen, do not select this component.

   Click Next.

10. Choose "This instance will be the configuration directory server" as shown in the following figure if you are installing Directory Server with this instance of iAS.

    
    
    

    Otherwise, choose "Use existing configuration directory server" and enter the settings to be used by the Directory Server:

    • Host name of the machine in Server Identifier

    • Server Port number

    • Bind As

    • Password

11. Choose "Store data in this directory server" as shown in the following figure if you are installing Directory Server with this instance of iAS.

    
    
    

    Otherwise, choose "Store data to existing Directory Server" and enter the following:

    • Host

    • Port

    • Bind As

    • Password

    • Suffix

12. Enter the following Directory Server settings:
    • Server Identification

    • Port number

    • Suffix

13. Enter the Administrator ID and password to the configuration directory as shown in the following figure:

    
    
    

    Important: This is the Administrator ID and password required to uninstall iAS and Directory Server.

    Make a note of this information, as you will need it if you uninstall either of these products.

14. Enter the name of the Administration Domain where iPlanet software information is stored on Directory Server as shown in the following figure:

    
    
    

15. Enter the Directory Manager distinguished name (DN) and password as shown in the following figure:

    
    
    

    The default value for the distinguished name is cn=Directory Manager.

16. Choose the supplier and consumer replication settings as shown in the following figure:

    
    
    

    For more information about consumer and supplier replication, see iPlanet Directory Server documentation:

    http://docs.iplanet.com/docs/manuals/directory.html#dirserver

17. Specify if you want to populate the directory server with commonly used entries to help you get started by checking the checkbox as shown in the following figure. Then decide if you want to populate the database by selecting the appropriate radio button as shown:

    
    
    

    For more information about populating the iPlanet Directory Server database, see Directory Server documentation:

    http://docs.iplanet.com/docs/manuals/directory.html#dirserver

18. Decide whether or not to enable schema checking for your directory server by selecting or deselecting the checkbox as shown in the following figure:

    
    
    

    For more information about installing and configuring Directory Server, see the Directory Server documentation:

    http://docs.iplanet.com/docs/manuals/directory.html#dirserver

19. (Optional) Enter a specific IP address to bind to your Administration Server.

    
    
    

20. When prompted for the Administration Server user ID and password, enter the user ID and password that will be required to log on to the Administration Server through the administration tool (iAS Administration tool).

    Make sure this user ID and password account has been created in Directory Server.

    
    
    

21. Enter the port number for the Directory Server Administration Server as shown in the following figure:

    
    
    

    This is required for using the Console to administer the Directory Server.

22. Confirm the Directory Server information and enter a Directory Server manager password as shown in the following figure:

    
    
    

23. Enter the unique global configuration name of the configuration settings for this installation of iAS as shown in the following figure:

    
    
    

    The name you assign is stored on the configuration Directory Server, under the o=iPlanetRoot tree along with the global configuration names of other iAS installations.

24. Enter the product key of iAS as shown in the following figure:

    
    
    

25. When prompted for the type of web server to be used with this installation of iAS, click one of the supported web server types and, if you clicked iPlanet Web Server, enter the web server instance name in the format https-macine_name.domain_name for iWS 4.1:

    
    
    

26. If you are using a web server other than IIS or iWS, or performing a webless install, enter the doc and cgi-bin directories.

27. Enter the number of Java Servers (KJS) and C++ Servers (KCS) used to process applications as shown in the following figure:

    
    
    

    The default values are 1; increase this to handle high processing loads.

28. Enter the port numbers for the Administrative Server (KAS), the Executive Server (KXS), the Java Servers (KJS), and C++ Servers (KCS) as shown in the following figure:

    
    
    

    All port numbers you specify are for listener ports must be within the acceptable range (1 to 65535), and must be unique (not used by any other applications on your system).

    Note: If the port number is already in use, make sure you change the value to a unique port number. Otherwise, the service you are assigning a port number to will not start up when you run iAS.

29. Rank the installed databases in priority order as shown in the following figure:

    
    
    

    The installation program lists all supported database client types. The clients are required for your applications to connect to your database back ends. You must rank the clients in order of connectivity priority, whether you've installed the clients or not. You can always install the client software after running the iAS installation program. Note that sample applications are configured for the highest priority database.

30. Specify if the server will have global transactions:

    
    
    

31. If you specified Yes, enter the mirror directory path where the transaction manager restart.bak file for each KJS engine process gets stored:

    
    
    

    The default disk drive is the drive on which you are installing iAS. It is strongly recommended that you specify a path on a separate disk drive. If you do, make sure you create the directory on that drive, prior to running the installation program.

32. Enter the log volume disk name where the transaction manager log file gets stored for each Java Server as shown in the following figure:

    
    
    

    It is strongly recommended that you create a raw partition on disk prior to running the installation program and that you specify the name of the raw device here.

    Indicate if the specified disk name is a raw partition.

    If the log volume is a raw partition, indicate the number of pages (Size) in the raw partition and the starting page number (the Offset value). Make sure that the size allocated for the log file is greater than 4 MB; in other words, the file should be greater than or equal to 1000 pages, at a size of roughly 4 KB per page.

33. Indicate whether or not you want to configure iAS with resource manager and specify the number of resource managers you want to use as shown in the following figure:

    
    
    

34. If you indicate Yes, specify the following information for each resource manager:
    • Resource manager name (user-defined)

    • Database type

    • Datasource

    • User name for the data source

    • Password for the data source

    • Resource manager recovery GUID

    • Open string

    • Whether or not the resource manager is enabled.

      
      
      

35. Specify if you want to enable I18N support as shown in the following figure:

    
    
    

    Enabling I18N support allows multi-lingual applications to be deployed to iAS.

36. When prompted whether the server will synchronize data across servers, click Yes if you intend to synchronize session and state information across multiple servers for failover and fault tolerance, then enter the name of the cluster that this instance of iAS participates in as shown:

    
    
    

37. Indicate if you are currently installing a Sync Server or a Sync Local. If you are installing a Sync Local, then this server will use data synchronization services, but is not eligible to become a Sync Primary or the Sync Backup. Then enter the total number of Sync Servers that you plan to have in the cluster as shown in the following figure:

    
    
    

38. For each Sync Server in the cluster, specify the following information:
    • IP address

    • Executive Server port number

    • Priority rating

      
      
      

39. Choose which Sync Server has the highest priority for taking over as Sync Primary and rate all other servers in the cluster in order of priority.

40. Review the summary provided by the installation program of the configuration you have selected.

41. When the installation is complete, reboot the computer so that the new settings take effect.

Installing iAS on Solaris

You can choose from three installation types: custom, typical, and express. The following table shows which questions are asked for each type of installation. Use the table in conjunction with Using the Custom Installation Wizard.

For information on silent installation, see Using the Silent Installation Feature.

Table 0.5

Dialog Box	Custom	Typical	Express
Welcome	X	X	X
Software License Agreement	X	X	X
Installation Type	X	X	X
Select Server or Console Installation	X	X	X
Location of Installation The default install directory is c:\iPlanet\iAS6.	X	X	X
Components to Install Components with a number in () contain additional subcomponents which you can select using subsequent screens. iPlanet Server Family Core Components (3) iPlanet Directory Suite (2) Administration Services (2) iPlanet Application Server 6.0 (4)	X	X
iPlanet Server Family Core Components components. Specify the components you wish to install.	X
iPlanet Directory Suite Components Specify the components you wish to install	X
Administration Services components Specify the components you wish to install.	X
iPlanet Application Server Suite components. Specify the components you wish to install.	X
System User	X	X	X
System Group	X	X	X
Do you want to register this software with an existing iPlanet configuration directory server?	X	X
Do you want to use another directory server to store your data?	X	X
Directory Server Network Port	X	X
Directory Server Identifier	X	X
iPlanet configuration directory server administrator ID	X	X	X
Password	X	X	X
The suffix is the root of your directory tree.	X	X
Directory Manager DN	X`	X	X
Password	X	X	X
Administration Domain	X	X
Administration Port	X	X
Run Administration Server as [xxxxx]	X	X
Enter HOSTNAME for this machine	X
Do you want to use the Directory Server installed locally in /export/machine_name/test to connect to iAS ?	X
Please provide a name for your iAS global configuration parameters	X
Product Key	X	X	X
Enter the FULL PATH of the Web Server Instance to be used. For example: /usr/ns-home/https-my_web_server	X	X	X
Configuring the Web Server Press ENTER to continue.	X
Port number for iAS Administration server (KAS)	X
Port number for Executive Server (KXS) to iAS communication	X
Port number for CGI to KXS communication	X
Enter the number (0-32) of Java Servers (KJS) to install.	X
Port number for Java Server (KJS) 1 to KXS communication	X
Enter the number (0-32) of C++ Servers (KCS) to install.	X
Port number for C++ Server (KCS) 1 to KXS communication	X
Access to the Administration Server using the iPlanet Application Server Administration tool is password-protected. When you access the Administration Server, you will be prompted for the user name and password.	X	X	X
Password	X	X	X
Configure Transaction Manager	X
Enter the full path name for MirrorDirectoryRoot	X
Enter the full path name for the next LogVolumeDiskName	X
Cluster Configuration for Data Synchronization Will this server participate in DSync ?	X
For iAS to participate in DSync, it must be a member of a cluster. Enter the name of the Cluster this iAS will be a member of.	X
Servers that participate in data synchronization fit into two categories : 1. Sync Server : A Sync Server is the principal data store of a cluster and can assume the responsibility for distributing data to all the other iAS in the cluster. 2. Sync Local : A Sync Local is a iAS that participates in data synchronization but can never assume the responsibility for distributing data to all the other iAS in the cluster.	X
Gather information to configure DSync Server candidate # 2 Enter the IP address	X
Enter the port number of the Executive Server (KXS) to iAS communication for the iAS installed on DSync Server # 2.	X
Indicate if you want to run iAS at the system startup.	X
Finished with gathering of information. Press ENTER to continue:	X	X	X

Using the Custom Installation Wizard

The following procedure describes how to install iAS using the Custom installation option:

1. Insert the iAS Install CD-ROM into the CD-ROM drive.

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

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

   /cdrom/cdrom0/solaris/setup

4. Follow the instructions of the installation program.

   During installation, press:

   CTL+B to back up to the previous screen within an installation section. An installation section is defined by the title at the top of the screen. For example, "iPlanet Server Products," "iPlanet Directory," and "Application" are names of sections within the installation program. You cannot use CTL+B to go back to a screen in a different section than the one you are currently in.

   CTL+C if you need to exit the installation. This results in an incomplete installation. If you want to install again, you must run the installation program from the beginning.

5. When prompted, press Enter or specify 1 to select "iPlanet Servers" as the item to install.

6. Specify the type of installation:

   1 = Custom: for advanced users

   2 = Typical: for most users

   3 = Express: for users new to iAS

7. Specify a target installation directory as the base directory within which all components are installed. Do not include spaces in the path name. Default directory is /usr/iPlanet/iAS6.

8. When prompted for the components you want to install, to install iAS along with Directory Server, press Enter. This selects all of the following components.
   • iPlanet Server Family Core Components

   • iPlanet Directory Suite

   • Administration Services

   • iPlanet Application Server 6.0

9. When prompted to install the iPlanet Server Family Core Components, press Enter to select all of the components listed.

10. When prompted to install the Directory Suite components, press Enter to select all of the components listed.

11. When prompted to install the Administration Services components, press Enter to select all of the components listed.

12. When prompted to install iAS components, press Enter if you want to install all the listed components.

13. When prompted to install iPlanet Web Connector Plug-in components, press Enter if you want to install all the listed components.

14. Specify the domain name of your machine. Press Enter to accept the default value provided here by the installation program.

15. Specify the Unix user and group name under which your iAS and Directory Server installations will run.

    You should have already set up this user and group prior to running the installation program. Specify a user that has no privileges elsewhere on the system, so as to avoid access to restricted servers, such as the configuration Directory Server, from iAS.

16. Specify this Directory Server as the configuration Directory Server. Only specify an existing Directory Server as the configuration Directory Server if you are not installing Directory Server with this installation of iAS.

17. Specify this Directory Server as the storage server. Only specify an existing Directory Server as the storage server if you are not installing Directory Server with this installation of iAS.

18. Enter the port number to be used by the Directory Server you are installing. The default value is 389 if you install as root, otherwise, the default value will be a random port number which is available on the system.

19. When prompted for the Directory Server identifier, enter the host name of the Directory Server machine.

20. Enter the administrator ID and password for the configuration Directory Server.

    Important: This is the Administrator ID and password required to uninstall iAS and Directory Server.

    Make a note of this information, as you will need it if you uninstall either of these products.

21. When prompted for the suffix, enter the top level domain name.

22. Enter the Directory Manager distinguished name (DN) and password. The default value for the distinguished name is cn=Directory Manager.

23. Enter the name of the Administration Domain where iPlanet software information is stored on Directory Server.

24. Enter the port number for the Directory Server Administration Server. This is required for using the Console to administer the Directory Server.

25. Confirm the user which the Administration Server will run as.

26. Enter the host name of the current machine on which you are installing iAS.

27. Indicate that you want iAS to be configured with this Directory Server.

28. Enter the unique global configuration name of the configuration settings for this installation of iAS. The name you assign is stored on the configuration Directory Server, under the o=iPlanetRoot tree along with the global configuration names of other iAS installations.

29. Enter the product key of iAS. The product key is available in the Welcome letter you received with the product.

30. Enter the full path of the web server.

31. When prompted, enter port numbers for the Administrative Server (KAS), the Executive Server (KXS), and the web server (CGI to KXS).

    All port numbers you specify are for listener ports, must be within the acceptable range (1025 to 32768), and must be unique (not used by any other services on your system). In most cases, the default port numbers supplied by the installation program are adequate.

32. Enter the number of Java Servers (KJS) that you intend to use to process applications with this installation of iAS, and the port number(s) for the Java Server(s).

    All Java Server port numbers you specify are for listener ports and must be within the acceptable range of 1025 to 32768. Port numbers must be unique (not used by any other services on your system). In most cases, the default port numbers supplied by the installation program are adequate.

33. Enter the number of C++ Servers (KCS) that you intend to use to process applications with this installation of iAS, and the port number(s) for the C++ Server(s).

    All C++ port numbers you specify are for listener ports and must be within the acceptable range of 1025 to 32768. Port numbers must be unique (not used by any other services on your system). In most cases, the default port numbers supplied by the installation program are adequate.

34. When prompted for the Server Administrator user name and password, enter the user name and password to log on to the iAS Administration tool.

35. Provide all the necessary database connectivity information.

    The installation program lists the database clients supported by iAS. The clients are required for your iAS applications to process data. You must indicate if you want to configure this instance of iAS to connect with each of the supported database clients. For each client that you specify Yes, you must provide the installation program with the client's home directory and library name.

36. If you specified at least one database, rank the installed databases in priority order. Specify the top priority database first. (If you only specified one database, then list that one here as the top priority database).

37. Enter the mirror directory path where the transaction manager restart.bak file of each KJS process gets stored.

    The default directory is iAS install directory/CCS0/TXNMGR_MIRROR/. This is the same path that is used to store the restart file. It is recommended that you store restart.bak in a different location than restart. Consider using a pointer to the different physical disk drive.

38. For each Java Server specified, provide the following information:
    • Log volume disk name where the transaction manager log file gets stored. The default name is iAS install directory/CCS0/TXNMGR/ENGnumber, where number represents the KJS engine process number.

    • Whether or not the log volume disk is a raw partition. If you specify Yes, make sure that the name you enter here is that of a raw device.

    • If the log volume disk is a raw partition, indicate the number of pages (Size) in the raw partition and the starting page number (the Offset value). Make sure that the size allocated for the log file is greater than 4 MB; in other words, the file should be greater than or equal to 1000 pages, at a size of 4 KB per page.

39. When prompted, indicate if you want to enable resource manger.

40. If you answer Yes, specify the number of resource managers you want to enable.

41. If you answer Yes, specify the following information for each resource manager:
    • User-defined resource manager name

    • Database type

    • Open string

    • Whether or not the resource manager is enabled

42. When prompted whether the server will synchronize data across servers (Dsync), specify Yes if you intend to synchronize session and state information across multiple servers for failover and fault tolerance.

43. If you answered yes, when prompted for the cluster name, enter the name of the cluster where this instance of iAS belongs.

    The cluster you specify may already exist, or this installation of iAS may be the first server assigned to the cluster.

44. If you answered yes, indicate if this instance of iAS is a Sync Server or a Sync Local.

45. If you answered yes, for each Sync Server in the cluster, specify the following information:
    • IP address

    • Sync Server priority-You are asked to start by specifying the highest priority Sync Server in the cluster, that is, the server that is first in line to take over for the Sync Primary if it fails. Next, you are asked to specify the next highest priority Sync Server, and so on, until you have ranked all the Sync Servers.

46. If you answered yes, for each installation of iAS within the cluster you specified, specify the same set of IP addresses and port numbers. The addresses and port number configurations must match across installations for the cluster to function properly.

47. If you answered yes, specify the number of Sync Backup servers that should be active while the cluster is running.

48. Press Enter to continue.

49. Indicate whether or not you want to run iAS automatically when you reboot the machine.

    You can only complete this step if you are logged on as root.

After using Typical or Express installation, you can configure your database connection and resource manager by going to $iAS_home/bin and running db_setup.sh.

Using the Silent Installation Feature

Silent installation allows you to install iAS on multiple Solaris machines without running the installation program more than once. For instance, to install iAS on three machines, run the installation program on the first machine as described in Installing iAS on Solaris, using setup -k as described below. Then use silent installation to install iAS on two additional machines by running just one command.

To use silent installation on Solaris, perform the following steps:

1. Run the following command on the first Solaris machine:

   setup -k

2. Proceed with the installation program. See Installing iAS on Solaris.

   An install.inf file is generated in the install directory/setup directory. In addition, a log file, userinput.log, is generated in the install directory/ias directory. This file contains all input entered during the installation procedure.

3. Once you have completed the installation process, copy install.inf and userinput.log and add them to the /tmp directory of a second system.

4. Modify the copies of install.inf and userinput.log, making the following changes:

   For install.inf, change the values for the following keys by entering the machine name and IP address of the machine where you are silently installing iAS:

   • FullMachineName

   • ConfigDirectoryLdapURL

   • UserDirectoryLdapURL

   • ServerIdentifier

   • ServerIpAddres

   For userinput.log, change the following keys by entering the machine name and IP address of the machine where you are silently installing iAS:

   • LDAP_Hostname

   • LDAP_ServerIdentifier

   • LocalHostName

   • NSRootDir

   • CLUSTERNAME

   • nsinst

   • LocalIPAddress

   Finally, fill in the value of LDAP_RootDNPwd by entering the password for the directory manager.

5. Run the following command on the second system to begin silent installation:

   setup -s -f <full path>/install.inf

   This will perform an installation with exactly the same setup as the first system.

Verifying Installation of the Application Server

---

You can use a pre-installed application to verify that iAS is running. Since this basic application, which uses servlets and JSPs, does not rely on a backend database, it runs without any post-installation setup.

To verify installation, perform the following steps:

1. Open your browser and enter the following URL:

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

2. Press Enter.

3. Click the Test Connectivity to iAS link to run a basic application. Press shift the shift key and click on the browser's Reload button to ensure the application repeatedly returns a new HTML stream.

Installing the Web Connector Plug-in

---

The Web Connector plug-in passes requests from your web server to applications on iAS.

If you install iAS on a different machine than where the web server resides, you are configuring what is referred to as a "webless installation" of iAS. If this is the case, you must install the iAS Web Connector plug-in on the web server machine.

Before you install the Web Connector plug-in, do the following:

1. Check whether or not the iAS 6.0 Web Connector plug-in has already been installed. If it has, the web server instance is already configured for iAS and you do not need to re-install the plug-in.

2. Stop running your web server instance.

3. On Solaris, log on as the root user, or as a user from the same group as the root user, who installed iAS before installing the Web Connector plug-in

   On NT, you must be logged on as an administrator before installing the iAS Web Connector plug-in.

This procedure assumes that you have already installed iAS and Directory Server.

To install the Web Connector plug-in, perform the following steps:

1. After you finish installing iAS as a webless installation, take the installation CD-ROM to the machine or machines that host the web server.

2. Run the installation program as described Running the Installation Wizard.

3. Follow the instructions of the installation program.

4. When prompted, select "iPlanet Servers" as an installation.

5. Specify the installation type "Typical."

6. Specify a target installation directory. Do not include spaces in the path name.

7. When prompted for the components you want to install, select an iAS-only installation.

8. When prompted to install the iAS components, select the iAS Web Connector Component.

9. Follow the instructions of the installation program. See the Administration and Deployment Guide for more information.

10. On NT, when the installation program finishes running, reboot the web server machine.

Using the Sample Applications

---

To use the sample applications, perform the following steps:

1. Start running iAS.

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

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

3. Select the iAS 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.

To better understand specific technology features provided by iAS, select the iAS Technology Samples.

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

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

iAS Installation Path/ias/ias-samples/

There you can also find compile scripts that help you experiment with the sample code.

Uninstalling iPlanet Application Server

---

When uninstalling iAS, use the procedure described in this section. Do not uninstall iAS by deleting directories or modifying parameters in the registry.

This procedure is for uninstalling iAS and its subcomponents only. If you installed Directory Server along with iAS, other servers may also have since been configured with that Directory Server. Uninstalling the Directory Server could cause problems for these other servers. Therefore, you should not uninstall Directory Server with iAS, unless you are absolutely certain that the only system configured with this installation of Directory Server is the iAS you are uninstalling.

The following directories remain after you uninstall iAS:

• iAS root directory

• Any custom directories you created under the iAS directory (on NT)

• The install directory/APPS directory, which is moved by the uninstallation program to install directory/ias_APPS/ (on Solaris) and install directory\APPS \ (on NT)

After uninstalling iAS, decide if you want to remove these directories, particularly the custom and APPS directories which may contain applications you've developed and files you wish to keep.

Before running the iAS uninstallation program, make sure that Directory Server is running. Do not uninstall Directory Server before you uninstall iAS.

During the uninstallation process, you are prompted to provide a user name and password with administrator access to the configuration Directory Server. If you do not want to use the user name and password you entered at the beginning of the installation process, enter another user name and password, as long as it has administrator privileges on the configuration Directory Server.

On Solaris, the uninstall program overwrites the web server configuration file (obj.conf) with a version of the same file that existed before you installed iAS and the Web Connector plug-in. Therefore, all changes you made to the web server's obj.conf file after installing iAS and the Web Connector plug-in are lost.

For Solaris:

1. From the iPlanet installation directory (the default is /usr/iPlanet/iAS6), type uninstall and press Enter.

2. Follow the uninstall instructions.

3. Specify the components you want to uninstall.

4. Enter a user ID and password that has administrator privileges on the configuration Directory Server. If you do not want to use the user name and password you entered at the beginning of the installation process enter another user name and password, as long as it has administrator privileges on the configuration Directory Server.

For NT:

1. Click the Uninstall icon in the iPlanet Application Server 6.0 program group.

2. Follow the uninstall instructions.

3. Choose the components you wish to uninstall.

   Note: During the uninstall of iAS, you may be prompted by the following message to remove some shared libraries:

   "Setup has determined that this is a shared file, but it is not being used by any other applications. Do you want to remove this file?"

   Select "No to All" to indicate that you do not want to remove the shared libraries.

4. When prompted, enter a user name and password with administrator access to the configuration Directory Server. If you do not want to use the user name and password you entered at the beginning of the installation process, enter another user name and password, as long as it has administrator privileges on the configuration Directory Server.

5. Re-enter the configuration Directory Server information you entered in Step 4.