Sun Shared Visualization 1.1 Client Installation

C H A P T E R 2

This chapter describes installation and configuration information for the Sun Shared Visualization 1.1 client. Topics include:

Sun Shared Visualization 1.1 Software

Installation on a Solaris or Linux Client

Installation on a Mac OS X Client

Installation on a Windows Client which includes these subsections:

To Install TurboVNC on a Windows Client

To Install VirtualGL on a Windows Client

To Install Exceed for Windows

Configuring Exceed for Windows

Note - Unless stated otherwise, the majority of examples provided in this chapter are for the Solaris 10 Operating System.

Note - Names of files and directories that indicate a software release name might be slightly different from the names specified in the Sun Shared Visualization 1.1 documentation. For example, instead of “1.1” you might find “1.1.1”.

Sun Shared Visualization 1.1 Software

This section describes how to install the Sun Shared Visualization 1.1 software onto your client and how to remove the software.

Installation on a Solaris or Linux client installs support for both VirtualGL and TurboVNC.

Installation on a Mac OS X client installs either VirtualGL or TurboVNC, or both.

Installation on a Windows client installs either VirtualGL or TurboVNC, or both.

A Windows client using VirtualGL Image Transport requires both VirtualGL and the third-party Exceed (or Exceed 3D) X windows server. (Exceed software is not included with Sun Shared Visualization software).

Using TurboVNC does not require Exceed software.

A Sun Ray client has nothing to install. (The graphics server has Sun Shared Visualization software installed.)

Installation on a Solaris or Linux Client

Software Components That Are Not Needed on a Client

If you are using Sun Grid Engine, your client mounts that software from your grid’s NFS server. You do not need to install a copy on the client. Therefore, the product’s optional software (listed in TABLE 2-1) is not required on the client.

TABLE 2-1 Optional Software Components, All Unneeded on Clients
Solaris packages	Linux RPMs
`SUNWsge3D`	`sun-n1ge-3D.noarch.rpm`
`SUNWsgear SUNWsgeau` `SUNWsgearsmr`	`sun-n1ge-adv_reserv.noarch.rpm`

The Sun Ray plug-in (Solaris package SUNWvglsr or Linux RPM VirtualGL-SunRay) is installed by default. Though not harmful, this plug-in is not needed on any clients. For instructions to remove the plug-in after installation, see To Remove the Sun Ray Plug-In.

To Install Sun Shared Visualization 1.1 Software on a Solaris or Linux Client

1. Take one of the following actions, depending on your installation media:

Perform Step 2 if you are installing the software from a download directory.

Perform Step 3 if you are installing the software from the CD-ROM.

2. Install the software from a download directory.

a. As superuser, change to that directory and extract the zip file.

# cd /path/to/download/directory
# unzip SharedVisualization_1.1_package.zip

where 1.1 is 1.1.1 in the 1.1.1 release, and package depends on the download, solaris or linux. The directory structure is created and the files are extracted.

b. Change to the installation script directory:

# cd SharedVisualization_1.1_package

c. Continue to Step 4.

3. Install the software from the CD-ROM.

a. As superuser, insert the Sun Shared Visualization 1.1 CD-ROM into an optical drive that is connected to your system.

If your system automatically mounts the disc, continue to Step b.

If your system does not automatically mount the disk, mount it with the following commands:

# mkdir -p /cdrom/SSV1.1
# mount -F hsfs -o ro device /cdrom/SSV1.1

where 1.1 is 1.1.1 in the 1.1.1 release, and device is:

a path (such as /dev/dsk/c0t6d0s2 for the Solaris OS) that is obtained by running the rmformat command, using dsk rather than rdsk

the path /dev/cdrom for Linux

If you are installing the Sun Shared Visualization 1.1 software from a CD-ROM onto a Linux host, you might see the following error:

bash: ./install: /bin/bash: bad interpreter: Permission denied

This error might occur if you use the automounter with default options, or if you have noexec in the CD-ROM mount entry of the /etc/fstab file.

To prevent this error, change the noexec option to exec, or mount the CD-ROM manually using the exec option.

b. Change to the installation directory:

# cd cdrom-path

where the cdrom-path depends on your environment. The following are common names that are available in each environment, but the name on your system might vary:

Environment	CD-ROM Path
Solaris OS	`/cdrom/ssv_1.1`
Red Hat Linux	`/cdrom/ssv_1.1` or `/cdrom/SSV_1.1` or `/media/cdrom`
SuSE Linux	`/media/SSV_1_1` or `/media/dvd`
Ubuntu Linux	`/cdrom/` or `/media/cdrom` or `/media/cdrom0`

