Sun Java logo     Previous      Contents      Index      Next     

Sun logo
Sun Java System Portal Server 6 Enterprise Sample Installation Guide 

Chapter 2
Install and Configure Communication Services

Product and Configuration Dependencies

The following Sun Java Enterprise System products must be installed and configured on the system on which you will install and run the Enterprise Sample:

If you want to configure the Communication channel services to use the adventuresportscafe.com organization and associated sample data, you need to install and configure the following Sun Java Enterprise System products, which provide hosted domain support:

Post-installation Configuration and Startup

This section explains how to configure each of the Sun Java System Portal Server communication services so that the Communication channels in the Enterprise Sample will be preconfigured with the Adventure Sports Café sample data.

Please see the Sun Java Enterprise System 2004Q2 Installation Guide for additional configuration information.

Directory Server Configuration

The Directory Server setup script (comm_dssetup.pl) configures your LDAP Directory Server to work with your Messaging Server, Calendar Server, and User Management Utility configurations.

The comm_dssetup.pl script is located in the following directory (the default root directory for the Directory Server is /opt/SUNWmsgsr):

/msg-server-install-root/lib

  1. Change to the directory in which the Directory Server setup script is installed. For example:

    2. cd /opt/SUNWmsgsr/lib

  2. Ensure that the Directory Server is running; if not, enter the following command. Note that DS_SERVERROOT represents the Directory Server root directory (the default is /var/opt/mps/serverroot), and HOSTNAME represents the host name on which the Directory Server is installed.

    3. DS_SERVERROOT/slapd-HOSTNAME/start-slapd

  3. Run the Directory Server setup script using the following command:

    4. DS_SERVERROOT/bin/slapd/admin/bin/perl ./comm_dssetup.pl

  4. Respond to the prompts as shown in the following table. Note that responses in brackets are default responses. To specify the default response to a prompt, press Enter.

    Prompt

    Response

    Directory Server root [/var/opt/mps/serverroot]

    Press Enter to accept the default.

    Please enter the Directory Manager DN [cn=Directory Manager]

    Press Enter to accept the default.

    Please enter the Users/Groups base suffix [o=usergroup]

    Specify the root suffix (or base dn) for your site (which is specified during the Directory Server and Identity Server portions of the Sun Java Enterprise Server installation). For example:

    dc=example,dc=com

    Please enter the Schema Type (1, 1.5, 2) [2]

    Press Enter to accept the default.

    Do you want to update the schema files [yes]

    Press Enter to accept the default.

    Do you want to configure new indexes [yes]

    Press Enter to accept the default.

    Do you want to reindex the new indexes now [yes]

    Press Enter to accept the default.

User Management Utility Configuration

The User Management Utility command-line utilities enable administrators to manage different communication services for users, groups, domains, and organizations. The User Management Utility configuration program (config-iscli) is located in the following directory (the default root directory for the User Management Utility is /opt/SUNWcomm/):

