Communications Suite 6 Update 2 Installation Scenario - Install Convergence

Assumptions

This scenario shows how to install an instance of the Convergence on a separate host or Solaris zone. It is based on the Install Convergence leaf in the Communications Suite 6 Update 2 Installation Flowchart. The scenario makes these assumptions:

• You are deploying Communications Suite on multiple hosts or Solaris zones.
• This Convergence is one functional component of your multi-host deployment.
• The Communications Suite servers (Messaging Server, Calendar Server, Instant Messaging) are installed on separate hosts.
• If you are distributing multiple instances of the Convergence across several hosts, you can follow these instructions for each host on which you install the Convergence.

This scenario describes how to install the software that should run on the same host as Convergence. For a list of all the products required for Convergence, including those installed on other hosts, see Product Version Requirements for Convergence 1 Update 2.

Which Software Components and Downloads Do You Need?

Software Components:

To successfully configure and run Convergence on this host, you need to install the following software components:

Required:

• Sun Java System Application Server 9.1 Update 2 with High Availability Database (HADB) - Zip/File Based
  
  
• Convergence 1 Update 2

Recommended:

• Webmail Server component of Messaging Server 7 Update 2

We recommend that you install the Webmail Server on this host.

Optional, for SSO:

• Sun Java System Access Manager 7.1 SDK - To use Access Manager for authentication and/or Single Sign-on (SSO), you also must install the Access Manager SDK. To successfully use the Access Manager SDK on this host, Access Manager Server 7.1 must be installed on a remote host.
• Sun OpenSSO Enterprise 8.0 - See Configuring Sun Convergence with Sun OpenSSO Enterprise 8.0.

Downloads:

• Application Server 9.1 Update 2 with High Availability Database (HADB) - Zip/File Based
• Java ES 5 Update 1 distro: for Access Manager 7.1
• Communications Suite: for Convergence 1 Update 1 and Webmail Server

Download these software files from the Communications Suite download site. For details, see Get the Software.

Convergence Support for SSO

Convergence supports the following methods for implementing Single SignOn.

• Access Manager
• Messaging Server (Trusted Circle) SSO
• Sun OpenSSO Enterprise 8.0.

If you have a third-party authentication or SSO service, you can also customize the Convergence Server to create an authentication and/or SSO plug-in for that service. For details, see

• Writing a Custom Authentication Module for Convergence
• Writing a Custom SSO Module for Convergence

About Webmail Server

The best deployment practice is to place the Webmail Server on the same host as Convergence to provide horizontal scalability and enable smooth growth of services.

Note: From a functional perspective, Convergence provides complete mail service when the Webmail Server is located on a different host than Convergence. Therefore, in some deployments, the Webmail Server may be located on a different host.

Other Messaging Server components such as the message store and MTA, Calendar Server, and Instant Messaging Server may be located on other hosts.

Which Task Sequence Do You Follow?

Step 1. Install Application Server 9.1 Update 2 with High Availability Database (HADB) - Zip/File Based.

Download the Application Server software zip file from the Communications Suite download site. Do not install the version of Application Server bundled with JES 5 Update 1; that is an older version of Application Server.

Follow these guidelines:

• The high availability database (HADB) version provides shared components needed by Application Server and Communications Suite. You can configure this version of Application Server without using the HADB.

• The Communication Suite installer does not install Application Server.

• To install Application Server, follow the instructions in the Sun Java System Application Server 9.1 Installation Guide.

• Install Application Server before you install Access Manager and configure Convergence.

• To verify which version of Application Server you have installed, see Verify Application Server Version.

Step 2. Install Access Manager 7.1 SDK

Perform this task only if you intend to use Access Manager for authentication and/or SSO.

Prerequisite: This task assumes that Access Manager Server 7.1 is installed on a remote host.

If you already have Access Manager Server installed on this host, you do not need to install the Access Manager SDK.

1. Be sure that Directory Server Enterprise Edition 6.3 is installed and configured on another host in your deployment.
2. Start Directory Server.
3. Verify that Application Server 9.1 Update 2 is installed and running on this host.
4. Verify that the full Access Manager 7.1 server is running and accessible, either on a remote host (or on another instance on the same host where you plan to install the Access Manager SDK).
5. Log in as or become superuser (root).
6. Launch the Java ES 5 Update 1 installer.
7. When the Java ES installer displays the Choose Software Components Page, under Access Manager 7.1, select only the Access Manager SDK.
8. Choose the Configure Later option for installing the Access Manager 7.1 SDK.
   
   

   About the Configure Later Option If you install the Access Manager 7.1 SDK to Application Server 9.1 without installing the full Access Manager Server on this host, you must choose Configure Later. If you do not, the AM SDK does not work.

   
   

   Realm Mode and Legacy Mode Convergence supports both Access Manager Realm mode (the default) and Legacy mode for providing authentication and SSO.

