chap-uninstall.xml revision ec40cc0dc62425cea5d63fd9d984f8614479de25
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark<?xml version="1.0" encoding="UTF-8"?>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark<!--
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark ! CCPL HEADER START
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark !
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark ! This work is licensed under the Creative Commons
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark ! Attribution-NonCommercial-NoDerivs 3.0 Unported License.
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark ! To view a copy of this license, visit
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark ! http://creativecommons.org/licenses/by-nc-nd/3.0/
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark ! or send a letter to Creative Commons, 444 Castro Street,
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark ! Suite 900, Mountain View, California, 94041, USA.
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark !
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark ! You can also obtain a copy of the license at
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark ! trunk/opendj3/legal-notices/CC-BY-NC-ND.txt.
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark ! See the License for the specific language governing permissions
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark ! and limitations under the License.
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark !
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark ! If applicable, add the following below this CCPL HEADER, with the fields
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark ! enclosed by brackets "[]" replaced with your own identifying information:
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark ! Portions Copyright [yyyy] [name of copyright owner]
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark !
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark ! CCPL HEADER END
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark !
08248b5c5b494aff8d1922e8e0b5777796d7450dmark ! Copyright 2011-2014 ForgeRock AS
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark !
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark-->
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark<chapter xml:id='chap-uninstall'
ec40cc0dc62425cea5d63fd9d984f8614479de25mark xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en'
ec40cc0dc62425cea5d63fd9d984f8614479de25mark xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance'
ec40cc0dc62425cea5d63fd9d984f8614479de25mark xsi:schemaLocation='http://docbook.org/ns/docbook
ec40cc0dc62425cea5d63fd9d984f8614479de25mark http://docbook.org/xml/5.0/xsd/docbook.xsd'
ec40cc0dc62425cea5d63fd9d984f8614479de25mark xmlns:xlink='http://www.w3.org/1999/xlink'>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark <title>Removing OpenDJ Servers</title>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark <indexterm><primary>Uninstalling</primary></indexterm>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark
f6ccbb233102c86936499e5c3cb844dfe77872bemark <itemizedlist>
f6ccbb233102c86936499e5c3cb844dfe77872bemark <para>This chapter includes the following procedures.</para>
f6ccbb233102c86936499e5c3cb844dfe77872bemark
f6ccbb233102c86936499e5c3cb844dfe77872bemark <listitem><para><xref linkend="uninstall-gui" /></para></listitem>
f6ccbb233102c86936499e5c3cb844dfe77872bemark <listitem><para><xref linkend="uninstall-cli" /></para></listitem>
f6ccbb233102c86936499e5c3cb844dfe77872bemark <listitem><para><xref linkend="uninstall-deb" /></para></listitem>
f6ccbb233102c86936499e5c3cb844dfe77872bemark <listitem><para><xref linkend="uninstall-rpm" /></para></listitem>
f6ccbb233102c86936499e5c3cb844dfe77872bemark </itemizedlist>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark <procedure xml:id="uninstall-gui">
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark <title>To Uninstall OpenDJ From the Graphical Uninstaller</title>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark <step>
ec40cc0dc62425cea5d63fd9d984f8614479de25mark <para>
ec40cc0dc62425cea5d63fd9d984f8614479de25mark Run the
ec40cc0dc62425cea5d63fd9d984f8614479de25mark <link
ec40cc0dc62425cea5d63fd9d984f8614479de25mark xlink:show="new"
ec40cc0dc62425cea5d63fd9d984f8614479de25mark xlink:href="admin-guide#uninstall-1"
ec40cc0dc62425cea5d63fd9d984f8614479de25mark xlink:role="http://docbook.org/xlink/role/olink"
ec40cc0dc62425cea5d63fd9d984f8614479de25mark ><command>uninstall</command></link> command.
ec40cc0dc62425cea5d63fd9d984f8614479de25mark </para>
ec40cc0dc62425cea5d63fd9d984f8614479de25mark
429cb4af0dd170c44fe076f66fb43338d1820073mark <para>(UNIX) Run <command>/path/to/opendj/uninstall</command>.</para>
429cb4af0dd170c44fe076f66fb43338d1820073mark <para>(Windows) Double-click <filename>/path/to/opendj\uninstall.bat</filename>.</para>
429cb4af0dd170c44fe076f66fb43338d1820073mark <para>(Mac OS X) Double-click <filename>/path/to/opendj/Uninstall.app</filename>.</para>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark <mediaobject xml:id="figure-uninstall-start">
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark <imageobject>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark <imagedata fileref="images/uninstall-start.png" format="PNG" />
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark </imageobject>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark <textobject>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark <para>Select what to remove in the initial screen.</para>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark </textobject>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark </mediaobject>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark </step>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark <step>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark <para>When the process is finished, you might still have some files
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark to remove manually.</para>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark <mediaobject xml:id="figure-uninstall-finished">
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark <imageobject>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark <imagedata fileref="images/uninstall-finished.png" format="PNG" />
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark </imageobject>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark <textobject>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark <para>The final screen indicates what must be removed manually.</para>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark </textobject>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark </mediaobject>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark </step>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark </procedure>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark <procedure xml:id="uninstall-cli">
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark <title>To Uninstall OpenDJ On the Command Line</title>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark <step>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark <para>Login as the user who installed and runs the server.</para>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark </step>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark <step>
429cb4af0dd170c44fe076f66fb43338d1820073mark <para>Run the <command>/path/to/opendj/uninstall --cli</command> command.</para>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark <para>This command starts the removal program in interactive mode on the
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark command line, prompting you for each option. Alternatively, use additional
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark <command>uninstall</command> options to specify choices for the options.
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark See <command>uninstall --help</command> for more information.</para>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark
08248b5c5b494aff8d1922e8e0b5777796d7450dmark <screen>
08248b5c5b494aff8d1922e8e0b5777796d7450dmark$ <userinput>/path/to/opendj/uninstall --cli</userinput>
08248b5c5b494aff8d1922e8e0b5777796d7450dmark<computeroutput>Do you want to remove all components of the server or select the components to
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmarkremove?
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark 1) Remove all components
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark 2) Select the components to be removed
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark q) quit
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmarkEnter choice [1]:
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmarkThe server is currently running and must be stopped before uninstallation can
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmarkcontinue.
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmarkStop the Server and permanently delete the files? (yes / no) [yes]:
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmarkStopping Directory Server ..... Done.
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmarkDeleting Files under the Installation Path ..... Done.
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmarkThe Uninstall Completed Successfully.
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmarkTo complete the uninstallation, you must delete manually the following files
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmarkand directories:
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark/path/to/opendj/lib
08248b5c5b494aff8d1922e8e0b5777796d7450dmarkSee /var/....log for a detailed log of this operation.</computeroutput>
08248b5c5b494aff8d1922e8e0b5777796d7450dmark </screen>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark </step>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark <step>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark <para>If the command output tells you to delete files manually, then remove
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark those remaining files to complete the process.</para>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark
08248b5c5b494aff8d1922e8e0b5777796d7450dmark <screen>
08248b5c5b494aff8d1922e8e0b5777796d7450dmark$ <userinput>rm -rf /path/to/opendj</userinput>
08248b5c5b494aff8d1922e8e0b5777796d7450dmark </screen>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark </step>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark </procedure>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark <procedure xml:id="uninstall-deb">
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark <title>To Uninstall the Debian Package</title>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark <indexterm><primary>Debian (.deb) package</primary></indexterm>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark <para>When you uninstall the Debian package from the command line, OpenDJ
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark directory server is stopped if it is running.</para>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark <step>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark <para>Remove the package from your system.</para>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark
08248b5c5b494aff8d1922e8e0b5777796d7450dmark <screen>
08248b5c5b494aff8d1922e8e0b5777796d7450dmark$ <userinput>sudo dpkg -r opendj</userinput>
08248b5c5b494aff8d1922e8e0b5777796d7450dmark<computeroutput>(Reading database ... 185725 files and directories currently installed.)
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmarkRemoving opendj ...
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark*Stopping OpenDJ server...
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmarkStopping Server...
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark[03/Jun/2013:10:00:49 +0200] category=BACKEND severity=NOTICE
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark msgID=9896306 msg=The backend userRoot is now taken offline
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark[03/Jun/2013:10:00:49 +0200] category=CORE severity=NOTICE
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark msgID=458955 msg=The Directory Server is now stopped
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark
08248b5c5b494aff8d1922e8e0b5777796d7450dmark*OpenDJ successfully removed</computeroutput>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark$ </screen>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark <para>Removing the package does not remove your data or configuration.
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark You must remove <filename>/opt/opendj</filename> manually to get rid of
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark all files.</para>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark </step>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark </procedure>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark <procedure xml:id="uninstall-rpm">
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark <title>To Uninstall the RPM Package</title>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark <indexterm><primary>Red Hat (.rpm) package</primary></indexterm>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark <para>When you uninstall the RPM package from the command line, OpenDJ
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark directory server is stopped if it is running.</para>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark <step>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark <para>Remove the package from your system.</para>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark
08248b5c5b494aff8d1922e8e0b5777796d7450dmark <screen>
08248b5c5b494aff8d1922e8e0b5777796d7450dmark# <userinput>rpm -e opendj</userinput>
08248b5c5b494aff8d1922e8e0b5777796d7450dmark<computeroutput>Pre Uninstall - uninstall
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmarkStopping Server...
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark[03/Jun/2013:10:42:46 +0200] category=BACKEND severity=NOTICE
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark msgID=9896306 msg=The backend userRoot is now taken offline
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark[03/Jun/2013:10:42:46 +0200] category=CORE severity=NOTICE
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark msgID=458955 msg=The Directory Server is now stopped
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmarkPost Uninstall - uninstall
08248b5c5b494aff8d1922e8e0b5777796d7450dmarkOpenDJ successfully removed.</computeroutput>
08248b5c5b494aff8d1922e8e0b5777796d7450dmark#
08248b5c5b494aff8d1922e8e0b5777796d7450dmark </screen>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark <para>Removing the package does not remove your data or configuration.
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark You must remove <filename>/opt/opendj</filename> manually to get rid of
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark all files.</para>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark </step>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark </procedure>
51607ea01068c9047391e4c8b46bc9dbd0edb7fdmark</chapter>