Preface

Who Should Use This Book

You should read this book if you are responsible for installing, administering, and configuring Portal Server at your site.

Before You Read This Book

Before you administer Portal Server, you must be familiar with the following concepts:

Basic Solaris™ administrative procedures

LDAP

Sun Java™ System Directory Server (formerly Sun ONE Directory Server)

Sun Java™ System Access Manager (formerly Sun ONE Identity Server, and Sun Java System Identity Server)

Depending on the Web container that you are using, you should be familiar with one or more of the following:

Sun Java™ System Web Server (formerly Sun ONE Web Server)

Sun Java System Application Server

BEA WebLogic Server ™ 8.1 SP2

IBM WebSphere� 5.1



Note	The Sun™ Java System family of products was previously branded under the Sun™ ONE name.

How This Book Is Organized

This book contains the following chapters and appendices

Table 0-1 List of Chapters and Appendices
Chapter	Description
Preface	(This chapter)
Chapter 1, "Introduction to Administering the Sun Java System Portal Server"	This chapter describes the Portal Server architecture, protocols, and interfaces, and provides an overview of administering and customizing the product.
Chapter 2, "Post Installation Configuration"	This chapter provides instructions for performing post installation configuration tasks.
Chapter 3, "Creating and Deleting Instances of the Server"	This chapter provides instructions for creating and deleting instances of Portal Server.
Chapter 4, "Setting Up the Portal Server to Use Secure External LDAP Directory Server"	This chapter provides instructions for setting up Portal Server to use a secure external LDAP server.
Chapter 5, "Configuring the Portal Server to Run as User Non-Root"	This chapter provides instructions for configuring the Portal Server to run as user non-root.
Chapter 6, "Administering Authentication, Users, and Services"	This chapter describes how to use Sun Java System Identity Server to administer authentication, users, and services.
Chapter 7, "Configuring Delegated Administration"	This chapter describes how to configure delegated administration for Portal Server.
Chapter 8, "Administering the Portal Desktop Service"	This chapter describes how to administer the Portal Server Desktop service.
Chapter 9, "Administering the Web Services for Remote Portlets (WSRP) Service"	This chapter provides information and instructions for using Web Services for Remote Portlets (WSRP).
Chapter 10, "Administering the Display Profile"	This chapter describes how to administer the Portal Server display profile component.
Chapter 11, "Administering the NetMail Service"	This chapter describes how to administer the NetMail service.
Chapter 12, "Administering the Rewriter Service"	This chapter describes how to administer the Rewriter service.
Chapter 13, "Administering the Search Engine Service"	This chapter describes how to configure and administer the Search Engine service.
Chapter 14, "Administering the Search Engine Robot"	This chapter describes the Search Engine robot and its corresponding configuration files.
Chapter 15, "The Pre-defined Robot Application Functions"	This chapter describes the pre-defined robot application functions. You can use these functions to create and modify filter definitions.
Chapter 16, "Administering the Subscriptions Service"	This chapter describes how to configure and administer the Subscriptions service.
Chapter 17, "Configuring the Communication Channels"	This chapter provides information on the communication channels for Portal Server.
Chapter 18, "Managing the Portal Server System"	This chapter describes the various administrative tasks associated with maintaining the Portal Server system.
Chapter 19, "Tuning the Portal Server"	This chapter provides information about the perftune script that comes with Portal Server.
Appendix A, "SSO Adapter Templates and Configurations"	This appendix provides a reference for the communication channels for Portal Server.

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 4 Default Paths and File Names
Term	Description
PortalServer-base	Represents the base installation directory for Portal Server. The Portal Server 2005Q1 default base installation and product directory depends on your specific platform: Solaris™ systems /opt Linux systems: /opt/sun
AccessManager-base	Represents the base installation directory for Access Manager. The Access Manager 2005Q2 default base installation and product directory depends on your specific platform: Solaris™ systems: /opt/SUNWam Linux systems: /opt/sun/identity
DirectoryServer-base	Represents the base installation directory for Sun Java System Directory Server. Refer to the product documentation for the specific path name.
ApplicationServer-base	Represents the base installation directory for Sun Java System Application Server. Refer to the product documentation for the specific path name.
WebServer-base	Represents the base installation directory for Sun Java System Web Server, or BEA WEblogic 8.1 SP2, or IBM WebSphere. Refer to the product documentation for the specific path name.

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

Book Title	Description
Portal Server Deployment Planning Guide http://docs.sun.com/db/doc/817-6257	Describes how to plan for and deploy Sun Java System Portal Server software.
Portal Server Administration Guide http://docs.sun.com/db/doc/817-7691	Describes how to administer Sun Java System Portal Server 6 using the Access Manager 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 Sun Java System Portal Server 6 Secure Remote Access.
Portal Server Release Notes http://docs.sun.com/db/doc/817-7699	Available after the product is released. Contains last-minute information, including a description of what is new in this current release, known problems and limitations, installation notes, and how to report issues with the software or the documentation.
Portal Server Technical Reference Guide http://docs.sun.com/db/doc/817-7696	Provides detailed information on the Sun Java System Portal Server technical concepts (such as Display Profile, Rewriter), command line utilities, tag libraries (in the software), and files (such as templates and JSPs). This guide serves as a single source for such essential background information.

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 2005Q1 Administration Guide, and the part number is 817-7691.

Previous Contents Index Next