Follow the instructions in Deploying the Access Manager 7.1 SDK with Application Server 9.1.

For more information, see: Technical Note: Deploying Access Manager with Application Server 9.1.

For information about the Java ES installer, see Sun Java Enterprise System 5 Update 1 Installation Guide for UNIX.

For more details, see Access Manager Configuration Guide. You can also find installation instructions in this Access Manager Deployment Example.

Step 3. Before you install Messaging Server (Webmail Server component):

Note: Perform this task if you are installing Webmail Server on this host.

• Make sure you do not configure conflicting port numbers on a machine when various components are running on a single machine. For a list of port numbers used by Messaging Server, see Default Port Numbers.

Step 4. Install Convergence and Webmail Server:

1. Run the Communications Suite installer.
   
   
2. When the Comms Installer lists the components to install, choose the following components:
   
   

• Convergence 1 Update 2 (Integrated Web Client)
  
  
• Messaging Server. Choose the 32-bit or 64-bit version by selecting one of these components:
  
  
  • Messaging Server 7 Update 2 for the 32-bit version)
    
    
  • Messaging Server (64-bit) 7 Update 2 (for the 64-bit version)
    
    Note: Select Messaging Server only if you are installing Webmail Server on this host.
    
    Make sure that the other components are not selected.
    
    

Step 5. Configure the Webmail Server:

Note: Follow these steps if you are installing Webmail Server on this host.

1. Use the following worksheet to gather configuration information for the Webmail Server: Messaging Server 7 Update 1 - Configuration Worksheet
   
   
2. Run the Messaging Server initial configuration program:
   
   For 32-bit: # INSTALLROOT/messaging/bin/configure
   
   For 64-bit: # INSTALLROOT/messaging64/bin/configure
   
   For detailed instructions, see Messaging Server 7 Update 2: Initial Configuration.
   
   When the Messaging Server configure program lists the components to configure, select
   
   Webmail Server
   
   Make sure that the other components are not selected.
   
   
3. Set the following configutil parameters. The Webmail Server uses these configutil parameters to log in to the back-end IMAP servers:

Note that the Webmail Server can communicate with multiple back-end IMAP servers. If the IMAP servers use different values for these parameters are different, you must set individual configutil parameters for each host, as follows:

where hostname is the name of the host on which each back-end IMAP server is running.

Examples

For one back-end IMAP server:

configutil -o local.service.proxy.admin -v myadmin
configutil -o local.service.proxy.adminpass -v <password>
configutil -o local.service.proxy.imapport -v 143

For multiple back-end IMAP servers:

configutil -o local.service.proxy.admin.host1.siroe.com -v admin1
configutil -o local.service.proxy.adminpass.host1.siroe.com -v <password>
configutil -o local.service.proxy.imapport.host1.siroe.com -v 143

configutil -o local.service.proxy.admin.host2.siroe.com -v admin2
configutil -o local.service.proxy.adminpass.host2.siroe.com -v <password>
configutil -o local.service.proxy.imapport.host2.siroe.com -v 143

Step 6. Before you configure Convergence, take these steps:

1. Use the following worksheet to gather configuration information for the Convergence: Convergence 1 Update 1 - Configuration Worksheet
   
   
2. If your Convergence deployment supports Instant Messaging (the chat component), you must configure the Httpbind JID and Avatar JID on Instant Messaging Server. Peform this step before you run the Convergence configuration program.
   
   For details, see Configure IM Components to Enable Communication with the Instant Messaging Server.
   
   
3. Be sure that the back-end servers and web container are up and running:
   

• Directory Server
  
• Messaging Server
  
• Calendar Server
  
• Application Server 9.1 Update 2
  
  Verify whether users are able to log in to the back-end servers correctly:
• Messaging Server
  
• Calendar Server
  
  

Step 7. Configure Convergence:

1. Run the Convergence initial configuration program:
   
   # INSTALLROOT/iwc/init-config
   
   
2. When you run the initial configuration program, specify the configuration values to connect to the back-end servers supported in your Convergence deployment:
   

• To support the Convergence mail component, configure values for the Webmail Server.
  
• To support the Convergence calendar component, configure values for the Calendar Server.
  
• To support the Convergence chat component, configure values for the IM Server.
  
  For detailed instructions, see Convergence 1 Update 2: Initial Configuration.