Java Desktop System Release 3 Troubleshooting Guide

Preface

This guide provides troubleshooting information for the JavaTM Desktop System Release 3. Most of the information in this guide is generic to all releases of the Java Desktop System Release 3. Where the information is not generic, the platform is indicated.

Supported Systems

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

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

  • Xeon

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 JavaTM 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:

Related Documentation

The following manuals are related to this guide:

Associated Documentation

Java Desktop System Release 3 for the Solaris 10 Operating System:

Java Desktop System Release 3 on Linux:

Documentation CD

The accompanying Java Desktop System Release 3 Documentation CD contains files or links for those manuals directly-related, or closely associated with, the Java Desktop System Release 3 on Linux.

Accessing Sun Documentation Online

The docs.sun.comSM 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-ato 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 promptmachine_name%
 C shell superuser promptmachine_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.