C H A P T E R  2

Installation

The Sun Ray Connector for Windows Operating Systems Version 2.1 requires Sun Ray Server Software 4.1 or later on any supported operating system.


TABLE 2-1 Supported Operating System Versions for the Sun Ray Windows Connector

Operating System

Version

SuSE Linux Enterprise Server (SLES)

10 with Service Pack 1 or later

Red Hat Enterprise Linux Advanced Server (RHEL AS)

5 Update 1

Solaris (SPARC and x86)

Solaris 10 5/08 or higher

Solaris Trusted Extensions (SPARC and x86)

Solaris 10 5/08 or higher


The Sun Ray Windows Connector software must always be installed and configured on the primary data store server, otherwise Terminal Server licenses and printer configurations will not be stored. This is the case even if the primary data store server is not used to host Sun Ray sessions.

Additional installation requirements include:



Note - If you access terminal server functionality provided by Microsoft operating system products, you need to purchase additional licenses to use such products. Consult the license agreements for the Microsoft operating system products you are using to determine which licenses you must acquire. Currently, information regarding Terminal Services can be found in the following URL: http://www.microsoft.com/windowsserver2003/howtobuy/licensing/ts2003.mspx



Basic Installation (Solaris)

single-step bullet  Before running the installer, create a dedicated UNIX group for the sole use of the Sun Ray Windows Connector.


# groupadd <group-name>

where group-name is the name you assign to this group. The first character of the name must be alphabetic. Do not add users to this group. Once you have created and named the group, follow the steps below to install the Sun Ray Windows Connector.



Note - If you have already mounted the Sun Ray Connector for Windows OS CD-ROM, locally or from a remote server, or extracted the ESD files to an image directory, begin at Step 4.


1. Open a shell window as superuser on the Sun Ray server.

To avoid installation script errors that can occur if user environment settings are carried forward, use one of the following commands for superuser login instead of using the su command without arguments:


% su -


% su - root

2. Insert the Sun Ray Connector for Windows OS CD-ROM.

If a File Manager window opens, close it. The File Manager CD-ROM window is not necessary for installation.

3. Change to the image directory, for example:


# cd /cdrom/cdrom0

4. Install the Sun Ray Windows Connector software.


# ./installer

The installer prompts for the name of the group you want to use for the Sun Ray Windows Connector.


Enter the name of a pre-existing group for use by Sun Ray Connector:

5. Enter the name of the group you created for this purpose at the beginning of this procedure, as below, then press Enter or Return to continue.


Enter the name of a pre-existing group for use by Sun Ray Connector: group-name

6. Run the automatic configuration script.


# /opt/SUNWuttsc/sbin/uttscadm -c

The uttscadm script launches the SRWC proxy daemon uttscpd and adds an entry for uttscpd in the /etc/services file, using port 7014 as the default. uttscpd is described under Proxy Daemon.

7. Restart Sun Ray services if the script asks you to do so.


# /opt/SUNWut/sbin/utrestart



Note - It is not necessary to restart Sun Ray services if the uttscadm script does not ask you to do so.



Basic Installation (Linux)



Note - If you have mounted the Sun Ray Windows Connector CD-ROM locally or from a remote server or extracted the ESD files to an image directory, begin at Step 4.


1. Open a shell window as superuser on the Sun Ray server.

To avoid installation script errors that can occur if user environment settings are carried forward, use one of the following commands for superuser login instead of using the su command without arguments:


% su -


% su - root

2. Insert the Sun Ray Connector for Windows OS CD-ROM.

If a File Manager window opens, close it. The File Manager CD-ROM window is not necessary for installation.

3. Change to the image directory, for example:


# cd /cdrom/cdrom0

4. Install the Sun Ray Windows Connector software.


# ./installer

5. Run the automatic configuration script.


# /opt/SUNWuttsc/sbin/uttscadm -c

The uttscadm script may prompt you for a path to the OpenSSL libraries.

6. Accept the default path, or supply a different path, if applicable.

7. Restart Sun Ray services if the script asks you to do so.


# /opt/SUNWut/sbin/utrestart



Note - It is not necessary to restart Sun Ray services if the uttscadm script does not ask you to do so.



Uninstallation

1. Before uninstalling the Sun Ray Windows Connector, use the following command to unconfigure it:


# /opt/SUNWuttsc/sbin/uttscadm -u

On Solaris, the uttscpd entry is removed from the /etc/services file and the SRWC proxy daemon is stopped.

2. To remove the Sun Ray Windows Connector software, type the following command:


# /opt/SUNWuttsc/sbin/uninstaller

3. Answer Y or N to the Accept (Y/N) prompt.

a. Answer N to leave the existing installation in place.

or

b. Answer Y to uninstall the old version of Sun Ray Windows Connector software.


Upgrade Procedure



Note - To upgrade from an earlier version of the Sun Ray Windows Connector, you must run the installer and the uttscadm configuration script, as described in this procedure.


1. Change to the image directory of the Sun Ray Windows Connector CD-ROM, for example:


# cd /cdrom/cdrom0

2. Install the Sun Ray Windows Connector software.


# ./installer

The installer script indicates what Sun Ray Windows Connector software is already installed on your system, for example:


Sun Ray Connector 2.0 is currently installed.
Do you want to uninstall it
and install Sun Ray Connector 2.1?
Accept (Y/N):

3. Answer Y or N to the Accept (Y/N) prompt.

a. Answer N to leave the existing installation in place.

or

b. Answer Y to uninstall the old version of Sun Ray Windows Connector software and install the newer version.

The existing Sun Ray data store is not removed or touched by the upgrade procedure.

4. Run the automatic configuration script again.


# /opt/SUNWuttsc/sbin/uttscadm -c


Multimedia Redirection

The multimedia component redirects video streams to provide better performance for various models of Sun Ray DTU. It supports Windows Media Player 10 or 11 on Windows 2003 and Windows XP, and includes the following items, all of which intercept H.264 and VC-1 and uncompressed YUV streams:


Name

Description

Sun Video Renderer

Microsoft DirectShow filter

Sun Audio Renderer

Microsoft DirectShow filter

Sun DMO

DirectX Media Object (DMO) component


The multimedia component is delivered in the Supplemental section of the SRWC image, under Supplemental/SunMMR.

Installation and Registration

To install and register the multimedia component:

1. Run setup.exe on the destination Windows server.

2. Select the Everyone option during installation.

Additional Requirements for H.264 (MPEG-4)

The multimedia component does not include audio/video demux and decoders for H.264 (MPEG-4) streams; however, these are available as freeware as well as from third parties. To ensure that MPEG-4 video streams are accelerated properly, you need to download some third-party or freeware solutions. One way to do so would be to download the following freeware:

and

As an alternative to Matroska Splitter and ffDShow, you can use a third-party codec, such as this one from MainConcept:

For the MainConcept codec, only the following are required:



Note - Many other solutions are possible but cannot all be listed here.


Xinerama Limitation

H264 and VC-1 support on the DTU is not available for Xinerama sessions. In Xinerama sessions, video windows may be dragged from one DTU to another or may span multiple DTUs, but audio/video synchronization of H264 and VC-1 support is limited to the primary DTU, and the videos cannot be synchronized between DTUs. H264 and VC-1 videos may still be rendered by the application in the same manner they would be rendered on Sun Ray 1 DTUs.

For more information on Xinerama, see the Sun Ray Server Software 4.1 Administrator’s Guide.