Skip Headers
Oracle® Fusion Middleware Release Notes for Identity Synchronization for Windows 6.0 Service Pack 1
11g Release 1 (11.1.1.7.0)

Part Number E28964-01
Go to Documentation Home
Home
Go to Table of Contents
Contents
Go to Index
Index
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
PDF · Mobi · ePub

2 Understanding Deployment Issues

This chapter provides important formation about software related to Identity Synchronization for Windows 6.0 Service Pack 1 . In some cases you may have to resolve related software issues before you can run the Identity Synchronization for Windows 6.0 Service Pack 1 installer. This chapter contains the following sections:

2.1 Installing the Critical ISW Patch Set

Included with the Identity Synchronization for Windows bundle is the critical ISW 6.0SP1 CUMIL5 patch set. This patch set should be installed after ISW core installation, but before the Java console is used to create a configuration for ISW.

See the README file contained in the HotFix-6.0SP1_COMBO_5_20110722 bundle. Instructions for installing the ISW 6.0SP1 CUMIL5 patch set are contained in the installation and migration overview sections for each platform. The patch set is Java-based, and it works similarly on all supported platforms.

2.2 Installing or Upgrading Sun Java System Message Queue

Identity Synchronization for Windows 6.0 Service Pack 1 requires the installation and configuration of Message Queue software. This guide provides instructions for installing or upgrading Message Queue to the 4.3 release.

If you are installing a new instance of Identity Synchronization for Windows, you must first complete the steps for installing NSS and NSPR components, the included JDK, and Message Queue.

If you are migrating from version 6.0 or an from earlier 6.0 Service Pack 1 installation of Identity Synchronization for Windows, before upgrading your Message Queue installation, you must complete the steps for cleaning up and exporting configuration.

For detailed instructions, see the "Preparing for Migration" section of one of the following platform-based chapters:

Identity Synchronization for Windows 6.0 Service Pack 1 also supports Message Queue 3.7 Update 1 (the version that is provided with Java Enterprise System 5 update 1).

To determine which Message Queue version you are running, run the mqbrokerd command.

On Solaris
# /usr/bin/imqbrokerd -version
On Linux
# /opt/sun/mq/bin/imqbrokerd -version
On Windows
C:\Program Files\Sun\MessageQueue\mq\bin\imqbrokerd -version

2.2.1 To Install Message Queue 4.3

See the Sun Java System Message Queue 4.3 Installation Guide.The complete Message Queue 4.3 documentation is available at http://download.oracle.com/docs/cd/E19340-01/index.html

Note:

The graphic installer must not be run on a sub-display other than 0.

If the Message Queue installer fails to start, then make sure that your DISPLAY environment variable is set to host:display.0.

2.2.2 To Upgrade Pre-3.6 Versions of Message Queue

If you are running a pre-3.6 version of Message Queue, then use the following steps to upgrade your installation.

  1. Run the installer:

    On Solaris and Linux
    # cd ODSEE_Identity_Synchronization_for_Windows/mq4_3-installer/
    # ./installer
    
    On Windows
    C:\install\odsee-11.1.1.5.0\ODSEE_Identity_Synchronization_for_Windows\mq4_3-installer
     
    C:\run installer.vbs
     
    

    Where C:\install\odsee-11.1.1.5.0\ is the directory where download zip was unpacked.

    The Installer's Welcome screen is displayed. Click Next.

  2. Read and accept the product license agreement.

    Make sure the radio button labeled "I accept the terms in the license agreement" is selected, then click Next.

  3. In the JDK Selection screen, specify the version 1.5.0_29 JDK installed for Identity Synchronization for Windows, then click Next.

  4. In the Multilingual Packages screen, specify whether to install multilingual packages, then click Next.

    By default, Message Queue is installed to operate in the English language only. The Multilingual Packages screen allows you to install it for use in another language.

  5. In the Upgrade screen, make sure the radio button labeled "Upgrade" is selected, then click Next.

    If an earlier version of Message Queue exists on your system, or if any of the shared components on which Message Queue depends need to be upgraded from earlier versions, the Upgrade screen displays them in a scrollable list along with their current and required versions. If no upgrades are needed, the existing components are simply listed with their version numbers and a notation that they will remain at their current versions. In this case, the "Upgrade" and "Do not upgrade" radio buttons do not appear; just click Next to proceed to the next step.

    Caution:

    It is possible that upgrading Message Queue's shared components may break other software components on your system that depend on the earlier versions previously installed. Be sure there are no such dependencies before proceeding with the upgrade.

  6. In the Ready to Install screen, click Install.

  7. In the Register window, provide the required information and then click Next.

  8. In the Create and Account screen, provide the required information, and then click Next.

  9. In the Installer Summary screen, you can review the installation status and then click Exit.

