There are two paths for installing GlassFish Enterprise Server for use with Web Space Server:
Use the bundled version of GlassFish included with Web Space Server
The various Web Space Server 10.0 evaluation bundles include a copy of GlassFish 2.1 Enterprise Server software suitable for production use. You can use the bundled version of GlassFish if you do not already have or do not wish to perform a separate GlassFish Enterprise Server installation. See Getting Sun GlassFish Web Space Server Software for more information about the various Web Space Server bundles.
Use a standalone version of GlassFish Enterprise Server
In many production environments, Sun GlassFish Enterprise Server may already be installed or it may be desirable, for any number of reasons, to install GlassFish separately from Web Space Server. For such environments, GlassFish Enterprise Server software is available in two package formats:
GlassFish JAR-based installer
The JAR-based installer is useful for development and testing environments, and is typically installed by an individual on his or her personal desktop.
GlassFish production packages
The various Sun GlassFish Enterprise Server production packages are recommended for deploying Web Space Server in production environments, and can be bundled with MySQL, HADB support, and/or Enterprise Manager administration software.
Instructions for installing these two packages are provided in the next two sections.
Set the JAVA_HOME environment variable to point to the directory in which JDK 1.6 is installed.
The latest JDK packages are available from the Sun Java SE downloads page.
Set the ANT_HOME environment variable to point to an installation of Ant 1.7 or above.
The latest Ant packages are available from the Apache Ant Project downloads page.
GlassFish Enterprise Server is bundled with Ant 1.6.5, which is too old to work with Web Space Server. Make sure that ANT_HOME points to an installation of Ant 1.7 or later, and is not pointing to the version of Ant bundled with GlassFish.
Download the GlassFish Enterprise v2.1 package to the directory of your choice.
Change to the directory in which you downloaded the GlassFish JAR package, and then start the GlassFish installer:
cd download_directory java -Xmx256m -jar filename.jar |
The directory in which the GlassFish components are unpacked is referred to throughout this documentation as gf-install-dir.
Change to the gf-install-dir directory and run the GlassFish setup script.
cd gf-install-dir ant -f setup.xml |
If you prefer to install GlassFish with clustering support, run the setup-cluster.xml script instead of setup.xml.
ant -f setup-cluster.xml |
Change to the gf-install-dir/bin directory and start the default GlassFish domain.
cd gf-install-dir/bin ./asadmin start-domain |
Proceed to the instructions in To Install Web Space Server Software Into an Existing Sun GlassFish Enterprise Server Configuration.
Refer to the GlassFish Quick Start Guides more information about getting started with the various GlassFish packages. For more information about configuring GlassFish clustering and load balancing, refer to Configuring the Cluster/Load Balancer with GlassFish V2.
The installation instructions for the various GlassFish Enterprise packages vary depending on the particular bundle and features being used. For comprehensive instructions about installing Sun GlassFish Enterprise Server, see the Sun GlassFish Enterprise Server 2.1 Installation Guide.
With the foregoing in mind, this procedure explains only the steps required to configure GlassFish Enterprise Server so it can work with Web Space Server. This procedure is not meant to provide comprehensive GlassFish installation instructions.
Set the JAVA_HOME environment variable to point to the directory in which JDK 1.6 is installed.
The latest JDK packages are available from the Sun Java SE downloads page.
Set the ANT_HOME environment variable to point to an installation of Ant 1.7 or above.
The latest Ant packages are available from the Apache Ant Project downloads page.
GlassFish Enterprise Server is bundled with Ant 1.6.5, which is too old to work with Web Space Server. Make sure that ANT_HOME points to an installation of Ant 1.7 or later, and is not pointing to the version of Ant bundled with GlassFish.
Install Sun GlassFish Enterprise Server 2.1 on your machine.
Follow the installation instructions for your particular GlassFish Enterprise Server package.
The directory in which the GlassFish components are installed is referred to throughout this documentation as gf-install-dir.
Change to the gf-install-dir/bin directory and start the default GlassFish domain.
cd gf-install-dir/bin ./asadmin start-domain |
Proceed to the instructions in To Install Web Space Server Software Into an Existing Sun GlassFish Enterprise Server Configuration for additional GlassFish configuration steps.
Refer to the GlassFish Quick Start Guides more information about getting started with the various GlassFish packages. For more information about configuring GlassFish clustering and load balancing, refer to Configuring the Cluster/Load Balancer with GlassFish V2.