test

Sun Java System Application Server Enterprise Edition 8.2 Installation Guide

Installing Application Server Software

This section provides instructions for installing the Application Server software.

For information on supported platforms, see Hardware and Software Requirements in Sun Java System Application Server Enterprise Edition 8.2 Standalone Installer Release Notes.

Tip –

As you run the installation program, make a note of the user names, passwords, and the port numbers you enter, for future reference.

ProcedureTo Install Application Server Software

Before You Begin

On UNIX or Linux, if you are installing as a non-root user, you must have read/write access to the following directories:

  1. After you have planned the topology, navigate to the location where the installation program resides and run the installation program.

    See Table 1–2 for a list of installation commands for various installation methods. Refer Table 1–1 for installation options. If you are installing the load balancing plugin, a web server must already be installed. Refer to Installing the Load Balancing Plugin Component. For more information on planning topology, see Sun Java System Application Server Enterprise Edition 8.2 Deployment Planning Guide.

    Note –

    If you do not have execute permission for this file, use the chmod command to grant yourself execute permissions.

  2. Follow the installation wizard screens to accept the license agreement.

  3. Specify the path to the Application Server installation directory or accept the default installation directory.

  4. Select the components to install.

    If a component is disabled, the installation program has detected it as already installed on your system.

    The following components are available for installation:

    • Node Agent – All machines that contain application server instances should have a node agent installed.

    • High Availability Database Server (Enterprise Edition only) -This component stores session information so requests can be failed over if you are using the load balancing plugin.

    • Load Balancing Plugin - Install the load balancing plugin on the machine where a web server is installed. If you do not already have a web server installed on the machine where you are installing the load balancing plugin, you cannot continue to install the load-balancer plugin. Supported web servers are listed in Web Servers in Sun Java System Application Server Enterprise Edition 8.2 Standalone Installer Release Notes.

    • Domain Administration Server and Administration Tool - The Domain Administration Server (DAS) acts as a central repository for applications and configuration information for server instances, even if the instances are located on a remote machine. It includes graphical and command-line administration tools.

    • Command Line Administration Tool Only - Install the Command Line Administration tool on machines which do not contain a DAS, but from which you want to communicate with the DAS or a node agent. For example, install the command-line administration tool on machines from which you plan to remotely administer the Application Server using the command-line administration tools.

    • No Administration Tools - Use this option when installing components on a machine that already contains the administration tools, or on which no administration tools are required. For example, when installing the load balancing plugin on a machine with a web server, but no Application Server, no Application Server administration tools are required.

    • Sample Applications - Samples come with the source, schema, Ant build scripts, and EAR files. Any existing data associated with the database-related samples is available in the included Java DB database.

  5. Choose to install the Java 2 SDK, or use a preinstalled Java 2 SDK.

    If you choose to install the Java 2 SDK, a private copy is installed. The default Java 2 SDK installation path for all platforms is install-dir/jdk.

    Note –

    The Application Server software is certified to work with Java 2 SDK from Sun Microsystems. Third-party Java 2 SDK development kits, even with appropriate version number, are not supported.

  6. If you selected the load balancing plugin component, identify your web server and its installation directory. For instructions on how to install the load balancing component, refer Installing the Load Balancing Plugin Component

    Note –

    If you are using a Web Server 7.0 installation, you need to provide Web Server 7.0 administration-specific information. For more details, refer Installing the Load Balancing Plugin Component.

  7. In the Administration Configuration page (or at the command line), enter the following (and you proceed to Step 9):

    • Administration User Name - Name of the user who administers the server

    • Password - Administration user’s password to access the Domain Administration Server (8-character minimum)

    • Master Password - SSL certificate database password, used in operations such as Domain Administration Server startup

    • Administration Port - Port number to access the Domain Administration Server

    • HTTP Port - Port number to access the default server instance

    • HTTPS Port - Secure port number to access the default server instance

    Note –

    The installation program automatically detects ports in use and suggests unused ports for the default settings.

    The default ports are:

    • Administration Server - The default is 4849

    • HTTP server - The default is 8080

    • HTTPS sever - The default is 8181

    In addition, five other ports are automatically assigned. You can change the automatically assigned values after installation using the Admin Console. The default ports assigned are:

    • Sun Java System Message Queue - The default is 7676

    • IIOP - The default is 3700 for IIOP, and 3820 and 3890 for IIOP/SSL

    • JMX - The default is 8686

    If these default port numbers are in use, the installation program assigns random port numbers from the dynamic port range. This number may not be the next available port number.

  8. Alternatively, if you are installing the node agent but not the Domain Administration Server, enter the following:

    • Admin Host Name - Host name of the Domain Administration Server

    • Admin User Name - Name of the user who administers the Domain Administration Server

    • Password - Domain Administration Server administration user’s password (8-character minimum)

    • Master Password - Domain Administration Server's SSL certificate database password, used in operations such as node agent startup

    • Admin Port - Port number to access the Domain Administration Server

    • Node Agent Name - Defaults to the system host name

    Note –

    In most cases, you must not change the node agent name, because node agent names must be unique within each server domain.

  9. In the Installation Options page, select the options that you want.

    If you select the “Upgrade from Previous Version” checkbox, the upgrade process begins after installation is completed. Upgrades from 7.x Enterprise Edition, 8.0 Platform Edition, 8.1 Platform Edition, 8.1 Enterprise Edition, and 8.2 Platform Edition are supported. For information about upgrading, see Chapter 2, Upgrading an Application Server Installation, in Sun Java System Application Server Enterprise Edition 8.2 Upgrade and Migration Guide.

  10. The installation program verifies the available disk space on your machine.

    If you do not have enough disk space, an error message is displayed. See the Platform Requirements in Sun Java System Application Server Enterprise Edition 8.2 Standalone Installer Release Notes to identify the minimum disk space required.

  11. In the Ready to Install page, verify the information on what is to be installed, and click Install Now to start the installation (or enter yes at the command line).

  12. When the installation is complete, read the installation summary page to determine the status of the installation. If the installation is successful, click Finish.

    Review the installation log files. For a list of these log files and their locations, see Installation Log Files.

  13. Start the server.

    See the Sun Java System Application Server Enterprise Edition 8.2 Quick Start Guide in the install-dir/docs-ee directory or online for information about starting the server.

  14. If you selected the HADB components:

    1. Verify that you have successfully installed the HADB on each host by typing: hadbm --help

      A list of all commands available using the hadbm utility is displayed. The hadbm utility is located at install-dir/hadb/4/bin.

    2. Configure your system for high availability. See the Sun Java System Application Server Enterprise Edition 8.2 High Availability Administration Guide for information.