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

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, and PAM 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/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	`/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.
JRE 1.5 or later		60 Mbytes

This table shows disk space requirements for various directories.

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

Software Requirements

Java Runtime Environment (JRE)

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

http://java.sun.com/j2se

JRE version 1.5 is also bundled on the SRSS 4.1 CD, in the Supplemental directory.

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

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

Linux Operating System Versions

Sun Ray Server Software 4.1 runs on:

SuSE Linux Enterprise Server (SLES) 10

Red Hat Enterprise Linux (RHEL) 5 Update 1

SuSE Linux Enterprise Server (SLES) 10

All packages are required and must be installed. In addition to the default RPMs selected, add the following items:

C/C++ Development Tools

DHCP & DNS Server

LDAP

tftp

Red Hat Enterprise Linux (RHEL) 5 Update 1

All packages are required and must be installed. In addition to the default RPMs selected, add the following items:

Software Development Tools

glib-1.2.10-20.el5 (32-bit RPM on 32-bit and 64-bit OS)

dhcp-3.0.5-3.el5 (Servers/Network Servers)

openldap-2.3.27-8 (Servers/Network Servers)

openldap-clients-2.3.27-8 (Base System/System Tools)

tftp-server-0.42-3.1 (Servers/Legacy Network Server)

libXp-1.0.0-8.i386.rpm (32-bit RPM on 32-bit and 64-bit OS)

openmotif22-2.2.3-18.i386.rpm (32-bit RPM on 32-bit and 64-bit OS)

openssl-0.9.8b-8.3.el5_0.2.i386.rpm (32-bit RPM on 32-bit and 64-bit OS)

compat-libstdc++-33-3.2.3-61 (32-bit RPM on 32-bit and 64-bit OS)

libusb-devel-0.1.12-5.1.i386 (32-bit RPM for 32-bit OS for libusb)

Caution - The Red Hat installation script asks whether to start a graphical console. Be sure to answer “Yes”, otherwise Sun Ray startup scripts and X initialization scripts may fail to run.

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

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

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.