Installing an Application Server

Web Space Server requires a Java EE–compliant application server in which to run. Currently, Web Space Server runs on the following application servers:

• Sun GlassFish Enterprise Server v2.1. Note that GlassFish Enterprise v3 software can also be used, but it is not supported for production deployments. Refer to Software and Hardware Requirements for the complete list of Web Space Server installation requirements.

• Oracle WebLogic Server 10g Enterprise Edition

The following subsections explain how to install these two application servers for use with Web Space Server.

• Installing Sun GlassFish Enterprise Server Software

• Installing Oracle WebLogic Server Software

Installing Sun GlassFish Enterprise Server Software

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.

• To Install GlassFish Enterprise Server Using the JAR-Based Installer

• To Install Other GlassFish Enterprise Server Packages

To Install GlassFish Enterprise Server Using the JAR-Based Installer

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

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

   ---

   Note –

   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.

   ---

3. Download the GlassFish Enterprise v2.1 package to the directory of your choice.

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

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

6. Change to the gf-install-dir/bin directory and start the default GlassFish domain.

   cd gf-install-dir/bin ./asadmin start-domain

7. Proceed to the instructions in To Install Web Space Server Software Into an Existing Sun GlassFish Enterprise Server Configuration.

See Also

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.

To Install Other GlassFish Enterprise Server Packages

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.

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

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

   ---

   Note –

   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.

   ---

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

4. Change to the gf-install-dir/bin directory and start the default GlassFish domain.

   cd gf-install-dir/bin ./asadmin start-domain

5. Proceed to the instructions in To Install Web Space Server Software Into an Existing Sun GlassFish Enterprise Server Configuration for additional GlassFish configuration steps.

See Also

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.

Installing Oracle WebLogic Server Software

There are several different WebLogic packages available for several platforms. The specific instructions for your package and platform will vary. The intention in this section is to simply highlight the configuration steps that are relevant for running Web Space Server software in a WebLogic Server environment.

Refer to the Oracle WebLogic Server product page for complete WebLogic installation and configuration instructions.

To Install Oracle WebLogic Server Software

In these instructions, the root WebLogic installation directory is referred to as or-install-dir.

1. Download the Oracle WebLogic Server package you want to use.

   Web Space Server 10.0 software works with Weblogic 10g and 11g software.

2. Start the WebLogic configuration wizard.

   • On Linux and Solaris, enter the following in a command shell:

     /root/Oracle/Middleware/wlserver_10.3/common/bin/config.sh

   • On Microsoft Windows, go to Start->Programs->Oracle WebLogic->WebLogic Server->Tools->Configuration Wizard.

3. Create a WebLogic domain for Web Space Server.

   1. Click Generate Domain, and then click Next.

   2. Specify domain1 as the domain name.

   3. Enter a user name and password.

   4. Select Development mode and choose the Sun or JRockit JDK.

   5. Click Create.

4. Start the WebLogic domain.

   1. In a command shell, change to the or-install-dir/domains/domain1/bin directory.

   2. Enter the domain startup command.

      • On Linux and Solaris:

        ./startWeblogic.sh

      • On Microsoft Windows:

        .\startWeblogic.cmd