Java Desktop System Release 3 Troubleshooting Guide

Preface

This manual provides troubleshooting information for the Java^TM Desktop System Release 3 on systems running the Solaris^TM 10 Operating System.

Supported Systems

This release of the Java Desktop System supports the following systems:

Systems running the Solaris 10 Operating System on SPARC® platforms.
Systems running the Solaris 10 Operating System on x86 platforms.

Table P–1 describes where you can find information about systems that are supported by the Solaris 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
SPARC	SPARC64 UltraSPARC	See the Solaris 10 Hardware Compatibility List at the following location: `http://www.sun.com/bigadmin/hcl`
x86	AMD64 Pentium EMT64	See the Solaris 10 Hardware Compatibility List at the following location: `http://www.sun.com/bigadmin/hcl`

About This Guide

This guide describes known issues and workarounds for the Java^TM Desktop System Release 3. If change requests are logged in the Bugster application, the change request numbers are provided.

Who Should Read This Guide

This guide is for users who perform the following tasks with the Java Desktop System Release 3:

Installing the Java Desktop System.
Administering 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 Email and Calendar 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

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.

Typographic Conventions

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

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.