Sun ONE logo      Previous      Contents      Index      Next     

Sun ONE Application Server 7, Enterprise Edition Installation Guide

Chapter 2
Installing Enterprise Edition Software

This chapter provides instructions for installing the Sun ONE Application Server 7, Enterprise Edition product. You can install this version of the product interactively or you can use silent mode to replicate an installation scenario on multiple machines. Refer to "Installation Roadmap" to see the full sequence of events for implementing the Sun ONE Application Server 7, Enterprise Edition product.

The following topics are addressed here:

You should be familiar with the information in "Preparing to Install" before beginning the tasks in this chapter.

For any late-breaking updates to these instructions, check the Sun ONE Application Server Release Notes. For more information about configuring your application server after installation, refer to the Sun ONE Application Server Administrator’s Guide.

The following location contains product downloads in addition to other useful information:

http://www.sun.com/software/products/appsrvr/home_appsrvr.html

About Installation

Only one Sun ONE Application Server 7 installation can reside on a single machine. If an installation of Application Server 7 already exists on your system, the installation program will not overwrite it, but the pre-existing installation will be detected and you will not be allowed to proceed with the installation until you have removed the existing Application Server 7 software using the uninstallation program.

Note

Solaris 9 bundled installations and non-package-based evaluation installations do not affect the Enterprise Edition installation program, so they do not need to be removed from your system.

The following topics are addressed in this section:

Installation Components

In general, you are installing the basic components that provide the functionality of the Sun ONE Application Server Version 7, Enterprise Edition product. You can choose not to install some of the components. Later, if you want to add a component that you initially chose not to install, you can do an incremental installation of that component, providing dependencies are met.

Note

Using either of the interactive methods, you can do a partial installation which can be followed by any number of incremental (subsequent) installations. For silent mode, you can do a partial initial installation, but any subsequent installations must be done using an interactive method.

Since only one installation of the same component package on the same system is allowed, the installation program tries to detect components that are already installed. If a component is already installed, installation of that component is disabled.

The installation program enforces component dependencies as specified for each component. Once component dependencies are satisfied, component life cycles are independent. A particular component can be installed or uninstalled dynamically through incremental installation and partial uninstallation mechanisms without corrupting other components.

The following installation components are included with the Sun ONE Application Server 7, Enterprise Edition product:

See "Installation Components" for further description of the Sun ONE Application Server components.

Installation Options

There are three ways you can perform the installation:

The setup command allows you to specify the method you want to use for installation, and allows you to create a configuration file for silent installation.

Note

The default installation mode is the graphical method, so if you don’t specify an option when you run setup, the installation program presents the graphical screens.

Use the following syntax when running the setup command:

Table 2-1 describes the setup command options.

Table 2-1  Options for the setup Command 

Option

Description

-console

Runs the installation using the command-line method.

-silent config_file

Runs the installation in silent mode. Installation parameters are read from an existing installation configuration file. This option is mutually exclusive with the savestate option.

The installation configuration file path must be explicitly provided; there is no default file path. Refer to "Installing in Silent Mode (Non-Interactive)" for further specifics on silent mode installation and the installation configuration file.

-savestate

Runs the installation using either the graphical or command-line method and creates an installation configuration file based on this installation. This option is mutually exclusive with the silent option. If you do not specify this option, no installation configuration file will be created.

The file will be called statefile and located in install_dir.

Installation Syntax

Installing Application Server Software

This section provides instructions for installing the Sun ONE Application Server software using either the graphical-interface or command-line interface. The steps are identical for both methods. However, for the command-line interface, text-based screens are displayed instead of graphical screens.

Tip

If you are familiar with high availability concepts and installation of enterprise-level products, you may want to use the summary checklists in Appendix A, "Installation Cheatsheet."

