Preparing for Installation

C H A P T E R 2

The installation process is easy and straightforward; however, it is essential that you verify all requirements before you install Sun Ray Server Software 4.0. This chapter describes what you need to do.

Topics in this chapter include:

Hardware Requirements

Software Requirements

Before you install Sun Ray Server Software, you should:

Verify the operating environment.

Make sure that you are running the desired supported operating system on your system. See Upgrading the Operating System.

Verify that you have installed the latest operating system patches.

For Solaris patches, see Operating System Patch Requirements. For Solaris Trusted Extensions, see also Solaris Trusted Extensions Patch Requirements.

Verify system requirements.

Make sure that the system(s) on which you plan to install the software fulfills the necessary hardware and software requirements.

Note - The utinstall script does not automatically add Sun Ray information to the crontab, syslog, PAM, and SunMC services as earlier versions did; instead, it adds them upon the first reboot after installation or upgrade.

Hardware Requirements

Disk Space

The standard installation of Sun Ray Server Software requires at least 95 MB of disk space. TABLE 2-1 lists the disk space requirements for specific directories.

TABLE 2-1 Sun Ray Server Software Disk Space Requirements
Product	Default Installation Path	Requirements
Sun Ray core software	`/` `/opt` `/var/adm/log` `/var/tmp` `/var/opt/SUNWut`	1 Mbyte 20 Mbytes 1 Mbyte 5 Mbytes Allow enough disk space for the log files.
Sun Ray Data Store 3.0	`/opt/SUNWut/srds` `/etc/opt` `/var/opt/SUNWut/srds`	4 Mbytes in `/opt` 0.1 Mbytes in `/etc` Allow enough disk space for the data store and log files. For 1,000 entries, allocate roughly 1.5 Mbytes of disk space, 64 Mbytes of RAM, and 128 Mbytes of swap space.

This table shows disk space requirements for various directories.

For Solaris Trusted extensions, it is recommended that each system have a minimum of 1 GB of RAM, although 500 MB will work. Further, it is recommended that you use newer-model systems with sufficient capacity so your installation experience will be faster.

Note - The suggested server configuration includes approximately 50-100 MB of swap space per user.

Software Requirements

Java Runtime Environment (JRE)

SRSS 4.0 requires JRE version 1.5 or later. The latest Java release is available at:

http://java.sun.com/j2se

Client vs. Server Java Virtual Machine (JVM)

By default, J2SE 5.0 on server-class machines -- those with at least two CPUs and two GB of physical memory -- uses a server JVM, rather than a client JVM for Java applications. The server JVM’s default options also are tuned for server-type Java applications. These combined defaults produce a large memory footprint and extend the necessary startup time, both of which are undesirable for Java applications in a multiuser environment.

Use the -client option to the java command to specify the client JVM for Java user applications on the Sun Ray server. For further details, see:

http://java.sun.com/j2se/1.5.0/docs/guide/vm/server-class.html

Note - Since the 64-bit JVM is a server VM only, the 32-bit client JVM is preferable, even on 64-bit systems.

Solaris Operating System Versions

Sun Ray Server Software 4.0 runs on Solaris 10 11/06 on SPARC and x86 platforms, including Trusted Extensions. Supported operating systems are summarized in the Sun Ray Server Software 4.0 Release Notes published on docs.sun.com.

If the correct version of the Solaris operating environment is already installed on the system or systems on which you will install Sun Ray Server Software, go to Chapter 3. If you need to upgrade the Solaris operating environment, please follow the instructions in Upgrading the Operating System before continuing.

On SPARC platforms, configure the Sun Ray server with an “Entire Distribution” software cluster installation of the Solaris 10 “Server”, SPARC Platform Edition before you install the Sun Ray sever software.

On x86 platforms, configure the x86 Sun Ray server with an “Entire Distribution” software cluster installation.

You can check the operating system version by typing the following UNIX command as a user of the Sun Ray server:

% cat /etc/release

If the server has a lower version number than you need, contact your Sun Microsystems representative to purchase the latest version of the Solaris software.

Operating System Patch Requirements

Sun Ray Server Software’s utinstall script installs, by default, required patches that have not yet been included in the latest Recommend Patch Cluster (RPC). For the software to function properly, however, you must also install the latest Recommend Patch Cluster (RPC) for the operating system version you intend to run.

