Chapter 6 Setting up the Communications Tab

This chapter contains the following:

Introduction to Communication Services

The Communications tab available with the Enterprise Sample showcases the Java Enterprise System Communication Services.

Communication Products

The Communication Services are presented in the desktop via a series of channels that retrieve and display content from the following Communication products:

Sun Java^TM System Calendar Server 6
Sun Java^TM System Messaging Server 6
Sun Java^TM System Instant Messaging 7
Sun Java^TM System Communications Express 6

Communications Tab Channels

Address Book: Displays a list of contacts and launches the Communications Express client
Calendar: Displays a list of today's events and launches the Communications Express client
Find an Employee: Search for employees
Instant Messaging: Displays online contacts and launches the Instant Messenger client
Mail: Displays mail messages and launches the Communications Express client
Tasks: Displays tasks, including overdue tasks, and launches the Communications Express client

Installing the Enterprise Sample Portal Communications Tab

The Communications tab must be installed by the administrator after the Enterprise Sample has been installed and the Installation Prerequisites have been completed.

Installation Prerequisites

The Enterprise Sample Communications tab setup is dependent on the Delegated Administrator Utility, specifically the commadmin command line utility. The Delegated Administrator Utility is a Java Enterprise System supported mechanism for granting Domain and User level mail and calendar privileges. Please refer to Sun Java System Communications Services 6 2005Q4 Delegated Administrator Guide for more information.

The portal host must contain the following Java Enterprise System 2005Q4 installed and configured products:

Sun Java^TM System Access Manager
Sun Java^TM System WebServer OR Application Server
Sun Java^TM System Delegated Administrator Utility
Sun Java^TM System Portal Server 7

In addition, the following Java Enterprise System 2005Q4 products need to be installed and configured and may exist on a different host than Portal Server 7:

Sun Java^TM System Directory Server
Sun Java^TM System Calendar Server 6
Sun Java^TM System Messaging Server 6
Sun Java^TM System Message Queue 3 Enterprise Edition
Sun Java^TM System Instant Messaging 7
Sun Java^TM System Communications Express 6

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

Access Manager Single Sign-On (SSO) support
Hosted Domain support

Installing the Communications Tab

The Communications tab is, by default, installed under the My Portal tab in the Enterprise Sample portal desktop. The Communications tab must be installed by the administrator using ant.

To Install the Communications Tab

Steps

Copy the sample portal configuration files to a custom directory.

The Enterprise Sample Communications tab setup depends on the following files:

input.properties
password.properties
comms.properties

Copy the template files from PortalServer-base/samples/portals/shared directory to a custom directory, remove the .template extension, and substitute the tokens in each file. For example, type:

mkdir /tmp/mydir
cp /opt/SUNWportal/samples/portals/shared/password.properties.template /tmp/mydir/password.properties
cp /opt/SUNWportal/samples/portals/shared/comms.properties.template /tmp/mydir/comms.properties
cp /opt/SUNWportal/samples/portals/shared/input.properties.template /tmp/mydir/input.properties
OR
cp /var/opt/SUNWportal/tmp/input.properties /tmp/mydir/input.properties

Specify values for the following files:
input.properties

Edit the input.properties file and replace all the tokens that begin and end with % with the appropriate portal settings.

Note –
When the portal is configured, a populated input.properties file is available at PortalServer-DataDir/tmp/ directory.

password.properties

Edit the password.properties file and replace all the tokens that begin and end with % with the appropriate administrator password value.

comms.properties
Edit the comms.properties file and replace all the tokens that begin and end with % with the appropriate Communication Server setting.

If all Java Enterprise System products have been installed on a single host, then there is a helper ant script to gather the Communication Product's information and generate the comms.properties file. The helper ant script,PortalServer-base/samples/portals/enterprise/singleHostGatherCommConfig.xml, usage is:
ant -buildfile /opt/SUNWportal/samples/portals/enterprise/singleHostGatherCommConfig.xml -Doutput.location=outputlocation
Where

ant

Refers to the ant script.

outputlocation

Refers to the location of the generated comms.properties file.

For example:
/usr/sfw/bin/ant -buildfile /opt/SUNWportal/samples/portals/enterprise/singleHostGatherCommConfig.xml -Doutput.location=/tmp/mydir
This command will generate the comms.properties file in the directory specified by the output.location. Please review the settings in the comms.properties file before installing the communications tab.

Run the ant script to install the Communications tab.

This step installs or configures the Communications tab in the Enterprise Sample. The result of this step is a fully configured Communications tab with sample data for each channel: address book, mail, tasks, calendar, and instant messaging.

To install, execute the command:
ant config_comms -buildfile PortalServer-base/samples/portals/enterprise/build.xml -Dconfig.location=configlocation -logfile logfile
where

ant

Refers to the ant script.

configlocation

Refers to the location (directory) of the password.properties and comms.properties files.

logfile

Refers to the location of the generated ant logfile.

For example, type:
/usr/sfw/bin/ant config_comms -buildfile /opt/SUNWportal/samples/portals/enterprise/build.xml -Dconfig.location=/tmp/mydir -logfile /tmp/comms.log

Restart the web container.

At this point, the Communications tab is configured on the Enterprise Sample desktop under the My Portal tab.