Sun Java logo     Previous      Contents      Index      Next     

Sun logo
Sun Java System Communications Express 6 2005Q1 Administration Guide 

Chapter 2
Installing and Configuring Communications Express

This chapter describes how to install and configure Communications Express.

The following topics are covered in this chapter:

Note

  • Ensure Messaging Server 6.2 and Calendar Server 6.2 are installed and configured and that Messenger Express is configured on the same machine.
  • To use Sun Java System LDAP Schema, v.2, ensure that the latest Access Manager 6.2, formerly known as Identity Server is installed and configured.
  • Install Directory Preparation Script (comm_dssetup.p1) from the Java Enterprise System Installer.

Installing Communications Express from Java Enterprise System Installer

To install Communications Express follow the steps mentioned below:

Note

Uninstall any previous installation of Communications Express.

You need to uninstall Communications Express using Java Enterprise System Uninstaller if you have installed it from an earlier build of the Java Enterprise System Installer. On Solaris, Sun Java™ Enterprise System Uninstaller is available at: /var/sadm/prod/entsys/uninstall

  1. Select Sun Java™ System Communications Express from the list of components displayed in Sun Java™ Enterprise System Install Wizard.

    2. Note

    When Sun Java System Communications Express is selected, the products on which Communications Express depends on gets automatically selected. However, if any of these products are already installed in the system, the option is disabled.

  2. The Install Directories panel is displayed. Browse to specify the name of the target installation directory for each component product.

    3. Click Next.

  3. After a couple of panels the Configuration Type panel is displayed.
    1. Decide on the configuration type you want. The options available are:
      • Configure Now. Allows you to configure component products that permit configuration at installation time.
      • Configure Later. The installer installs the packages in the specified directory paths and proceeds without configuring them. For more details, refer to the section on Choosing a Configuration Type in Chapter 2 of the Sun Java Enterprise System Installation Guide at:

        • http://docs.sun.com/db/doc/819-0056

        Note

        Communications Express cannot be configured from the Sun Java™ Enterprise System Install Wizard. You need to run the Communications Express configurator program to configure Communications Express.

    2. Select a configuration type and click Next.
  4. The Custom Configuration panel appears.

    5. Click Next to configure other component products (if any).

  5. Complete the installation process.

Prerequisites for Configuring Communications Express

Before running the Communications Express configurator program, make sure you perform the following:

  1. Choose your schema. Refer to the section on Schema Choices for information on the available schema choices.
  2. Ensure that you have the following entry in /etc/hosts file on your Solaris system:

    3. ip-of system FQHN hostname

    For Example,

    129.158.230.64 budgie.siroe.varrius.com budgie

  3. Ensure that the following components are up and running before you configure Communications Express. Make sure that the configuration of the products for Communications Express is done in the order mentioned here:
      1. Directory Server
      2. Administrative Console for Directory Server
      3. Application Server (if chosen) or Web Server (if chosen)

        4. Note

        After this step, run Directory Preparation Script (comm_dssetup.pl) to update the schema details in the User/Group Directory Server.

        Skip this step if you have already configured Messaging Server and Calendar Server successfully.

        To run Directory Preparation Script (comm_dssetup.pl) type:

        cd /root -of -the -directory -preparatory-script/SUNWcomds/sbin

        perl comm_dssetup.pl

      4. Access Manager, if you have chosen Sun Java System LDAP Schema, v.2.
      5. Messaging Server
      6. Calendar Server
      7. Delegated Administrator if you have chosen Sun Java System LDAP Schema, v.2.

        8. For details on the product configuration process, refer to Chapter 10 of the Sun Java Enterprise System Installation Guide at:

        http://docs.sun.com/db/doc/819-0056

  4. Verify whether users are able to login to the following servers correctly.
    • Messaging Server
    • Calendar Server
    • Access Manager (formerly known as Identity Server), if you have chosen Sun Java System LDAP Schema, v.2

Schema Choices