After you have planned the topology, run the installation program on each system, selecting and installing the appropriate components based on your topology.

  1. Uninstall any previous versions of the Sun ONE Application Server 7 software on the machines where you are going to install the Enterprise Edition of the Application Server.

    2. Note

    If the previously-installed packages are bundled in the Solaris operating environment, they need not be removed. However, port conflicts must be resolved.

  2. Verify that all requirements that apply to your installation have been met. See "Installation Requirements" for information on requirements.
  3. Log in as root and create a temporary directory for the product distribution file.

    4. Note

    If you are installing the load balancer plug-in, your web server must already be installed on the machines where you are going to install the load balancer plug-in before you start the installation process. Refer to "High-Availability Requirements".

  4. Start all the processes on your system that use ports and are expected to run at the same time as the Application Server software. This allows the installation program to detect what ports are in use and avoid assigning them for other purposes.
  5. For a download, unzip the .gz file as follows:

    6. gunzip sun-appserver7-sol.tar.gz

  6. For a download, untar the unzipped file as follows:

    7. tar -xvf sun-appserver7-sol.tar

    This process may take a little time. When the files are unpacked, you will see the sun-appserver7 directory, which contains the setup file and the pkg directory.

  7. Navigate to the sun-appserver7 directory.
  8. Select your installation method.

    9. Refer to "Installation Options" for guidelines on selecting the correct options to use with the setup command.

    When the installation starts, the Welcome page of the installation program is displayed.

    Note

    Click the Help button to display context-sensitive information for a page.

  9. Read the Welcome page and click Next.

    10. The License Agreement page is displayed.

  10. Read the License Agreement and click Yes to agree to the terms of the license (or type Yes at the command line), then click Next.

    11. Note

    You must accept the license agreement to continue with the installation.

    After you accept the License Agreement, the Select Installation Directory page is displayed.

  11. Specify the path to your Sun ONE Application Server installation directory (default is /opt/SUNWappserver7).

    12. If you are installing only the HADB Server component, you can choose /opt as the installation directory. This will install the HADB packages into their default location, which is /opt/SUNWhadb.

    Note

    You must select identical installation directories on all systems hosting HADB Server nodes.

    Note

    When installing the Sun ONE Application Server together with HADB, if you do not want to use the default installation folder, you can create alternate directories, then create symlinks (ln -s) to these directories from the /var/opt and /etc/opt directories.

    The standards for packaging Solaris packages require that the licenses and configuration files are located in the /var/opt and /etc/opt directories.

    • Click Browse to browse for a directory (or press Enter at the command line to accept the default installation directory).
    • If you enter a directory name that does not already exist, the Create New Directory? dialog is displayed.
      • Click Create Directory (or type 1 at the command line) to create a new directory.
      • Click Choose New (or type 2 at the command line) to return to the Select Installation Directory page.

        • The Component Selection page displays the available components.

  12. Choose from the components listed on the Component Selection page (or type Yes or press Enter to accept a component from the command line).

    13. Note

    If some components are disabled on the Component Selection page (or if a command-line mode installation did not offer them for installation), this means the disabled component has been detected as already installed on your system.

    • Sun ONE Application Server, with graphical and command-line interfaces (J2SE and Sun ONE Message Queue are installed along with this component)

      • Note

      If you want to install Sun ONE Application Server and an HADB server node on the same system, select them both. Otherwise, select only one of them.

    • (Optional) Sample Applications
    • Sun ONE Application Server Administration Client (select only this component to install standalone command-line)
    • High-Availability Database
    • High-Availability Database Administration Client
    • Load Balancer Plug-in

      Refer to "Installing the Load Balancer Plug-in" for instructions on installing this component separately.

      Note

      If you do not already have your web server installed on the machine where you are installing the load balancer plug-in, you cannot continue to install the load-balancer plug-in.

  13. Sun ONE Message Queue—If the installation program detects a version of the Sun ONE Message Queue preinstalled in your system, you are presented with one of the following actions:
    • If the correct version of the package-based Sun ONE Message Queue is installed, it will be reused. You can choose to exit at this point. If you don’t exit, the installation program will use the installed version and proceed to the next step.
    • If there is no package-based Sun ONE Message Queue installed, you can choose to let the installation program install the Sun ONE Message Queue packages automatically.
    • If an incorrect version of the package-based Sun ONE Message Queue is found, a message is displayed, asking if you want to upgrade your current version or cancel. Choose one of the following:
      • To have the installation program update your current Sun ONE Message Queue, click Upgrade (or type 1 at the command line).
      • To exit the installation program, click Cancel (or type 2 at the command line).
  14. For J2SE—The installation program looks in the /usr/j2se default location to detect if you have the correct version of the J2SE preinstalled in your machine.

    15. You are presented with one of the following actions (if you have any problems in this step, refer to "J2SE Installation/Upgrade Issues"):

    • If the correct version of the package-based J2SE is installed, it will be reused or you can enter the path to another correct version. The installation program proceeds to the next step.
    • If there is no package-based J2SE installed, you can choose to let the installation program install the J2SE package automatically or reuse an existing J2SE installation.
    • If an incorrect version of the package-based J2SE is found, a message is displayed asking if you want to upgrade your current version or cancel. Choose one of the following options:
      • To have the installation program update your current J2SE version, click Upgrade (or type 1 at the command line).

        • Note

        Because other applications might be running and using this J2SE installation, upgrading J2SE is a potentially disruptive process. You may prefer to cancel the current installation and take care of all dependencies (such as gracefully shutting down processes).

      • To exit the installation program, click Cancel (or type 2 at the command line).

        • Before continuing with the installation, you must uninstall the J2SE currently located in /usr/j2se or upgrade it to J2SE 1.4.1_03. Then restart the Application Server installation.

        Note

        If your J2SE requires an upgrade, you will need to reboot your machine after completing the Application Server installation.

        Note

        This Sun ONE Application Server 7 software is certified to work with J2SE 1.4.1_03 from Sun Microsystems. Third-party J2SE development kits, even with appropriate version number, are not supported.

  15. Specify your product configuration directory.

    16. Accept the default (/etc/opt/SUNWappserver7) or enter the path to your Sun ONE Application Server product configuration directory.

    • Click the ellipsis (...) to browse for a directory (or press Enter at the command line to accept the default installation directory).
    • If the directory does not already exist, the Create New Directory? dialog is displayed.
    • Click Create Directory (or type 1 at the command line). You can also click Choose New (or type 2 at the command line) to select an existing directory.
  16. Specify your server configuration directory.

    17. Accept the default (/var/opt/SUNWappserver7) or enter the path to your Sun ONE Application Server Version 7, Enterprise Edition domains installation directory.

    • Click the ellipsis (...) to browse for a directory (or press Enter at the command line to accept the default installation directory).
    • If the directory does not already exist, the Create New Directory? dialog is displayed.
    • Click Create Directory (or type 1 at the command line). You can also click Choose New (or type 2 at the command line) to select an existing directory.

      • If you selected Application Server for installation, the Server Configuration Information page is displayed. Skip to Step 18.

      If you selected the load balancer plug-in, the Web Server Directory page is displayed. Proceed to Step 17

  17. If you selected the load balancer plug-in, identify your web server as follows:
    • Choose which web server you are going to install (Sun ONE Web Server or Apache Web Server).
    • Enter the web server instance path.

      Default values will be offered based on web server type. The installation program checks to see if appropriate configuration files can be found at the provided location.

      Refer to "Installing the Load Balancer Plug-in" if you are installing the load balancer plug-in separately.

  18. If you selected the Sun ONE Application Server component, enter the following:
    • Admin User—Name of the user who administers the server (for example, admin).
    • Admin User’s Password—Password to access the Admin Server. Minimum number of characters is 8. For example, adminadmin. Re-enter the password to confirm your choice.
    • Admin Server Port—Port number to access the Admin Server.

      A default port number is displayed (for example 4848, if that port is not in use on your machine). Change the default number if necessary. The installation program will check port numbers for validity and availability when you click Next.

    • HTTP Server Port—Port number to access the default server instance.

      • A default port number is displayed (for example 80, if that port is not in use on your machine). Change the default number if necessary. The installation program will check port numbers for validity and availability when you click Next.

      Note

      The installation program automatically detects ports in use and suggests currently unused ports for the default settings. By default, the initial default ports are 80 for the HTTP server and 4848 for the Admin Server.

      If these initial default ports are being actively used on your system, the installation program will suggest alternative port numbers.

  19. Click Next.

    20. The installation program proceeds to verify that you have enough disk space based on the components you selected. The Checking Disk Space progress indicator bar is displayed.

    • If you do not have enough disk space, an error message is displayed.

      • In this case, you need to exit the installation program, create enough space, and restart the installation. Information on space requirements is contained in "Platform Requirements".

    • If you have enough disk space, the Ready to Install page is displayed.
  20. On the Ready to Install page, you have the following choices:
    • Click Back if you want to return to the previous page. Disk space is rechecked if you do this.
    • Click Install Now (or type 1 at the command line) to start the installation process.
    • Click Cancel to exit the installation program.

      • An Installation progress indicator bar is displayed.

      When installation finishes, the Installation Summary page is displayed.

  21. Check the installation outcome on the Installation Summary page. If installation failure has occurred, review the following log file:
  22. Click Finish (or type Finish at the command line) to complete the installation.

    23. The installation components are now installed on your systems.

  23. Start the server.

    24. You can start the Sun ONE Application Server software by using the instructions on "Starting and Stopping the Server".

    When the Admin Console has been started, the initial page of the Application Server graphical interface is displayed.

    Note

    The installation program creates an initial domain called domain1 with a single instance called server1. Refer to "Creating Domains and Instances" for instructions on creating additional domains and instances.

  24. If you have not already done so, add the HADB bin directory to the PATH environment variable as described in "Setting Up the User Environment".
  25. If you selected the HADB components, verify that you have successfully installed the HADB software by doing the following on each host:

    26. hadbm --help

    The result of this command should be a list of all commands available using the hadbm command-line utility.

