Chapter 7 Installing Enterprise Sample Portal Communications Tab

This supplement contains the following:

• Pre-Installation Requirements

• Installing Enterprise Sample Portal Communications Tab

Pre-Installation Requirements

The Sun Java System Portal Server Enterprise Sample Portal Communications tab setup is dependent on the Delegated Administrator software (a Sun Java Enterprise System supported mechanism for granting domain and user level mail and calendar privileges), specifically the commadmin command line utility.

The Portal Server host must contain the Sun Java Enterprise System 2005Q4 version of the following software installed and configured:

In addition, the following Sun Java Enterprise System 2005Q4 products must be installed and configured and may exist on a different host:

The Communication Products (Messaging Server, Calendar Server, Delegated Administrator, Instant Messaging Server, and Communications Express) must be configured for:

• Access Manager Single Sign-On (SSO) support

• Hosted Domain support

Installing Enterprise Sample Portal Communications Tab

The Communications tab is installed under the My Portal tab in the Enterprise sample portal desktop.

To Install the Communications Tab

Steps

1. Copy the input.properties.template, password.properties.template, and comms.properties.template files in PortalServer-base7/SUNWportal/samples/portals/shared directory to a custom directory and remove the .template extension from the file names.

2. Edit the input.properties file.

   Replace all the tokens that begin and end with % with the appropriate portal settings. When the portal is configured, the portal instance identifier must be substituted in the input.properties file in /var/opt/SUNWportal/tmp directory.

3. Edit the password.properties file.

   Replace all the tokens that begin and end with % with the appropriate administrator's password value.

4. Edit the comms.properties file.

   Replace all the tokens that begin and end with % with the appropriate Communication Server setting. Alternatively, if all Sun Java Enterprise System products have been installed on a single host, then there is a helper ant script in /opt/SUNWportal/samples/portals/enterprise/singleHostGatherCommConfig.xml file to gather the Communication Product's information and generate the comms.properties file. To run this script, type ant -buildfile PortalServer7-base/SUNWportal/samples/portals/enterprise/singleHostGatherCommConfig.xml -Doutput.location=outputlocation where outputlocation refers to the location of the generated comms.properties file.

5. Run the ant script in /opt/SUNWportal/samples/portals/enterprise/build.xml file to install the communications tab. For example, type ant config_comms -buildfile /opt/SUNWportal/samples/portals/enterprise/build.xml -Dconfig.location=configlocation -logfile logfile where configlocation refers to the location (directory) of the password.properties and comms.properties files and logfile refers to the location of the generated ant log file.

   This step installs and configures the Communications tab in the Enterprise sample portal. You can access a fully configured Communications tab with sample data for each channel: address book, mail, tasks, calendar, and instant messaging.

6. Restart the web container.

   This will allow the Communications tab to be configured on the Enterprise Sample Portal desktop under the My Portal tab.