Java Desktop System Release 3 Administration Guide

Preface

This guide provides information about how to administer systems running the Java^TM 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:

Systems running Linux on Intel-compatible hardware, including most desktop and laptop systems from most vendors.
Systems running the Solaris^TM 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 Xeon	See the Solaris 10 Hardware Compatibility List at the following location: `http://www.sun.com/bigadmin/hcl`

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

Familiarize yourself 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.
Chapter 11, Accessing User Sessions Remotely on Linux Systems describes how to access remotely the Java Desktop System session of a user on a Linux system.
Chapter 12, Migration to Unicode Multilingual Computing describes issues that might arise when you migrate to multilingual computing.
Appendix A, Hidden Directories describes the hidden directories that the Java Desktop System adds to the home directories of users.
Appendix B, Security Note on Configuring SMB Printers on Linux Systems provides a security note related to the configuration of printers on Windows network shares on Linux systems.
Glossary is a list of terms used in this guide, and definitions of the terms.

Associated Documentation

Java Desktop System Release 3 on Linux:

Java Desktop System Email and Calendar User Guide
StarOffice 8 Administration Guide
StarOffice 8 Getting Started Guide
StarOffice 8 Programming Guide for BASIC

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

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

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