Readme for Ace Backup

[ support forum ] [ website ] [ configuring ]

There isn't really much that is needed for this script. Just follow these basic guidelines, and it should install fine, and start backing up your files/databases in no time!

1) Upload backup.cgi to the place you want to run it (most servers can run .cgi files outside the cgi-bin now). Make sure the directory it has been uploaded to is CHMODed to 777, or 775 if your server won't allow 777.

NOTE: Remember to change the variables at the top of the script before running it! See here for information on configuring it!

2) CHMOD the script to 755.

3) Upload check.cgi, and CHMOD to 755. Run it, to see if ou have everything set up correctly.

4) Call the script via the browser.

5) Select the first menu option on the left (setup cron).

6) You will be given 4 options. Daily, weekly, monthly or annual backups. Make your choice, and then press the button. This will set up the cron-job, that is going to be run every x days.

7) You then need to add a folder to backup, and if you have any MySQL databases that need it, them too. These things can be done from the menu on the left.

 

That should be it. Depending on when you set the script to run, you should get an email (if you turned this option on) letting you know how the cron job backup went.

ADVANCED USERS

If you know how to use SSH, then log into your account, and type the following (replacing the path to your own);

perl /home/yourdomain.com/stuff/backup.cgi

Then see what output is returned. If it is 'permission denied', then make sure the folder is appropriately CHMODed.

 

[ CONFIGURATION ]

There is not really that much to do here for basic users. Just edit these variables;

$webmaster Set this to the email address you want notifications to be sent to. Even if you set the below variable to 0, make sure you configure it, otherwise major problems will not get reported to you!
$send_mail_to_admin To receive notifications after every build, of how the process went, set this to 1, if not, then set to 0.
$sendmail This is the location to sendmail on your system. If you don't know it, then check up on your hosts FAQ pages, or in a Telnet/SSH session, type "whereis sendmail". That will give you a list of places it is located.
$debug Only turn this on in exceptional cases. It can reveal important information about your system if you leave it on! Leave to 0 by default.
$admin_password Set this to the password you want to enter when first accessing backup.cgi.
$path_to_mysql_dump This is the path to where mysqldump is located. Again, if you are unsure, consult your hosts FAQ pages, or in a Telnet/SSH session, type "whereis mysqldump". That will give you a list of places it is located.

[ Advanced Options ]

Here are a few of the more 'advanced' options that interact with MySQL dump.

Variable Actual Translation About
$add_locks --add-locks

Add LOCK TABLES before and UNLOCK TABLE after each table dump. (To get faster inserts into MySQL.)

$add_drop_table --add-drop-table

Add a DROP TABLE before each create statement.

$delayed --delayed

Insert rows with the INSERT DELAYED command.

$extended_insert --extended-insert

Use the new multiline INSERT syntax. (Gives more compact and faster inserts statements.)

$lock_tables --lock-tables

Lock all tables before starting the dump. The tables are locked with READ LOCAL to allow concurrent inserts in the case of MyISAM tables. Please note that when dumping multiple databases, --lock-tables will lock tables for each database separately. So using this option will not guarantee your tables will be logically consistent between databases. Tables in different databases may be dumped in completely different states

$xml --xml

Dumps a database as well formed XML

 

Thanks

Just wanted to say thanks to you for purchasing this script. We are always making improvements...which are given out over our product mailing lis.

Cheers

Andy Newby
Founder/Programmer
webmaster@ace-installer.com

 

© Ace Installer. All Rights Reserved 1999-2002