Hardware and Software Requirements

This section lists the requirements that must be met before installing Sun GlassFish Communications Server.

• Supported Platforms

• Important Patch Information

• JDK Version

• Ant Version

• JDBC Drivers and Databases

• Message Queue Versions

• Browsers

• Required Free Ports

• Other Requirements

Supported Platforms

The following table lists the operating systems with which the Sun GlassFish Communications Server is compatible. All supported operating systems are 32-bit unless indicated otherwise. 64-bit JDK is only supported on 64-bit supported operating systems.

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 and 64 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 and 64 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 and 64 bit Production SUSE Linux Enterprise Server 10 (32–bit and 64–bit) (SP1 and SP2 are also supported) 512 MB 1 GB 250 MB free 500 MB free J2SE 5.0 - 32 bit Java SE 6 - 32 bit and 64 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 and 64 bit Development Windows 7 1 GB 2 GB 500 MB free 1 GB free J2SE 5.0 - 32 bit Java SE 6 - 32 bit and 64 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 OpenSolaris 2009.06 512 MB 1 GB 250 MB free 500 MB free J2SE 5.0 - 32 bit Java SE 6 - 32 bit and 64 bit Development

On UNIX, you can check your operating system version using the uname command. Disk space can be checked using the df command.

Important Patch Information

Solaris Patch Requirements

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.

JDK Version

The minimum (and certified) version of JDK required for Communications Server is 1.6.0_23.

To Switch to the Supported Java SE Version

You can switch to a supported Java SE version by editing the asenv file as described here.

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

2. Stop the Communications Server domains.
3. 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:
4. Edit the as-install/samples/common.properties file, changing the line beginning com.sun.aas.javaRoot... to reference the new Java home directory.
5. Restart Communications Server.

Ant Version

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.

JDBC Drivers and Databases

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 12.5, 15 MS SQL 2000, 2005 DB2 9.1 DB2 8.1, 8.2 MySQL Connector/J Driver 5.1.6 Type 4 MySQL 5.0 Oracle 10g, 11g Type 4 Oracle 10g, 11g -RAC PostGres Type 4 8.2.x

In general, the Communications Server supports all JDBC drivers that meet the Java EE specification.

Message Queue Versions

For file-based installations, Message Queue 4.4 is co-packaged with Communications Server.

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.

Browsers

This section lists the browsers that are supported with the Sun GlassFish Communications Server 2.0.

Table 2-3 Supported Web Browsers

Browser Version Mozilla 1.7.12 Internet Explorer 6.0 Service Pack 2, 7.0 Firefox 2.x, 3.x Safari 3.x,4.x Netscape 8.0.4, 8.1, 9.0, 9.0.x

Required Free Ports

You must have seventeen unused ports available for the ports Communications 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-4 Default Port Assignments for Communications Server

Port Number Usage 4848 Admin Console 8080 HTTP 8081 HTTPS 8686 Pure JMX clients 3700 IIOP 3820 IIOP/SSL 3920 IIOP/SSL with mutual authentication 22 SSH port 9009 Java debugger 6666 OSGi shell telnet port 7676 JMS provider Auto-generated from the operating system's dynamic port range Message Queue TCP port Auto-generated from the operating system's dynamic port range Message Queue Admin port 9090 GMS TCP start port 9200 GMS TCP end port Auto-generated between GMS TCP start and end ports GMS listener port Auto generated between 2048 and 32000 GMS multicast port

Other Requirements

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.

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

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