/** UNINSTALL - a document to answer the question of "How do I uninstall Anthill?" **/
/** Part of the Anthill Bug Manager distribution                                   **/


Note: For those who are impatient and have a solid grasp on how to use
MySQL and Perl on their system, you can optionally make sure that you
have DBI and DBD::mysql from CPAN and run 'uninstall.pl'.  Report back
here if you have problems.


Contents:
This document answers the following questions:

1. What do I need before I begin to uninstall?
2. How do I uninstall Anthill?
3. What if that way doesn't work?
4. How do I re-install Anthill?


1. What do I need before I begin to uninstall?

You will need the "config.inf" file that was generated when you
installed Anthill.  If this file was not generated, Anthill was
not installed.  Place this file in the same directory as the
"uninstall.pl" script, and go to that directory before running the
uninstall script.


The only dependencies of the uninstall script should be already
installed if you were able to install Anthill.  If you need an exact
list, then here it is:

Part I: Software required.

Standard Perl module that is necessary:
All Perl distributions should come with this, so you are most likely
covered already:

File::Spec: A module that greatly eases the pain of writing scripts
	that portably use filenames.

If you choose to use the automated database uninstall, then you will
also need:

DBI: A module that allows easy and portable access to databases via Perl.

DBD::mysql: A driver module for DBI that allows access to MySQL databases.
	Please note that for this module, it is a recent phenomenon that
	any/all of the test scripts seem to fail despite the fact that the
	module still works perfectly.  If you suspect that it is the test
	scripts' fault (in this instance, this is normally the case), then
	you may force the install anyway (for users of CPAN, it is usually
	a simple "make install" in the source directory of the package).


Part II: Information required.

The uninstall.pl script will get most of the required information from
the config.inf file generated at install time.  It will mainly ask you
for permission to remove certain files.


2) How do I uninstall Anthill?

You should run the configuration script "uninstall.pl"
from the command-line in the same directory as the
"config.inf" file generated when Anthill was installed.

The uninstallation script will ask you a few permission
questions, and will remove the files that the installation
script put on your system.

The uninstallation script then needs to uninstall the MySQL
databases and users that the installation script created.
If you didn't select an alternative database type, it can do
this for you.  You will need to have a user with administrative
privileges whose username is not 'root'.  If you do not have one
of these, then you can enter in the commands that it prints out
manually with the mysql client.  If you do have such a user, then
you will be asked for login information, and if all goes well,
the script will automatically uninstall the proper things.

If you select the automatic uninstallation, you also have the option
of completely removing the users that Anthill added instead of simply
revoking their privileges.  Since this directly affects the
"mysql.user" table, it is not selected by default.  Simply revoking
privileges is enough to guarantee that the selected users will not
be able to access data.

If all goes well, you should have successfully uninstalled Anthill.


3) What if that way doesn't work?

You should contact us immediately.  While we are thinking about
how to respond, you may do the uninstallation manually.

Anthill installs program and HTML files in two directories,
given by the "$PROG_INSTALL_DIR" and "$HTML_INSTALL_DIR"
variables in the config.inf file.  These can usually be safely
removed.  If the "$ANTHILL_EXTRA_MODULE_DIR" variable exists
in the config.inf file, then the file "AnthillDirectories.pm"
in that directory may also be safely removed.

To get a list of what you should do to clean up the databases,
run the program in the 'docs' subdirectory called
'database_uninstall.pl'.


4) How do I re-install Anthill?

By running the 'configure.pl' script again.  Read the INSTALL file first,
however.


Note: Wherever the name "Anthill" is mentioned in this document, it
refers to the Anthill Bug Manager.  If other projects, things, people,
or fuzzy green mittens coincidentally bear the name "Anthill", it is
assumed that the reader can divine from the context of this document
that only the Anthill Bug Manager is being referred to.  If not, that
is what this note is for.