Java Desktop System Release 2 Troubleshooting Guide

Preface

The information in this guide is relevant for the following release:

Java^TM Desktop System Release 2 for Linux.
Java Desktop System Release 2 for the Solaris^TM 9 Operating System 9/04 on x86 platforms.

About This Book

This book contains information about known issues and workarounds for the Java Desktop System Release 2. If bugs are logged in the Bugtraq application, the Bug IDs are provided.

Who Should Read This Book

This book is for users who perform the following tasks with the Java Desktop System Release 2:

Installing the Java Desktop System.
Administering the Java Desktop System, and applications in the Java Desktop System.
Setting up the Java Desktop System in various locales.

Associated Documentation

The following documents are associated with this guide:

Java Desktop System Release 2 Ximian Evolution 1.4 User Guide
StarOffice 7 Office Suite Administration Guide
StarOffice 7 Office Suite Basic Guide
StarOffice 7 Office Suite Setup Guide
StarOffice 7 Office Suite User's Guide
System Configuration Manager Release 1 Collection

Accessing Sun Documentation Online

The docs.sun.com^SM Web site enables you to access Sun technical documentation online. You can browse the docs.sun.com archive or search for a specific book title or subject. The URL is http://docs.sun.com.

Ordering Sun Documentation

Sun Microsystems offers select product documentation in print. For a list of documents and how to order them, see “Buy printed documentation” at http://docs.sun.com.

Supported Solaris Systems

Table P–1 describes where you can find information about systems that are supported by the Solaris^TM Operating System, relevant to this product release. In the Java Desktop System documentation, the term x86 refers to the processor families shown in Table P–1.

Table P–1 Supported Solaris Systems


Architecture	Processor Families	Solaris Systems
x86	AMD64 Pentium Xeon EM64T	See the Solaris 10 Hardware Compatibility List at the following location: `http://www.sun.com/bigadmin/hcl`

Typographic Conventions

The following table describes the typographic changes that are used in this book.

Table P–2 Typographic Conventions


Typeface or Symbol	Meaning	Example
`AaBbCc123`	The names of commands, files, and directories, and onscreen computer output	Edit your `.login` file. Use `ls -a` to list all files. `machine_name% you have mail.`
`AaBbCc123`	What you type, contrasted with onscreen computer output	`machine_name%` `su` `Password:`
`AaBbCc123`	Command-line placeholder: replace with a real name or value	The command to remove a file is `rm` `filename`.
AaBbCc123	Book titles, new terms, and terms to be emphasized	Read Chapter 6 in the User's Guide. These are called class options. Do not save the file. (Emphasis sometimes appears in bold online.)

Shell Prompts in Command Examples

The following table shows the default system prompt and superuser prompt for the C shell, Bourne shell, and Korn shell.

Table P–3 Shell Prompts


Shell	Prompt
C shell prompt	`machine_name%`
C shell superuser prompt	`machine_name#`
Bourne shell and Korn shell prompt	`$`
Bourne shell and Korn shell superuser prompt	`#`

Mouse Usage Conventions

The following table lists the conventions for mouse usage in documentation for the Java Desktop System.

Action	Definition
Click	Press and release the left mouse button, without moving the mouse.
Click-and-hold	Press and do not release the left mouse button.
Left-click	Same as click. Left-click clarifies the action when there might be confusion with right-click.
Middle-click	Press and release the middle mouse button, without moving the mouse.
Right-click	Press and release the right mouse button, without moving the mouse.
Double-click	Press and release the left mouse button twice in rapid succession without moving the mouse.
Drag	Click-and-hold a mouse button, then move an object. For example, you can drag a window or an icon. The left and middle mouse buttons can perform drag actions.
Drag-and-drop	Click-and-hold a mouse button, then move an object. For example, you can drag-and-drop a window or an icon. Release the mouse button to place the object in a new location.
Grab	Point to an item that you can move, and click-and-hold on the mouse button. For example, you can grab the titlebar of a window, then drag the window to a new location.