/um-util-install-root/sbin

  1. Change to the directory in which the User Management Utility configuration program is installed. For example:

    2. cd /opt/SUNWcomm/sbin

  2. Run the configuration program using the following command:

    3. ./config-iscli

  3. Respond to the prompts as follows:

    Prompt

    Response

    Directory to store configuration and data files

    /var/opt/SUNWcomm

    Components

    Commcli Server

    Hostname

    company22.example.com (note that you must specify the fully-qualified hostname)

    Port

    80

    Default domain

    example.com

    Default SSL port

    443

    Identity Server base directory

    /identity-server-install-root/

    LDAP URL

    ldap://company22.example.com:389 (defaults to the port specified for the Directory Server)

    Bind as

    cn=Directory Manager

    Password

    password

    Identity Server top-level administrator user name

    amadmin

    Identity Server top-level administrator password

    password

    Identity Server internal LDAP authentication user name

    amldapuser

    Identity Server internal LDAP authentication password

    password

    Organization DN

    o=company22.example.com, dc=example,dc=com

    Top-level administrator for the default organization user name

    admin

    Top-level administrator for the default organization password

    password

  4. If the Sun Java System Identity Server is using Sun Java System Application Server as its web container, run the asadmin deploy command which deploys commcli-server.war into the Identity Server web container. To manually deploy commcli-server.war:
    1. Ensure that the Application Server is running; if not, enter the following commands:

      2. cd /opt/SUNWappserver7/bin

      ./asadmin start-appserv

    2. Execute the asadmin deploy utility with the following command-line options, substituting the values appropriate for your installation.

      3.     ./asadmin deploy \

          --user admin_user_name \

          --password admin_user_password \

          --host hostname \

          --port as_port_number \

          --name commcli \

          --contextroot commcli \

          /opt/SUNWcomm/lib/jars/commcli-server.war

      • The admin_user_name variable is the Application Server user associated to the instance.
      • The admin_user_password variable is the password that corresponds to the Application Server user.
      • The hostname variable is the local host name of the machine hosting the Application Server instance.
      • The as_port_number is the http-listener port number for the admin server within the Application Server. For a default installation, this port number is stored in the following file:

        • /var/opt/SUNWappserver7/domains/domain1/admin-server/config/server.xml

        For more description on the asadmin deploy utility, see the Sun ONE Application Server 7 Administrator's Guide.

    3. Stop the Application Server:

      4. ./asadmin stop-appserv

    4. Start the Application Server:

      5. ./asadmin start-appserv

  5. Test the commadmin utility. The commadmin domain search command obtains all the directory properties associated with a single domain. Run the command with the following command-line options (option -h displayed online help):

    6. ./commadmin domain search -D admin -w password -X company22.example.com
    -p 80 -n company22.example.com -d company22.example.com

    OK
    dn: dc=example,dc=com
    o: company22.example.com
    objectclass: sunISManagedOrganization
    objectclass: sunNameSpace
    objectclass: top
    objectclass: sunManagedOrganization
    objectclass: organization
    objectclass: domain
    sunnamespaceuniqueattrs: o,sunPreferredDomain,associatedDomain,sunOrganizationAlias
    sunregisteredservicename: SunPortalNetMailService
    sunregisteredservicename: SunPortalSubscriptionsService
    sunregisteredservicename: iPlanetAMAuthenticationDomainConfigService
    sunregisteredservicename: iPlanetAMAdminConsoleService
    sunregisteredservicename: iPlanetAMAuthMembershipService
    sunregisteredservicename: iPlanetAMAuthService
    sunregisteredservicename: iPlanetAMPolicyConfigService
    sunregisteredservicename: SunSSOAdapterService
    sunregisteredservicename: iPlanetAMUserService
    sunregisteredservicename: SunMobileAppABService
    sunregisteredservicename: iPlanetAMProviderConfigService
    sunregisteredservicename: SunMobileAppMailService
    sunregisteredservicename: SunPortalWSRPConsumerService
    sunregisteredservicename: SunPortalWSRPProducerService
    sunregisteredservicename: iPlanetAMAuthLDAPService
    sunregisteredservicename: SunMobileAppCalendarService
    sunregisteredservicename: SunPortalDesktopService
    dc: example
    inetdomainstatus: Active
    sunorganizationalias: company22.example.com

Messaging Server Configuration

The Messaging Server configuration utility (configure) is located in the following directory (the default root directory for the Messaging Server is /opt/SUNWmsgsr):

/msg-server-install-root/sbin

To configure the Messaging Server:

  1. Change to the directory in which the Messaging Server configuration utility is installed. For example:

    2. cd /opt/SUNWmsgsr/sbin

  2. Run the configuration utility using a command similar to the following:

    3. ./configure

  3. Respond to the prompts as shown in the following table:

    Prompt

    Response

    Directory to store config and data files

    SUNWmsgsr

    Components

    Message Transfer Agent

    Message Store

    Messenger Express

    Messaging Server UNIX user name

    mailsrv

    Messaging Server UNIX group

    mail

    LDAP URL

    ldap://company22.example.com:389 (defaults to the port specified during installation of Directory Server)

    Bind as

    cn=Directory Manager

    Password

    password

    Postmaster group email address

    Store.Administrator@company22.example.com

    admin account password

    password

    email domain

    company22.example.com

    Organization DN

    o=company22.example.com,dc=example,dc=com

  4. If you received the following warning message:

    5. The following ports are found to be in use:
    SMTP(25), WEBMAIL(80)

    Change the Messenger Express client port setting by entering the following command:

    ./configutil -o service.http.port -v 81

  5. Disable ipsecurity by entering the following command:

    6. ./configutil -o service.http.ipsecurity -v no

  6. Ensure that sendmail is not running by entering the following command:

    7. /etc/init.d/sendmail stop

  7. Stop and restart the Messaging Server using the following commands:

    8. ./stop-msg

    ./start-msg

Calendar Server Configuration

