Sun Java logo     Previous      Contents      Index      Next     

Sun logo
Sun Java System Portal Server 6 2005Q4 Enterprise Sample Portal 1.1 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.

Directory Server Configuration

The Directory Server setup script (comm_dssetup.pl) configures your LDAP Directory Server to work with your Delegated Administrator, Messaging Server, and Calendar Server 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 where the Directory Server setup script is installed.

    2. For example:

    cd /opt/SUNWcomds/sbin

  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 Access Manager 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.

Delegated Administrator Configuration

The Delegated Administrator (commadmin) enables administrators to manage different communication services for users, groups, domains, and organizations.

The Delegated Administrator configuration utility is located in the following directory (the default root directory for the Delegated administrator is /opt/SUNWcomm/sbin/config-commda script).

um-util-install-root/sbin

To configure the Delegated Administrator:

  1. Change to the directory in which the Delegated Administrator Utility program is installed. For example:

    2. cd /opt/SUNWcomm/sbin

  2. Run the configuration program using the following command:

    3. ./config-commdaRespond to the prompts as follows:

    Prompt

    Response

    Directory to store configuration and data files

    /var/opt/SUNWcomm

    Components

    Delegated Administrator Utility, Delegated Administrator Console, Delegated Administrator Server

    Hostname

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

    Port

    80, if this is the port you are running on.

    Default domain

    example.com

    Default SSL port

    443

    Access Manager base directory

    /access-manager-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

    Access Manager top-level administrator user name

    password

    Access Manager top-level administrator password

    password

    Access Manager internal LDAP authentication user name

    password

    Access Manager 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

  3. Test the Delegated Administrator utility. The commadmin domain search command obtains all the directory properties associated with a single domain. Assuming that you are running on port 80, run the command with the following command-line options (option -h displayed online help):

    4. ./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

  4. Restart the web container.

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 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)

    Assuming that you wish to use port 81, 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:

    3. .csconfigurator.sh

  3. Respond to the prompts as follows. 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, if you are using this port

    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. 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 Messaging 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:

    3. ./configure

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

    Prompt

    Response

    Components

    Instant Messaging Server

    Instant Messenger Resources

    Access Manager 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

    45222

    Multiplexor port

    5222

    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/im

    Assuming that you want to run on port 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:

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

      (The default installation root directory for the Application Server is /var/opt/SUNWappserver/domains/domain1/docroot/.)

    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: 819-4160-10.   Copyright 2005 Sun Microsystems, Inc. All rights reserved.