The SunTM JavaTM System Portal Server 7.1 Technical Reference guide provides detailed information on the Sun Java System Portal Server 7.1 technical concepts (such as Display Profile, Rewriter), command line utilities, tag libraries (in the software), and files (such as templates and JSPs). Use this book in conjunction with the other books in the Portal Server 7.1 documentation set (see Books in This Documentation Set)
The Sun Java System Portal Server 7.1 Technical Reference is intended for use by administrators and individuals responsible for:
Administering and configuring the Portal Server 7.1 software
Customizing pieces of the software
Readers should have admin-level permissions to the software. This guide is not intended for end users.
Administrators and individuals using this guide must be familiar with basic SolarisTM administrative procedures and must 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)
Portal Server 7.1 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.comSM.
Because the Portal Server 7.1 software components work together with Sun Java System Sun Java 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. Sun Java System Access Manager software documentation can be accessed online at http://docs.sun.com/.
Because Sun Java System Sun Java System Directory Server is used as the data store for primary configuration information and user profile data in a Portal Server 7.1deployment, you should be familiar with the documentation provided with that product.Sun Java System Directory Server software documentation can be accessed online at http://docs.sun.com.
The first chapter of this book provides an overview of the entire Portal Server 7.1 product. The rest of the book is divided into parts; each part includes multiple chapters detailing a concept. The following table summarizes various parts of this book.
Table P–1 How This Book Is Organized
Part Title |
Part Description |
---|---|
Describes the various attributes in the Portal Server 7.1 software. |
|
Describes properties in the properties file for the Desktop and Search service. |
|
Describes the display profile document, objects, priorities, merge semantics, and properties. |
|
Describes the various JSPs installed in the default and sampleportal directories. |
|
Describes the supported URLs and provide background information on defining rules and rulesets. |
|
Describes the software Sample Portal and its associated containers and themes. The sample portal is an authentication-less desktop that consists of sample containers, channels, portlets, services, and templates which demonstrates the Portal Server 7.1 software’s capabilities. |
|
Describes the Search engine robot and its application functions. The Search Engine robot is included to discover, convert, and summarize document resources. Users can then locate or browse content contained in the database. |
|
Describes the tag libraries used by the Desktop and Search service. |
|
Describes the Desktop templates installed in the default and sampleportal directories. |
The tables in this section describe the conventions used in this book.
The following table describes the typographic changes used in this book.
Table P–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. |
% suPassword: |
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. |
The following table describes the symbol conventions used in this book.
Table P–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. |
The following table describes the default paths and file names used in this book.
Table P–4 Default Paths and File Names
Term |
Description |
---|---|
PortalServer-base |
Represents the base installation directory for Sun Java System Portal Server 7.1 software. The Portal Server 7.1 software default base installation and product directory depends on your specific platform: Solaris systems: /opt/SUNWportal Linux systems: /opt/sun/portal |
AccessManager-base |
Represents the base installation directory for Sun Java System Access Manager software. The Sun Java System 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 Sun Java System Directory Server software default base installation is /opt/sun/ds6. |
ApplicationServer-base |
Represents the base installation directory for Sun One Application Server software. The Sun One Application Server software default base installation is /opt/SUNWappserver. |
WebServer-base |
Represents the base installation directory for Sun Java System Web Server software. The Sun Java System Web Server software default base installation is /opt/SUNWbsvr7. |
PortalServer-ContentFiles |
Represents the Portal Server Data directory where JSPs, templates and property files, and tag libraries are installed. By default, this is /var/opt/sun/portal for Linux. |
PortalServer-SEdb |
Represents the Portal Server 7.1 software Search Engine database. By default, this is /var/opt/SUNWportal/searchservers/search1/db. |
The following table describes the shell prompts used in this book.
Table P–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:\\ |
The http://docs.sun.com web site enables you to access Sun technical documentation online. You can browse the archive or search for a specific book title or subject.
The following table summarizes the books included in the Portal Server 7.1 core application documentation set.
Table P–6 Books in This Documentation Set
Book Title |
Description |
---|---|
Describes how to administer the Portal Server 7.1 software using the administration console and the command line. |
|
Sun Java System Portal Server Secure Remote Access 7.1 Administration Guide |
Describes how to administer Portal Server 7.1 Secure Remote Access software. |
Describes how to configure the Portal Server 7.1 software Desktop. |
|
Describes how to extend the Portal Server 7.1 software APIs. |
|
Describes how to plan for and deploy Portal Server 7.1 software. |
Other server documentation collections are:
Sun Java System Directory Server documentation: http://docs.sun.com
Sun Java System Web Server documentation: http://docs.sun.com
Sun One Application Server documentation: http://docs.sun.com
Sun Java System Access Manager documentation: http://docs.sun.com
Access these URLs for product downloads, professional services, patches and support, and additional developer information.
Download Center http://www.sun.com
Professional Services: http://www.sun.com
Sun Enterprise Services, Solaris Patches, and Support: http://www.sun.com
Developer Information: http://developers.sun.com
If you have technical questions about this product that are not answered in the product documentation, go to http://www.sun.com.
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 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 7.1 Technical Reference and the part number is 819-7095.