Sun ONE logo      Previous      Contents      Index      Next     

Installation Guide: Sun ONE Portal Server Communication Channels

Chapter 1
Preparing for Installation

This chapter contains the following sections to help you prepare for the installation of Sun™ ONE Portal Server Communication Channels:

Installation Overview

The following are the three basic steps involved in installing communication channels:

  1. Enabling access to Mail and Calendar applications
  2. Uninstalling previous installation of communication channels, if applicable
  3. Installing and configuring the Mail, Calendar and Address Book applications

System Requirements

Before you install the communication channels, you must ensure that you have met the minimum hardware and operating system requirements and that the software dependencies are installed and configured.

This hardware requirements are:

Software dependencies include the following products:

Enabling Access to Mail and Calendar Applications

Messaging Server and Calendar Server both verify the Internet Protocol (IP) address of the host where the browser requests a login session ID. If the IP address differs from the host IP address where the session ID is issued, Mail Server and Calendar Server reject the session with a session time out message.

You must change the value of the parameter that enables and disables an IP security check to allow the user to access mail through Portal Server. The parameter that specifies whether to restrict session access to the login IP address, is service.http.ipsecurity.

Turning off ipsecurity for Messaging Server

Complete the following steps in the command line on the machine running the mail server:

  1. Log in as a messaging server user.
  2. Enter this command:

    3. /install_directory/server5/msg-hostname/configutil -o service.http.ipsecurity -v no

    Where install_directory is the messaging server’s installation directory and msg-hostname is the name of the messaging server.

  3. Change to root.
  4. Stop the messaging server using this command:

    5. /install_directory/server5/msg-hostname/stop-msg

  5. Start the messaging server using this command:

    6. /install_directory/server5/msg-hostname/start-msg

Turning off ipsecurity for Calendar Server

Complete the following steps from the command line on the machine running the calendar server:

  1. Change to root.
  2. Use the cd command to change to the

    3. /install_directory/SUNWics5/cal/bin/config directory.

    Where install_directory is the calendar server’s installation directory

  3. Edit the ics.conf file to change the value of service.http.ipsecurity to no (for example: service.http.ipsecurity=no).
  4. Save the file.
  5. Stop calendar server using this command:

    6. /install_directory/SUNWics5/cal/bin/stop-cal

  6. Start calendar server using this command:

    7. /install_directory/SUNWics5/cal/bin/start-cal

Uninstalling Previous Installation of Communication Channels, if Applicable

If no previous installation of Communication Channels exists, skip this chapter and go to Chapter 2.

Removing Individual Communication Channels, if Desired

You cannot uninstall individual communication channels from the release version (the standard version) of Sun ONE Portal Server Communication Channels, since you must uninstall all communication channels (Address Book, Calendar, and Mail) or none; however, you can remove individual communication channels from users’ desktops while keeping them installed as follows:

  1. Access the Sun™ ONE Identity Server administration console:
    1. From an Internet browser, type: http://hostname.domain:port/amconsole, for example http://psserver.company22.siroe.com:80/amconsole
    2. Enter the administrator User ID and Password.
    3. Click Submit.
  2. Select User Management in the View drop down list, if it is not already selected.
  3. Click the organization link. For example: siroe.com
  4. In the lower left frame, select Services in the Show drop down list.
  5. Scroll down to Portal Server Configurations.
  6. Click the arrow icon beside Desktop.
  7. In the lower right frame, click the Channel and Container Management link.
  8. Scroll down to Channels.
  9. Click the boxes next to the communication channels you want to delete. For example: Calendar; clicking a box puts a checkmark in that box.
  10. Click Delete.

Release Version Vs. Beta/Early Access Version

The uninstallation procedures are different depending upon the version of communication channels you are uninstalling: the release version or the beta/EA version.

If you are uninstalling a release version, continue to the next section, "Uninstalling the Release Version (the standard version) of Communication Channels." If you are uninstalling a beta or EA version, go to "Uninstalling the Beta or EA version of Communication Channels".

Uninstalling the Release Version (the standard version) of Communication Channels

To prevent errors, after you uninstall the release version of the communication channels, either reinstall the communication channels or follow the steps for permanent uninstallation. These two options are explained in more detail subsequently.

  1. Delete communication channels from the desktop:
    1. Access the Identity Server administration console:
      1. From an Internet browser, type: http://hostname.domain:port/amconsole, for example http://psserver.company22.siroe.com:80/amconsole
      2. Enter the administrator User ID and Password.
      3. Click Submit.
    2. Select User Management in the View drop down list, if it is not already selected.
    3. Click the organization link. For example: siroe.com
    4. In the lower left frame, select Services from the Show drop down list.
    5. Scroll down to Portal Server Configurations.
    6. Click the arrow icon beside Desktop.
    7. In the lower right frame, click the Channel and Container Management link.
    8. Scroll down to Channels.
    9. Click in the boxes next to Address Book, Calendar, and Mail, which puts a checkmark in those boxes.
    10. Click Delete.
    11. Exit the Internet browser.
  2. Change directories to where the commsetup file is located.

    3. The commsetup command can be used to uninstall or install communication channels, depending upon the options you add.

  3. Type:

    4. ./commsetup -r

    Here you are using the commsetup command with -r, the remove option.

  4. When the license agreement appears, if you agree, type:

    5. Yes

    It is necessary to agree to the license for the uninstallation to continue. You will then see the message: Removing old installation

    The uninstallation takes a few moments.

    After uninstalling the release version (the standard version) of communication channels (not the beta or Early Access version) if you now want to re-install those same Channels, you are finished with the uninstall process. Therefore, if you just uninstalled the release version of Channels, but you do not want to permanently remove those Channels, skip the rest of this chapter and go to Chapter 2. If you want to remove the Channels permanently continue to the next section.

