7 Removing the Software

This section contains procedures for removing Identity Synchronization for Windows 6.0 SP1 in the following sections:

• Planning for Uninstallation

• Uninstalling the Software

• Uninstalling the Console Manually

7.1 Planning for Uninstallation

Before removing the software keep in mind the following points:

• You must uninstall subcomponents and the Directory Server Plug-in before you uninstall their associated connectors, and uninstall all the connectors before Core. (The Active Directory Connector does not have any subcomponents to uninstall.)

  Failure to uninstall one of these components in the proper order will prevent you from selecting and uninstalling the other components. For example, if you do not uninstall the connectors first, you cannot select Core for uninstallation.

• You must uninstall the Directory Server Plug-in before you uninstall Core.

  Uninstalling Core first will remove the Plug-in bits without unregistering them from the Directory Server, which prevents the Directory Server from starting unless you manually remove cn=pswsync,cn=plugins,cn=config.

• In replicated environments with replicas (in addition to primary and secondary servers) you must uninstall the Directory Server Plug-in and then restart the servers.

• The order in which you uninstall connectors does not matter.

• After uninstalling a Sun Java System Directory Server or Windows Connector, you must perform some additional steps to reinstall the Connector on a different machine or to use a different server port.

  In this case, you must uninstall and reinstall all of the corresponding subcomponents, and restart the Identity Synchronization for Windows daemon/service where Core is installed (see Starting and Stopping Services.

• You must run the uninstall.cmd script (located in the isw-hostname directory) on Windows 2000 and NT platforms. (You must run this batch file as Administrator.)

• You must run the runUninstall.sh script (located in the installation directory, /opt/SUN/isw, by default) on the Solaris or Linux operating systems. (You must run this script as root.)

Note:

You must follow the instructions for uninstalling product components and subcomponents explicitly, and verify that you have uninstalled all components successfully.

7.2 Uninstalling the Software

Your system may contain any or all of the following Identity Synchronization for Windows components:

• Active Directory Connectors

• Directory Server Connectors and Plug-ins

• Core

  Your Windows NT system may contain the Windows NT Connector and subcomponents.

  Use runUninstaller.sh (Solaris), uninstaller.sh (Linux), or uninstall.cmd (Windows) to remove all connectors and subcomponents and then remove Core (if installed).

This section provides instructions for the following:

• Uninstalling Connectors

• To Uninstall Core

7.2.1 Uninstalling Connectors

7.2.1.1 To Uninstall the Connectors

1. Start the uninstaller program (runUninstaller.sh on Solaris, uninstaller.sh on Linux, or uninstall.cmd on Windows).

   These programs are located in the installation directory (which is the /opt/SUNWisw directory by default).

2. At the Welcome screen click Next.

3. Enter the Configuration Directory Host name and Port number.

   • Select the root suffix of the configuration directory. (If necessary, click Refresh to see the list of suffixes.)

   • For secure communication between the uninstall program and the configuration directory server, enable the Secure Port box and specify the Directory Server's SSL port number.

4. Enter your administrator's name and password for the configuration directory.

5. Select the connector(s) to be uninstalled.

   Note:

   The selected connectors must be present on the target host.

6. Click Next to perform further uninstallation related tasks.

7. A summary window appears. Please follow the instructions presented in this window.

   • On Solaris systems: Uninstallation logs are written to /var/sadm/install/logs/

   • On Linux systems: Uninstallation logs are written to /var/sadm/install/logs/

   • On Windows systems: Uninstallation logs are written to the %TEMP% directory, which is a subdirectory of the Local Settings folder located in

     C:\Documents and Settings\Administrator

     Note:

     On some Windows systems such as Windows 2000 Advanced Server, the Local Settings folder is a hidden folder. To view this folder and the Temp subdirectory:

     Open your Windows Explorer and select Tools > Folder Options from the menu bar. When the Folder Options dialog box is displayed, select the View tab and enable the Show Hidden Files option.

8. Click Close to exit the program.

9. If there are no other connectors installed on the target host, then you can safely remove the isw-hostname folder.

10. Repeat Uninstalling Connectors for all hosts where connectors are installed.

7.2.2 To Uninstall Core

Note:

You must uninstall the Directory Server Plug-in before you uninstall Core.

Uninstalling Core before the Plug-in removes the Plug-in bits without unregistering them from the Directory Server, which will prevent the Directory Server from starting unless you manually remove cn=pswsync,cn=plugins,cn=config.

Use the following instructions to uninstall Core:

1. Start the uninstaller program:

   On Windows machines:

   1. Click Start, and then choose Settings > Control Panel.

   2. Double-click Add/Remove Programs.

   3. In the Add/Remove Programs window, select name="ProductName" content="Identity Synchronization for Windows", then click Remove.

2. Start the uninstaller.

   • On Solaris, execute runUninstaller.sh.

   • On Linux, execute uninstaller.sh .

   • On Windows, execute uninstall.cmd.

   These programs are located in the installation directory (which is the /opt/SUNWisw directory on Solaris and /opt/sun/isw directory on Linux by default).

3. In the Welcome screen click Next.

4. Enter the Configuration Directory Host name and Port number.

   1. Select the root suffix of the configuration directory. (If necessary, click Refresh to see the list of suffixes.)

   2. For secure communication between the uninstall program and the configuration directory server, enable the Secure Port box and specify the Directory Server's SSL port number.

5. Enter your administrator's name and password for the configuration directory.

6. Select Core to be uninstalled and click Next.

7. Enter the configuration directory URL, click Refresh, and select the appropriate root suffix from the drop-down list.

8. Click Next to perform further uninstallation related tasks.

9. A summary window appears. Please follow the instructions presented in this window.

   1. On Solaris systems: Uninstallation logs are written to /var/sadm/install/logs/

   2. On Linux systems: Uninstallation logs are written to /var/sadm/install/logs/

   3. On Windows systems: Uninstallation logs are written to the %TEMP% directory, which is a subdirectory of the Local Settings folder located under

      C:\Documents and Settings\Administrator

   On some Windows systems (such as Windows 2000 Advanced Server), the Local Settings folder is a hidden folder.

   To view this folder and the Temp subdirectory:

   Open your Windows Explorer and select Tools > Folder Options from the menu bar. When the Folder Options dialog box is displayed, select the View tab and enable the Show Hidden Files option.

10. Click Close to exit the program.

7.3 Uninstalling the Console Manually

After you have removed all other Identity Synchronization for Windows components, you may have to manually uninstall the Console.

7.3.1 From Solaris or Linux Systems

7.3.1.1 To Uninstall the Console from Solaris or Linux

1. Delete the following subtree from the configuration directory:

   cn=Sun Java (TM) System Identity Synchronization for Windows,
   cn=server_group,cn=hostname,
   ou=domain_ name, o=netscaperoot
   

2. For all console installations, remove all of the .jar files with an isw prefix from the following directory:

   serverroot/server/java/jars
   

7.3.2 From Windows Systems

7.3.2.1 To Uninstall the Console from a Windows Active Directory or NT system

1. Delete the following subtree from the configuration directory:

   cn=Sun Java (TM) System Identity Synchronization for Windows,
   cn=server_group, cn=hostname,
   ou=domain_name, o=netscaperoot
   

2. For all console installations, remove all of the .jar files with an isw prefix from the following directory:

   serverroot/server/java/jars