If you used the mkdir command in Step a in any environment, you can change to the installation directory with this command:

# cd /cdrom/SSV1.1*

c. Continue to Step 4.

4. Run the installation script:

# ./install

The script begins:

Sun Microsystems, Inc. ("Sun") ENTITLEMENT for SOFTWARE
 
Licensee/Company: Entity receiving Software.
 
Effective Date: Date of delivery of the Software to You.
....

The script displays the licensing agreement, and asks:

...
Agreement. No modification of this Agreement will be binding, unless in writing
and signed by an authorized representative of each party.
 
Please contact Sun Microsystems, Inc. 4150 Network Circle, Santa Clara, 
California 95054 if you have questions.
 
 
Do you accept the license agreement? [y/n]:

5. To proceed with software installation, type y.

After agreement, the script begins installation:

This program installs the software for the Sun Shared Visualization 1.1
 
Copyright 2007 Sun Microsystems, Inc.  All rights reserved.
Use is subject to license terms.

The script checks for a newer version of the Sun Shared Visualization 1.1 software. If the script finds one, the script displays:

This system has a higher version of Sun Shared Visualization
software than is available in this Release.  Sun Shared
Visualization software from this release will not be installed.

Otherwise, the script begins adding packages and asks you about optional software:

application SUNWsge3D    Sun Grid Engine Graphic Extensions
application SUNWsgearsmr Sun Grid Engine Graphic Advance Reservations
application SUNWsgeau    Sun Grid Engine Graphic Advance Reservations (Usr)
 
Do you wish to install the optional Software (SUNWsge3D SUNWsgeau
SUNWsgearsmr)?  [y,n,?,q]

The details of this question will vary, depending on your operating system.

6. Answer n.

The optional software is needed only on servers. See Software Components That Are Not Needed on a Client. The script informs you:

This script is about to take the following actions:
- Install Sun Shared Visualization Software 
 
To cancel installation of this software, press ’q’ followed by a Return.
	 **OR**
Press Return key to begin installation:

7. Press the Return key to continue installation.

The script begins installing required patches and packages:

*** Installing Sun Shared Visualization Software for Solaris 10...
Installing required packages:
	SUNWtvnc SUNWvgl SUNWvglsr SUNWvrpt
 
Installation of <SUNWtvnc> was successful.
Installation of <SUNWvgl> was successful.
Installation of <SUNWvglsr> was successful.
Installation of <SUNWvrpt> was successful.
 
*** Installation complete.

The script informs you how to remove the software, and where a log file of the installation is located:

To remove this software, use the ’remove’ script on this CDROM, or
the following script:
 
	/var/tmp/SharedVis_remove
 
A log of this installation can be found at:
	/var/tmp/SharedVis.install.2007.12.22.0952

The log file is named with a date and time stamp. In this example, December 22, 2007 at 9:52 am.

Secure Shell on Solaris 8 and 9

vglconnect uses the secure shell (ssh), which may not be installed on older Solaris releases. If your need to use Sun Shared Visualization on a Solaris host without ssh, you need to install ssh, for example, from http://www.sunfreeware.com/openssh8.html or http://www.sunfreeware.com/openssh9.html

To Remove the Sun Ray Plug-In

The Solaris package SUNWvglsr and the Linux RPM VirtualGL-SunRay are server support for Sun Ray clients. This plug-in is not needed on a client, though it is installed by the installation script on a Solaris or Linux host. See Software Components That Are Not Needed on a Client. When the installation script is completed, you can leave the plug-in installed or you can remove it.

Remove the Sun Ray plug-in.

For Solaris clients, type:

# pkgrm SUNWvglsr

For Linux clients, type:

# rpm -e VirtualGL-SunRay

To Remove the Sun Shared Visualization 1.1 Software From Solaris or Linux Clients

You might need to remove the Sun Shared Visualization 1.1 software in the future.

1. As superuser, run the removal script.

If you are running the removal script installed with the Sun Shared Visualization 1.1 software, type:

# /var/tmp/SharedVis_remove

If you are running the removal script from the CD-ROM:

a. Mount the CD-ROM as in Step a

b. Then cd onto the CD-ROM as in Step b.

c. Then type one of the following commands:

For Solaris OS:

# SharedVisualization_1.1/Solaris/remove

For Linux:

# SharedVisualization_1.1/Linux/remove

The script starts and identifies the software packages that are to be removed.

All required software for the Sun Shared Visualization Software
software  will be REMOVED.
 
The following packages will be removed:
 SUNWvglsr SUNWvgl SUNWtvnc SUNWvrpt

The script asks:

To cancel removal of this software, press ’q’ followed by a Return. 
	 **OR**
Press Return key to begin package removal:

