The Communications tab must be installed by the administrator after the Enterprise Sample has been installed and the Installation Prerequisites have been completed.
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 JavaTM System Access Manager
Sun JavaTM System WebServer OR Application Server
Sun JavaTM System Delegated Administrator Utility
Sun JavaTM 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 JavaTM System Directory Server
Sun JavaTM System Calendar Server 6
Sun JavaTM System Messaging Server 6
Sun JavaTM System Message Queue 3 Enterprise Edition
Sun JavaTM System Instant Messaging 7
Sun JavaTM 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
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.
Copy the sample portal configuration files to a custom directory.
The Enterprise Sample Communications tab setup depends on the following files:
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:
Edit the input.properties file and replace all the tokens that begin and end with % with the appropriate portal settings.
When the portal is configured, a populated input.properties file is available at PortalServer-DataDir/tmp/ directory.
Edit the password.properties file and replace all the tokens that begin and end with % with the appropriate administrator password value.
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
Refers to the ant script.
Refers to the location of the generated comms.properties file.
/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
Refers to the ant script.
Refers to the location (directory) of the password.properties and comms.properties files.
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.