Prior to installing and configuring, you will need to decide on the schema model you wish to adopt. You have two schema and web container options available when deploying Communications Express.

The configurator panel displayed for each schema and web container combination varies depending on your schema and web container selection. Table B-1 in Appendix B, lists the panels that are displayed for each schema and web container combination.

Upgrading Communications Express

Prior to installing and configuring, you have the option of upgrading from Communications Express 6 2004Q2 to Communications Express 6 2005Q1. Refer to the Sun Java Enterprise System 2005Q1 Upgrade and Migration Guide for more information on how to upgrade from Communications Express 6 2004Q2 to Communications Express 6 2005Q1.

http://docs.sun.com/app/docs/doc/819-0062

Invoking Configuration Tool

This section describes how to invoke the configuration tool

  1. Login as Administrator (root for UNIX or Linux).
  2. Before invoking the configuration wizard set the display settings.
  3. Go to uwc-basedir/SUNWuwc/sbin directory.
  4. Then type,

    5. ./config-uwc to invoke the configuration tool in the GUI mode.

    ./config-uwc -nodisplay to invoke the configuration tool in the console mode.

    Note

    This version does not support the silent installation mode.

  5. The configuration wizard appears.

Configuring Communications Express

The following steps walk you through configuring Communications Express.

Note

If you are invoking the configuration wizard in a language other than English, resize the configuration panel to view its contents properly.

  1. The Welcome panel.

    2. The first panel in the configure program is a copyright page. Select Next to continue or Cancel to exit.

  2. The Select the Directory to Store Configuration and Data Files panel appears.

    3. Select the directory in which the configuration and data files for Communications Express should be deployed. For example, /var/opt/SUNWuwc.

    This directory is referred as uwc-deployed-path throughout this guide.

    Click Next.

  3. The Select Components to be Configured panel appears.

    4. Select the components you want to configure and unselect those components you do not wish to configure.

    • Mail Component
    • Calendar Component

      • Note

      You have to select atleast one component from the Select Components to be Configured panel.

      Although the component size is displayed as zero, the Mail and Calendar components are installed.

      Click Next.

  4. The Network Connection panel appears.

    5. The configuration program tries to establish network connection using the host name and DNS domain name displayed in this panel.

    Host Name. The host name on which Communication Express is being configured is displayed.

    DNS Domain Name. Displays the DNS domain name maintained by the DNS Server.

    Click Next.

  5. The Select a Web Container panel appears.

    6. Select the web container you want to use from the options displayed. The options available are:

    • Web Server. For Web Server panel details, see Web Server.
    • App Server. For App Server panel details, see Application Server.

      • Click Next.

      Web Server

      If you have selected Web Server to be your web container, the following panels appear:

    • The Web Server Configuration Details panel.

      • Specify the local Web Server instance details. The web server details specified here is used by the installer to deploy Communications Express on Web Server.

      Server Root Directory. Browse to select the installation root of the Web Server. Default location is, /opt/SUNWwbsvr/

      Server Instance Identifier. Enter the Web Server Instance on which Communications Express is to be deployed. For example, budgie.siroe.varrius.com.

      Virtual Server Identifier. Enter the virtual server identifier on which Communications Express is to be deployed. For example, https-budgie.siroe.varrius.com

      HTTP Port. Enter the HTTP port number Web Server listens to. This is the HTTP port from which Communications Express is accessed.

      Note

      If you want to configure a secure HTTP port number, specify it after configuring Communications Express. To configure a secure port number refer to the post configuration steps provided in the section, To Use Communications Express in the SSL mode, in Chapter 3 of this guide.

      Click Next.

      You will see a small pop-up window indicating that the Web Server Instance is being verified. This may take a few minutes.

      An Error message is displayed if the configure tool is unable to connect to the Web Server Instance. Click Accept, to continue with the installation process, or click Choose New, to specify different Web Server configuration details.

    • The Web Container User and Group panel.

      • Specifies the identity, the web container uses to run the services.

      Web Container User ID. The web container user identifier from the user database is displayed.

      Web Container Group ID. The web container group identifier from the group database is displayed.

      Click Next.

      The configurator program installs some files and directories containing sensitive data, such as passwords. The ownership of these files and directories are given to web container user and group mentioned in this panel. Only the web container user is given read and write permissions to the files and directories containing sensitive data.

      Note

      Ensure you enter the correct web container User ID and Group ID values in this panel. Entering wrong values may result in startup failure of the Communications Express.

      Go to Step 6 after you have configured the Web Server as your web container.

      Application Server

      If you have selected Application Server to be your web container, the following panels appear:

    • The Application Server Configuration Details panel.

      • In the Application Server Configuration Details panel, specify the following details:

      Install Directory. Browse to select the local directory in which Application Server is installed.

      Domain Directory. Browse to select the domain directory of the Application Server.

      Document Root Directory. Browse to select the document root directory of the Application Server.

      Server Target Name. Enter a name for the Application Server target, for which Communications Express is to be configured. The Communications Express Configurator supports only the Domain Administration Server (DAS) deployment for Application Server 8.1.

      Virtual Server Identifier. Enter the virtual server identifier for which Communications Express is to be configured.

      Server Instance HTTP Port. Enter the Application Server port number where an HTTP service is available. This is the HTTP port from which Communications Express application will be accessed.

      Click Next.

      Note

      Specify the HTTP Port number here. If you want to configure a secure HTTP port number, specify it after configuring Communications Express. To configure a secure port number, refer to the post configuration steps provided in the section To Use Communications Express in the SSL mode, in Chapter 3 of this guide.

      You will see a small pop-up window indicating that the Application Server Instance is being verified. This may take a few minutes.

      An Error message is displayed if the configure tool is unable to connect to the Application Server Instance. Click Accept, to continue with the installation process, or click Choose New, to specify the Application Server Configuration Details again.

    • The Application Server Administration Instance Details panel.

      • Specify the administration instance details of the Application Server. The administration instance details is used by the configurator to deploy Communications Express on Application Server.

      Administration Server Port. Enter the Administration Server port number.

      Note

      The administration port of the Application Server must be available for configuring Communications Express on Application Server.

      Administrator User ID. Enter the administrator’s user identifier.

      Administrator Password. Enter the administrator’s user password.

      Secure Administration Server Instance. Select this check box, to specify that the Application Server’s administration instance is running in the secure mode.

      Deselect the checkbox, to specify that the Application Server’s administration instance is running in the normal mode.

      Click Next.

      Depending on the selection, a pop-up window confirming the mode in which the Application Server’s administration instance is running, appears. Click OK to exit the pop-up window.

      Note

      When deploying Communications Express on Application Server, two files, server.xml and server.policy,are modified.

      Before modifying server.xml and server.policy files, a backup of these files is maintained by the configurator program. The backup files are stored in the directory

      DOMAIN-DIRECTORY/SERVER-INSTANCE-NAME/config/.CommsExpress_YYYYMMDDhhmmss

      Where,

      DOMAIN-DIRECTORY is Application Server’s Domain Directory.

      SERVER-INSTANCE-NAME is the Application Server Instance Name for which Communications Express is being configured.

      YYYYMMDDhhmmss is the time stamp of the backup directory.

    • The Module Name for this Web Application panel.

      • Enter the module name with which Communications Express should be deployed on Application Server.

      Click Next.

      Go to Step 6 after you have configured the Application Server as your web container.

  6. The URI Path Setting panel appears.

    7. Enter the URI where Communications Express should be deployed. For example, /uwc.

    Caution

    If you are using an existing URI to deploy Communications Express, the configuration tool first removes any previous application data before deploying Communications Express on that URI. For example, if you are deploying Communications Express on a URI such as /uwc that has a web application deployed in it, Communications Express configurator first removes the existing web-application from /uwc before deploying Communications Express. This could result in the loss of the previous application’s data and accessibility of the application.

    Click Next.

  7. The Do you want Hosted Domain Support? panel appears.

    8. Select the option to enable hosted domain support for Communications Express. Select this option only if you have enabled hosted domain support in Calendar Server.

    Click Next.

  8. The User/Group Directory (LDAP) Server Details panel appears.

    9. Enter the following details:

    LdapURL. Specify the user/group LDAP URL in the format ldap://UG-LDAP-HOST:UG-LDAP-PORT.

    Bind DN. Enter the LDAP distinguished name of the User/Group administrator.

    Bind Password. Enter the bind password for User/Group administrator.

    Click Next.

  9. The DC Tree Suffix panel appears.

    10. Enter the base distinguished name for the DC tree suffix. This suffix will be used by the Communications Express to search for domain lookup.

    Click Next.

  10. The Default Domain Name panel appears.

    11. Enter the default domain name.

    Each domain has certain properties. When a user logs into a domain that does not have the required properties, the properties are picked up from the default domain name.

  11. The Enable Identity Server for Single Sign-on panel appears.

    12. To setup single sign-on with Identity Server, select Enable Identity Support for Sun Java System Communications Express.

    Only if you have enabled Identity Support for Sun Java System Communications Express, the Identity Server Preferences panel is displayed.

    Enter the Identity Server Preferences such as the login URL, Identity Server Administrator DN and Password in this panel.

    Login URL. Specify the Identity Server Login URL in the format protocol://Identity server hostname:Identity Server port/context -path-of-amserver/UI/Login.

    Admin DN. Enter the complete LDAP DN (distinguished name) of the Identity Server Administrator, such as, DN=uid=amAdmin, ou=people, Identity Server-root suffix.

    Admin Password. Enter the Password for the Identity Server administrator.

    Click Next.

  12. The Messaging Express Port panel appears.

    13. This panel appears only when the mail component is selected in the Select Components to be Configured panel.

    Enter the port number where the Messenger Express service is available.

    Note

    Ensure Communications Express is deployed on the same machine on which Messenger Express is deployed.

    Click Next.

  13. The Calendar Server Host and Port Configuration panel appears.

    14. This panel appears only when calendar component is selected in the Select Components to be Configured panel.

    Calendar Server Host Name. Enter the Calendar Server’s host name.

    Calendar Server HTTP Port Number. Enter the Calendar Server’s HTTP port number.

    Click Next.

  14. The Calendar Server Administration Details panel appears.

    15. This panel appears only when calendar component is selected in the Select Components to be Configured panel.

    Administrator User ID. Enter the Calendar Server’s administrator’s name. For example, calmaster.

    Administrator User Password. Enter the Calendar Server’s administrator’s password.

    Note

    Ensure that the Calendar Admin User ID value you have entered here is the same as the service.admin.calmaster.userid value mentioned in Calendar Server’s ics.conf file.

    Click Next.

  15. The PAB Directory Server Details panel appears.

    16. The Personal Address Book LDAP Server is the store where users personal address books are located. Enter the following details in this panel:

    LDAP URL. Specify the LDAP host and port for the PAB Store. The url should be in the format: ldap://PAB-ldap-hostname:PAB-ldap-portnumber

    Bind DN. Enter the LDAP DN to be used to bind to the PAB Store. The Bind DN specified here should have appropriate privileges to manage the data under root suffix o=PiServerDB.

    Password. Enter the bind password.

    Click Next

  16. The Ready to Configure panel appears.

    17. The configuration program will check for enough disk space on your machine and then list the components it is ready to configure.

    Click Configure Now, to configure the Communications Express.

    Click Back, to change any of your configuration variables.

    Click Cancel, to exit from the configuration program.

  17. A summary of tasks and the sequence status is displayed.

    18. Click Next.

  18. The Configuration Summary panel lists the status of the configuration program. Click Details button to view the log.
  19. The Post Configuration Instructions panel appears only when the configuration is successful. This panel may display warning messages when the required shared components are not installed.

    20. In order to complete the configuration process, follow the post-configuration instructions provided here.

