Sun Java System Portal Server 7.1 Technical Reference

Chapter 12 XML and Schema Files

The Sun Java System Portal Server 7.1 registers its services into the Sun Java System Sun Java System Access Manager Service Management Services (SMS) framework. This occurs during the pre-installation of the Portal Server 7.1 and post-installation for Sun Java System Access Manager software.

Service Management Services

Note –

In general, any service-related data that is not server-specific is stored in the Sun Java System Access Manager directory. Server-specific data can be stored in properties files that are local to the specific server.

SMS provides a mechanism for services to define and manage their configuration data by using an Extensible Markup Language (XML) file that adheres to the SMS Document Type Definition (DTD). The definition of the configuration parameters through the XML file is called the schema for the service. Each Portal Server 7.1 service (Desktop, Rewriter, and Search) has its own XML and properties files for presenting and modifying service specific data.

Within the Sun Java System Access Manager framework, Portal Server 7.1 defines services related to the following functional areas:


The SunPortalDesktopService includes data associated with the Desktop component, including the display profile and other configuration parameters associated with the Desktop.

Search Engine

The SunPortalSearchService defines the data associated with the Search component, such as the search person and search instances. One or more instances of Search service instances can be defined.


The SunPortalRewriterService includes data associated with the Rewriter component, including the named rule sets that control the rewriting operation. The Rewriter API makes reference to the named rule sets that are stored in the directory.

In addition, the Portal Server 7.1 also uses other DTDs to define LDAP attribute values for the display profile and the Rewriter ruleset.

The Display Profile Document Type Definition (DTD) defines how the Display Profile is structured. The underlying data format for a display profile document is XML. It is intended to define the display configuration for the Desktop. It does that by defining provider, portlet, and channel objects, and their properties. The Rewriter ruleset DTD defines the structure of the ruleset. The Rewriter includes a default ruleset.

The file paths for the various XML, DTD, and schema files used to define the services of the Portal Server 7.1 (in the first column) and the service which uses the corresponding file (in the second column) are:


Service Management Services Document Type Definition (DTD)


Portal Server 7.1 Desktop service definition


Portal Server 7.1 Rewriter service definition


Portal Server 7.1 Search service definition


Display Profile document type definition (DTD)


Rewriter Ruleset document type definition (DTD) under resources/RuleSet.dtd


Default ruleset under resources/DefaultRuleSet.xml


ldif file available in desktop directory.


Portal Server 7.1 Desktop Schema


Portal Server 7.1 Search Schema