You are now ready to configure your system for high availability. Proceed to "Preparing for HADB Setup" to begin this process.

Installing the Load Balancer Plug-in

This section provides instructions for installing the load balancer plug-in component separately.

To install the load balancer plug-in component, perform these steps:

  1. Check the system that will be hosting the web server and load balancer plug-in to see if a previously-installed load balancer plug-in or reverse proxy plug-in is present. If it is, you will need to remove it using the unistallation program.

    2. As root, run the following command:

    pkginfo SUNWaspx

    On a clean system, the following message will be displayed:

    ERROR: information for "SUNWaspx" was not found.

  2. Verify that the correct web server is present on the machines were you are going to install the load balancer plug-in. Currently supported versions include the following:
    • Sun ONE Web Server 6.0 SP6
    • Apache Web Server 1.3.27

      • Note

      Make a note of the web server installation directory. This information will be needed during installation.

  3. Log in as root and create a temporary directory for the product distribution file.
  4. For a download, unzip the .gz file as follows:

    5. gunzip sun-appserver7-sol.tar.gz

  5. For a download, untar the unzipped file as follows:

    6. tar -xvf sun-appserver7-sol.tar

    This process may take a little time. When the files are unpacked, you will see the sun-appserver7 directory, which contains the setup file and the pkg directory.

  6. Navigate to the sun-appserver7 installation directory.
  7. Select your installation method.

    8. Refer to "Installation Options" for guidelines on selecting the correct options to use with the setup command.

    When the installation starts, the Welcome page of the installation program is displayed.

  8. Read the License Agreement and click Yes to agree to the terms of the license (or type Yes at the command line), then click Next.

    9. Note

    You must accept the license agreement to continue with the installation.

    After you accept the License Agreement, the Select Installation Directory page is displayed.

  9. Specify the path to your Sun ONE Application Server installation directory (default is /opt/SUNWappsrver7).
    • Click Browse to browse for a directory (or press Enter at the command line to accept the default installation directory).
    • If you enter a directory name that does not already exist, the Create New Directory? dialog is displayed.
      • Click Create Directory (or type 1 at the command line) to create a new directory.
      • Click Choose New (or type 2 at the command line) to return to the Select Installation Directory page.

        • The Component Selection page displays the available components.

  10. Choose the load balancer plug-in component on the Component Selection page (or type Yes or press Enter to accept the component from the command line).

    11. Note

    If some components are disabled on the Component Selection page (or if a command-line mode installation did not offer them for installation), this means that disabled component has been detected as already installed on your system.

    If you selected the load balancer plug-in component, the Web Server Directory page displays.

  11. Identify your web server.
    • Choose the web server you have installed (Sun ONE Web Server or Apache Web Server).
    • Enter the web server instance path.

      Default values will be offered based on server type. The installation program checks to see if appropriate configuration files can be found at the specified location.

  12. Click Next.

    13. The installation program proceeds to verify that you have enough disk space based on the components you selected. The Checking Disk Space progress indicator bar is displayed.

    • If you do not have enough disk space, an error message is displayed.

      • In this case, you need to exit the installation program, create enough space, and restart the installation. Information on space requirements is contained in "Platform Requirements".

    • If you have enough disk space, the Ready to Install page is displayed.
  13. On the Ready to Install page, you have the following choices:
    • Click Back if you want to return to the previous page. Disk space is rechecked if you do this.
    • Click Install Now (or type 1 at the command line) to start the installation process.
    • Click Cancel to exit the installation program.

      • An Installation progress indicator bar is displayed.

      When installation finishes, the Installation Summary page is displayed.

  14. Check installation outcome on the Installation Summary page. If installation failure has occurred, review the following log file:

    15. /var/sadm/install/logs/Sun_ONE_Application_Server_install.log

    Refer to "About Logs and Messages" for additional information.

  15. Click Finish (or type Finish at the command line) to complete the installation.
  16. Edit the supplied loadbalancer.xml.example file to include references to actual application server instances. This file is located in the following location:

    17. For Sun ONE Web Server:

    webserver_instance_dir/config/loadbalancer.xml.example

    For Apache Web Server:

    webserver_instance_dir/conf/loadbalancer.xml.example

  17. After you have made your modifications, save the loadbalancer.xml.example file as loadbalancer.xml in the same directory.

    18. Note

    If you want to configure more than one web server instance, or want to add additional instances at a later time, you will need to manually configure them. Instructions for doing this are contained in the Configuring Load Balancer Plug-in section in the Sun ONE Application Server Administrator’s Guide.

    Refer to the Apache documentation for information on the Apache Web Server.

