This section lists the requirements that must be met before installing Sun GlassFish Enterprise Server.
The following table lists the operating systems with which the Sun GlassFish Enterprise Server v2.1.1 is compatible. All supported operating systems are 32-bit unless indicated otherwise. 64-bit JDK is only supported on 64-bit supported operating systems.
Note - The table lists the minimum required version of each supported operating system. Service pack updates to the minimum required version are also supported.
Table 2-1 Supported Operating Systems
On UNIX, you can check your operating system version using the uname command. Disk space can be checked using the df command.
The Enterprise Server enterprise profile is not supported on any 64–bit platform.
Its recommended that you use the NTFS file system rather than FAT or FAT32 when running the Enterprise Server on any Microsoft Windows platform.
Although Mac OS is not supported for production deployments, it is supported for development purposes. You can get information on downloading the Macintosh operating system from the GlassFish downloads page , or through the SDK page where Mac is listed. For example, on the Java EE 5 SDK Update 5 download page.
System virtualization is a technology that enables multiple operating system (OS) instances to execute independently on shared hardware. Functionally, software deployed to an OS hosted in a virtualized environment is generally unaware that the underlying platform has been virtualized. Sun performs testing of its Sun Java System products on select system virtualization and OS combinations to help validate that the Sun Java System products continue to function on properly sized and configured virtualized environments as they do on non-virtualized systems.
It is recommended that Solaris 10 (x86, SPARC) users have the “Sun recommended patch cluster” installed. This patch cluster is available under “Recommended and Security Patches” on the SunSolve Web site.
The minimum (and certified) version of JDK required for Enterprise Server is 1.6.0_23.
You can switch to a supported Java SE version by editing the asenv file as described here.
The Java SE SDK can be downloaded from http://java.sun.com/javase
From the command line:
From the Administration Console:
Click the Application Server node.
Click Stop Instance.
From the command line:
From the Administration Console:
Click the Application Server node.
Click Start Instance.
Version 1.6.5 of Apache Ant is bundled with Enterprise Server on all operating systems except Ubuntu Linux. Version 1.7.0 of Apache Ant is bundled with Ubuntu Linux and used with Enterprise Server .
Table 2-2 lists databases and drivers that meet the Java EE compatibility requirements. All supported configurations of the Sun GlassFish Enterprise Server must contain at least one database/driver combination from this table, such as the bundled Java DB database and driver. In addition, the Enterprise Server is designed to support JDBC connectivity to any additional DBMS with a corresponding JDBC driver.
Table 2-2 Java EE-Compatible JDBC Drivers
In general, the Enterprise Server v2.1.1 supports all JDBC drivers that meet the Java EE specification.
This section provides instructions for using the Java DB database implementation bundled with Enterprise Server v2.1.1. Java DB is based on the Apache Derby database.
Sun GlassFish Enterprise Server has the following asadmin commands for starting and stopping the Java DB Network Server.
Use the asadmin start-database command to start an instance of the Java DB network server:
asadmin start-database [--dbhost 0.0.0.0] [--dbport 1527] [--dbhome path]
The default value for the host is 0.0.0.0, which enables Java DB to listen on localhost as well as the IP/hostname interfaces. The value for the dbhome property is the location of where the Java DB databases reside. The default path is as-install/javadb.
Use the asadmin stop-database command to shut down a running instance of the Java DB network server:
asadmin stop-database [--dbhost 0.0.0.0] [--dbport 1527]
The Java DB configuration that is supplied with Enterprise Server 2..1.1 includes scripts that can help you use Java DB. The following scripts are available for use in the as-install/javadb/bin directory:
startNetworkServer, startNetworkServer.bat— Script to start the network server
stopNetworkServer, stopNetworkServer.bat— Script to stop the network server
ij, ij.bat— Interactive JDBC scripting tool
dblook, dblook.bat — Script to view all or part of the DDL for a database
sysinfo, sysinfo.bat — Script to display versioning information about the Java DB environment
NetworkServerControl, NetworkServerControl.bat — Script which provides a means of executing commands on the NetworkServerControl API
For more information about these utilities, see the following Derby documentation:
For file-based installations, Message Queue 4.4 is co-packaged with Enterprise Server.
The embedded Sun GlassFish Message Queue code that is supplied as part of Enterprise Server is only tested and certified (typically) against the equivalent version of the Message Queue broker. This means that using the supplied embedded Message Queue code to connect to a remote (not managed by Enterprise Server) Message Queue broker running a different version of the Message Queue code is not supported.
This section lists the Web servers that are supported for the Sun GlassFish Enterprise Server load balancing plugin.
Table 2-3 Supported Web Servers
This section lists the browsers that are supported with the Sun GlassFish Enterprise Server v2.1.1.
Table 2-4 Supported Web Browsers
In addition to the requirements listed in Hardware and Software Requirements, verify that your system meets the requirements listed below for running HADB.
Note - HADB is only bundled with the Enterprise Server v2.1.1 Enterprise profile. Also note that the Java components of the system have been built and tested on JDK 5 and JDK 6.
Solaris (SPARC). – Solaris 8 MU7, Solaris 9 MU7, Solaris 10 RR.
Solaris (x86). – Solaris 9 MU7, Solaris 10 RR.
Red Hat Enterprise Linux. 2.1 U5 (only ext2 file system is supported, not ext3). 3.0 U4 (both ext2 and ext3,4, 5 are supported. Updates before U4 are not recommended due to excessive swapping.) Note that HADB is tested on these operating system versions in 32–bit mode only. Also, note that HADB does not support Red Hat Enterprise Linux 3.0 running in 64–bit mode due to a bug in the operating system (see known bug 6249685 in the High Availability section for details about impact on HADB). Versions 4 and 5 are also supported.
Microsoft Windows. – Microsoft Windows 2000 Advanced Server Service Pack 4 and Microsoft Windows 2003 Enterprise Edition, Windows 2008, Windows XP Professional are supported. Note that HADB does not support any of the forthcoming Microsoft Windows operating system versions in 64–bit mode.
Minimum memory - 320 MB per node.
Minimum free disk space - 70 MB for HADB binaries per host. In addition, disk space is needed for the data devices, 512 MB for a test installation per node.
Recommended memory - 512 MB per node.
Recommended free disk space - 70 MB for HADB binaries per host. In addition, disk space is needed for the data devices, 1200 MB for a test installation per node.
Note - Make sure write caching is disabled on devices storing HADB data and log files. Write caching is enabled by default on some Solaris platforms; for example, Solaris x86.
Minimum memory - 128 MB
Minimum free disk space - 70 MB for HADB binaries per node
Minimum memory - 120 MB
Minimum free disk space - 20 MB
Refer to the Sun GlassFish Enterprise Server v2.1.1 Upgrade Guide for complete instructions for upgrading from a previous version of the Enterprise Server to the current version.
You must have seventeen unused ports available for the ports Enterprise Server uses. The installation program automatically detects ports that are in use and suggests currently unused ports for the default settings. The initial default port assignments are listed in the following table. If these default port numbers are in use, the installation program assigns a randomly selected port number from the dynamic port range. The selected port number might not be the next available port number.
Table 2-5 Default Port Assignments for Enterprise Server
The following additional requirements should be met before installing the Sun GlassFish Enterprise Server software.
Free space: your temporary directory must have a minimum of 35MB free for Sun GlassFish Enterprise Server installation, and 250 MB of free space for the SDK installation.
Using the uninstall program: If you need to remove the Enterprise Server from your system, it is important to use the uninstall program that is included with the software. If you attempt to use another method, problems will arise when you try to reinstall the same version, or when you install a new version.
Replacing previously-installed servers (UNIX) — Refer to the Sun GlassFish Enterprise Server v2.1.1 Upgrade Guide for complete instructions for upgrading from a previous version of the Enterprise Server.
Shutting down firewall (Microsoft Windows) — You must stop any firewall software before installing the Sun GlassFish Enterprise Server software, because some of this software disables all ports by default. The installation program must be able to accurately determine which ports are available.
For further compatibility information, see theSun GlassFish Enterprise Server v2.1.1 Upgrade Guide.