Provider README


This document describes the steps to add providers and channels into an existing Sun JavaTM System Portal Server 6 2004Q2 system.

1. Put class files in the provider class base directory. The provider class base directory is defined in the desktopconfig.properties file, in the "providerClassBaseDir" property. By default, the value is /etc/opt/SUNWps/desktop/classes. If the provider is in a JAR file, add it to the root level of the provider class base directory. If the provider is in a class, add it in the sub-directory under the provider class base directory, based on the java class package.

2. If the provider has desktop templates or JSPs, create the proper directories under the template base directory and copy the templates into the directories. The template base directory is defined in the desktopconfig.properties file, in the "templateBaseDir" property, by default is /etc/opt/SUNWps/desktop. The templates should be copied into the <templateBaseDir>/<desktop-type>/<providername>, where <desktop-type> defaults to 'default', and <providername> is the provider name given to the provider in the display profile. If the template is used by a specific channel, and the template is modified based on the channel's specific need, then the template should be copied to <templateBaseDir>/<desktop-type>/<channelname>, where the <channelname> if the channel name given to the channel in the display profile.

3. Put the provider's properties file, if any, in the provider class base directory.

4. Put the channel on-line help files in the proper sub-directories under portal server's web-src directory, by default it is /opt/SUNWps/web-src/docs. The on-line help files should be copied to <web-src-dir>/docs/desktop and <web-src-dir>/docs/<locale>/desktop, where <locale> is the supported locale for the portal server instance. The on-line help files then should be deployed into the web container using the deploy command:
        deploy redploy

5. Import the XML display profile provider and channel definitions using dpadmin command. For example:
        amadmin add -u amadminDN -w password -g provider_displayprofile_name
        amadmin add -u amadminDN -w password -d <orgDN> channel_displayprofile_name

For complete information about the amadmin command, please see the Sun ONE PortalTM Server 6 2004Q2 Administrator's Guide.

5a. Another way to import the XML display profile is to use the Identity Server administration console:
 For more information about how to use the Identity Server administration console, please see the Sun JavaTM System Portal Server 6 2004Q2 Administrator's Guide.

6. Use the Identity Server administration console to add a channel in an existing container in the desktop:
For more information about how to use the Identity Server administration console, please see the Sun JavaTM System Portal Server 6 2004Q2 Administrator's Guide.