Post Configuration Instructions

Note

Make sure you are familiar with the location of the Communications Express files.

Refer to the section on Default Paths and File Names in the Preface of this guide.

Refer to Chapter 3, "Configuration Details," and Chapter 6, "Configuring the Hosted Domains," of this guide for details on the configuration parameters.

Before performing the post configuration steps make sure you have performed the following steps:

  1. Assuming that the Communications Express package has already been installed, ensure that for a setup using Identity Server single sign-on, the Core and LDAP services are added. For more information, refer to the section on Tuning Directory Server, in Chapter 8 of this guide.
  2. After you have configured Communications Express, perform the following steps
    1. To enable the Mail component in Communications Express, configure Single Sign-On. Refer to Chapter 4, "Implementing Single Sign-On," for information on configuring Messenger Express and Communications Express.
    2. Go to calendar-server-install-directory/SUNWics5/cal/bin/config (e.g. /opt/SUNWics5/cal/bin/config).

      3. Edit the ics.conf file and set the following:

      • service.http.allowadminproxy = "yes"
      • service.http.admins = proxy-admin-for-calendar-http-service
      • service.admin.calmaster.userid = the-value-specified-for- calendar.wcap.adminid-in-uwcconfig.properties
      • service.admin.calmaster.cred = the-value-specified-for- calendar.wcap.passwd-in-uwcconfig.properties
      • service.wcap.anonymous.allowpubliccalendarwrite = "yes"
      • service.http.allowanonymouslogin = "yes"
      • service.calendarsearch.ldap = "no"

        • If you have edited the ics.conf file, restart Calendar Server for the changes to take effect.

  3. Restart Web Server or the Application Server, depending on which you have selected as the web container.
  4. Communications Express is now ready and you can access the application from:

    5. http://Web-Container-host: Web-Container-port/URI path

    where

    Web-Container-host is the host name of the web container instance in which the Communications Express application is configured.

    Web-Container-port is port number of the web container instance in which the Communications Express is configured

    URI path is the path specified in the URI Path Setting panel.

