Documentation Home
> Solaris Common Desktop Environment: Advanced User's and System Administrator's Guide
Solaris Common Desktop Environment: Advanced User's and System Administrator's Guide
Book Information
Preface
Chapter 1 Configuring Login Manager
Starting the Login Server
Managing Local and Network Displays
Finding the Login Server Process ID
Displaying a Login Screen on a Local Display
Running the Login Server without a Local Display
Accessing Command Line Login on a Local Display
Accommodating a Character Display Console
Displaying a Login Screen on a Network Display
XDMCP Direct Requests from Network Displays
XDMCP Indirect Requests from Network Display
Managing Non-XDMCP Network Displays
Example
Controlling Access to the Login Server
XDMCP Direct
XDMCP Indirect
Checking for Errors
Stopping the Login Server
The Login Screen
Changing the Login Screen Appearance
To Change the Logo
To Change the Welcome Message
To Change the Fonts
To Provide Alternate Text to Display for Each Language
Changing the Login Screen Behavior
Changing the Login Screen Behavior Per Display
Changing the X Server Access
To Change the X Server Environment
To Change the Default Language
To Change the Content of the Login Screen Language Menu
Issuing Commands Before the Login Screen Appears
Issuing Commands Before Starting the User Session
Starting a Desktop Session
Starting a Failsafe Session
After the User's Session Ends
The Login Server Environment
Changing the User or System Path
To Change the User Path
To Change the System Path
To Change the System Shell
To Change the Time Zone
Administering Login Manager
Login Manager Files
Chapter 2 Configuring Session Manager
What Is a Session?
The Initial Session
Current Session
Home Session
Display-Specific Sessions
Starting a Session
When a Session Starts
Sourcing the .dtprofile Script
Sourcing Xsession.d Scripts
Displaying the Welcome Message
Setting Up the Desktop Search Paths
Gathering Available Applications
Optionally Sourcing the .profile or .login Script
Starting the ToolTalk Messaging Daemon
Starting the Session Manager Client
Loading the Session Resources
Starting the Color Server
Starting Workspace Manager
Starting the Session Applications
Additional Session Startup Customizations
To Set Environment Variables
To Set Resources
To Set Display-Specific Resources
To Change Applications for the Initial Session
To Set Up a Display-Specific Session
Executing Additional Commands at Session Startup and Logout
To Execute Additional Commands at Session Startup
To Execute Additional Commands at Logout
To Recover a Session from Backup
To Investigate Session Startup Problems
Session Manager Files and Directories
Chapter 3 Troubleshooting Login and Session Startup Problems
Login Startup Files
Error Log Locations
User Startup Files
Solaris CDE Startup Examples
Chapter 4 Adding and Administering Applications
Structure of Application Manager
Directory Location of Application Manager
How Application Manager Finds and Gathers Applications
Precedence Rules in Gathering Applications
Application Groups Provided with the Default Desktop
Example of How Application Groups Are Gathered
Adding Applications to Application Manager
Ways to Add Applications to Application Manager
Registering the Application
Adding the Application without Using a Registration Package.
To Add a Desktop-Smart Application to Application Manager
To Register an Existing or Non-Desktop Smart Application
To Add an Application Icon to an Existing Application Group
Creating and Administering General Application Groups
To Create a System-Wide General Application Group
To Create a Personal General Application Group
To Customize a Built-In Application Group
Modifying the Search Path Used To Locate Applications
The Default Search Path
Adding an Application Server to the Application Search Path
To Set a System-Wide Application Search Path
To Set a Personal Application Search Path
General Application Manager Administration
To Remove an Application
To Update Application Manager During a Session
Changing the Text Editor and Terminal Emulator
To Change the Default Text Editor or Terminal Emulator
Chapter 5 Registering an Application
Overview of Application Registration
Features Provided by Application Registration
The Purpose of Application Registration
General Steps for Registering an Application
Step 1: Modifying Font and Color Resources
Modifying Font Resources
Modifying Color Resources
Step 2: Creating the Desktop Application Root
Step 3: Creating the Registration Package Directories
Registration Package Contents
To Create the Registration Package
Step 4: Creating the Actions and Data Types for the Application
Actions and Data Types Required by an Application
Location for Action and Data Type Definition Configuration Files
Ways to Create Actions and Data Types
To Create Actions and Data Types Using Create Action
To Create Actions and Data Types Manually
Step 5: Putting the Help Files in the Registration Package
Step 6: Creating Icons for the Application
Icons Required for the Desktop
Step 7: Creating the Application Group
Creating the Application Group Directory
Application Group Name
Configuring the Application Group To Use a Unique Icon
Creating the Contents of the Application Group
Creating the Action File (Application Icon)
Read Me Files
Creating a Specialized Front Panel Control
Step 8: Registering the Application Using dtappintegrate
To Register an Application with dtappintegrate
Syntax and Options for dtappintegrate
How dtappintegrate Integrates Applications
Actions and Data Types
Help Information Files
Icon Files
Application Group
Example of Creating a Registration Package
Information You Need to Know About ``BestTextEditor''
Steps to Registering ``BestTextEditor''
Chapter 6 Miscellaneous Configurations
Solaris CDE Directory Structure
/usr/dt
/etc/dt
/var/dt
$HomeDirectory
Key Configuration Files
Xconfig
Xservers
Starting the Login Server
Mounting an Installed CDE from Another Workstation or Network Server Installation Location
To Mount an Installed CDE
To Unmount a Mounted CDE Directory
Configuring Your Desktop To Use Multiple Screens
To Make the Desktop Start on Multiple Screens
Networked Desktops
Using XTerminals
Login Locale and Font Path
Using Workstations as XTerminals
To Use Chooser To Select a Host CDE Login
To Use a Specific Host CDE Login
To Use the First Available Host Login
Special CDE Configurations
Customizing Mail Printing
To Modify the Print Action
Converting Calendars to New Data Format
Adding the AnswerBook Package from the Network
Setting Up the CDE Environment Outside the CDE Desktop
Desktop Environment File
Using Floppy and CD Media with the Apple Macintosh Application Environment
To Change the /etc/rmmount.conf File
Chapter 7 Configuring the Desktop in a Network
Overview of Desktop Networking
Types of Networked Desktop Services
Typical Network Situations
Other Networking Situations
Summary--Types of Servers
General Steps for Configuring Desktop Networking
Configuring Base Operating System Networking for the Desktop
Providing Login Accounts to Users
Providing Login Accounts
Providing Consistent User and Group IDs
Configuring Distributed File System Access
Providing a Networked Home Directory
File-Name Consistency
Configuring Access to Remote Printers
Configuring Electronic Mail
Configuring X Authorization
Configuring Desktop Clients and Servers
Configuring Login and Session Services
Configuring Other Application-Related Services
To Configure Desktop Clients and Servers
Configuring the Mount Point for Remote File Systems
Requirements for File-Name Mapping
Setting a Value for DTMOUNTPOINT
Configuring the Subprocess Control Daemon
To Configure dtspcd
SPC Security
Configuring Environment Variables for Remote Execution
Configuring the ToolTalk Database Server
Configuring the ToolTalk Message Server
Configuring the Calendar Daemon
Administering Application Services
Search Path Environment Variables
Configuring an Application Server and Its Clients
To Configure an Application Server
To Configure the Client of an Application Server
Configuring Database, Icon, and Help Services
To Create a Database, Help, or Icon Server
To Configure the Session Server to Find a Database, Icon, or Help Server
Special Networked Application Configurations
Specifying a Remote Execution Host
To Configure the Remote Execution Host
To Configure the System Containing the Action Definition
To Configure the Session Server
Running Applications Locally
To Configure the Application Server
To Configure the Session Server
Chapter 8 Configuring and Administering Printing from the Desktop
Adding and Deleting Printers
To Add a Printer to the Desktop
To Delete a Printer from the Desktop
Modifying the Job Update Interval
Printer Icon Images
Icon File Names and Sizes
To Globally Change the Icon, Printer Label, or Description of a Printer
Configuring the Default Printer
To Change the Destination for Default Printing
Printing Concepts
Chapter 9 Desktop Search Paths
Desktop Search Paths and Their Environment Variables
Setting the Value of a Search Path
To See the Current Value for a Search Path (Output Variable)
To Make Personal Modifications to a Search Path
To Make System-Wide Modifications to a Search Path
Application Search Path
Default Application Search Path
Application Search Path Environment Variables
Syntax for the Application Search Path Input Variables
How the Value of the Application Search Path Is Assembled
Changing the Precedence of the System-Wide Local Location
How the Application Search Path Affects the Database, Icon, and Help Search Paths
Database (Action/Data Types) Search Path
Default Database Search Path
How the Application Search Path Affects the Database Search Path
Database Search Path Environment Variables
Syntax for the Database Search Path Input Variables
How the Database Search Path Is Assembled
Icon Search Path
Default Icon Search Path
How the Application Search Path Affects the Icon Search Path
Icon Search Path Environment Variables
Syntax for the Icon Search Path Input Variables
How the Icon Search Path Is Assembled
Help Search Path
Default Help Search Path
How the Application Search Path Affects the Help Search Path
Help Search Path Environment Variables
Syntax for the Help Search Path Input Variables
How the Help Search Path Is Assembled
Localized Search Paths
Chapter 10 Introduction to Actions and Data Types
Introduction To Actions
How Actions Create Icons for Applications
How Actions Use Data Files as Arguments
Additional Uses for Actions
Introduction to Data Types
What Is a Data Type?
How Data Types Connect Data Files to Actions
Running Actions from the Selected Menu
Defining the Double-Click Behavior of the Data Type
Dropping a Data File on an Action Icon
Creating Desktop Printing for a Data Type
Chapter 11 Creating Actions and Data Types Using Create Action
What Create Action Does
Limitations of Create Action
Action Limitations
Data Type Limitations
Creating an Action and Data Type for an Application with Create Action
To Create an Action for an Application
To Create One or More Data Types for an Application
Using the Find Set Dialog Box To Specify an Icon
To Specify a Set of Icons Located on the Icon Search Path
To Specify an Icon in a Registration Package
Chapter 12 Creating Actions Manually
Reasons You Must Create an Action Manually
COMMAND Actions
MAP Actions
TT_MSG (ToolTalk Message) Actions
Creating an Action Manually: General Steps
Configuration Files for Actions
To Create an Action Manually
Example of Creating a COMMAND Action
Example of Creating a MAP Action
To Reload the Actions/Data Types Database
Creating an Action File (Icon) for an Action
To Create an Action File (Action Icon)
Action Labels
Specifying the Icon Image Used by an Action
To Modify an Existing Action Definition
Precedence in Action Definitions
Building the Execution String for a COMMAND Action
General Features of Execution Strings
Action Arguments
Using Shells in Execution Strings
Name or Absolute Path of the Executable
Creating an Action that Uses No Arguments
Examples
Creating an Action that Accepts a Dropped File
Examples
Creating an Action that Prompts for a File Argument
Creating an Action that Accepts a Dropped File or Prompts for One
Creating an Action that Prompts for a Non-File Argument
Interpreting a File Argument as a String
Providing Shell Capabilities in an Action
Examples
Creating COMMAND Actions for Multiple File Arguments
Creating an Action for Non-Interchangeable Arguments
Creating an Action with Interchangeable File Arguments
Examples
Creating an Action for Multiple Dropped Files
Examples
Windowing Support and Terminal Emulators for COMMAND Actions
Specifying the Window Support for the Action
Specifying Command-Line Options for the Terminal Emulator
Specifying a Different Default Terminal Emulator
Restricting Actions to Certain Arguments
Restricting an Action to a Specified Data Type
Restricting an Action Based on the Number of Arguments
To Provide Different Double-Click and Drop Behavior
Restricting an Action Based on the Mode of the Argument
Creating Actions that Run Applications on Remote Systems
Creating an Action that Runs a Remote Application
Examples
Using Variables in Action and Data Type Definitions
Using String Variables in an Action
To Define a String Variable
To Reference a String Variable
Using Environment Variables in Actions and Data Types
Invoking Actions from a Command Line
Syntax of dtaction
Creating an Action that Runs Another Action
Creating an Action that Runs as a Different User
Creating Localized Actions
Locations for Localized Actions
To Localize an Existing Action
Creating Actions for ToolTalk Applications
addressing and disposition Fields
Unsupported Messages
Keywords for TT_MSG Actions
Chapter 13 Creating Data Types Manually
Reasons You Must Create a Data Type Manually
Components of a Data Type Definition: Criteria and Attributes
Creating a Data Type Manually: General Steps
Configuration Files for Data Types
To Create a Data Type Definition
Example of Creating a Personal Action and Data Type
Defining the Data Attributes of a Data Type
Specifying the Icon Image Used for a Data Type
Associating Data Types with Actions
Hiding Files Based on Data Type
Specifying Behaviors When the File Is Manipulated
Defining the Data Criteria for a Data Type
Name-Based Data Types
Examples
Location-Based Data Types
Data Types Based on Name and Location
Examples
Using File Modes as a Typing Criteria
Examples
Content-Based Data Typing
To Create a Data Type with Several Independent Criteria
Creating Localized Data Types
Locations for Localized Data Types
To Localize a Data Type
Chapter 14 Creating Icons for the Desktop
Icon Image Files
Icon File Formats
Icon File Names
Icon Size Conventions
Icon Search Path
Accessing Icons across the Network
Icon Associations
Specifying Icon Files
To Associate an Icon with an Action or Data Type
Example of an Action Definition
Example of Data Type Definition
To Display an Icon in a Front Panel Control
Example
To Associate an Icon with an Application Window
To Use File Manager as an Icon Browser
Icon Design Recommendations
Color Usage
Chapter 15 Advanced Front Panel Customization
Front Panel Configuration Files
Default Front Panel Configuration File
Search Path for Front Panel Configuration Files
How the Front Panel Is Assembled: Precedence Rules
Dynamically Created Front Panel Files
Administering User Interface Customizations
To Prevent Personal Customizations
To Restore a Deleted Control or Subpanel
Organization of the Front Panel Definition
Front Panel Components
General Syntax of the Front Panel Definition
PANEL Definition
BOX Definitions
CONTROL Definitions
SUBPANEL Definitions
SWITCH Definition
Modifying the Main Panel
To Add a Control to the Main Panel
To Remove a Control
To Modify a Control
To Interchange the Position of Controls
To Replace a Front Panel Control
Specifying the Icon Used by a Control
Creating and Modifying Subpanels
To Create a New System-Wide Subpanel
Customizing the Built-in Subpanels
To Modify General Properties of a Built-In Subpanel
To Add a System-Wide Control to a Built-In Subpanel
To Remove a Control from a Built-In Subpanel
To Remove the Install Icon Control
To Change the Auto-Close Behavior of Subpanels
Defining Front Panel Controls
Front Panel Control Definitions
Control Types
To Create a New Control
Creating a Control that Runs an Action When Clicked
Creating a Control that Opens a File
Creating a Control that Behaves as a Drop Zone
Creating a Control that Monitors a File
Creating a One-Instance (Toggle) Control
To Create a Client Window Control
To Animate a Control
Providing On Item Help for Front Panel Controls
Customizing the Workspace Switch
To Change the Default Number of Workspaces
To Change the Number of Switch Rows
To Change or Add Controls in the Workspace Switch
General Front Panel Configuration
General Steps
To Change the Default Front Panel Location
To Label Controls in the Main Panel
To Change the Click Behavior of Controls
To Create an Entirely New Front Panel
Example of Creating a Personal Front Panel with Three Rows
Chapter 16 Customizing the Workspace Manager
Workspace Manager Configuration Files
To Create or Modify a Personal Configuration File
To Create a System-Wide Configuration File
To Include (Source In) Other Files
To Restart the Workspace Manager
Customizing Workspaces
To Change the Number of Workspaces on a System-Wide Basis
To Provide System-Wide Workspace Names
To Create Additional Backdrops
To Replace the Backdrop With a Graphics Image
Workspace Manager Menus
Workspace Manager Menu Syntax
To Modify the Existing Workspace (Root) Menu
To Create a New Workspace (Root) Menu
To Create a New Window Menu
Customizing Button Bindings
Button Binding Syntax
To Add a Button Binding
To Create a New Button Binding Set
Customizing Key Bindings
Default Desktop Key Bindings
Key Binding Syntax
To Create a Custom Key Binding Set
Switching Between Default and Custom Behavior
Chapter 17 Administering Application Resources, Fonts, and Colors
Setting Application Resources
To Set System-Wide Resources
To Set Personal Resources
How the Desktop Loads Resources
Defining UNIX Bindings
To Specify-EMACS Style Translations
To Modify the EMACS-Style Translations
UNIX Bindings Provided by the UNIXbindings File
Administering Fonts
Setting Desktop Font Resources
Resources Set by the Font Dialog Box
Resources Used by the Font Dialog Box
To List Available Fonts
To Specify Fonts on the Command Line
X Logical Font Description (XLFD)
Example
Viewing Selected Font Group Attributes
User's Font Group Filesystem Storage
System Administrator Font Group Creation
Administering Colors
Color Palettes
Color Sets
Specifying Color Values
How Color Sets are Mapped to Resources
Default Color Set Assignments
Controlling Color with Style Manager
Number of Colors Used by Style Manager
colorUse Resource
shadowPixmaps Resource
foregroundColor Resource
dynamicColor Resource
Setting Shadow Thicknesses for Application Windows
Chapter 18 Configuring Localized Desktop Sessions
Managing the LANG Environment Variable
Setting the Language for Multiple Users
Setting the Language for One Session
Setting the Language for One User
LANG Environment Variable and Session Configuration
Setting Other NLS Environment Variables
NLSPATH Environment Variable
Finding Fonts
Localizing app-defaults Resource Files
Localizing Actions and Data Types
Localizing Icons and Bitmaps
Localizing Backdrop Names
Localizing Palette Names
Localizing Help Volumes
Localizing Message Catalogs
Executing Localized Desktop Applications Remotely
Resetting Your Keyboard Map
Appendix A dtconfig(1) Man Page
Index
Numbers and Symbols
A
B
C
D
E
F
G
H
I
K
L
M
N
O
P
Q
R
S
T
U
V
W
X
© 2010, Oracle Corporation and/or its affiliates