Sun ONE logo     Previous      Contents      Index      Next     
Sun ONE Portal Server 6.0 Administrator's Guide



Appendix C      Desktop Attributes

The Desktop Service consists of global and dynamic attributes. The values applied to the global attributes are applied across the iPlanet™ Directory Server Access Management Edition configuration and are inherited by every configured organization. They cannot be applied directly to roles or organizations as the goal of global attributes is to customize the iPlanet Directory Server Access Management Edition application. Values applied to the dynamic attributes are assigned to a role or organization. When the role is assigned to a user or a user is created in an organization, the dynamic attribute then becomes a characteristic of the user.

The Desktop attributes are divided into:

Desktop Global Attributes

Table C-1 describes the global attributes for the Desktop Service.

The table contains three columns: the first column identifies the attribute, the second column provides the default value for the attribute, and the third column describes the attribute.

Table C-1    Desktop Service - Global Attributes

Attribute

Default Value

Description

Desktop Session Reap Interval (seconds)

1800

Defines in seconds the time interval between checks for removing inactive Desktop sessions.

Maximum Inactive Session Time Before Reap (seconds)

3600

Specifies the maximum number of seconds a Desktop session can be idle before it is considered inactive. If a session is idle for more than this value, it is made a candidate for session reaping and can be removed the next time the Desktop session times.

Enable XML Parsing Validation (Use with Caution)

True (checked)

Specifies whether to enforce validation while parsing the display profile XML document. Unchecking this attribute can improve system performance. However, this can potentially introduce corruption in the display profile document because the resulting XML document might include some fragments that do not conform to the DTD.

Namespace URI

http://www.iplanet.com

Specifies the unique identifier for the XML namespaces or Uniform Resource Indicator (URI) in the form of a URL. This guarantees that XML tags will be unique.

Display Profile

The default value depends on the type of installation performed. If the sample portal is installed, the Display Profile contains the definitions for the built-in providers (the basic providers of Sun™ ONE Portal Server), such as bookmark and notes. If the sample portal was not installed, the global Display Profile is blank.

Displays several links for manipulating the global display profile, an XML document that defines the container management, channel attributes, and provider definitions for the organization. Links are:

  • Edit XML—Allows you to edit the entire display profile XML file.
  • Upload XML—Allows you to upload an XML file containing display profile information to the Portal Server.
  • Download XML—·Allows you to download the display profile to your local drive.
  • Channel and Container Management—Provides a graphical user interface to manage container channels and channels without the need to edit the XML file.

These links are not attributes. Selecting these links allows you to manipulate the display profile.

Display profile elements defined in the global display profile are inherited by all users on the system, regardless of the organization or role to which they belong.

Authorized
Authentication-less User IDs

uid=authlessanonymous,
ou=People,o=iplanet.com,o=isp|
authlessanonymous

Defines the User IDs that are authorized to access the Desktop without authenticating.

Default
Authentication-less User ID

uid=authlessanonymous,
ou=People,o=iplanet.com,o=isp

Defines the default authentication-less user ID to be used when one is not specified.

Desktop Dynamic Attributes

Table C-2 describes the dynamic attributes for the Desktop Service.

The table contains three columns: the first column identifies the attribute, the second column provides the default value for the attribute, and the third column describes the attribute.

Table C-2    Desktop Service - Dynamic Attributes

Attribute

Default Value

Description

Conflict Resolution Level

Highest

Sets the conflict resolution level for the Desktop service template used to resolve conflicts when multiple Desktop templates are merged. There are seven conflict resolution settings available ranging from Highest to Lowest.

Do not confuse this setting with the display profile document priority. The display profile document priority is a numeric value that is set in the XML file with the priority= syntax tag. When a merge occurs, it starts with the lowest display profile priority document (lowest number) and proceeds in increasing priority number, until it arrives at the user (base), the highest priority display profile.

When an attribute conflict occurs, the attribute on the template set with the highest conflict resolution level is returned.

Default Channel Name

JSPTabContainer

Identifies which default channel is rendered when the Desktop is called with an unspecified provider.

Default Edit Channel Name

JSPEditChannel

Specifies which default edit channel to use to wrap the content when one is not specified in the URL. When a channel is edited, an "Edit" request URL is sent to the Desktop Servlet. The URL generated for the "Edit" of each of the channels inside a container depends on the property "editContainerName" defined in the display profile.

If you have migrated containers from iPlanet™ Portal Server 3.0, you must specify the default edit channel with which to wrap the content using this attribute because the URL format has changed.

Desktop Type

default

Retrieves template files for the specified Desktop type when different Desktop configurations are needed and when different sets of templates and JSPs are required for those configurations.

Most sites will not use the default Desktop type, as they will have different channels, different logo, different look and feel, and the like.

Display Profile

The default value depends on the type of installation performed. If the sample portal was installed, a sample display profile document is installed at the organization level that contains channels that display the built-in providers defined in the global display profile.

Displays several links for manipulating the display profile, an XML document that defines the container management, channel attributes, and provider definitions for this specific node (role, organizaMarch 2003tion, suborganization). Links are:

  • Edit XML—Allows you to edit the entire display profile XML file.
  • Upload XML—Allows you to upload an XML file containing display profile information to the Portal Server.
  • Download XML—Allows you to download the display profile to your local drive.

These links are not attributes. Selecting these links allows you to manipulate the display profile.

Show Desktop Service Attributes

True (checked)

Specifies whether the Desktop Service attributes are displayed to the users associated with the role. This dynamic attribute is mainly used for role-based delegated administration, Values applied to this attribute are only in effect for a role.

When the role is assigned to a user and the value of this attribute is false, users (usually delegated administrators) cannot see any Desktop Service attributes except the Channel and Container Management link when they navigate into all the roles within the organization.


Previous      Contents      Index      Next     
Copyright 2002-2003 Sun Microsystems, Inc. All rights reserved.