# Sun ONE Web Server

> Overview
> Before Starting
> Installing Sun Cluster HA for Sun ONE Web Server
> Customizing Sun Cluster HA for Sun ONE Web Server

## Overview

SunPlexTM Manager installs the Sun Open Net Environment (Sun ONE) Web Server from the Sun ONE distribution. You can configure Sun Cluster HA for Sun ONE Web Server as a scalable or a failover data server. For a list of Sun ONE Web Server releases that are supported for use with SunTM Cluster, ask your Sun sales representative.

Note: By running the Sun Cluster HA for Sun ONE installation, you agree to the terms of the Sun ONE LICENSE.txt file.

Note: Multiple instances of Sun Cluster HA for Sun ONE Web Server can run on the cluster as long as: The location of the configuration files and installation files is not the same for each installation The ports do not conflict

Note: If you are running multiple data services in your Sun Cluster configuration, you can set up the data services in any order, with the following exception: If Sun Cluster HA for Sun ONE Web Server depends on Sun Cluster HA for DNS, you must set up DNS first. See DNS Server Overview. DNS software is included in the Solaris operating environment. If the cluster obtains the DNS service from another server, then configure the cluster to be a DNS client first.

For a more advanced configuration, use the Administrative Console to manually customize your configuration after SunPlex Manager completes the installation. For more control over the installation than SunPlex Manager provides, perform the installation manually, following the procedures in the Sun Cluster 3.1 Data Services Installation and Configuration Guide.

Return to top

## Before Starting

Before you install the Sun ONE Web Server package:

- Ensure that you have the Sun ONE distribution on a file system that all nodes on the cluster can access. If the Sun ONE distribution was delivered as a
  tar
  file, you must use the
  tar
  command to extract the distribution.

- Ensure that the logical host name or shared address is set up. In most cases, you set up the logical host name when you install Sun Cluster. If the logical host name is not set up, see Creating a Logical Host Name Resource.

- Decide whether to run Sun Cluster HA for Sun ONE Web Server as a failover or a scalable service.

- Determine where you want to install the application and data files. You can install locally or globally.

- If you plan to run

  - Multiple instances of the Sun ONE Web Server data service
  - Multiple data services on the same node

  determine a unique network address and port number for each instance.

- Ensure that you have the CD that contains the Sun Cluster 3.1 data service.

Return to top

## Installing Sun Cluster HA for Sun ONE Web Server

| The Sun ONE Web Server data service takes approximately 10 minutes to install.
| When you exit SunPlex Manager or click Back in your web browser after you begin the installation, the data service disconnects you from the installation. This disconnection can result in an incomplete installation because of insufficient information or an unresolved error message. To clean up an incomplete installation, you must remove the application files and resources and resource groups that were created.

To install Sun ONE Web Server, complete the following steps:

1. From the navigation frame in SunPlex Manager, choose [cluster name] Cluster.

   The Cluster window appears.

2. From the Install Data Service menu, choose Sun ONE Web Server.

   SunPlex Manager ensures that:

   - The Sun Cluster HA for Oracle data service packages are already installed.
   - The Sun Cluster HA for Oracle data services are registered with RGM.

   If the Sun ONE Web Server data service package is installed and is registered, proceed to the next step.

   If SunPlex Manager does not find the Sun ONE Web Server data service package already installed and registered, SunPlex Manager guides you through installation and registration. You need to provide the location of the CD that contains the Sun Cluster 3.1 data service.

   A window that contains configuration information appears.

3. Modify the information on the configuration page for your system.

   Field | Description
   --- | ---
   Administrative Server Port | The port to be used for the Sun ONE Administrative Server. This port defaults to 8888.
   Administrative Server Password | The password to access the Administrative Server port.
   Web Server Port | The port on which the web server accepts requests. Typical values are 80 or 8080. If you are running the Sun Cluster HA for Sun ONE Web Server service and another HTTP server, and if they use the same network resources, configure the servers to listen on different ports. Otherwise, a port conflict occurs between the two servers.
   Source Directory for Sun ONE Installation | Directory that holds the Sun ONE distribution. The setup executable must be located in this directory.
   Installation Directory | The directory where the binaries for the Sun ONE Web Server application are installed. Warning: If one or more binaries for the Sun ONE Web Server application are located in this directory, the installation fails.
   Root Directory for Web Pages | The directory that holds the web pages for the Sun ONE Web Server.
   Network Resource | Specifies the logical host name or shared address that is used to access Sun ONE Web Server over the network. If a logical host name is used, one Sun ONE Web Server instance runs as a failover service. If a shared address is used, multiple Sun ONE Web Server instances run as a scalable service.
   Resource Name | Specifies the name of the Sun ONE Web Server resource that is created. This name must be unique within the cluster.
   Resource Group Name Used for a scalable resource | If a shared address is used, specifies the name of the resource group that is created. This resource group will hold the scalable Sun ONE Web Server resource. If a logical host name is used, the failover Sun ONE Web Server resource is placed in the same resource group as the logical host name.
   Name Service | This option controls the Sun ONE Web Server Address parameters, and normally matches the type of name service in use on the cluster. If you choose DNS, the Address is the logical host name or shared address. If you choose NIS, the Address is the numeric IP value that is associated with the logical host name or shared address.
   Dots Demo | If you choose and install Dots Demo, SunPlex Manager installs additional Web pages on the cluster to demonstrate load balancing across the cluster.

4. Click Continue.

   SunPlex Manager verifies the information on the configuration page. If SunPlex Manager finds no errors, SunPlex Manager installs the binaries for the Sun ONE Web Server application. If SunPlex Manager discovers errors, SunPlex Manager displays an error message and the configuration page.

5. Click Continue.

   The installer configures and starts a resource. SunPlex Manager lists the commands that it executes to configure and start the resource.

| Recommended step. To test the web server, click the web server URL. SunPlex Manager tests Sun Cluster HA for Sun ONE and displays a confirmation window.

Note: To view the dots demo (if you installed it), click the dots demo URL. A graphical illustration of the nodes on the Sun Cluster appears. The dots demo demonstrates load balancing across the cluster.

Return to top

## Customizing Sun Cluster HA for Sun ONE Web Server

Instructions that describe how to customize your Sun ONE Web Server data service installation are presented in the Sun Cluster 3.1 Data Services Installation and Configuration Guide.

Return to top