Unconfiguring Communications Express

Perform the following steps if you have configured Communications Express on Web Server or Application Server and feel the need to unconfigure Communications Express:

Communications Express File Directory Layout

After you install and configure Communications Express, its directories and files are arranged in the organization as shown in Table 2-1. The table is not exhaustive; it shows only those directories and files of most interest for typical server administration tasks.

Table 2-1  Communications Express Directories and Files

Directory and Legends

Default Location and Description

Communications Express Base

uwc-basedir

Default location:

Solaris: /opt/SUNWuwc/

Linux: /opt/sun/uwc/

This directory is where communications express is installed.

Note: Only one Communications Express Base directory per machine is permitted.

Deployed Directory

uwc-deployed-dir

 

Default location:

Solaris: /var/opt/SUNWuwc/

Linux: /var/opt/sun/uwc/

Communications Express is deployed in this directory. The web container takes the files from this location while loading Communications Express.

Web Applications Root Directory

web-inf

uwc-deployed-dir/WEB-INF

WEB-INF directory of Communications Express web application.

Web Applications Root Directory

web-inf

uwc-deployed-dir/WEB-INF

WEB-INF directory of Communications Express web application.

Configuration

config

uwc-deployed-dir/WEB-INF/config/

Contains all the Communication Express configuration files.

Domain

domain

uwc-deployed-dir/WEB-INF/domain/

Contains per domain localization and Customization files.

Skin

skin

uwc-deployed-dir/WEB-INF/skin/

Contains per domain themes.

Logs

logs

uwc-deployed-dir/logs/

Contains the Communications Express log files.

System Administrator Programs

sbin

uwc-basedir/sbin/

Contains the Communications Express system administrator executable programs and scripts.

Help

help

uwc-deployed-dir/help

Contains Communications Express help files.



Previous      Contents      Index      Next     

Part No:819-0115-10.   Copyright 2005 Sun Microsystems, Inc. All rights reserved.