Preface
The Desktop Customization Guide includes sample customizations and detailed instructions for customizing the software desktop. This preface contains the following sections:
Who Should Use This Book
The Desktop Customization Guide is intended for use by administrators and other individuals responsible for customizing the software Desktop.
Audience for this guide should already understand the following technologies:
- Lightweight Directory Access Protocol (LDAP)
- Java technology
- JavaServer Pages™ (JSP™) technology
- Hypertext Transfer Protocol (HTTP)
- Hypertext Markup Language (HTML)
- Extensible Markup Language (XML)
You must also be familiar with the following software configuration, administration, and customization tasks:
- Sun JavaTM System Access Manager
- Sun JavaTM System Directory Server
- Sun JavaTM System Web Server
- Sun JavaTM System Application Server
Before You Read This Book
Portal Server is a component of Sun Java Enterprise System, a software infrastructure that supports enterprise applications distributed across a network or Internet environment. You should be familiar with the documentation provided with Sun Java Enterprise System, which can be accessed online at http://docs.sun.com/coll/entsys_05q1.
Because the Portal Server software components work together with Sun JavaTM System Access Manager for user, service, and policy management and authentication, single sign-on, and logging services, you should be familiar with the documentation provided with that product. Access Manager software documentation can be accessed online at http://docs.sun.com/doc.
Because Sun JavaTM System Directory Server is used as the data store for primary configuration information and user profile data in a Portal Server deployment, you should be familiar with the documentation provided with that product. Directory Server software documentation can be accessed online at http://docs.sun.com/coll/DirectoryServer_05q1.
How This Book Is Organized
The first chapter of this book provides an overview of the areas of customization. Chapters 2 through 14 provide sample customizations and information for customizing the desktop. Chapter 15 includes essential information about JSPs and desktop templates that you will need when customizing the software.
Table 0-1 How This Book Is Organized
|
Title
|
Description
|
|
Chapter 1, "Introduction to Customizing the Desktop"
|
Provides an overview of the possible areas of customization.
|
|
Chapter 2, "Modifying the Default Sample Portal"
|
Provides information on modifying the sample portal to suit your deployment environment.
|
|
Chapter 3, "Creating a New Desktop"
|
Provides instructions for setting up a custom desktop.
|
|
Chapter 4, "Customizing Container Tabs"
|
Provides information on customizing tab containers.
|
|
Chapter 5, "Customizing Channels"
|
Provides information on customizing channels.
|
|
Chapter 6, "Customizing Instant Messaging"
|
Provides information on customizing the Sun JavaTM System Instant Messaging server.
|
|
Chapter 7, "Customizing the Anonymous Desktop"
|
Provides information on configuring, accessing, and modifying the anonymous desktop.
|
|
Chapter 8, "Customizing Authentication"
|
Provides information on customizing UNIX and LDAP authentication.
|
|
Chapter 9, "Modifying the Desktop Layout"
|
Provides information on modifying the desktop layout.
|
|
Chapter 10, "Branding the Desktop"
|
Provides information on branding the default desktop.
|
|
Chapter 11, "Changing Desktop Colors"
|
Provides information on changing the desktop colors.
|
|
Chapter 12, "Customizing the Global Themes"
|
Provides information on cutomizing the GlobalThemes.
|
|
Chapter 13, "Customizing the Service Providers"
|
Provides information on customizing the search and discussion providers.
|
|
Chapter 14, "Customizing the Desktop End-User Online Help"
|
Provides information on customizing the desktop end-user online help files.
|
|
Chapter 15, "Miscellaneous JSP and Template Information"
|
Provides miscellaneous information on JSPs and desktop templates.
|
Conventions Used in This Book
The tables in this section describe the conventions used in this book.
Typographic Conventions
The following table describes the typographic changes used in this book.
Table 2 Typographic Conventions
|
Typeface
|
Meaning
|
Examples
|
|
AaBbCc123
(Monospace)
|
API and language elements, HTML tags, web site URLs, command names, file names, directory path names, onscreen computer output, sample code.
|
Edit your.login file.
Use ls -a to list all files.
% You have mail.
|
|
AaBbCc123
(Monospace bold)
|
What you type, when contrasted with onscreen computer output.
|
% su
Password:
|
|
AaBbCc123
(Italic)
|
Book titles, new terms, words to be emphasized.
A placeholder in a command or path name to be replaced with a real name or value.
|
Read Chapter 6 in the User’s Guide.
These are called class options.
Do not save the file.
The file is located in the install-dir/bin directory.
|
Symbols
The following table describes the symbol conventions used in this book.
Table 3 Symbol Conventions
|
Symbol
|
Description
|
Example
|
Meaning
|
|
[ ]
|
Contains optional command options.
|
ls [-l]
|
The -l option is not required.
|
|
{ | }
|
Contains a set of choices for a required command option.
|
-d {y|n}
|
The -d option requires that you use either the y argument or the n argument.
|
|
-
|
Joins simultaneous multiple keystrokes.
|
Control-A
|
Press the Control key while you press the A key.
|
|
+
|
Joins consecutive multiple keystrokes.
|
Ctrl+A+N
|
Press the Control key, release it, and then press the subsequent keys.
|
|
>
|
Indicates menu item selection in a graphical user interface.
|
File > New > Templates
|
From the File menu, choose New. From the New submenu, choose Templates.
|
Default Paths and File Names
The following table describes the default paths and file names used in this book.
Table 0-4 Default Paths and File Names
|
Term
|
Description
|
|
PortalServer-base
|
Represents the base installation directory for Sun Java System Portal Server software. The Portal Server software default base installation and product directory depends on your specific platform:
Solaris™ systems: /opt/SUNWps
|
|
AccessManager-base
|
Represents the base installation directory for Sun Java System Access Manager software. The Access Manager software default base installation and product directory depends on your specific platform:
Solaris™ systems: /opt/SUNWam
|
|
DirectoryServer-base
|
Represents the base installation directory for Sun Java System Directory Server software. The Directory Server software default base installation is /var/opt/mps/serverroot.
|
|
ApplicationServer-base
|
Represents the base installation directory for Sun JavaTM System Application Server software. The Application Server software default base installation is /opt/SUNWappserver8.
|
|
WebServer-base
|
Represents the base installation directory for Sun JavaTM System Web Server software. The Web Server software default base installation is /opt/SUNWwbsvr.
|
|
PortalServer-ContentFiles
|
Represents the directory where JSPs, templates and property files, and tag libraries are installed. By default, this is /etc/opt/SUNWps.
|
|
PortalServer-SEdb
|
Represents the Portal Server software Search Engine database. By default, this is /var/opt/SUNWps.
|
Shell Prompts
The following table describes the shell prompts used in this book.
Table 5 Shell Prompts
|
Shell
|
Prompt
|
|
C shell on UNIX or Linux
|
machine-name%
|
|
C shell superuser on UNIX or Linux
|
machine-name#
|
|
Bourne shell and Korn shell on UNIX or Linux
|
$
|
|
Bourne shell and Korn shell superuser on UNIX or Linux
|
#
|
|
Windows command line
|
C:\
|
Related Documentation
The http://docs.sun.comSM web site enables you to access Sun technical documentation online. You can browse the archive or search for a specific book title or subject.
Books in This Documentation Set
The following table summarizes the books included in the Portal Server core application documentation set.
Table 6 Books in This Documentation Set
|
Book Title
|
Description
|
|
Portal Server Administration Guide
http://docs.sun.com/db/doc/817-7691
|
Describes how to administer the Portal Server software using the administration console and the command line.
|
|
Portal Server Secure Remote Access Administration Guide
http://docs.sun.com/db/doc/817-7693
|
Describes how to administer Portal Server Secure Remote Access software.
|
|
Portal Server Developer’s Guide
http://docs.sun.com/db/doc/817-7695
|
Describes how to extend the Portal Server software APIs.
|
|
Portal Server Technical Reference Guide
http://docs.sun.com/db/doc/817-7696
|
Provides detailed information on the the Portal Server software concepts.
|
|
Portal Server Deployment Planning Guide
http://docs.sun.com/db/doc/817-7697
|
Describes how to plan for and deploy Portal Server software.
|
|
Portal Server Migration Guide
http://docs.sun.com/db/doc/817-7698
|
Describes how to migrate from previous releases of the Portal Server software to this release.
|
Other Server Documentation
For other server documentation, go to the following:
- Directory Server documentation: http://docs.sun.com/coll/DirectoryServer_04q2
- Web Server documentation: http: //docs.sun.com/coll/S1_websvr61_en
- Application Server documentation: http://docs.sun.com/coll/s1_asseu3_en
- Access Manager documentation: http://docs.sun.com/???
Accessing Sun Resources Online
For product downloads, professional services, patches and support, and additional developer information, go to the following:
- Download Center: http://wwws.sun.com/software/download/
- Professional Services: http://www.sun.com/service/sunps/sunone/index.html
- Sun Enterprise Services, Solaris Patches, and Support: http://sunsolve.sun.com/
- Developer Information: http://developers.sun.com/prodtech/index.html
Contacting Sun Technical Support
If you have technical questions about this product that are not answered in the product documentation, go to http://www.sun.com/service/contacting.
Related Third-Party Web Site References
Sun is not responsible for the availability of third-party web sites mentioned in this document. Sun does not endorse and is not responsible or liable for any content, advertising, products, or other materials that are available on or through such sites or resources. Sun will not be responsible or liable for any actual or alleged damage or loss caused or alleged to be caused by or in connection with use of or reliance on any such content, goods, or services that are available on or through such sites or resources.
Sun Welcomes Your Comments
Sun is interested in improving its documentation and welcomes your comments and suggestions.
To share your comments, go to http://docs.sun.com and click Send Comments. In the online form, provide the document title and part number. The part number is a seven-digit or nine-digit number that can be found on the title page of the book or at the top of the document. For example, the title of this book is Sun Java System Portal Server 6 2005Q1 Desktop Customization Guide and the part number is 817-7694-10.
