This chapter guides you in removing Directory Server Enterprise Edition software.
This chapter contains the following sections:
Server Instance Removal covers removing the server instances that depend on the software to remove.
Software Removal covers how to remove the software after you have removed server instances.
Directory Server Enterprise Edition 6.3 Downgrade Instructions covers how to downgrade the Directory Server Enterprise Edition installation.
Before removing Directory Server Enterprise Edition software used by server instances on the system, you must remove all the server instances.
Access Directory Service Control Center through Java Web Console.
The default URL for Java Web Console on the local system is https://hostname:6789.
If you have installed Directory Server Enterprise Edition from the zip distribution, use http://hostname:8080/dscc or https://hostname:8181/dscc to access DSCC based on your application server configuration.
Delete the server instance with the Delete command in the action drop-down list.
(Optional) If you have used DSCC to manage the server instance, remove registration for the server.
$ dsccreg remove-server -h hostname /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 hostname. Connecting to /local/dps Disabling DSCC access to /local/dps |
For details, see dsccreg(1M)
Delete the server instance.
$ dpadm delete /local/dps Directory Proxy Server instance '/local/dps' stopped Directory Proxy Server instance '/local/dps' removed. |
After you have removed all server instances on the system, you can proceed to Software Removal.
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 9, Directory Server Backup and Restore, in Sun Java System Directory Server Enterprise Edition 6.3 Administration Guide.
Access Directory Service Control Center through Java Web Console.
The default URL for Java Web Console on the local system is https://hostname:6789.
If you have installed Directory Server Enterprise Edition from the zip distribution, depending on the way you have configured application server, use http://hostname:8080/dscc or https://hostname:8181/dscc to access Directory Service Control Center.
Delete the server instance with the Delete command in the action drop-down list.
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 9, Directory Server Backup and Restore, in Sun Java System Directory Server Enterprise Edition 6.3 Administration Guide.
(Optional) If you have used DSCC to manage the server instance, remove registration for the server.
$ dsccreg remove-server -h hostname /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 hostname. Connecting to /local/ds Disabling DSCC access to /local/ds Restarting /local/ds |
For details, see dsccreg(1M)
Delete the server instance.
$ dsadm delete /local/ds Server stopped /local/ds deleted |
After you have removed all server instances on the system, you can proceed to Software Removal.
After you have removed all server instances that depend on the installed product components, you can remove the component software.
To Remove Directory Service Control Center Installed from Native Packages
To Remove Directory Server or Directory Proxy Server Installed From Native Packages
To Force Removal of Software Installed From the Zip Distribution
By removing all of DSCC, you also remove Directory Server packages from the system.
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 *** |
On Windows, run the following command to dismantle DSCC.
C:\install-path\dscc6\bin>dsccsetup.exe dismantle |
On Solaris, the dsccsetup command is located in install-path/dscc6/bin/dsccsetup. See Default Paths to determine the default install-path for your system.
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 using the zip distribution is not uninstalled using the above procedure. If you need to uninstall DSCC, refer to the respective application server documentation on how to remove a Web application.
Remove the software with the Java ES installer.
For instructions, see the Java Enterprise System documentation at http://docs.sun.com/coll/1286.3.
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 |
On Windows, run the following command to uninstall the software:
C:\install-path\dsee6\bin\dsee_deploy uninstall -i install-path |
For a full list of supported components, see dsee_deploy(1M).
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.
Remove components with a system command.
$ rm -rf install-path |
On Windows, run the following commands to remove the components:
C:\>del /s install-path C:\>del install-path |
After you upgrade to Directory Server Enterprise Edition 6.3 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 restores the previous working copy of your Directory Server Enterprise Edition installation and retains all your configuration information that you had before upgrading to Directory Server Enterprise Edition 6.3.
To downgrade Directory Server Enterprise Edition, do the following steps:
Stop all running server instances.
Run the following command to remove the patch.
Remove the localization patch before you remove the base patch to clean up the system. Refer to Patch Table for Zip Distribution in the To Install Directory Server Enterprise Edition 6.3 From Zip Distribution section for the patch id for each platform.
Solaris OS
# patchrm patch-id
Linux. Go to the directory where the Directory Server Enterprise Edition 6.2, 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.
Make sure that after downgrading you have all the 6.0, 6.1, or 6.2 rpm files. Downgrading the subset of the rpm files results in corrupted installation.
# rpm -U --oldpackage rpm-file-name |
For example, if you choose to downgrade to Directory Server Enterprise Edition 6.2 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. The following table lists 6.2 and 6.1 base and localized files.
Localized 6.2 rpm files |
|
|
Base 6.2 rpm files |
|
|
Localized 6.1 rpm files |
|
|
Base 6.1 rpm files |
|
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.
Directory Server Enterprise Edition 6.3 installation 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.3.
To remove Directory Server Enterprise Edition completely, see To Remove Software Installed From the Zip Distribution.