Sun Logo


SRSS 3.1.1 Administrator's Guide for Linux

for the Linux Operating System

819-6686



Contents

Figures

Tables

Preface

1. Sun Ray System Overview

Computing Model

The Sun Ray System

Sun Ray DTU

Multihead Displays

Firmware Module

Sun Ray Server Software

Authentication Manager

Sessions and Services

Session Manager

CLI and Admin GUI

Data Store

Network Components

Sun Ray Interconnect Fabric

VLAN Implementation

LAN Implementation

Physical Connections

Deployment Examples

Small Deployments

Medium to Large Deployments

Failover Group Scenario

Regional Hotdesking

Security Considerations

2. Command-Line Interface

Supported Commands

procedure iconsmall spaceTo Stop Sun Ray Services

procedure iconsmall spaceTo Start Sun Ray Services

Session Redirection

procedure iconsmall spaceTo Redirect to a Different Server

procedure iconsmall spaceTo Redirect a DTU Manually

procedure iconsmall spaceTo List Available Hosts

procedure iconsmall spaceTo Select a Server with the Latest Session

Changing Policies

Enabling Multiple Administration Accounts

PAM Entries

procedure iconsmall spaceTo Configure UNIX Users

procedure iconsmall spaceTo Revert to the Old admin User

Administration GUI Audit Trail

Enabling and Disabling Device Services

procedure iconsmall spaceTo Determine the Current State of Device Services

procedure iconsmall spaceTo enable usb service

procedure iconsmall spaceTo disable usb service

procedure iconsmall spaceTo perform a cold restart

Configuring Interfaces on the Sun Ray Interconnect Fabric

procedure iconsmall spaceTo Add an Interface

procedure iconsmall spaceTo Delete an Interface

procedure iconsmall spaceTo Print the Sun Ray Private Interconnect Configuration

procedure iconsmall spaceTo Add a LAN Subnet

procedure iconsmall spaceTo Delete a LAN Subnet

procedure iconsmall spaceTo Print Public LAN Subnets

procedure iconsmall spaceTo Remove All Interfaces and Subnets

Managing Firmware Versions

procedure iconsmall spaceTo Update All the DTUs on an Interface

procedure iconsmall spaceTo Update a DTU Using the Ethernet (MAC) Address

Restarting the Sun Ray Data Store (SRDS)

procedure iconsmall spaceTo Restart Sun Ray Data Store

Smart Card Configuration Files

procedure iconsmall spaceTo Load a Configuration File Into the Directory

Configuring and Using Token Readers

procedure iconsmall spaceTo Configure a Token Reader

procedure iconsmall spaceTo Get a Token ID From a Token Reader

Using the utcapture Tool

procedure iconsmall spaceTo Start utcapture

3. Administration Tool

Administration Data

Logging In

procedure iconsmall spaceTo Log Into the Administration Tool

procedure iconsmall spaceTo Change the Administrator's Password

Changing Policies

procedure iconsmall spaceTo Change the Policy

Restarting Sun Ray Services

procedure iconsmall spaceTo Preserve Sessions Upon Restart

procedure iconsmall spaceTo Terminate Sessions Upon Restart

Token Readers

Creating a Token Reader

procedure iconsmall spaceTo Create a Token Reader

procedure iconsmall spaceTo Locate Token Readers

procedure iconsmall spaceTo Get Information on a Token Reader

Managing Desktops

procedure iconsmall spaceTo List All Desktops

procedure iconsmall spaceTo Display a Desktop's Current Properties

procedure iconsmall spaceTo List Currently Connected Desktops

procedure iconsmall spaceTo View the Properties of the Current User

procedure iconsmall spaceTo Search for Desktops

procedure iconsmall spaceTo Edit a Single Desktop's Properties

Managing Multihead Groups

procedure iconsmall spaceTo View All Multihead Groups

Managing Sun Ray Device Services

procedure iconsmall spaceTo Enable or Disable Sun Ray Device Services

Examining Log Files

