There are two steps to installing MM.MySQL. First, you need to unpack the files you downloaded, and second you need to add MM.MySQL to your CLASSPATH.
Use the appropriate tool to unpack the MM.MySQL distribution (tar -xzf filename.tar.gz for Unix, winzip for Windows).
You will end up with the following directory structure:
mm.mysql.jdbc-[version]
COPYING
README
doc
...
mysql_comp.jar
mysql_uncomp.jar
org
gjt
mm
mysql
...
Note: If you are using a virtual machine other than the JDK like the JRE or Microsoft's Jview consult the appropriate documentation for details on how to set the CLASSPATH variable.
The CLASSPATH tells the Java runtime and compiler where to find the classes it needs to run. To allow the Java Virtual Machine to find MM.MySQL and use it, the CLASSPATH needs to be modified.
Note: On Windows systems make sure that either file and directory names in the CLASSPATH are no longer than 8.3 or that they use the mangled names, or that the entire CLASSPATH is surrounded by quotes. Otherwise, the Java runtime will not be able to find the classes.
You will need to either set the CLASSPATH to include the mm.mysql.jdbc-[version] directory you created when you unarchived the MM.MySQL files, or include the full path to the mysql_comp.jar or mysql_uncomp.jar (compressed, and uncompressed, respectively) file. Note: Some JVM's cannot load compressed JAR files, so make sure if you are using JAR files that you are using one appropriate for your JVM.
The following is an example of setting the CLASSPATH under UNIX (using csh).
Example 2-1. Setting the CLASSPATH under UNIX
$ setenv CLASSPATH /path/to/mm.mysql.jdbc-[version]:$CLASSPATH
|
The above command can be added to the appropriate startup file for the login shell to make MM.MySQL available to all Java applications.
The following is an example of setting the CLASSPATH under Microsoft Windows:
Example 2-2. Setting the CLASSPATH under Microsoft Windows
C:\> set CLASSPATH=\path\to\mm.mysql.jdbc-[version];%CLASSPATH%
|
This command can be added as the last line in AUTOEXEC.BAT. If this is done the MM.MySQL driver will be available to all Java applications run on the Windows system. This setting will require the computer to be rebooted before the changes will take effect.
Once the CLASSPATH is set, the driver is ready for use! Taking a look at the next chapter containing programming information might be a good idea, however.