<?xml version="1.0" encoding="UTF-8"?>

<chapter xml:id='chap-uninstall'

xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en'

xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance'

xsi:schemaLocation='http://docbook.org/ns/docbook

xmlns:xlink='http://www.w3.org/1999/xlink'>

<title>Removing OpenDJ Servers</title>

<indexterm><primary>Uninstalling</primary></indexterm>

<itemizedlist>

<para>This chapter includes the following procedures.</para>

<listitem><para><xref linkend="uninstall-gui" /></para></listitem>

<listitem><para><xref linkend="uninstall-cli" /></para></listitem>

<listitem><para><xref linkend="uninstall-deb" /></para></listitem>

<listitem><para><xref linkend="uninstall-msi" /></para></listitem>

<listitem><para><xref linkend="uninstall-rpm" /></para></listitem>

</itemizedlist>

<procedure xml:id="uninstall-gui">

<title>To Uninstall OpenDJ From the Graphical Uninstaller</title>

<step>

<para>

Run the

<link

xlink:show="new"

xlink:href="reference#uninstall-1"

xlink:role="http://docbook.org/xlink/role/olink"

><command>uninstall</command></link> command.

</para>

<para>(UNIX) Run <command>/path/to/opendj/uninstall</command>.</para>

<para>(Windows) Double-click <filename>/path/to/opendj\uninstall.bat</filename>.</para>

<para>(Mac OS X) Double-click <filename>/path/to/opendj/Uninstall.app</filename>.</para>

<mediaobject xml:id="figure-uninstall-start">

<imageobject>

<imagedata fileref="images/uninstall-start.png" format="PNG" />

</imageobject>

<textobject>

<para>Select what to remove in the initial screen.</para>

</textobject>

</mediaobject>

</step>

<step>

<para>When the process is finished, you might still have some files

to remove manually.</para>

<mediaobject xml:id="figure-uninstall-finished">

<imageobject>

<imagedata fileref="images/uninstall-finished.png" format="PNG" />

</imageobject>

<textobject>

<para>The final screen indicates what must be removed manually.</para>

</textobject>

</mediaobject>

</step>

</procedure>

<procedure xml:id="uninstall-cli">

<title>To Uninstall OpenDJ On the Command Line</title>

<step>

<para>Login as the user who installed and runs the server.</para>

</step>

<step>

<para>Run the <command>/path/to/opendj/uninstall --cli</command> command.</para>

<para>This command starts the removal program in interactive mode on the

command line, prompting you for each option. Alternatively, use additional

<command>uninstall</command> options to specify choices for the options.

See <command>uninstall --help</command> for more information.</para>

<screen>

$ <userinput>/path/to/opendj/uninstall --cli</userinput>

<computeroutput>Do you want to remove all components of the server or select the components to

remove?

1) Remove all components

2) Select the components to be removed

q) quit

Enter choice [1]:

The server is currently running and must be stopped before uninstallation can

continue.

Stop the Server and permanently delete the files? (yes / no) [yes]:

Stopping Directory Server ..... Done.

Deleting Files under the Installation Path ..... Done.

The Uninstall Completed Successfully.

To complete the uninstallation, you must delete manually the following files

and directories:

/path/to/opendj/lib

See /var/....log for a detailed log of this operation.</computeroutput>

</screen>

</step>

<step>

<para>If the command output tells you to delete files manually, then remove

those remaining files to complete the process.</para>

<screen>

$ <userinput>rm -rf /path/to/opendj</userinput>

</screen>

</step>

</procedure>

<procedure xml:id="uninstall-deb">

<title>To Uninstall the Debian Package</title>

<indexterm><primary>Debian (.deb) package</primary></indexterm>

<para>When you uninstall the Debian package from the command line, OpenDJ

directory server is stopped if it is running.</para>

<step>

<para>Remove the package from your system.</para>

<screen>

$ <userinput>sudo dpkg -r opendj</userinput>

<computeroutput>(Reading database ... 185725 files and directories currently installed.)

Removing opendj ...

*Stopping OpenDJ server...

Stopping Server...

[03/Jun/2013:10:00:49 +0200] category=BACKEND severity=NOTICE

msgID=9896306 msg=The backend userRoot is now taken offline

[03/Jun/2013:10:00:49 +0200] category=CORE severity=NOTICE

msgID=458955 msg=The Directory Server is now stopped

*OpenDJ successfully removed</computeroutput>

$ </screen>

<para>Removing the package does not remove your data or configuration.

You must remove <filename>/opt/opendj</filename> manually to get rid of

all files.</para>

</step>

</procedure>

<procedure xml:id="uninstall-msi">

<title>To Uninstall the Windows Installer Package</title>

<indexterm><primary>Windows installer (.msi) package</primary></indexterm>

<para>

When you uninstall the files installed from the Windows installer package,

only the installed files are removed.

To remove OpenDJ directory server configuration files,

run the <command>uninstall</command> command

as described in <xref linkend="uninstall-gui" />

or <xref linkend="uninstall-cli" />.

</para>

<step>

<para>

Remove installed OpenDJ files in one of the following ways.

</para>

<stepalternatives>

<step>

<para>

Use Windows Control Panel.

</para>

<substeps>

<step>

<para>

Open Windows Control Panel and browse to the page to uninstall a program.

</para>

</step>

<step>

<para>

Find ForgeRock OpenDJ in the list and uninstall it.

</para>

</step>

</substeps>

</step>

<step>

<para>

Use the <command>msiexec</command> command.

</para>

<para>

The following command quietly removes installed files.

</para>

<screen>

C:\><userinput>msiexec /x OpenDJ-${docTargetVersion}.msi /q</userinput>

</screen>

</step>

</stepalternatives>

</step>

</procedure>

<procedure xml:id="uninstall-rpm">

<title>To Uninstall the RPM Package</title>

<indexterm><primary>Red Hat (.rpm) package</primary></indexterm>

<para>When you uninstall the RPM package from the command line, OpenDJ

directory server is stopped if it is running.</para>

<step>

<para>Remove the package from your system.</para>

<screen>

# <userinput>rpm -e opendj</userinput>

<computeroutput>Pre Uninstall - uninstall

Stopping Server...

[03/Jun/2013:10:42:46 +0200] category=BACKEND severity=NOTICE

msgID=9896306 msg=The backend userRoot is now taken offline

[03/Jun/2013:10:42:46 +0200] category=CORE severity=NOTICE

msgID=458955 msg=The Directory Server is now stopped

Post Uninstall - uninstall

OpenDJ successfully removed.</computeroutput>

#

</screen>

<para>Removing the package does not remove your data or configuration.

You must remove <filename>/opt/opendj</filename> manually to get rid of

all files.</para>

</step>

</procedure>

</chapter>