procedure iconsmall spaceTo View a Log File

Managing Smart Cards

procedure iconsmall spaceTo View or List Configured Smart Cards

procedure iconsmall spaceTo View The Smart Card Probe Order

procedure iconsmall spaceTo Change the Smart Card Probe Order

procedure iconsmall spaceTo Add a Smart Card

procedure iconsmall spaceTo Delete a Smart Card

Sun Ray System Status

procedure iconsmall spaceTo View the Sun Ray System Status

Administering Users

procedure iconsmall spaceTo View Users by ID

procedure iconsmall spaceTo View Users by Name

procedure iconsmall spaceTo Delete a User

procedure iconsmall spaceTo View Current Users

procedure iconsmall spaceTo Display a User's Current Properties

procedure iconsmall spaceTo Add a User

procedure iconsmall spaceTo View the User's Sessions

procedure iconsmall spaceTo Edit a User's Properties

procedure iconsmall spaceTo Add a Token ID to a User's Properties

procedure iconsmall spaceTo Delete a Token ID From a User's Properties

procedure iconsmall spaceTo Enable or Disable a User's Token

procedure iconsmall spaceTo Find a User

procedure iconsmall spaceTo Get a Token ID From a Token Reader

Managing Sessions

procedure iconsmall spaceTo Find Sun Ray Sessions

procedure iconsmall spaceTo View Sun Ray Sessions

4. Peripherals for Sun Ray DTUs

Device Nodes and USB Peripherals

Device Nodes

Device Links

Device Node Ownership

Hotdesking and Device Node Ownership

Mass Storage Devices

Device Nodes and Links

Mount Points

Device Ownership and Hotdesking

Common Disk Operations

Attached Printers

Printer Setup

procedure iconsmall spaceTo Set Up a Printer

Non-PostScript Printers

Adapters

libusb

5. Hotdesking (Mobile Sessions)

Regional Hotdesking

Functional Overview

Site Requirements

Providing Site Integration Logic

procedure iconsmall spaceTo Configure a Site-specific Mapping Library

Token Readers

procedure iconsmall spaceTo Configure the Sample Data Store

procedure iconsmall spaceTo Disable Regional Hotdesking

6. Encryption and Authentication

Introduction

Security Configuration

Security Mode

Session Security

Security Status

Session Connection Failures

7. Gnome Display Manager

Installation

Uninstallation

Configuration

Gnome Display Manager Privileges

8. Deployment on Shared Networks

Sun Ray DTU Initialization Requirements

DHCP Basics

DHCP Parameter Discovery

DHCP Relay Agent

Network Topology Options

Directly-Connected Dedicated Interconnect

Directly-Connected Shared Subnet

Remote Shared Subnet

Network Configuration Tasks

Preparing for Deployment

Deployment on a Directly-Connected Dedicated Interconnect

Directly-Connected Dedicated Interconnect: Example

Deployment on a Directly-Connected Shared Subnet

Directly-Connected Shared Subnet: Example 1

Directly-Connected Shared Subnet: Example 2

Deployment on a Remote Subnet

Remote Shared Subnet: Example 1

Remote Shared Subnet: Example 2

Network Performance Requirements

Packet Loss

Latency

Out-of-Order Packets

Troubleshooting Tools

utcapture

utquery

OSD Icons

Encapsulated Options

Remote Configuration

Enhancements to Firmware Download and Configuration Support

9. Multihead Administration

Multihead Groups

Multihead Screen Configuration

Multihead Screen Display

Multihead Administration Tool

procedure iconsmall spaceTo Turn On Multihead Policy From the Command Line

procedure iconsmall spaceTo Turn On Multihead Policy Using the Administration Tool

procedure iconsmall spaceTo Create a New Multihead Group

XINERAMA

Session Groups

Authentication Manager

10. Failover Groups

Failover Group Overview

Setting Up IP Addressing

Setting Up Server and Client Addresses

Server Addresses

Configuring DHCP

Coexistence of the Sun Ray Server With Other DHCP Servers