Permanently Uninstalling the Release Version (the standard version) of Communication Channels

If you have already performed the first four steps of the uninstallation, permanent removal of the release version of communication channels requires that you also remove SunSSOAdapterService. To remove this service, you need to remove two directory server entries for SunSSOAdapterService using the ldapdelete command.

  1. Use the ldapdelete command to remove the following two directory server entries pertaining to SunSSOAdapterService:

    Note

    The first of the two directory server entries—as listed following this Note—that needs to be removed is different for Portal Server 6.1 than it is for Portal Server 6.0. For 6.0, the first entry to be removed is:

    ou=1.0,ou=SunSSOAdapterService,ou=services,o=organization_
    name

    For 6.1 the first entry to be removed is:

    ou=1.0,ou=SunSSOAdapterService,ou=services,dc=organization_
    name

    2. ou=1.0,ou=SunSSOAdapterService,ou=services,o=organization_
    name

    ou=SunSSOAdapterService,ou=services,o=organization_name

    Code Example 1-1 lists the commands for removing the preceding two entries from the directory server, where the password is mypassword; the service being removed is SunSSOAdapterService; the host name is localhost; the port number is the default, 389; and the organization name is siroe. This example applies to Portal Server 6.0. For Portal Server 6.1, use the appropriate entry information as described in the preceding Note.

    Code Example 1-1  Removing SUNSSOAdapterService

    setenv LD_LIBRARY_PATH DSBaseDir/lib

    DSBaseDir/shared/bin/ldapdelete -v -D "cn=Directory Manager

        " -w mypassword -h localhost -p 389

        "ou=1.0,ou=SunSSOAdapterService,ou=services,o=siroe"

    DSBaseDir/shared/bin/ldapdelete -v -D "cn=Directory Manager

        " -w mypassword -h localhost -p 389

        "ou=SunSSOAdapterService,ou=services,o=siroe"

    The preceding code first sets the path LD_LIBRARY_PATH and indicates the location of the ldapdelete command. Then, ldapdelete is issued twice in order to remove two different entries. Table 1-1 summarizes each option used with this command.

    Table 1-1  Options for the ldapdelete Command

    -v

    turns on verbose mode

    -D

    specifies the distinguished name, in this case “cn=Directory Manager,” to bind to the directory

    -w

    specifies the password, in this case mypassword, for authenticating to the directory

    -h

    specifies the host, in this case localhost, on which the directory server is running

    -p

    specifies the port, in this case the default port 389,through which the directory server is listening

    For more information about the ldapdelete command see iPlanet Directory Server 5.1 Administrator’s Guide at the following location:

    http://docs.sun.com/db/doc/816-5606-10

  2. After deleting SunSSOAdapterService, restart Identity Server by typing:

    3. BaseDir/SUNWam/bin/amserver stop

    BaseDir/SUNWam/bin/amserver start

Uninstalling the Beta or EA version of Communication Channels

  1. Delete communication channels from the desktop:
    1. Access the Identity Server administration console:
      1. From an Internet browser, type: http://hostname.domain:port/amconsole, for example http://psserver.company22.siroe.com:80/amconsole.
      2. Enter the administrator User ID and Password.
      3. Click Submit.
    2. Select User Management in the View drop down list, if it is not already selected.
    3. Click the organization link. For example: siroe.com
    4. In the lower left frame, select Services in the Show drop down list.
    5. Scroll down to Portal Server Configurations.
    6. Click the arrow icon beside Desktop.
    7. In the lower right frame, click the Channel and Container Management link.
    8. Scroll down to Channels.
    9. Click in the boxes next to Address Book, Calendar, and Mail, which puts a checkmark in those boxes.
    10. Click Delete.
    11. Exit the Internet browser.
  2. Change directories to where commsetup file is located.

    3. The commsetup command can be used to uninstall or install communication channels, depending upon the options you add.

  3. Type:

    4. ./commsetup -r

    Here you are using the commsetup command with -r, the remove option.

  4. When the license agreement appears, if you agree, type:

    5. Yes

    It is necessary to agree to the license for the uninstallation to continue. You will then see the message: Removing old installation

    The uninstallation takes a few moments.

Beta or EA Version: Removing the Communication Channels Services

