9 Installing From Scratch on Linux

This chapter provides instructions for installing Identity Synchronization for Windows 6.0 Service Pack 1 in a greenfield environment, an environment where no instance of Identity Synchronization for Windows already exists. This chapter contains the following sections:

• Creating Required Data Stores in Directory Server

• Obtaining the Identity Synchronization for Windows Software

• Preparing for Identity Synchronization for Windows Installation

• Installing the Software

• Checking the Software Version

9.1 Creating Required Data Stores in Directory Server

The LDAP directory used to store the Identity Synchronization for Windows configuration and synchronization data must be created and configured manually before you run the Identity Synchronization for Windows installer.

When creating this type of Directory Server instance, observe the following recommendations:

• Do not use an existing 5.2x Directory Server o=NetscapeRoot for the Identity Synchronization for Windows configuration data store. Create a new Directory Server that includes an instance of Identity Synchronization for Windows and is dedicated to Identity Synchronization for Windows configuration (o=NetscapeRoot ) and synchronization (ou=isw_config) data stores.

  For example, create a new ou=isw_config suffix, and then allow the Identity Synchronization for Windows administration console to create its own o=NetscapeRoot suffix on the same server during installation. Be sure to create a Top Entry when you create the new ou=isw_config suffix. When creating the ou=isw_config suffix using DSCC, on the "Step5 : Choose Data Options" page, choose "Create Top Entry for the suffix. "

  There should be no exisisting o=NetscapeRoot suffix when installing the Identity Synchronization for Windows Java console.

• Configure the configuration data store so that the o=NetscapeRoot suffix that Identity Synchronization for Windows uses is not replicated with configuration changes from multiple management domains. 

• The Identity Synchronization for Windows configuration suffix should not reside in a replicated suffix.  Use something like ou=isw_config as a root suffix. 

• Avoid using anything other than o or ou notation for the Identity Synchronization for Windows configuration suffix. Using dc suffix notation can cause install to fail.

• The o=NetscapeRoot suffix must not be a parent of the ou=isw_config suffix.

• Use a non-standard root level suffix so it is not a part of user LDAP space.

For detailed steps, see "Creating Directory Sources" in "Chapter 4, Configuring Core Resources" of the Oracle Identity Synchronization for Windows 6.0 Installation and Configuration Guide.

9.2 Obtaining the Identity Synchronization for Windows Software

See Section 1.4, "Obtaining the Software as Part of Directory Server Enterprise Edition."

9.3 Preparing for Identity Synchronization for Windows Installation

1. Review the following sections of this document:

   • Section 1.5, "Completing Pre-Installation Tasks"

   • Section 3.3, "Known Issues in Identity Synchronization for Windows 6.0 Service Pack 1"

2. After you unzip the distribution file, the directory should contain the following components:

   • HotFix-6.0SP1_COMBO_5_20110722

   • The Identity Synchronization for Windows 6.0 Service Pack 1 patch

   • JDK 5.0_u29

   • Message Queue 4.3

3. Install JDK 5.0_u29.

   Install the packages available under the appropriate jdk directory:

   # cd ISW-6.0-SP-1-content/jdk/
   # rpm -Uvh jdk-1.5.0_29-fcs.i586.rpm
   

4. Install or update Identity Synchronization for Windows components.

   # cd ISW-6.0-SP-1-content/packages/RHELxxx/
   # rpm -Uvh *
   

5. Install Message Queue 4.3.

   # export JAVA_HOME=/usr/java/jdk1.5.0_29/
   # cd ISW-6.0-SP-1-content/mq4_3-installer/
   # ./installer
   

6. Unpack the Identity Synchronization for Windows 6.0 Service Pack 1 binaries.

   Change to the patch-id directory that corresponds to your platform and unzip the Identity Synchronization for Windows zip file.

   For example,

   $ cd 144591-01
   $ unzip -q isw.6.0.sp1.linux.zip
   

9.4 Installing the Software

1. Update Java and install JSS.

   1. Run the installpatch command from the 121656-26 directory (Red Hat 4.0).

   2. Depending upon your platform, run rpm -Uvh sun-jss-4.3.2-4.i386.rpm or rpm -Uvh sun-jss-4.3.2-4.x86_64.rpm.

2. Set the DISPLAY environment variable to host:display.0

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

3. Set the JAVA_HOME environment variable to Java 1.5.0_29 at minimum.

4. Set the following environment variable:

   export LD_LIBRARY_PATH=/opt/sun/private/lib:$LD_LIBRARY_PATH
   

5. Install the Identity Synchronization for Windows 6.0 Service Pack 1 Core.

   # cd ISW-6.0-SP-1-content/144591-01/installer
   # ./installer.sh
   

   Follow the instructions in Chapter 3, Installing Core, in Oracle Identity Synchronization for Windows 6.0 Installation and Configuration Guide.

   Note:

   When installation is finished, do not start the console .

6. Unzip the isw-generic.zip file.

   # unzip -q isw-generic.zip
   

7. Install the HotFix-6.0SP1_COMBO_5_20110722 patch included within the 11.1.1.7.0 ODSEE release. For example:

   # ./Install /opt/sun/isw /var/Sun/mps/

8. Configure the Identity Synchronization for Windows 6.0 Service Pack 1 Core.

   Note:

   At the end of the installation, be sure to start the console with the -x nologo option. For example:

   # /var/Sun/mps/startconsole -x nologo

   Otherwise, the console might freeze at the splash screen.

   For more information, see Chapter 4, Configuring Core Resources, in Oracle Identity Synchronization for Windows 6.0 Installation and Configuration Guide.

9. Start the Identity Synchronization for Windows services. For example:

   # /etc/init.d/imq start
   # /etc/init.d/isw start
   

10. Start synchronization.

    See Section 1.6.2, "Starting and Stopping Synchronization."

9.5 Checking the Software Version

To confirm that the Identity Synchronization for Windows 6.0 Service Pack 1 installation has been successful, run the following command:

$/opt/sun/isw/bin/idsync -V

The output should be the same as the following:

mcommon.jar   : 6 2009Q1_SP1 (ISW build id:2010.116.1139 built by svbld)
connector.jar : 6.0SP1_COMBO_5_20110722 (ISW build id:2011.203.1459 built by pduc)
install.jar   : 6.0SP1_COMBO_5_20110722 (ISW build id:2011.203.1459 built by pduc)
registry.jar  : 6.0SP1_COMBO_5_20110722 (ISW build id:2011.203.1459 built by pduc)
ui.jar        : 6.0SP1_COMBO_5_20110722 (ISW build id:2011.203.1459 built by pduc)
watchdog.jar  : 6 2009Q1_SP1 (ISW build id:2010.116.1139 built by svbld)
manager.jar   : 6.0SP1_COMBO_5_20110722 (ISW build id:2011.203.1459 built by pduc)