2. Press the Return key to begin package removal.

Pressing the Q key and the Return key aborts the script.

The script does a search for the installed packages and displays the progress.

*** Found the following packages to remove:
              SUNWvglsr SUNWvgl SUNWtvnc SUNWvrpt
*** Removing old package(s)...
 
Removal of <SUNWvglsr> was successful.
 
Removal of <SUNWvgl> was successful.
 
Removal of <SUNWtvnc> was successful.
 
Removal of <SUNWvrpt> was successful.

The script concludes and tells you where a log file of the removal is located.

*** Done.  A log of this removal can be found at:
	/var/tmp/SharedVis.remove.2007.12.22

The log file is named with a date stamp. In this example, December 22, 2007.

Installation on a Mac OS X Client

As explained in Chapter 1 (especially through FIGURE 1-3 and FIGURE 1-5), Sun Shared Visualization software offers two alternative image transport techniques, VirtualGL Image Transport and TurboVNC (using X11 Image Transport). On a Macintosh client, you can install software for either or both forms of image transport.

The Sun Shared Visualization 1.1 CD-ROM did not include the Macintosh installation files (with names including the .dmg extension), but the 1.1.1 release does. This installation software is also available for download. Software for VirtualGL and TurboVNC are downloaded together. You can choose to install either or both.

To Download Sun Shared Visualization 1.1 Client Software for Mac OS X

1. Select the software download option starting from this page:

http://www.sun.com/servers/cr/visualization/get_it.jsp

Follow instructions at this site for downloading Sun Shared Visualization software and documentation.

2. Open the Mac OS X download file.

If the file does not unzip automatially, double-click on the .zip file.

Your desktop should now have two .dmg files:

TurboVNC-version.dmg

VirtualGL-version.dmg

The version number indicates the release of TurboVNC or VirtualGL software.

To Install VirtualGL on a Mac OS X Client

Installing the VirtualGL package on an x86 Apple Macintosh system enables that machine to act as a VGL Image Transport client.

1. Install the X11 application if it isn’t already present on the Macintosh system.

X11 is available on the Mac OS X installation media in the Optional Installs package.

2. Uninstall Applications/VirtualGL if a different version is already present on the Macintosh system.

3. On the Mac OS X desktop, double-click the VirtualGL disk image.

The VirtualGL disk image is named VirtualGL-version.dmg.

4. Open VirtualGL-version.pkg inside the disk image.

Follow any on-screen instructions to install the Mac OS X client. This client-only Mac OS X package will install files in the same locations as files installed by the Linux RPM.

To Install TurboVNC on a Mac OS X Client

Installing the TurboVNC package on an x86 Apple Macintosh system enables that system to start an optomized TurboVNC viewer. VirtualGL can be installed on the same system, but this viewer doesn’t make use of the VirtualGL Mac OS X client. Instead, the graphics server will run VirtualGL and use X11 Image Transport to provide images to the TurboVNC server session (X proxy). The TurboVNC session transports the images to one or more clients, which display the images with the TurboVNC verwer or the Web VNC viewer.

1. Uninstall Application/TurboVNC if a different version is already present on the Macintosh system.

2. On the Mac OS X desktop, double-click the TurboVNC disk image.

The TurboVNC disk image is named TurboVNC-version.dmg.

3. Open TurboVNC-version.pkg inside the disk image.

Follow any on-screen instructions to install the Mac OS X client. This client-only Mac OS X package will install files in the same locations as files installed by the Linux RPM.

Removing Sun Shared Visualization 1.1 Software From a Mac OS X Client

You might need to remove the Sun Shared Visualization 1.1 software in the future.

To Remove Sun Shared Visualization 1.1 Software From a Mac OS X Client

If your Macintosh system already has a package removal function, use that function to remove the Sun Shared Visualization 1.1 software in the future. Otherwise, perform this procedure.

1. Download and install the latest version of OSXPM from http://www.osxgnu.org.

2. Start OSXPM.

3. Click the Delete Package button.

4. Find and highlight any of these package names in the list of packages:

TurboVNC-version.pkg

VirtualGL-version.pkg

5. Click Delete Selected.

Enter your password, if prompted to do so.

Installation on a Windows Client

Using VirtualGL Image Transport on a Windows client requires installing both VirtualGL and the third-party Exceed (or Exceed 3D) X windows server (which is not included with Sun Shared Visualization software). VirtualGL provides a more seamless window experience.

Using TurboVNC requires installing only TurboVNC. This technique provides a single window to each TurboVNC session (on a remote graphics server). TurboVNC also allows collaborative sharing of a TurboVNC session.

