Sun Logo


Sun Ray Server Software 3.1 Administrator's Guide

for the Solaristrademark Operating System

819-2384



Contents

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

Sun Management Center

CLI and Admin GUI

Data Store

Controlled Access (Kiosk) Mode

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

Controlled Access Mode

procedure iconsmall spaceTo Configure Controlled Access Mode

procedure iconsmall spaceTo Select Additional Applications

procedure iconsmall spaceTo Add or Edit Applications

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

Mass Storage Devices and NSCM

Common Disk Operations

Attached Printers

Printer Setup

procedure iconsmall spaceTo Set Up a Printer

Printers Other Than PostScript Printers

PDA Synchronization

PDASync for Solaris Application on Sun Ray DTUs

procedure iconsmall spaceTo Set Up the PDASync Application on a Sun Ray DTU

Adapters

libusb

5. Hotdesking (Mobile Sessions)

NSCM Session

Sun Ray Mobile Session Login Dialog Box

Token Reader Icon

procedure iconsmall spaceTo Log In to an NSCM Session

Disconnecting an Active NSCM Session

Hot Key

procedure iconsmall spaceTo Disconnect the Current Session via utdetach

procedure iconsmall spaceTo Terminate the Current Session

procedure iconsmall spaceTo Reconfigure the Disconnect Hot Key Combination

procedure iconsmall spaceTo Customize the Short Cut for Disconnecting an NSCM Session

NSCM and Failover Groups

Load Balancing Between Servers

Switching Between Servers

Escape Token Sessions

Configuring the Authentication Manager for NSCM Sessions

procedure iconsmall spaceTo Enable NSCM Sessions From the Administration Tool

procedure iconsmall spaceTo Enable NSCM Sessions From a Command Line

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

8. Monitoring the Sun Ray System

Sun Management Center (SunMC) Software Features

Additional Sun Management Center Modules

Setting Up the Monitoring Environment

procedure iconsmall spaceTo Set Up the Monitoring Environment

procedure iconsmall spaceTo Create an Object

Setting Alarms

procedure iconsmall spaceTo Set an Alarm

procedure iconsmall spaceTo Start Monitoring

Setting Monitoring Guidelines

Sun Ray System Panel

procedure iconsmall spaceTo Display the Sun Ray System Panel

procedure iconsmall spaceTo Refresh the Sun Ray System Panel

procedure iconsmall spaceTo Set Alarms

Sun Ray Services Panel

Failover Group Panel

Interconnect Panel

procedure iconsmall spaceTo Set an Alarm for Running Out of Addresses

Desktops Panel

procedure iconsmall spaceTo Add a DTU to Be Monitored

procedure iconsmall spaceTo Delete a DTU to Exclude Monitoring

Using Other Monitoring Programs

Removing the Sun Ray Module from SunMC

procedure iconsmall spaceTo Remove the Sun Ray module

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. Controlled Access Mode

Controlled Access Mode Functionality

Enabling Controlled Access Mode

procedure iconsmall spaceTo Enable Controlled Access Mode with the Admin GUI

procedure iconsmall spaceTo Configure CAM Settings

procedure iconsmall spaceTo Configure CAM Using the CLI

Building the Controlled Access Mode Environment

procedure iconsmall spaceTo Add a New Application

procedure iconsmall spaceTo Edit an Available Application

procedure iconsmall spaceTo Make an Application Available to Users

procedure iconsmall spaceTo Make an Application Not Available to Users

procedure iconsmall spaceTo Remove an Application

Advanced Application Setup

Enabling Prototypes

procedure iconsmall spaceTo Enable Prototypes

Using Wrapper Scripts to Customize Controlled Access Mode Applications

procedure iconsmall spaceTo Launch an Application Using a Wrapper Script

Modifying CAM User Displays

procedure iconsmall spaceTo Change the Backdrop

procedure iconsmall spaceTo Change the CDE Menu

procedure iconsmall spaceTo Activate Debugging

Security and the Controlled Access Mode Environment

Failover

Localization

procedure iconsmall spaceTo Change the Locale for Controlled Access Mode Sessions Without Changing the System Locale

11. 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 Used to Detach NSCM Sessions

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

Wait Icon Cursor for Default Session Type

Patches

Authentication Manager Errors

Troubleshooting USB Mass Storage Devices

Device Links 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

PDA Synchronization Issues

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

Troubleshooting the Sun Management Center

No Sun Ray Object

procedure iconsmall spaceTo Load the Sun Ray Module

No Sun Ray Module

procedure iconsmall spaceTo Activate the Sun Ray Module

Glossary

Index