test

Sun Java System Directory Server Enterprise Edition 6.2 Installation Guide

Chapter 3 Uninstalling Directory Server Enterprise Edition 6.2

This chapter guides you in removing Directory Server Enterprise Edition software.

This chapter contains the following sections:

Server Instance Removal

Before removing Directory Server Enterprise Edition software used by server instances on the system, you must remove all the server instances.

ProcedureTo Delete a Directory Proxy Server Instance With DSCC

  1. Access Directory Service Control Center through Java Web Console.

    The default URL for Java Web Console on the local system is https://localhost:6789.

    If you have installed Directory Server Enterprise Edition from the zip distribution, use http://localhost:8080 or https://localhost:8181 to access DSCC based on your application server configuration.

  2. Delete the server instance with the Delete command in the action drop-down list.

ProcedureTo Delete a Directory Proxy Server Instance From the Command Line

  1. (Optional) If you have used DSCC to manage the server instance, remove registration for the server.


    $ dsccreg remove-server -h dscchost /local/dps
Enter DSCC administrator's password:
/local/dps is an instance of DPS
Enter password of "cn=Proxy Manager" for /local/dps:
Unregistering /local/dps from DSCC on dscchost.
Connecting to /local/dps
Disabling DSCC access to /local/dps

    For details, see dsccreg(1M)

  2. Delete the server instance.


    $ dpadm delete /local/dps
Directory Proxy Server instance '/local/dps' stopped
Directory Proxy Server instance '/local/dps' removed.
See Also

After you have removed all server instances on the system, you can proceed to Software Removal.

ProcedureTo Delete a Directory Server Instance With DSCC

Deleting a Directory Server instance completely removes all instance files, including all directory databases managed by the instance. Before you delete an instance, back up your data as described in Chapter 8, Directory Server Backup and Restore, in Sun Java System Directory Server Enterprise Edition 6.2 Administration Guide.

  1. Access Directory Service Control Center through Java Web Console.

    The default URL for Java Web Console on the local system is https://localhost:6789.

    If you have installed Directory Server Enterprise Edition from the zip distribution, depending on the way you have configured application server, use http://localhost:8080 or https://localhost:8181 to access Directory Service Control Center.

  2. Delete the server instance with the Delete command in the action drop-down list.

ProcedureTo Delete a Directory Server Instance From the Command Line

Deleting a Directory Server instance completely removes all instance files, including all directory databases managed by the instance. Before you delete an instance, back up your data as described in Chapter 8, Directory Server Backup and Restore, in Sun Java System Directory Server Enterprise Edition 6.2 Administration Guide.

  1. (Optional) If you have used DSCC to manage the server instance, remove registration for the server. 


    $ dsccreg remove-server -h dscchost /local/ds
Enter DSCC administrator's password:
/local/ds is an instance of DS
Enter password of "cn=Directory Manager" for /local/ds:
This operation will restart /local/ds.
Do you want to continue ? (y/n) y
Unregistering /local/ds from DSCC on dscchost.
Connecting to /local/ds
Disabling DSCC access to /local/ds
Restarting /local/ds

    For details, see dsccreg(1M)

  2. Delete the server instance.


    $ dsadm delete /local/ds
Server stopped
/local/ds deleted
See Also

After you have removed all server instances on the system, you can proceed to Software Removal.

Software Removal

After you have removed all server instances that depend on the installed product components, you can remove the component software.

ProcedureTo Remove Directory Service Control Center Software

By removing all of DSCC, you also remove Directory Server packages from the system.

  1. Dismantle DSCC with the dsccsetup dismantle command.

    For example, on a Solaris system the following command dismantles DSCC.


    root# /opt/SUNWdsee/dscc6/bin/dsccsetup dismantle
***
Unregistering DSCC Application from Sun Java(TM) Web Console...
This operation is going to stop Sun Java(TM) Web Console.
Do you want to continue ? [y,n] y
Stopping Sun Java(TM) Web Console...
Unregistration is on-going. Please wait...
/var/opt/SUNWdsee/dscc6/dcc has not been removed
DSCC Application has been unregistered from Sun Java(TM) Web Console
Restarting Sun Java(TM) Web Console
Please wait : this may take several seconds...
Sun Java(TM) Web Console restarted successfully
***

    The dsccsetup command is located in install-path/dscc6/bin/dsccsetup. See Default Paths to determine the default install-path for your system.

  2. Remove Directory Service Control Center with the Java ES installer.

    For instructions, see the Java Enterprise System documentation at http://docs.sun.com/coll/1286.3.

    Directory Service Control Center installed from the zip delivery is not uninstalled using the above procedure. If you need to uninstall DSCC, manually remove the WAR file from the application server instance.

ProcedureTo Remove Directory Server, or Directory Proxy Server Installed From Native Packages

  1. Remove the software with the Java ES installer.

    For instructions, see the Java Enterprise System documentation at http://docs.sun.com/coll/1286.3.

ProcedureTo Remove Software Installed From the Zip Distribution

  1. Remove the software with the dsee_deploy(1M) command.

    If zip distribution software was installed by a non-root user, that user can also remove the software.

    For example, to remove all Directory Server Enterprise Edition software installed under /local, issue the following command.


    $ /local/dsee6/bin/dsee_deploy uninstall -i /local