You can now install Identity Synchronization for Windows.

2.3 Configuring Group Synchronization

Identity Synchronization for Windows can be configured to work with "Domain Global Security" as well as "Domain Global Distribution" groups on Active Directory. If you use Identity Synchronization for Windows 6.0 Service Pack 1 to synchronize groups, you must use the following configuration:

In spite of this configuration, group synchronization still has the following limitations:

2.4 Synchronization With Active Directory 2008

Synchronization between Identity Synchronization for Windows 6.0 Service Pack 1 and Active Directory 2008 (including R2 and R2+) is supported, with the following restrictions:

Note:

Windows Server 2008 is not a supported installation platform for Identity Synchronization for Windows . So, although you can synchronize with Active Directory 2008 data, installing Identity Synchronization for Windows 6.0 Service Pack 1 on Windows Server 2008 is not supported. For more information, see Chapter 1, "Software Requirements.".

Windows 2008 does not alleviate the current group synchronization restrictions that are described in Configuring Group Synchronization.

2.5 Using SUL Filters

Verify any LDAP filters you plan on using within the SUL configuration by testing them with the ldapsearch command provided with Directory Server Enterprise Edition. Verify your configured search base as well as filters for both Active Directory and Directory Server Enterprise Edition LDAP servers with which you will be synchronizing.

Also, a group and its members should be defined in the same SUL, Members of a group are not synchronized if they are defined in a different SUL than their group.

2.6 Tuning the Client Timeout Setting

By default, Identity Synchronization for Windows 6.0 Service Pack 1 is configured with a client time-out period of two minutes. If your Active Directory server is under a heavy load, this setting can be too short and cause failures between the two servers. In this case, increase the client timeout setting. Complete the following steps.

  1. Stop Identity Synchronization for Windows.

    See Section 1.6.3, "Starting and Stopping Services."

  2. Make a backup of the WatchList.properties file.

    By default, this file is located here:

    On Solaris

    /var/opt/SUNWisw/resources/WatchList.properties

    On Linux

    /var/opt/sun/isw/resources/WatchList.properties

    On Windows

    C:\Program Files\Sun\MPS\isw-win2k3-isw\resources\WatchList.properties

  3. In WatchList.properties, change the value of the following setting.

    -Dcom.sun.directory.wps.CLIENT_TIME_LIMIT=value
    

    where value is the maximum number of milliseconds to wait for an operation to complete. The value must be from 0 through 600000. A value of 0 specifies that the client waits for server to complete the operation. The default value is the recommended minimum of 120000 milliseconds.

    The following example sets CLIENT_TIME_LIMIT to 300,000 milliseconds, or 5 minutes.

    -Dcom.sun.directory.wps.CLIENT_TIME_LIMIT=300000
    
  4. Save and close the WatchList.properties file.

  5. Restart Identity Synchronization for Windows.

    See Section 1.6.3, "Starting and Stopping Services."

2.7 Verifying that Uninstallation is Complete

When Identity Synchronization for Windows 6.0 Service Pack 1 is uninstalled, the productregistry file may not be updated.

After uninstalling Identity Synchronization for Windows, use a text editor to edit one of the following files, depending on your installation.

On Solaris

/var/sadm/install/productregistry

On Linux

/var/opt/sun/install/productregistry

On Windows

C:\WINDOWS\SysWOW64\productregistry

You can also use Windows Explorer to search for productregistry under your C:\WINDOWS path.

If the file still contains any entries for isw, delete them.