Java Desktop System Release 3 Administration Guide

Preface

The Java Desktop System Release 3 Administration Guide provides information about how to administer a system running the following releases:

Sun Java^TM Desktop System Release 3 for the SPARC® platform edition of the Solaris^TM Operating System.
Sun Java Desktop System Release 3 for the x86 platform edition of the Solaris Operating System.

Most of the information in the guide is generic to all releases of the Java Desktop System. Where the information is not generic, the platform is indicated.

Who Should Use This Guide

This guide is for system administrators who are responsible for administering one or more systems that run the Java Desktop System Release 3. For information about how to use the Java Desktop System, see the Java Desktop System Release 3 User Guide.

Before You Read This Guide

Before you read this guide, you should ensure that you have some familiarity with the following topics:

UNIX® system administration
Structure of Extensible Markup Language (XML) files
How to use XML files in the context of system administration

How This Guide Is Organized

This guide is organized as follows:

Chapter 1, Using GConf describes how to use GConf to manage user preferences.
Chapter 2, Customizing Menus describes the implementation of menus and how to customize menus.
Chapter 3, Installing Themes describes the types of theme that are available in the Java Desktop System, how to install themes, and how to create a custom theme.
Chapter 4, Configuring Fonts describes how to configure fonts for the Java Desktop System.
Chapter 5, MIME Types describes how applications detect MIME types, how to register MIME types, and how to add applications to the Java Desktop System.
Chapter 6, Setting Screensavers describes how to set preferences for the screensaver. This chapter also provides information about how to modify the displays that are available for the screensaver.
Chapter 7, Session Management introduces session management, and describes how to set session defaults. This chapter also contains information about sessions and login scripts.
Chapter 8, Help System describes the Help system in the Java Desktop System.
Chapter 9, Improving Performance describes how to improve the performance of the Java Desktop System.
Chapter 10, Disabling Features in the Java Desktop System describes how to disable particular features of the Java Desktop System.
Appendix A, Hidden Directories describes the hidden directories that the Java Desktop System adds to the home directories of users.
Glossary is a list of terms used in this guide, and definitions of the terms.

Supported Solaris Systems

The Solaris Operating System (Solaris OS) supports various architectures, processor families, and systems. Table P–1 describes where you can find information about systems that are supported by the Solaris OS, relevant to this product release.

Table P–1 Supported Solaris Systems


Architecture	Processor Families	Solaris Systems
SPARC	SPARC64 UltraSPARC	See the latest Solaris Hardware Platform Guide at the following location: http://docs.sun.com
x86	AMD64 Pentium Xeon EM64T	See the latest Solaris x86 Platform Hardware Compatibility List at the following location: http://www.sun.com/bigadmin/hcl

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 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	To delete a file, type `rm` `filename`.
AaBbCc123	Book titles, new terms, or terms to be emphasized	Read Chapter 6 in User's Guide. These are called class options. You must be root to do this.

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.