Please download the latest RPC from http://sunsolve.sun.com, then navigate to Product Patches->Recommended Patch Clusters->Recommended Solaris Patch Clusters and J2SE Clusters.

From the scrolling list of patch clusters, you can select the latest patches for your operating system version.

Note - As this installation guide nears completion, the resulting URL is
http://sunsolve.Sun.COM/pub-cgi/show.pl?target=patches/patch-accessbut it may change without further notice.

Further information on the latest Sun Ray patches is located at the following URL:

http://www.sun.com/software/sunray/patches.xml

Caution - Failure to install the latest RPC may cause unforeseen problems.

Solaris Trusted Extensions Patch Requirements

In a Solaris Trusted Extensions environment, certain patches must be installed prior to Sun Ray Software installation. These patches are available on the SunSolve trademark Website, and the latest patch numbers are published in the Sun Ray Server Software 4 Release Notes on docs.sun.com.

SunMC Requirements

To use SunMC, the administrator must install the correct version of the SunMC software. See Installing the SunMC Software.

Sun Ray Admin GUI Web Server Requirements

The Sun Ray Administration Tool (Admin GUI) requires that a Web server be installed and running on each Sun Ray Server. Since the previously used CGI-based rendering logic has been completely removed, the new Admin GUI must be hosted in a Web container that supports the Servlet 2.4 and JavaServer Pages trademark 2.0 specification. The Apache Tomcat 5.5 Web container implements these standards and runs on any operating system that has a Java Runtime Environment (JRE).

The utconfig script prompts for the location of an Apache Tomcat HTTP Server and asks whether it should be configured automatically.

If you supply the path and answer Yes, then it is so configured.

If you answer No, then the configuration is stored in /etc/opt/SUNWut/http/http.conf. You can then use this file to configure the HTTP server manually.

An Apache Tomcat 5.5 archive is included in the Sun Ray Server Software 4.0 image under Supplemental/Apache_Tomcat. The most recent version of Tomcat 5.5 can be downloaded from http://tomcat.apache.org.

The Sun Ray configuration script uses port 1660 for the Sun Ray Administration Tool (Admin GUI) by default. If this port is unavailable, you can configure a new port while running the utconfig script.

To Install Apache Tomcat

If Tomcat 5.5 is already installed on your system, you can omit the steps below and specify the path, if necessary, during configuration (see Configure Sun Ray Server Software).

1. As superuser, open a shell window on the Sun Ray server.

% su -

2. Change to the Apache_Tomcat directory, for instance:

# cd /cdrom/cdrom0/Supplemental/Apache_Tomcat

3. Extract the Tomcat archive into a suitable directory, such as /opt:

# tar -xvz -C /opt -f apache-tomcat-5.5.20.tar.gz

The Tomcat archive uses GNU tar extensions and must be untarred with a GNU-compatible version of the tar command.

Under Solaris, use gtar to extract the archive:

# /usr/sfw/bin/gtar -xvz -C /opt -f apache-tomcat-5.5.20.tar.gz

4. For convenience, you can create a symbolic link to the installation to make future Tomcat updates easier:

# ln -s /opt/apache-tomcat-5.5.20 /opt/apache-tomcat

Web Browser Requirements

To view the Sun Ray Administration Tool (Admin GUI), you must have a Web browser, such as Mozilla or Netscape trademark Communicator, installed on the system that will display it.

The latest version of the Mozilla browser is available at:

http://www.mozilla.org/download.html

The latest version of the Netscape Communicator Web browser is available at:

http://www.netscape.com/download

Sun Ray Data Store Port Requirements

When you configure a new Sun Ray server in a failover environment that uses SRSS 4.0 only, service port 7012 is used by default.

If you already have an LDAP (Lightweight Data Access Protocol) server configured on the Sun Ray server, it can coexist with Sun Ray Data Store; however, it must not use port 7012, which is reserved for use by the Sun Ray Data Store.

If you configure a new Sun Ray server in a mixed failover group, you must make sure that the primary server is running SRSS 4.0.

Note - Although it is possible to configure mixed failover groups consisting of servers running various versions of Sun Ray Server Software, this practice is discouraged. For more information, see Chapter 11 in the Sun Ray Server Software 4.0 Administrator’s Guide.

If the secondary server is running SRSS 4.0, no special care is required; the utreplica utility automatically synchronizes with the port number on the primary.