Installing in Silent Mode (Non-Interactive)

If you choose to install the Sun ONE Application Server Version 7, Enterprise Edition software in silent mode, the installation program runs without any user input. This is made possible when the installation program accesses a text file that provides the installation program with the configuration information it needs.

The following topics are discussed in this section:

Creating the Installation Configuration File

The installation configuration file is created when you use the savestate option with the setup command to start a interactive installation. During the interactive installation, your input is collected and stored in the configuration file you specified. This forms the template for silent installation, which you can use later to install the product on one or more machines.

If needed, you can modify the installation configuration file.

The following topics are addressed in this section:

Syntax for Creating the Installation Configuration File

The syntax for creating an installation configuration file is as follows:

For graphical method:

For command-line method:

Refer to "Installation Options" for more detailed information.

Example Installation Configuration File

An installation configuration file looks similar to the following:

# Wizard Statefile created: Mon Jan 27 16:25:26 PST 2003

# Wizard path: /tmp/herc/sun-appserver7/./appserv.class

# Install Wizard Statefile section for Sun ONE Application Server

#

[STATE_BEGIN Sun ONE Application Server 108a4222b3a6a8ed98832d45238c7e8bb16c67a5]

defaultInstallDirectory = /opt/SUNWappserver7
currentInstallDirectory = /opt/SUNWappserver7