Determine if you need to obtain Exceed and install VirtualGL, install TurboVNC, or both.

The self-expanding .exe installers are on the CD-ROM in the SharedVisualization_1.1*/Windows directory. (The same directory is available after unzipping the SharedVisualization_1.1*_windows.zip download file.)

To Install TurboVNC on a Windows Client

Installing the TurboVNC package on a Windows machine enables the machine to start a TurboVNC viewer. You do not need to install VirtualGL on the Windows client. VirtualGL will run on the graphics server, and will use its X11 Image Transport to provide images to the TurboVNC server session (X proxy). TurboVNC transports the images to one or more clients, to be displayed by the TurboVNC viewer or the Web VNC viewer.

1. Locate the TurboVNC installer, TurboVNC.exe.

2. Run the TurboVNC installer, typically by double-clicking its icon.

The only configuration option for installation is the directory in which you want the files to be installed.

Enabling VirtualGL Image Transport on a Windows Client

Installing the VirtualGL package on a Windows machine enables the machine to act as a VGL Image Transport client, along with Exceed or Exceed 3D. You do not need to install VirtualGL or Exceed on the Windows client machine if only TurboVNC clients will be used.

To Install VirtualGL on a Windows Client

1. Locate the VirtualGL installer, VirtualGL.exe.

2. Run the VirtualGL installer, typically by double-clicking its icon.

The only configuration option for installation is the directory in which you want the files to be installed.

To Install Exceed for Windows

1. Install Exceed or Exceed 3D, if the software isn’t already installed.

See the Exceed documentation for instructions.

2. Install patches for Exceed or Exceed 3D, if the patches aren’t already installed.

If your Windows client is using Exceed 2008 to support VirtualGL, you can optimize performance (as much as a 20 percent gain) by enabling the MIT Shared Memory Extension (MIT-SHM extension).

Obtain and install the latest Exceed 2008 Service Pack, including xlib patch xlib.dll v13.0.1.235 (or higher) for Exceed 2008. Patches are available to those with a Hummingbird support account from the Hummingbird support site:
The Sun Shared Visualization 1.1.1 Release Notes might contain more recent information about patches for this product.

http://connectivity.hummingbird.com/support/nc/exceed_patches.html

3. Add the Exceed software path to your system PATH environment variable.

See the Exceed documentation for instructions, if its path has not already been added.

Configuring Exceed for Windows

To Disable Pixel Format Conversion (for Exceed 2006 and Earlier)

1. Load Exceed XConfig.

a. Right-click on the Exceed taskbar icon.

b. Select Tools, then Configuration.

2. Open the X Server Protocol applet in XConfig.

Note - If you are using the Classic View mode of XConfig, open the Protocol applet instead.

3. In the X Server Protocol applet, select the Protocol tab and ensure that the Use 32 Bits Per Pixel For True Color box is unchecked.

4. Click Validate and Apply Changes.

Note - If XConfig asks whether you want to perform a server reset, click Yes.

5. Proceed to To Disable the Backing Store.

To Disable the Backing Store

1. Load Exceed XConfig.

a. Right-click on the Exceed taskbar icon.

b. Select Tools, then Configuration.

2. Open the Other Server Settings applet in XConfig.

Note - If you are using the Classic View mode of XConfig, open the Performance applet instead.

3. Select the Performance tab and ensure that Default Backing Store is set to None.

4. Click Validate and Apply Changes.

Note - If XConfig asks whether you want to perform a server reset, click Yes.

To Obtain Optimal Performance With Exceed

VirtualGL can use the MIT-SHM extension in the Exceed software to accelerate image drawing on Windows clients. By using this extension, the overall performance of the VirtualGL pipeline can be improved by as much as 20%. However, Exceed 2008 requires a patch to enable its MIT-SHM extension to work with VirtualGL. See the Sun Shared Visualization 1.1.1 Release Notes for details.

1. Load Exceed XConfig.

a. Right-click on the Exceed taskbar icon.

b. Select Tools, then Configuration.

2. Open the X Server Protocol applet in XConfig.

Note - If you are using the Classic View mode of XConfig, open the Protocol applet instead.

3. In the X Server Protocol applet, select the Extensions tab and ensure that MIT-SHM is checked.

4. Click Validate and Apply Changes.

Note - If XConfig asks whether you want to perform a server reset, click Yes.

Removing Sun Shared Visualization 1.1 Software From a Windows Client

You might need to remove the Sun Shared Visualization 1.1 software in the future.

To Remove the Sun Shared Visualization 1.1 Software From a Windows Client

Do one of the following:

In a Windows XP client, use the Add or Remove Programs applet in the control panel.

In a Windows Vista client, use the Programs and Features applet.