Previous Contents Index DocHome Next |
iPlanet Application Server Installation Guide |
Chapter 4 Advanced Installations for Solaris
This chapter describes the advanced installation options to install and configure iPlanetTM Application Server for the SolarisTM platform. It contains the following information:
What You're Installing
Check the Release Notes for any updates to these instructions at:Using the Solaris Custom Installer
Verifying Installation of the Application Server
http://docs.iplanet.com/docs/manuals/ias.html
Note Before you start iPlanet Application Server installation, make sure that you are running a Solaris 2.6 or Solaris 8 system.
What You're Installing
The software you're installing for iPlanet Application Server, actually consists of a group or stack of components, including:
iPlanet Directory Server, Enterprise Edition 5.0 SP1
See Chapter 1 "Getting Started," for an overview of iPlanet Application Server features and components.iPlanet Administration Console, which has its own Administration Server
iPlanet Application Server and its subcomponents:
Note In addition to these components, Custom Installation allows you to install database clients, proprietary Type 2 iPlanet Application Server Database Drivers, and Type 3 JDBC drivers.
Using the Solaris Custom Installer
This section explains how to install iPlanet Application Server on the Solaris platform using the custom set up procedure. It includes the following topics:
Starting Solaris Installation
To Begin the Custom Installation
To Configure the Directory Server
To Configure iPlanet Application Servers
To Configure Database Connectivity
To Install iPlanet Application Server Clusters
To Configure Clusters for Data Synchronization
Note You can configure your database connections effectively after installation by running the database setup tool, db_setup.sh, which is found in: <iASInstallDir>/bin.
Starting Solaris Installation
Before you begin installing iPlanet Application Server, meet the Minimum System Requirements and Prerequisites for Installation, as given in "Chapter 2 "Preparing to Install".
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.1 SP7 from: http://www.iplanet.com/downloads/download/
When installing iPlanet Application Server 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.
To Begin the Custom Installation
Login as root.
Within the iPlanet Application Server installation there are several panels having to do with installing and configuring the Directory Suite.Insert the product CD in the CD-ROM drive.
Mount the CD-ROM on, for example, /cdrom/cdrom0
At the shell prompt, run the following command:
Press Enter.
- /cdrom/cdrom0/solaris/iAS
- If you have downloaded the tar file, untar the file and type:
- ./setup
- The Tips screen appears.
You must enter Y to continue.
- The License Agreement screen appears.
Press enter to accept the default; install the iPlanet Servers group unless you select the iPlanet Console instead.
Enter 3 to select the Custom Installation type.
- If you select iPlanet Console (formerly Netscape Console), the iPlanet Administration Console is installed as a standalone application, which can be used from any machine to administer your iPlanet Application Server configuration.
Enter the installation directory. The default iPlanet Application Server installation directory location is: /usr/iplanet/ias6
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:
- If you enter a different location, do not include spaces in the path name. All components are installed in this base directory
Note You must have at least 400 MB free space available on this drive to install iPlanet Application Server.
Keep the default selection (All).
Press Enter in each subsequent screen to accept the default sub-components.
Enter 1,3,4 to not install the Directory Suite component if you already have a directory service available.
- If you choose [All], the sub-components of the selected components are listed in subsequent screens, so that you can further refine your choices.
Note The Directory Suite Component should not be selected if you intend to install multiple instances of iPlanet Application Server. See "Installing Multiple Instances on Solaris" for more information.
Enter 1,2,4 to not install the Administration Services component if you don't want to install 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.
Press Enter to accept the default name of the computer you are installing on.
Enter the system user and system group names.
- 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.
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.
To Configure the Directory Server
The Custom Installation Wizard panels set up the following:
Directory Server
The Directory Server is now configured for installation. Next, you will configure the port numbers and the number of Java and C++ servers.Registers the Directory Server's data tree by indicating what the Directory Server stores:
Sets up following administrators:
Records general settings for the Directory server's
Sets Administrative Domain boundaries for the Directory Server
Note For information about installing the Directory Server, see the iPlanet Directory Server Installation Guide at:
Press Enter to accept the default and register this Directory Server as the configuration Directory Server.
If you are not installing the configuration Directory Server included in this installation, specify an existing Directory Server and provide its fully qualified domain name (hostname.domain.com), and port number.
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 accept this Directory Server instance as the general directory data storage server.
Press Enter to accept the default directory server port number of 389.
- If you have an existing Directory Server already installed on your system for this purpose, specify it. You will have to provide the fully qualified domain name, port number, the data information tree suffix, and the user directory admin (typically cn=Directory Manager) and password.
Press Enter to set the unique identifier for the Directory Server by default to the name of the computer it's being installed on.
- If you are not logged in as root, the default value is a random number generated by the installer, which is greater than 1024.
Assign the Administrator ID and password for the Configuration Directory Server.
- To enter a different name, type in the name and press Enter.
Press Enter to accept default username as admin, or type in a username and press Enter.
Enter the data information tree suffix for your organization.Enter a password; it can contain letters and numbers.
Enter a distinguished name (DN) for the directory server's administrator. The default value is Directory Manager (cn=Directory Manager).
- 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 the directory server's Administration Domain.
- 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 Y to configure this Directory Server installation for replication; otherwise accept the default choice.
- If your installation has multiple domains setup for this Directory Server, enter a unique domain name here, otherwise keep the default entry. 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. Enter an administration domain to use for keeping software configuration information stored in the Configuration Directory Server distinct from other such information.
Enter Y to enter sample directory data or accept the default.
- Replication is used to duplicate all or part of a directory server to another directory server to provide a fail-safe setup.
- A server that holds a replica that is copied to a replica on a different server is called a supplier. A server that holds a replica that is copied from a different server is called a consumer. For more information on replication concepts, see iPlanet Directory Server Deployment Guide.
- http://docs.iplanet.com/docs/manuals/directory.html#dirserver
Enter the full path and filename of a file in LDIF format to populate the directory with your custom database, or Enter suggest at the prompt to add sample entries to the Directory Server.
Press Enter to enable schema checking for an imported database.
- Disable schema checking if you are going to import an old database immediately after or during installation, and you think you may have problems with it. If you choose to do this, schema checking will remain off
until you manually turn it back on.
- We recommend that you turn it back on as soon as possible.
To Configure iPlanet Application Servers
Press Enter to accept the default port number for the administration server, or type in a different port number.
Next up are configuration options to setup third party JDBC database drivers. You can also configure them after installation by running the db_setup.sh utility.
The Administration Server is separate from any of your application servers since it listens to a different port and access to it is restricted.Enter the IP address of the machine you want the Administration Server to bind to.
Press Enter to enable "root" user access to the Administration Server.
- By default, the IP address is that of the current host.
Enter Y if you want the locally installed Directory Server to be the instance which connects to the iPlanet Application Server.
Press Enter to accept the default global configuration name or type a unique name for this installation of iPlanet Application Server.
- Depending on the configuration you are currently installing you may or may not want the locally installed Directory Server to be the instance which connects to iPlanet Application Server.
Enter the product key.
- This name is stored on the configuration Directory Server, under the o=NetscapeRoot tree, along with global configuration names of any other iPlanet Application Server installations.
Enter the full path of your Web Server instance.
- The Product Key is in the welcome letter you received with iPlanet Application Server. You must enter this number correctly for installation to continue.
Press Enter to accept the default listener port numbers.
- No default is provided.
Press Enter to install one Java Server (KJS).
- Listener ports must be within the acceptable range (1025 to 32768), and must be unique (not used by any other services on your system).
Press Enter to install one C++ Server (KCS).
- If you intend to use more than one, enter the number and their default port number(s), or type different port numbers.
- All Java Server port numbers are 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).
Enter the username and password to use for the iPlanet Application Server Administration Tool.
- If you intend to use more than one C++ server, enter the number and their default port number(s).
- All C++ port numbers are 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).
Note Record the username and password. After installation, you'll need them to register iPlanet Application Server with the iPlanet Application Server Administration Tool.
iPlanet Application Server supports iPlanet Type 2 JDBC drivers and third party JDBC database drivers.
To Configure Database Connectivity
This section includes procedures on setting up the database clients, Third party JDBC drivers, the Transaction Manager, and the Resource Manager.
Press Enter to install iPlanet Type 2 JDBC drivers by default, or 2 to install Third Party JDBC drivers, or enter 3 for none.
- We recommend that you use the third party JDBC drivers, since the proprietary iPlanet Type 2 JDBC drivers are to be deprecated in the next major release.
To Set Up Third Party JDBC Drivers
Enter the number of Third Party JDBC drivers you need.
For each Third Party JDBC driver, enter the driver name, driver class name, and driver CLASSPATH. Follow the formats in the wizard examples. For more details, see "Preparing to Configure Third Party JDBC Drivers".
- The Third Party Native Driver Directory is required for Type 2 drivers only.
Note PointBase database server and its third party JDBC driver is automatically registered with the Administration Server. It also populates the sample databases of e-Store, J2EEGuide, Database, and Bank sample applications.
After installation you must register the datasource for the third party JDBC drivers. For more information, see "Configuring JDBC Datasources for Your Applications".
To Configure Type 2 Database Connectivity
The installation program lists the database clients supported by iPlanet Application Server. These clients are required for Type 2 connectivity.
Indicate if you want to configure this instance of iPlanet Application Server to connect with each of the supported database clients. For each client that you specify "Yes," provide the specified information for that client:
Oracle
Type Y (Yes) or N (No) to indicate whether or not to configure iPlanet Application Server for communication with Oracle, Sybase, Informix, and IBM DB2.Sybase:
Informix:
DB2:
Rank each database according to its priority for your application's data lookup needs.
- This enables you to write applications without specifying what database to use.
To Configure the Transaction Manager
The restart backup file for managing transactions, in case of engine failure, should be stored in a directory on a separate drive from the iPlanet Application Server installation directory. This needs to be setup prior to installing the application server.
Enter the mirror directory path where the transaction manager restart.bak file of each KJS process is to be stored.
Set a location for the transaction manager log file.
- The default directory is installDir/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 the default one. Consider using a pointer to the different physical disk drive.
Press Enter to configure iPlanet Application Server to use the Resource Manager with the Transaction Manager.
- The log volume disk name is where the transaction manager log file is stored. The engine specified by /ENGx/represents the KJS engine process number. Create a directory on a separate disk drive and specify if it is a raw partition.
Coordinate the first resource manager instance with a database driver. You must specify the database server name, administrative user name and password.
- If you have not yet configured a database, you are prompted to do it here.
Enter Y to enable standard Java Internationalization support, otherwise accept the default setting (N).
- To configure others, type a unique resource identifier, the database type to associate it with, as well as, the database server name, administrative user name and password.
To Install iPlanet Application Server Clusters
Follow instructions for installing and verifying the simple cluster on the Solaris platform at: http://developer.iplanet.com/appserver/samples/cluster/docs/unix-cluster.htmlAdditional information on configuring and deploying iPlanet Application Servers is available under "Configuring Clusters and Data Synchronization", and in the iPlanet Application Server Administrator's Guide.
To Configure Clusters for Data Synchronization
Enter y and press Enter to set this iPlanet Application Server instance to participate in data synchronization. The default is no (n).
This completes the configuration of your iPlanet Application Server installation. Continue with the next few steps to extract the packages and complete the installation.
If you answered yes in the previous screen, you are asked to:
- This sets up the synchronization of session and state information across multiple servers for failover and fault tolerance.
Enter the name of the cluster to which this instance of iPlanet Application Server belongs. The cluster may already exist, or this may be the first server assigned to the cluster.
Indicate if this iPlanet Application Server instance is to be a Sync Local or Sync Server instance.
Enter the IP addresses and port numbers for each installation of iPlanet Application Server in the cluster. The IP address of the machine you are installing on is added by default (if it's a Sync Server).
- A Sync Local server uses data synchronization services, but is not eligible to become a Sync Primary or the Sync Backup Server. For more information on Sync Servers and Sync Local, see "Configuring Clusters and Data Synchronization"
Enter the priority for each Sync Server. Start with the highest priority Sync Server in the cluster. This is the first server to take over if Sync Primary fails. Enter each Sync Server's priority until all are ranked.
- These IP addresses and port numbers must match across installations for the cluster to function properly.
Specify the number of Sync Backup servers that should be active while the cluster is running.
Enter Y to enable this iPlanet Application Server instance to automatically start at system startups.
The installation program now extracts the iPlanet Application Server files and installs them in your system.
- The default is No.
Note You can only run iPlanet Application Server automatically at startup if you have logged on as root.
To start iPlanet Administration Console, go to the installation directory and execute the command (printed at the end of the port number report):
- Here, you may be prompted to change the ownership of iAS files if the owner and group are different.
- Type y and press Enter if you want to change the group permission of iAS 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.
- The PointBase database engine automatically starts after installation (if you had opted to install it). Use this bundled database application to test your sample database applications. If you don't want to use it right away, you can shut down the PointBase database engine and use it later.
- To start PointBase, go to the <iASInstallDir>/pointbase/network/bin and type:
- pointbaseServer start
- To stop, type:
- pointbaseServer stop
- startconsole -a http://<servername.domain.com>:<port_number> .
Verifying Installation of the Application Server
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.
Open your browser and enter the following URL:
Press Enter.
- http://<yourwebserver>:<portnumber>/ias-samples/index.html
Click the Quick Test link, under Sample Applications.
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
Start iPlanet Application Server.
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.Open your browser, enter the following URL, and press Enter:
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.
- http://<yourwebserver>:<portnumber>/ias-samples/index.html
You can review the source code of the sample applications and associated J2EE XML Deployment Descriptors by browsing in the following location:
You can also find compile scripts at this site for experimenting with the sample code.
Installing Multiple Instances on Solaris
Multiple instances benefit both the development and production environments. In the development environment, having multiple iPlanet Application Server instances enables you to isolate code. In a production environment, multiple iPlanet Application Server instances will improve scalability.For more information on the benefits of installing multiple instances, see "Reasons for Installing Multiple Instances"
Note This option is available only on Solaris.
To Install for Developer Deployment
Create logins for each iPlanet Application Server instance.
Install the initial instance of the iPlanet Application Server on each system.
Set up a home directory, such as: /usr/iplanet/ias6/instance0.
Install additional iPlanet Application Server instances.Store configuration data under the global configuration name, iasconfig0, on the Directory Server.
Configure the number of executive server (KJS) processes so there is one KJS per iPlanet Application Server instance.
Use Custom Installation to assign different port numbers.
Store configuration data on the primary directory server in "iasconfig1", "iasconfig2", and so forth.Set up different home directories for each instance, like:
/usr/iplanet/ias6/instance1, /usr/iplanet/ias6/instance2Do not install the iPlanet Directory Suite or Administration Services.
Do not install iPlanet Core Java classes or Java Runtime Environment.
Install the Web Connector on all Web Server instances. Each Web Server instance is associated with one iPlanet Application Server instance.
To Install for Production Deployment
Install two Directory Servers; one to serve as a primary and the other a secondary server. Configure these servers so that the primary Directory Server replicates to the secondary.
Create logins for each Directory Server instance. The best performance comes from using 1 instance per processor, but up to eight (8) processors can be used per Directory Server instance.
Install the initial instance of the iPlanet Application Server on each system.
Setup an installation directory, like: /usr/iplanet/ias6/instance0.
Install additional instances.Store configuration data in iasconfig_global on the primary Directory Server.
Configure for the secondary Directory Server.
Configure at least two KJS processes per iPlanet Application Server instance.
Optional: Configure the application server so that it starts up automatically
Use the Custom Installation to change port numbers.
Store configuration data on the primary Directory Server in:Input different home directories for each instance, like: /usr/iplanet/ias6/instance1, /usr/iplanet/ias6/instance2
Do not install the iPlanet Directory Suite or Administration Services.
Do not install iPlanet Core Java classes or Java Runtime Environment.
Do not install iPlanet Application Server Web Connector Component or Deployment Tool.
iasconfig_global for most instances
Configure a secondary Directory Server.iasconfig_aol for Web servers and iPlanet Application Servers in a cluster configuration dedicated to handling AOL customers
iasconfig_isp1 for Web servers and iPlanet Application Servers in a cluster configuration dedicated to handling isp1 customers
iasconfig_ispN for Web servers and iPlanet Application Servers in cluster configuration dedicated to handling ispN customers
Configure the number of KXS and KJS processes so that there are at least two KJS processes per instance. Configure for a maximum of 8 processors per instance, but definitely consider starting with 1 processor per instance.
Configure each instance so that it does not start up automatically.
Create a script to bind processes to individual processors. Consider binding the KXS and two KJS processes of an instance to the same processor if a processor per instance has been allocated. Otherwise, bind the KXS to one processor and each of the KJS processes to separate processors for each instance. Consider 2 processor sets for KXS processes on Primary instances.
Create a crontab script to periodically check process bindings. A restart of a KJS process should cause this script to run the process binding script.
Configure cluster pairs so that:
- Example 1:
- Server A runs Instance 0 and Instance 1
- Server B runs Instance 2 and Instance 3
- Server C runs Instance 4 and Instance 5
Create Cluster 0 with Instance 1 and Instance 2
Create Cluster 1 with Instance 3 and Instance 4
Create Cluster 2 with Instance 5 and Instance 0
- Server A runs Instance 0, 1, 2, and 3
- Server B runs Instance 4, 5, 6, and 7
- Server C runs Instance 8 and 9
- Create Cluster 0 with Instance 0 and 4
- Create Cluster 1 with Instance 1 and 5
- Create Cluster 2 with Instance 2 and 6
- Create Cluster 3 with Instance 3 and 9
- Create Cluster 4 with Instance 7 and 8
Configure all iPlanet Application Server clusters for Per Component load balancing. Per Server load balancing will be confused by the sharing of servers between instances.
Install Web Connector on all web server instances. Allocate appropriate numbers of web server instances for each cluster that is allocated to ISP proxies. All other web server instances can be shared by the remaining cluster pairs.
- On each server, modify the rc2 startup scripts so that all Sync Primary instances are started as soon as possible. Delay the startup of all Sync Backup Instances. Determine which instances are to be Sync Primary or Sync Backup by evenly dividing the load between the physical servers. The reason for making these changes is that Sync Primary servers do more work, so it is desirable to evenly divide the work. Sync Primary instances are determined based on the startup order.
- Example 1:
- Continuing from Example 1 in the previous section. Primary instances could be 1, 3, and 5.
- Example 2:
- Continuing from Example 2 in the previous section. Primary instances could be 0, 1, 6, 7, and 8.
Configure the web tier load balancer so that sessions return to their original web servers.
Configure the web tier load balancer so that known ISP proxies are associated with the web servers which have been allocated for that purpose.
Configure the web tier load balancer so that application partitioning between clusters is supported (in cases where applications do not exist on all clusters).
Note Not all load balancing solutions can support all of these features. Resonate Central Dispatch is an example of a load balancer with these features.
Installing on Multiple Solaris Machines
The Silent Installation feature allows you to install the Application Server on multiple Solaris machines without running the installation program more than once.
Run the setup -k command on the first machine.
This performs an installation with exactly the same setup as the first system.
Once you have completed the installation process, copy install.inf and userinput.log and add them to the /tmp directory of a second system.
- Proceed with the installation program. An install.inf file is generated in the installDir/setup directory. In addition, a log file,userinput.log, is generated in the installDir/ias directory. This file contains all input entered during the installation procedure.
Modify the copies of install.inf and userinput.log, as described in the following steps.
You may have to change some or all of the following values in install.inf, depending on your configuration requirements, such as, port numbers, domain name, etc.
Change the following keys in the userinput.log file. You may need to change some or all of the following values, depending on your configuration requirements:
Enter the port numbers for KAS, KXS, KJS, KCS, etc.
Enter the logvol root's sizes for each of the kjs engines, such as, TXN_DirectoryRoot_logVol_1
Enter passwords in the following fields. You need not modify these values if you want to use the same passwords for all the multiple installations.
Run the following command on the second system to begin silent installation: setup -s -f fullpath/install.inf
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