See Also

For a full list of supported components, see dsee_deploy(1M).

ProcedureTo Force Removal of Software Installed From the Zip Distribution

Before You Begin

You can force removal by deleting installed files, if you have installed the software from the zip distribution.

If zip distribution software was installed by a non-root user, that user can also remove the software.

Do not directly delete files that are installed from native packages.

  1. Remove components with a system command.


    $ rm -rf install-path

Directory Server Enterprise Edition 6.2 Downgrade Instructions

After you upgrade to Directory Server Enterprise Edition 6.2 you might want to restore your previous Directory Server Enterprise Edition installation. This section provides complete information about how to downgrade the Directory Server Enterprise Edition installation.

Downgrading Directory Server Enterprise Edition Using Native Packages

Downgrading Directory Server Enterprise Edition restores the previous working copy of your Directory Server Enterprise Edition instance and retains all your configuration information that you had before upgrading to Directory Server Enterprise Edition 6.2.

To downgrade Directory Server Enterprise Edition, do the following steps:

  1. Stop all running server instances.

  2. Run the following command to remove the patch.

    Remove the localization patch before you remove the base patch to clean up the system.

    • Solaris OS

      # patchrm patch-id

    • Linux. Go to the directory where the Directory Server Enterprise Edition 6.1 or 6.0 .rpm files are stored and run the following command repetitively for all the rpm files as specified in the table below. The set of rpm files that you choose depends on the previous installation of Directory Server Enterprise Edition you had.


      # rpm -U --oldpackage rpm-file-name

      For example, if you choose to downgrade to Directory Server Enterprise Edition 6.1 base installation, run the above command repetitively with all the rpm files mentioned in the corresponding cell in the table below. Do not alter the order while executing the commands.

      Localized 6.1 rpm files

      		 

      sun-ldap-console-gui-l10n-6.1-3.i386.rpm
sun-ldap-console-gui-help-l10n-6.1-3.i386.rpm 
sun-ldap-proxy-client-l10n-6.1-3.i386.rpm
sun-ldap-proxy-l10n-6.1-3.i386.rpm
sun-ldap-directory-client-l10n-6.1-3.i386.rpm
sun-ldap-directory-l10n-6.1-3.i386.rpm
sun-ldap-shared-l10n-6.1-3.i386.rpm

      Base 6.1 rpm files

      		 

      sun-ldap-console-gui-6.0-32.i386.rpm
sun-ldap-console-gui-help-6.0-32.i386.rpm
sun-ldap-console-agent-6.0-32.i386.rpm
sun-ldap-console-cli-6.0-32.i386.rpm
sun-ldap-proxy-man-6.0-4.i386.rpm
sun-ldap-proxy-client-6.0-24.i386.rpm
sun-ldap-proxy-config-6.0-24.i386.rpm
sun-ldap-proxy-6.0-24.i386.rpm
sun-ldap-directory-man-6.0-4.i386.rpm
sun-ldap-directory-client-6.0-32.i386.rpm
sun-ldap-directory-config-6.0-32.i386.rpm
sun-ldap-directory-6.0-32.i386.rpm
sun-ldap-shared-6.0-32.i386.rpm

      Localized 6.0 rpm files

      		 

      sun-ldap-console-gui-l10n-6.0-10.i386.rpm
sun-ldap-console-gui-help-l10n-6.0-10.i386.rpm 
sun-ldap-proxy-client-l10n-6.0-8.i386.rpm
sun-ldap-proxy-l10n-6.0-8.i386.rpm
sun-ldap-directory-client-l10n-6.0-10.i386.rpm
sun-ldap-directory-l10n-6.0-10.i386.rpm
sun-ldap-shared-l10n-6.0-10.i386.rpm

      Base 6.0 rpm files

      		 

      sun-ldap-console-gui-6.1-2.i386.rpm
sun-ldap-console-gui-help-6.1-2.i386.rpm
sun-ldap-console-agent-6.1-2.i386.rpm
sun-ldap-console-cli-6.1-2.i386.rpm
sun-ldap-proxy-man-6.1-2.i386.rpm
sun-ldap-proxy-client-6.1-2.i386.rpm
sun-ldap-proxy-config-6.1-2.i386.rpm
sun-ldap-proxy-6.1-2.i386.rpm
sun-ldap-directory-man-6.1-2.i386.rpm
sun-ldap-directory-client-6.1-2.i386.rpm
sun-ldap-directory-config-6.1-2.i386.rpm
sun-ldap-directory-6.1-2.i386.rpm 
sun-ldap-shared-6.1-2.i386.rpm

    • Windows. Double-click the Uninstall_patch-id.bat file to remove the patch. The Uninstall_patch-id.bat file is stored in the folder where the patch is saved.

Downgrading Directory Server Enterprise Edition Using Zip Distribution

Directory Server Enterprise Edition 6.2 instance does not downgrade to the previous version. If you need to revert to the previous Directory Server Enterprise Edition version, restore the backup copy that you saved before upgrading to Directory Server Enterprise Edition 6.2.

To remove Directory Server Enterprise Edition completely, see To Remove Software Installed From the Zip Distribution.