Windows Installation

1. Prerequisites

Download and install the latest JRE (Java Runtime Environment). Java 5.0 (also known as 1.5) or later is required.

Optionally download and install MySQL. During the installation process you will be asked whether you want to "Configure the MySql Server now". Answer yes. Make sure that you specify latin1 (and not UTF-8), otherwise the database can not be created.

If you decide to run DuMP3 without a MySQL database it will use a lot more memory.

2. Install

After downloading DuMP3 extract the zip file into a directory where you can find it again later. Maybe something like C:\programs\dump3\.

You should now have the following files in the directory:
config.xml
COPYING.txt
create.mysql.sql
dump3gui.bat
dump3gui.jar
finddupsgui.bat
jacksum.jar
jai_imageio.jar
jconfig.jar
jl1.0.jar
jogg-0.0.7.jar
jorbis-0.0.15.jar
log4j-1.2.13.jar
log4j.properties
mp3spi1.9.4.jar
mysql-connector-java-3.1.13-bin.jar
org.eclipse.core.commands_3.2.0.I20060605-1400.jar
org.eclipse.equinox.common_3.2.0.v20060603.jar
org.eclipse.jface_3.2.0.I20060605-1400.jar
org.eclipse.osgi_3.2.0.v20060601.jarv
org.eclipse.ui.workbench_3.2.0.I20060605-400.jar
swt-3.2-win32-win32-x86.zip (or equivalent for your OS)
tritonus_jorbis-0.3.6.jar
tritonus_share-0.3.6.jar

3. Configure MySQL

Connect to MySQL using mysql --user=root --password=<password> where <password> is the password you chose during the installation of MySQL. Or just use the MySql Command Line Client.

Open the script create.mysql.sql in your favourite text editor. Copy and paste the contents into the MySQL window. You now have a database where fingerprints can get stored.

Open config.xml and change the password under the net.za.grasser.duplicate.persist.SQLDatabase category to the one you chose during the installation of MySQL.

4. Configure Environment

1. Right click "My Computer" icon.
2. Select Properties.
3. Select the Advanced tab.
4. Click the Environment Variables... button.
5. Under System variables find the JAVA_HOME Variable.
6. If it does not exist create is using the New... button.
7. Make sure it points to the Java JRE installation directory. (something like C:\Program Files\Java\jre1.5.0_07)

5. Run

Go to your install directory and run dump3cl.bat if you downloaded the command line version.

The GUI can be run using dump3gui.bat.

Before DuMP3 runs correctly the JAVA_HOME environment variable is checked. Then, if you are running the GUI, the images, language files and SWT library files are extracted. You will now have the following extra subdirectories and files in your directory:
.\icons
.\res
swt.jar
and some swt-xxx.dll files.

After the first successful run you will see the following additional files:
dump3.log
version.xml

6. Deinstallation

Just delete the whole directory where DuMP3 is installed.

And then, if you are not using it for something else, uninstall MySQL.

Linux, Solaris, HP-UX, AIX and Mac OS X Installation

1. Prerequisites

Download and install the latest JRE (Java Runtime Environment). Java 5.0 (also known as 1.5) or later is required.

Optionally download and install MySQL. See MySQL documentation for installation instructions. MySQL should be configured using the latin1 character set, otherwise the database may not be created correctly.

If you decide to run DuMP3 without a MySQL database it will use a lot more memory.

2. Install

After downloading DuMP3 extract the zip file into a directory where you can find it again later. Maybe something like /home/<user>/dump3.

You should now have the following files in the directory:
config.xml
COPYING.txt
create.mysql.sql
dump3gui.sh
dump3gui.jar
finddupsgui.sh
jacksum.jar
jai_imageio.jar
jconfig.jar
jl1.0.jar
jogg-0.0.7.jar
jorbis-0.0.15.jar
log4j-1.2.13.jar
log4j.properties
mp3spi1.9.4.jar
mysql-connector-java-3.1.13-bin.jar
org.eclipse.core.commands_3.2.0.I20060605-1400.jar
org.eclipse.equinox.common_3.2.0.v20060603.jar
org.eclipse.jface_3.2.0.I20060605-1400.jar
org.eclipse.osgi_3.2.0.v20060601.jarv
org.eclipse.ui.workbench_3.2.0.I20060605-400.jar
swt-3.2-gtk-linux-x86.zip (or equivalent for your OS)
tritonus_jorbis-0.3.6.jar
tritonus_share-0.3.6.jar

3. Configure MySQL

Connect to MySQL using mysql --user=root --password=<password> where <password> is the password you chose during the installation of MySQL.

Open the script create.mysql.sql in you favourite text editor. Copy and paste the contents into the MySQL window. You now have a database where fingerprints can get stored.

Open config.xml and change the password under the net.za.grasser.duplicate.persist.SQLDatabase category to the one you chose during the installation of MySQL.

4. Configure Environment

1. Open a shell/terminal window.
2. You should now be in /home/<user>, where <user> is your user id.
3. vi .profile or the relevant .profile for your shell. E.g. .bash_profile if you are using bash.
4. Add the line export JAVA_HOME=/usr/java/jre1.5.0_07. Just make sure you are pointing to the right JRE version.
5. Save .profile
6. These settings will only become active when you log in again.

5. Run

Go to your install directory and run ./dump3cl.sh if you downloaded the command line version.

The GUI can be run using ./dump3gui.sh.

Before DuMP3 runs correctly the JAVA_HOME environment variable is checked. Then, if you are running the GUI, the images, language files and SWT library files are extracted. You will now have the following extra subdirectories and files in your directory:
./icons
./res
swt.jar
and some swt-xxx.so, .so.2, .jnilib .sl or .a files.

After the first successful run you will see the following additional files:
dump3.log
version.xml

6. Deinstallation

Just delete the whole directory where DuMP3 is installed.

And then, if you are not using it for something else, uninstall MySQL.