This section lists the requirements that must be met before installing Sun GlassFish Communications Server.
All supported operating systems are 32-bit unless indicated otherwise. The 64-bit JDK is supported only on 64-bit supported operating systems.
The following table lists the operating systems with which the Sun GlassFish Communications Server is compatible.
Table 2–1 Supported Operating Systems
Operating System |
Minimum Memory |
Recommended Memory |
Minimum Disk Space |
Recommended Disk Space |
JVM |
Deployment Type |
---|---|---|---|---|---|---|
Sun Solaris 10 (x86)(32–bit and 64–bit) |
512 MB |
512 MB |
250 MB free |
500 MB free |
J2SE 5.0 - 32 bit Java SE 6 - 32 bit |
Production |
Sun Solaris 10 (SPARC)(32–bit and 64–bit) |
512 MB |
512 MB |
250 MB free |
500 MB free |
J2SE 5.0 - 32 bit Java SE 6 - 32 bit |
Production |
Red Hat Enterprise Linux 3.0 Update 1, 4.0, and 5.x (32-bit and 64-bit) |
512 MB |
1 GB |
250 MB free |
500 MB free |
J2SE 5.0 - 32 bit Java SE 6 - 32 bit |
Production |
SUSE Linux Enterprise Server 10 SP1(32–bit and 64–bit) |
512 MB |
1 GB |
250 MB free |
500 MB free |
J2SE 5.0 - 32 bit Java SE 6 - 32 bit |
Production |
Windows XP Windows Vista Windows 2008 |
1 GB |
2 GB |
500 MB free |
1 GB free |
J2SE 5.0 - 32 bit Java SE 6 - 32 bit |
Development |
Macintosh OS 10.4, 10.5 |
512 MB |
1 GB |
250 MB free |
500 MB free |
J2SE 5.0 - 32 bit Java SE 6 - 32 bit |
Development |
On UNIXTM, you can check your operating system version using the uname command. Disk space can be checked using the df command.
It is recommended that you use the NTFS file system rather than FAT or FAT32 when running the Communications Server on any Windows platform.
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 Communications Server is 1.6.0_7.
You can switch to a supported Java SE version by editing the asenv file as described here.
If you have not already done so, install the new Java SE version on your system.
The Java SE SDK can be downloaded from http://java.sun.com/javase
Stop the Communications Server domains.
Edit the as-install/config/asenv.conf file (asenv.bat on Windows), changing the value for AS_JAVA to point to the new Java home directory:
Edit the as-install/samples/common.properties file, changing the line beginning com.sun.aas.javaRoot... to reference the new Java home directory.
Restart Communications Server.
The Ant version bundled with SailFin JAR installation is 1.6.5. To build a custom Application Router application, you need Ant 1.7, which you will need to download separately.
Table 2–2 lists databases and drivers that meet the Java EE compatibility requirements. All supported configurations of the Sun GlassFish Communications Server must contain at least one database/driver combination from this table, such as the bundled Java DB database and driver. In addition, the Communications Server is designed to support JDBC connectivity to any additional DBMS with a corresponding JDBC driver.
Table 2–2 Java EE-Compatible JDBC Drivers
JDBC Driver Vendor |
JDBC Driver Type |
Supported Database Server |
---|---|---|
Derby Network Client |
Type 4 |
Derby 10.2 |
DataDirect 3.6.x, 3.7.x |
Type 4 |
Oracle 10g Oracle 9i Sybase ASE 15 MS SQL 2005 DB2 9.1 DB2 8.2 |
MySQL Connector/J Driver 5.1.6 |
Type 4 |
MySQL 5.0 |
Oracle 10G |
Type 4 |
Oracle 10g -RAC |
PostGres |
Type 4 |
8.2.x |
Table 2–3 lists all the additional databases and drivers scheduled to be supported in the Communications Server FCS release.
Table 2–3 Supported JDBC Drivers and Databases (Communications Server FCS)
JDBC Driver Vendor |
JDBC Driver Type |
Supported Database Server |
---|---|---|
Oracle OCI |
Type 2 |
Oracle 9i |
IBM DB2 |
Type 2 |
DB2 9.1 |
In general, the Communications Server supports all JDBC drivers that meet the Java EE specification.
For file-based installations, Message Queue 4.3 is co-packaged with Communications Server. For UNIX package-based installations, Message Queue 4.1.1, which is functionally equivalent to 4.3, is provided. Despite the version numbering, Message Queue 4.1.1 is actually backward-compatible with Message Queue 4.2.
The embedded Sun GlassFish Message Queue code that is supplied as part of Communications 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 Communications Server) Message Queue broker running a different version of the Message Queue code is not supported.
This section lists the browsers that are supported with the Sun GlassFish Communications Server 1.5.
Table 2–4 Supported Web Browsers
Browser |
Version |
---|---|
Mozilla |
1.7.12 |
Internet Explorer |
6.0 Service Pack 2, 7.0 |
Firefox |
1.5.x, 2.x |
Safari |
2 |
Netscape |
8.0.4, 8.1, 9.0, 9.0.x |
The following additional requirements should be met before installing the Sun GlassFish Communications Server software.
Free space: your temporary directory must have a minimum of 35MB free for Sun GlassFish Communications Server installation, and 250 MB of free space for the SDK installation.
Using the uninstall program: If you need to remove the Communications 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.
Free ports: You must have seven unused ports available. The installation program automatically detects ports in use and suggests currently unused ports for the default domain. By default, the initial default ports are:
8080 for HTTP, 8181 for HTTPS
3700 for IIOP, 3820 for IIOP/SSL and 3920 for IIOP/SSL with Mutual Authentication
4848 (HTTP) for the Administration Server
8686 (RMI) port for pure JMX Clients
Shutting down firewall (Microsoft Windows) — You must stop any firewall software before installing the Sun GlassFish Communications 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.