SELECTED_COMPONENTS = Java 2 SDK, Standard Edition 1.4.1_03#Application Server#Sun ONE Message Queue 3.0.1#Sample Applications#Load Balancing Plugin#Uninstall#Startup

USE_BUNDLED_JDK = FALSE
JDK_LOCATION = /usr/j2se
JDK_INSTALLTYPE = PREINSTALLED
AS_INSTALL_DEFAULT_CONFIG_DIR = /etc/opt/SUNWappserver7
AS_INSTALL_CONFIG_DIR = /etc/opt/SUNWappserver7
AS_INSTALL_DEFAULT_VAR_DIR = /var/opt/SUNWappserver7
AS_INSTALL_VAR_DIR = /var/opt/SUNWappserver7
DOMAINS_DIR = /var/opt/SUNWappserver7/domains
WEBSERVER_INSTALL_DEFAULT_DIR = /usr/iplanet/servers
WEBSERVER_INSTALL_DIR = /opt/iplanet/servers/https-tesla.red.iplanet.com
INST_ASADMIN_USERNAME = admin
INST_ASADMIN_PASSWORD = adminadmin
INST_ASADMIN_PORT = 4848
INST_ASWEB_PORT = 81
INSTALL_STATUS = SUCCESS
[STATE_DONE Sun ONE Application Server 108a4222b3a6a8ed98832d45238c7e8bb16c67a5]