If you have already performed the first four steps of the uninstallation, you can now implement the specific steps necessary for uninstalling the beta or EA Version. You need to remove the communication channels services for Address Book, Calendar, and Mail. To remove these services, you need to remove two directory server entries for each channel by using the ldapdelete command.

  1. Use the ldapdelete command to remove the following two directory server entries pertaining to the address book service:

    Note

    The first of the two directory server entries—as listed following this Note—that needs to be removed is different for Portal Server 6.1 than it is for Portal Server 6.0. For 6.0, the first entry to be removed is:

    ou=1.0,ou=SunSSOAdapterService,ou=services,o=organization_
    name

    For 6.1 the first entry to be removed is:

    ou=1.0,ou=SunSSOAdapterService,ou=services,dc=organization_
    name

    2. ou=1.0,ou=SunSSOAdapterService,ou=services,o=organization_name

    ou=SunSSOAdapterService,ou=services,o=organization_name

    Code Example 1-2 lists the commands for removing the preceding two entries from the directory server, where the password is mypassword; the service being removed is SunSSOAdapterService; the host name is localhost; the port number is the default, 389; and the organization name is siroe. This example applies to Portal Server 6.0. For Portal Server 6.1, use the appropriate entry information as described in the preceding Note.

    Code Example 1-2  Removing SUNSSOAdapterService

    setenv LD_LIBRARY_PATH DSBaseDir/lib

    DSBaseDir/shared/bin/ldapdelete -v -D "cn=Directory Manager

        " -w mypassword -h localhost -p 389

        "ou=1.0,ou=SunSSOAdapterService,ou=services,o=siroe"

    DSBaseDir/shared/bin/ldapdelete -v -D "cn=Directory Manager

        " -w mypassword -h localhost -p 389

        "ou=SunSSOAdapterService,ou=services,o=siroe"

    The preceding code first sets the path LD_LIBRARY_PATH and indicates the location of the ldapdelete command. Then, ldapdelete is issued twice in order to remove two different entries. Table 1-2 summarizes each option used with this command.

    Table 1-2  Options for the ldapdelete Command

    -v

    turns on verbose mode

    -D

    specifies the distinguished name, in this case “cn=Directory Manager,” to bind to the directory

    -w

    specifies the password, in this case mypassword, for authenticating to the directory

    -h

    specifies the host, in this case localhost, on which the directory server is running

    -p

    specifies the port, in this case the default port 389,through which the directory server is listening

    For more information about the ldapdelete command see iPlanet Directory Server 5.1 Administrator’s Guide at the following location:

    http://docs.sun.com/db/doc/816-5606-10

  2. Use the ldapdelete command to remove the following two directory server entries pertaining to Calendar:

    3. ou=1.0,ou=SunSSOAdapterService,ou=services,o=organization_name

    ou=SunSSOAdapterService,ou=services,o=organizatioin_name

    Code Example 1-3 lists the commands for removing the preceding two entries from the directory server, where the password is mypassword; the service being removed is SunSSOAdapterService; the host name is localhost; the port number is the default, 389; and the organization name is siroe. This example applies to Portal Server 6.0. For Portal Server 6.1, use the appropriate entry information as described in the Note.

    Code Example 1-3  Removing SUNSSOAdapterService

    setenv LD_LIBRARY_PATH DSBaseDir/lib

    DSBaseDir/shared/bin/ldapdelete -v -D "cn=Directory Manager

        " -w mypassword -h localhost -p 389

        "ou=1.0,ou=SunSSOAdapterService,ou=services,o=siroe"

    DSBaseDir/shared/bin/ldapdelete -v -D "cn=Directory Manager

        " -w mypassword -h localhost -p 389

        "ou=SunSSOAdapterService,ou=services,o=siroe"

  3. Use the ldapdelete command to remove the following two directory server entries pertaining to Mail:

    4. ou=1.0,ou=SunSSOAdapterService,ou=services,o=organization_name,

    ou=SunSSOAdapterService,ou=services,o=organizatioin_name

    Code Example 1-4 lists the commands for removing the preceding two entries from the directory server, where the password is mypassword; the service being removed is SunSSOAdapterService; the host name is localhost; the port number is the default, 389; and the organization name is siroe. This example applies to Portal Server 6.0. For Portal Server 6.1, use the appropriate entry information as described in the Note.

    Code Example 1-4  Removing SUNSSOAdapterService

    setenv LD_LIBRARY_PATH DSBaseDir/lib

    DSBaseDir/shared/bin/ldapdelete -v -D "cn=Directory Manager

        " -w mypassword -h localhost -p 389

        "ou=1.0,ou=SunSSOAdapterService,ou=services,o=siroe"

    DSBaseDir/shared/bin/ldapdelete -v -D "cn=Directory Manager

        " -w mypassword -h localhost -p 389

        "ou=SunSSOAdapterService,ou=services,o=siroe"

  4. After deleting all the services for the communication channels, restart Identity Server by typing:

    5. BaseDir/SUNWam/bin/amserver stop

    BaseDir/SUNWam/bin/amserver start

    Once you have completed the steps for uninstalling the beta or EA version of communication channels, go to Chapter 2.



Previous      Contents      Index      Next     

Copyright 2003 Sun Microsystems, Inc. All rights reserved.