Sun Java System Application Server 9.1 Update 1 Installation Guide

Installing GlassFish v2

This section provides instructions for installing GlassFish v2 distribution and for installing the load balancing plug-in for GlassFish v2. This distribution does not support upgrades or patching.

ProcedureTo Install GlassFish Application Server

Before You Begin

Get JDK (Java SE Development Kit) 5 or higher from http://java.sun.com/javase/, if you are using Solaris, Linux, or Windows.

If you are using Mac OS X, you need to download JDK 5 (supported on Mac OS X 1.4 or later) from http://www.apple.com/support/downloads/java2se50release3.html and make JDK 5 the default JVM.

If you are using AIX, download JDK 5 from: http://www.ibm.com/developerworks/java/jdk/aix/service.html.

  1. Download the GlassFish v2 distribution https://glassfish.dev.java.net/public/downloadsindex.html.

  2. Set the environment variable JAVA_HOME to point to the directory in which JDK 5 is installed.

  3. Run the following command:

    java -Xmx256m -jar <filename>.jar

  4. Set ANT_HOME to point to the ant 1.6.5 installation, which is at <downloaded-dir>/glassfish/lib/ant directory.

  5. Navigate to the glassfish directory:

    cd glassfish

  6. If you do not want clustering capabilities, run the following command:

    ant -f setup.xml

    • If you want to use GlassFish with clustering, change the command to:

      ant -f setup-cluster.xml

  7. Use the Admin Console or Update Center to register your installation of GlassFish. Start GlassFish using the instructions at Starting the Server in Sun Java System Application Server 9.1 Quick Start Guide.

ProcedureTo Install the Load Balancing Plug-in (standalone)

Use the procedures in this section if the load balancing plug-in is not part of the Application Server distribution you are using. If you are using the Sun Java System Application Server 9.1 (bundle with HADB), see To Install Application Server 9.1 Update 1 with HADB for instructions for installing the load balancing plug-in.

The load balancing plug-in is not currently bundled with the GlassFish v2Application Server. If you want load balancing capabilities, you can download the load balancing plug-in from the following locations:

  1. Before you install the load balancer plug-in, 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 Update 1 Release Notes.

  2. Create the lbplugin directory within <glassfish_install_dir>/lib.

  3. Unjar this file in the lbplugin directory. Run the following command: jar -xvf <lbplugin>.jar.

  4. Unzip the following two files: SUNWaslb.zip and SUNWaspx.zip in the same directory. Delete the zip files.

  5. Change permissions on all shared libraries within lbplugin directory. Run the following command: chmod -R 755 ${glassfish.home}/lib/lbplugin/lib.

  6. Create a configuration for the load balancer. See Setting up Load Balancing in Sun Java System Application Server 9.1 Quick Start Guide.

  7. Restart the Web Server after creating a configuration for the load balancer.

Next Steps

You need to configure Web Server for load balancing. For detailed instructions on manually configuring Web Server for load balancing, see Configuring Sun Java System Web Server in Sun Java System Application Server 9.1 High Availability Administration Guide.