Modifying the Installation Configuration File

You can modify the installation configuration file by editing the variables and values described in Table 2-2.

Table 2-2  Installation Configuration File Variables 

Variable Name

Valid values (if applicable)

Content

Comments

defaultInstallDirectory

 

Default installation directory path

Value not actively used by installation program.

currentInstallDirectory

 

Selected installation directory path

 

SELECTED_COMPONENTS

 

List of product components selected for installation

Pound (#') character is used as list delimiter.

USE_BUNDLED_JDK

TRUE
FALSE

Whether to install J2SE bundled with the product

 

JDK_LOCATION

 

J2SE path

Preinstalled J2SE path if USE_BUNDLED_J2SE is set to false; otherwise installation location for bundled J2SE.

JDK_INSTALLTYPE

PREINSTALLED
CANNOTUPGRADE
UPGRADABLE
CLEANINSTALL

How to handle existing J2SE installation

Only PREINSTALLED and CLEANINSTALL are valid values for silent installation configuration file.

AS_INSTALL_DEFAULT_CONFIG_DIR

 

Default configuration files directory path

Value not actively used by installation program.

AS_INSTALL_CONFIG_DIR

 

Selected configuration file directory path

 

AS_INSTALL_DEFAULT_VAR_DIR

 

Default domains configuration files directory path

Value not actively used by installation program.

AS_INSTALL_VAR_DIR

 

Selected domains configuration file directory path

 

DOMAINS_DIR

 

Selected domains configuration file directory path, plus domains subdirectory

AS_INSTALL_VAR_DIR and DOMAINS_DIR are generally redundant. However, both entries are needed by legacy installation program code.

WEBSERVER_INSTALL_DEFAULT_DIR

 

Default web server instance directory path

Value not actively used by installation program.

WEBSERVER_INSTALL_DIR

 

Selected web server instance directory path

 

INST_ASADMIN_USERNAME

 

Administrator username for initial domain

 

INST_ASADMIN_PASSWORD

 

Administrator password for initial domain

 

INST_ASADMIN_PORT

0 - 65535

Administration server port number for initial domain

 

INST_ASWEB_PORT

0 - 65535

Server port number for initial server instance

 

INSTALL_STATUS

SUCCESS

FAILURE

Installation outcome

Mandated by installer implementation. Value not actively used by installation program.

Installing in Silent Mode

Note

For silent mode, you can do a partial initial installation, but any incremental (subsequent) installations must be done using an interactive method.

To install the Sun ONE Application Server software in non-interactive silent mode, perform these steps:

  1. With a text editor, examine the current installation configuration file and verify that it contains what you want to use for your silent installation.
  2. Save your config_file with any name. For example:

    3. cp statefile my_silent_config

  3. Copy your installation configuration file to each machine where you plan to install the Sun ONE Application Server Version 7, Enterprise Edition software.
  4. Copy the Sun ONE Application Server installation files to each machine where you plan to install the Application Server software.
  5. If you are not in the directory already, navigate to the directory where you copied the installation files and your installation configuration file.
  6. As superuser, start silent installation at the command line using the following command format:

    7. ./setup -silent config_file

    The installation program reads the specified config_file, checks for adequate disk space, then installs the product based on the data in config_file.

    When the prompt is returned, the silent installation is complete and the installation components are now installed on your systems.

  7. You can start the Application Server software by using the instructions on "Starting and Stopping the Server".

    8. When the Admin Console has been started, the initial page of the Application Server graphical interface is displayed.

You are now ready to configure your system for high availability. Proceed to "Preparing for HADB Setup" to begin this process.



Previous      Contents      Index      Next     

Copyright 2003 Sun Microsystems, Inc. All rights reserved.