The Calendar Server configuration script (csconfigurator.sh) is located in the following directory (the default root directory for Calendar Server is /opt/SUNWics5/cal):

/calendar-server-install-root/sbin

To configure the Calendar Server:

  1. Change to the directory in which the Calendar Server configuration script is installed. For example:

    2. cd /opt/SUNWics5/cal/sbin

  2. Run the configuration script using a command similar to the following:

    3. ./csconfigurator.sh

  3. Respond to the prompts as follows. Note that responses shown in boldface type are non-default responses.

    Prompt

    Response

    LDAP Server host

    company22.example.com

    LDAP Server port

    389

    Directory Manager DN

    cn=Directory Manager (that is, the Directory Manager DN default as specified during the Sun Java Enterprise System installation)

    Directory Manager password

    password

    LDAP URL

    ldap://company22.example.com:389

    Base DN

    o=company22.example.com,dc=example,dc=com (that is, the Base DN default as specified during the Sun Java Enterprise System installation)

    Administrator user ID

    calmaster

    Administrator password

    password

    email alarms

    enabled

    Administrator email address

    Store.Administrator@company22.example.com

    SMTP host

    company22.example.com

    Service port

    82

    Maximum sessions

    5000

    Maximum threads

    20

    Number of server processes

    2

    Runtime user ID

    icsuser

    Runtime group ID

    icsgroup

    Calendar Server startup

    Check both boxes.

    Configuration directory

    /var/opt/SUNWics5/config

    Database directory

    /var/opt/SUNWics5/csdb

    Logs directory

    /var/opt/SUNWics5/logs

    Temporary files directory

    /var/opt/SUNWics5/tmp

  4. Edit the Calendar Server configuration file (which is located in /calendar-server-install-root/config/ics.conf) and specify the following. Note that some responses are specific to your installation.

    5. local.schemaversion="2"

    service.defaultdomain="company22.example.com"

    service.http.ipsecurity = "no"

    service.schema2root="dc=example,dc=com"

    service.siteadmin.userid = "calmaster@company22.example.com"

    service.siteadmin.cred = "password"

    service.virtualdomain.support="y"

  5. Stop and restart the Calendar Server using the following commands:

    6. ./sbin/stop-cal

    ./sbin/start-cal

Instant Messaging Server Configuration

The Instant Messaging Server configuration program (configure) is located in the default root directory for the Instant Messaging Server (/opt/SUNWiim/)

To configure the Instant Message Server:

  1. Change to the directory in which the Instant Messaging Server configuration program is installed. For example:

    2. cd /opt/SUNWiim

  2. Run the configuration program using a command similar to the following:

    3. ./configure

  3. Respond to the prompts as follows. Note that responses shown in boldface type are non-default responses.

    Prompt

    Response

    Components

    Instant Messaging Server

    Instant Messenger Resources

    Identity Server Instant Messaging Service

    Hostname

    company22

    DNS domain name

    example.com

    IM Server
    IS Server options

    Select both check boxes.

    Runtime files directory

    /var/opt/SUNWiim

    Domain name

    company22.example.com

    IM server port

    49999

    Multiplexor port

    49909

    Disable server

    Make sure the check box is not selected.

    LDAP Server name

    company22.example.com

    LDAP port

    389

    Base DN

    dc=example,dc=com (that is, the Base DN as specified during the Sun Java Enterprise System installation)

    Bind DN

    cn=Directory Manager [(that is, the Bind DN as specified during the Sun Java Enterprise System installation)

    Bind password

    password

    SMTP Server

    company22.example.com

    Code base

    http://company22.example.com:80

    Assign IM service to existing users

    Select the check box.

    Services startup configuration

    Make sure both check boxes are selected.

  4. Set up the codebase by linking the IM HTML directory to the web container’s document root. If the Enterprise Sample is deployed on the Application Server, follow these steps:
    1. Change directory to the web container’s document root by entering a command similar to the following:

      2. cd /app-server-install-root/domains/domain1/server1/docroot

      (The default installation root directory for the Application Server is /var/opt/SUNWappserver7.)

    2. Create a soft link to the IM HTML directory by entering a command similar to the following:

      3. ln -s /im-server-install-root/html im

  5. Ensure that the Instant Messaging Server is running by entering a command similar to the following:

    6. /im-server-install-root/sbin/imadmin refresh



Previous      Contents      Index      Next     

Part No: 817-7621-10 .   Copyright 2004 Sun Microsystems, Inc. All rights reserved.