Administering Other Clients

procedure iconsmall spaceTo Set Up IP Addressing on Multiple Servers Each With One Sun Ray Interface

Group Manager

Redirection

Group Manager Configuration

procedure iconsmall spaceTo Restart the Authentication Manager

Load Balancing

procedure iconsmall spaceTo Turn Off the Load Balancing Feature

Setting Up a Failover Group

Primary Server

procedure iconsmall spaceTo Specify a Primary Server

Secondary Server

procedure iconsmall spaceTo Specify Each Secondary Server

procedure iconsmall spaceTo Add Additional Secondary Servers

Removing Replication Configuration

procedure iconsmall spaceTo Remove the Replication Configuration

Viewing the Administration Status

procedure iconsmall spaceTo Show Current Administration Configuration

Viewing Failover Group Status

procedure iconsmall spaceTo View Failover Group Status

Sun Ray Failover Group Status Icons

Recovery Issues and Procedures

Primary Server Recovery

procedure iconsmall spaceTo Rebuild the Primary Server Administration Data Store

procedure iconsmall spaceTo Replace the Primary Server with a Secondary Server

Secondary Server Recovery

Setting Up a Group Signature

procedure iconsmall spaceTo Change the Group Manager Signature File

Taking Servers Offline

procedure iconsmall spaceTo Take a Server Offline

procedure iconsmall spaceTo Bring a Server Online

A. User Settings and Concerns

Supported Devices and Libraries

Supported Mass Storage Devices

Sun Ray DTU Settings

procedure iconsmall spaceTo Change the Sun Ray Settings

Monitor Settings

Hot Key Preferences

Hot Key Values

procedure iconsmall spaceTo Change the Hot Key for the Settings GUI

procedure iconsmall spaceTo Change the Hot Key Setting for a Single User

Power Cycling a Sun Ray DTU

procedure iconsmall spaceTo Power Cycle a Sun Ray DTU

procedure iconsmall spaceTo Perform a Soft Reset

procedure iconsmall spaceTo Kill a User's Session

B. Troubleshooting and Tuning Tips

Understanding OSD

OSD Icon Topography

Sun Ray Desktop Unit Startup

procedure iconsmall spaceActions to take if this icon stays on for more than 10 seconds:

procedure iconsmall spaceActions to take if this icon stays on for more than 10 seconds:

procedure iconsmall spaceActions to take:

procedure iconsmall spaceActions to take if the icon displays for more than a few seconds or if the DTU continues to reset after the icon is displayed:

procedure iconsmall spaceTo Identify a Hung Session

procedure iconsmall spaceTo Kill a Hung Session

Firmware Download

procedure iconsmall spaceActions to take:

procedure iconsmall spaceActions to take:

Firmware Download Failed

procedure iconsmall spaceActions to take:

Bus Busy

No Ethernet

procedure iconsmall spaceActions to take:

Ethernet Address

Session Connection Failures

procedure iconsmall spaceActions to take:

Token Reader Icon

Card Read Error OSD

procedure iconsmall spaceActions to take:

Prompt for Card Insertion OSD

Access Denied OSD

Wait for Session OSD

Patches

Authentication Manager Errors

Soft Reset Issues for Printing

procedure iconsmall spaceTo Soft Reset a Printer

procedure iconsmall spaceTo Get the Printer Manufacturer and Model Name

Troubleshooting USB Mass Storage Devices

Device Nodes Are Not Created

Device Is Not Automatically Mounted

Device Is Not Automatically Unmounted

Audio

Audio Device Emulation

Audio Malfunction

procedure iconsmall spaceTo Activate the Redirection Library

Performance Tuning

General Configuration

Applications

Sluggish Performance

Monitor Display Resolution Defaults to 640 x 480

procedure iconsmall spaceTo Correct or Reset the Screen Resolution:

Old Icons (Hourglass with Dashes Underneath) Appear on Display

Port Currently Owned by Another Application

Design Tips

Glossary

Index