Sun Java System Portal Server 7 Enterprise Sample Guide

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.

ProcedureTo Install the Communications Tab

Steps
  1. 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 
  2. 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.

  3. 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
  4. Restart the web container.

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