File Release Notes and Changelog
Release Name: 0.2.0
Notes: ----------------------------------------------------------------- -- HostingBackup: The easy way to backup your hosted websites. -- ----------------------------------------------------------------- HostingBackup is a set if PHP command line scripts to allow an easy way to backup your hosted websites to your local computer. HostingBackup is designed for backing up websites hosted on Linux servers with MySQL databases using FTP. HostingBackup uses lftp (http://lftp.yar.ru/) to download all the files from your remote server. HostingBackup uses rc4 encryption, so you do not need to have PHP compiled with mcrypt. HostingBackup is tested on Linux local computer with PHP 4.3.x and lftp 3.0.x. -------------- -- Concepts -- -------------- HostingBackup has two components: - the local one - the remote one The remote component will manage some operations like optimization and dump of MySQL databases. The local component will manage the execution of backups and other utilities like the generation of crypted passwords and the automatic installation of the remote component. To allow an easy way to backup all hosted MySQL databases we store the main password for the account directly on the remote server, crypted with rc4. When we call the dump script we pass the decrypt key. To catch the login data an hacker should read the crypted password written on the server and intercept the key on the net. ------------------ -- Installation -- ------------------ We suggest the creation of a user named "ftpbackup". The home directory for "ftpbackup" should be "/home/ftpbackup". Go to /home/ftpbackup and uncompress the HostingBackup archive. If you want, you can rename the HostingBackup directory into "bin". Go to the new directory and take a look at the files. First we need to generate the crypted password: # php crypt.php write your key (invent it) and than your read password, here you have the crypted password. If you want to test the crypted password and the key than use: # php decrypt.php Now we've to write the main configuration file, so let's edit config.php, it's self explanatory. Once finished we could install the remote component on the server: # php install.php 0 where 0 stands for the number of the host in the configuration file. Now we can finally backup our host with the command: # php execute.php 0 where 0 stands for the number of the host in the configuration file. ----------------------- -- Automatic backups -- ----------------------- HostingBackup do not supportn automatic backups, but you could configure your cron like this: 0 0 * * * php /home/ftpbackup/bin/execute.php 0 0 0 * * * php /home/ftpbackup/bin/execute.php 1 0 0 * * * php /home/ftpbackup/bin/execute.php 2 0 0 * * * php /home/ftpbackup/bin/execute.php 3 so you'll have all your 4 websites backed up every midnight. ---------------------------------------- -- Historical and incremental backups -- ---------------------------------------- HostingBackup do not support historical or incremental backups. You could use many ways to do this, we suggest using a backup solution like BackupPC (http://backuppc.sourceforge.net) to do this, simply make the software backup your own host and all will be ok. -------------------------------------------- -- How to upgrade from a previous release -- -------------------------------------------- See UPGRADE file. -------------------------------- -- Notes on Microsoft Windows -- -------------------------------- HostingBackup is not tested on Windows servers or local workstations. Surely you have to install cygwin environment to allow lftp to run. ------------- -- Authors -- ------------- Fabrizio Balliano <fabrizio.balliano@crealabs.it> CREALABS Viale dei Mughetti, 13/A - 10151 Torino - Italy Tel. +39-011-735645 - Fax +39-011-735645 http://www.crealabs.it - mailto:info@crealabs.it
Changes: 0.2.0 - Add: fix permission routine to change the permission of files on the remote server (useful for uploaded files, unreadable by ftp account) - Add: UPGRADE file with instructions on how to upgrade from a previous release - Update: READE file - Change: renamed config.php in config.sample.php 0.1.0 - Initial release
