test

Sun Java System Application Server 9.1 Installation Guide

ProcedureTo Install Application Server 9.1 with HADB

Before You Begin

Use this procedure if you are using the Sun Java System Application Server file—based installer. Verify that your system meets the requirements specified in Hardware and Software Requirements in Sun Java System Application Server 9.1 Release Notes.

Solaris and Linux installations support both root and non-root user installations. Users of Windows installations should have Power User or Administrator access. If you are installing as a non-root user on Solaris or Linux, you must have read-write access to the following directories:

  1. Navigate to the directory where you downloaded the distribution file.

  2. If you have downloaded a .bin file, change the permission of the distribution file so that you have execute access:

    chmod +x distribution_filename

  3. Run the installation program.

    • If you are installing from a .bin file, use the following command to run the installation program :

      ./distribution_filename

      Use the -console option to run the installation program in command-line mode.

    • If you are installing from a .zip file, unzip the file, navigate to the extracted folder, and run the following command:

      ./setup

      Use the -console option to run the installation program in command-line mode.

    • If you are installing from an .exe file on Windows, double-click the file.

  4. Specify the directory where you want to install the software or accept the default installation directory.

  5. Select the components to install. If you are using a Application Server bundle without HADB, you will not see this screen.

    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 -This component stores session information so requests can be failed over if you are using the load balancing plug-in.

    • Load Balancing Plug-in - Install the load balancing plug-in 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 plug-in, you cannot continue to install the load balancer plug-in. Supported web servers are Sun Java System Web Server 6.1 and above (including 7.0), Apache 2.0.x, and IIS 5.0 and above.

    • 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 plug-in 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.

    Note –

    Before you run incremental installation of Application Server 9.1 components, ensure that server processes are stopped if Domain Administration Server or Node Agent component is pre-installed on the machine

  6. Choose to install JDK 5 or use a pre-installed JDK 5.

  7. If you selected the load balancing plug-in component:

    1. Select the Web Server you have installed. Ensure that you have installed a supported web server. For a list of supported web servers, see Web Servers in Sun Java System Application Server 9.1 Release Notes.

    2. If you have Sun Java System Web Server, provide the install-dir and the instance-dir. If you have Apache web server or IIS, provide the install-dir.

    3. If you have created a DAS certificate for the Apache web server , automatically import the certificate by providing the Certificate file location.

      The Certificate file location is the location of the DAS certificate file. Ensure that you provide the path to certificate file inclusive of the name of the certificate file.

      Automatic import of DAS certificate is supported only for Apache web server. If you are using Apache web server, install Application Server without the load balancing plug-in. After installing Application Server, create and export a DAS certificate by using the certutil utility, and run the Application Server installer again to install the load balancing plug-in. For instructions on how to create and export DAS certificate for Apache web server, see Chapter 4, Configuring Web Servers for Load Balancing, in Sun Java System Application Server 9.1 High Availability Administration Guide

      If you are using Sun Java System Web Server or IIS, you will need to manually import the DAS certificate. You need to install load balancer without a DAS certificate. After installing the load balancing plug-in, you can create a DAS certificate and manually import it. For instructions, see Chapter 4, Configuring Web Servers for Load Balancing, in Sun Java System Application Server 9.1 High Availability Administration Guide.

  8. If you are installing the load balancing plug-in on Web Server 7.0, the installer displays the Sun Java System Web Server 7.0 information page. Enter the following:

    • Web Server Administrator User - Name of the user who administers the web server.

    • Web Server Administrator Password - Password to access the Web Server administration server.

    • Web Server Host Name - Name of the web server host.

    • Web Server Administration Port - Port number to access the Web Server administration server. The default port is 8989.

    Note –

    • Ensure that you enter valid values for these fields related to Web Server 7.0 administration server. The installer does not validate these values.

    • After you install load balancing plug-in on Windows for Sun Java Systems Web Server 7.0, you need to reboot the machine, so that the installer updates the system PATH environment variable to add the path to the plug-in libraries.

    The Installation Summary page is displayed indicating the installation status.

  9. In the Administration Configuration page (or when prompted at the command line), enter the following:

    • Admin User Name – Name of the user who administers the server.

    • Password – Admin user’s password to access the Admin Server (8-character minimum).

    • Master Password — The master password (8-character minimum).

    • Admin Port – Administration port number for initial server instance. The default value is 4848.

    • HTTP Port - Port number to access the default server instance. You need to provide this value only if you had selected to install DAS.

    • HTTPS Port - Secure port number to access the default server instance. You need to provide this value only if you had selected to install DAS.

    • Node agent name — A name for the node agent. You need to provide this value only if you had selected the Node Agent option.

    • 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 4848

      • 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.

  10. In the Installation Options page, select the options that you want. Installation Options are:

    • Register Application Server: Select this option to register your installation of Application Server.

    • Upgrade from Previous Version: Select this option to upgrade from configuration data from an earlier installation of Application Server.

    • Enable Updatecenter Client: Select this option to enable Updatecenter to check for available updates and collect system data.

    Note –

    If you are running the installer in command-line mode, you need to run the asupgrade command manually.

  11. On the Ready to Install page, click Install Now.

    Note –

    To create a Windows service, the sc.exe utility must be available on the system. Windows 2000 users may need to install the Windows 2000 Resource Kit to get this utility. For other supported Windows versions, the utility is included in the operating system.

  12. After the installation completes, set the PATH environment variable to include the Application Server install-dir/bin directory.

  13. Verify the installation by following the procedures in the Sun Java System Application Server 9.1 Quick Start Guide, located in install-dir/docs/QuickStart.html or on docs.sun.com.

    If you have problems with your installation, see the known issues and limitations in Installation in Sun Java System Application Server 9.1 Release Notes.

Next Steps

If you have installed load balancing plug-in, you need to configure Web Server for load balancing. For detailed instructions on configuring Web Server for load balancing, see Chapter 4, Configuring Web Servers for Load Balancing, in Sun Java System Application Server 9.1 High Availability Administration Guide.