About this project

The idea for this project comes from Daniel Schlichtholz.

In 2004 he created a forum called MySQLDumper and soon, programmers who wrote new scripts, supplemented Daniel's scripts.
After a short time the small backup-script developed into a stately project.

If you have any improvement suggestions you can visit the MySQLDumper-Forum: http://www.mysqldumper.de.

We wish you a lot of fun with this project.

The MySQLDumper-Team

Daniel Schlichtholz - Steffen Kamper
Perlscript with Support from Detlev Richter
Logo - René Schulze

MySQLDumper Help

Download

This Script is available on the Homepage of MySQLDumper.
It is recommanded to visit the Homepage frequently to get the latest information, updates and help.
The address is http://www.mysqldumper.de/board

System Mandatories

The Script works with nearly any server (Windows, Linux, ...)
and PHP >= Version 4.3.4 with GZip-Library, MySQL (>= 3.23), JavaScript (must be enabled).

Installation

The installation is very easy. Unpack the archive in any folder, which is accessible from the Webserver
(e.g. in the root directory [Server rootdir/]MySQLDumper)
change config.php to chmod 777
... all done!
you can start MySQLDumper in your Browser by typing "http://webserver/MySQLDumper" to complete the setup, just follow the instructions.
Note:
If your webserver runs with the option safemode=ON MySqlDump mustn't create directories.
You will have to do that yourself.
MySqlDump breaks in that case and tells you what to do.
After you created the directories MySqlDump will function normally.

Guidance for the Perl script

Most have a cgi-bin directory, in which Perl can be executed.
This is usually by Browser over http://www.domain.de/cgi-bin/ available.

Make the following steps for this case please.

1. Call in MySQLDumper the page Backup and click "Backup Perl"
2. Copy the path, that stands behind entry in crondump.pl for $absolute_path_of_configdir:
3. open the file "crondump.pl" in the editor
4. paste the copied path there with absolute_path_of_configdir (no blanks)
5. Save crondump.pl
6. copy crondump.pl, as well as perltest.pl and simpletest.pl to the cgi-bin directory (ASCII mode in the ftp-client!)
7. chmod 755 to the scripts.
7b. If the ending cgi is desired, change the ending of all 3 files pl - > cgi (rename)
8. Call in the MySQLDumper the page Configuration
9. click on Cronscript
10. changes Perl execution path to /cgi-bin/
10b. if the Scripts are renamed to *.cgi , change Fileextension to cgi
11 save the Configuration

Ready ! The scripts are available from the Page "Backup"

When you can execute Perl anywhere, only following step are needed:

1. Call in MySQLDumper the page Backup.
2. Copy the path, that stands behind entry in crondump.pl for $absolute_path_of_configdir:
3. open the file "crondump.pl" in the editor
4. paste the copied path there with absolute_path_of_configdir (no blanks)
5. Save crondump.pl
6. chmod 755 to the scripts.
6b. If the ending cgi is desired, change the ending of all 3 files pl - > cgi (rename)
(ev. 10b+11 from above)

Windowsuser must change the first line of all Perlscripts, to the path of Perl.

Example:
instead of: #!/usr/bin/perl w
now #!C:\perl\bin\perl.exe w

Operating

Home

Configuration

Configured Databases: list of configured databases. The active database is in bold.

Table-Prefix: you can choose a prefix for each database seperated. The prefix is a filter, which only handle the tables in a dump, that start with this prefix (e.g. all tables starting with "phpBB_"). If you don't want to use it, leave this field empty.

GZip-Compression: Here you can activate the compression. It is recommended to work with compression because of the smaller size of files, netherless disk space is ever rarely.

Records count for backup: These are the number of records which are being read simultaneously while the backup, before the script makes the callback. For slow server you can reduce this parameter to prevent timeouts.
Records count for restore: These are the number of records which are being read simultaneously while the backup, before the script makes the callback. For slow server you can reduce this parameter to prevent timeouts.
Directory for Backup files: choose your directory for the backup files. If you choose a new one, the script will create it for you. You can use relative or absolute paths.

Send dumpfile as email: When this option is enabled, the script will automatically send the finished backup file as an email with an attachment (be careful!, you should use compression with this option because the dumpfile may be too large for email!)

Email address: Recipient's email address

Email subject: The subject of the email

FTP-Transfer: When this option is enabled, the script will automatically send the finished backup file via FTP.

FTP Server: the Address of the FTP-Servers (e.g. ftp.mybackups.de)

FTP Server Port: the Port for the FTP-Server (normally 21)

FTP User: the username for the FTP-Account

FTP Passwort: the password for the FTP-Account

FTP Upload-Ordner: the folder for saving the backup file (there must be Upload-Rights!)

automatic deletion of backups: When you activate this options, backup files will be deleted automatically by the following rules. Combinations are possible.

Delete by age of files (in days): A Value > 0 deletes all files older than the value in days

Delete by number of files: A Value > 0 deletes all files except the given value

Langauge: choose your language for the interface.

Time limit for Cronjob: this value in seconds increases the allowed time limit of the process in seconds when your ISP allows that.

Management

All the actions are listed here.
You see all files in the backup directory. For the actions "Restore" and "Delete" you have to select a file first.

Restore: you restore the database with the records of the selected backupfile.
Delete: you can delete the selected backup file.
Start new Dump: here you start a new backup (dump) with your configured parameters.