raqbackup.sh 4.0

Get raqbackup.sh installed on your BlueOnyx server

Don't want to install raqbackup.sh yourself? Get raqbackup.sh installed on your server!

Install it on your own

Please follow the instructions on this page. This page generates some lines of code which you'll have to execute on your Cobalt or BlueOnyx server - so there is no normal download procedure. But don't worry, you will see that it is very easy to setup raqbackup.sh

Since raqbackup.sh uses FTP to transfer the backup to another server you'll have to configure two servers. The source has to be a RaQ or blueOnyx server but the target machine can be any server with FTP-access.

target machine
1. create an user with FTP-access on the target machine. You can use the username backup if you like.
2. be sure to adjust the quota for this user and site as needed.
3. if you like create a special directory where raqbackup.sh should store the backup files. raqbackup.sh will create a directory under this directory with the hostname of the source server. If you don't specify a special directory raqbackup.sh uses the start-directory of the ftp-session. If the target machine is a RaQ and the ftp-user is backup raqbackup.sh will store the files under /home/sites/site/users/backup/hostname.of.source/

Source Blueonyx server

All versions of BlueOnyx have the CMU already installed

You are now able to customize raqbackup.sh to your needs. What you type is secret - you don't have to submit it to us or to other servers. It is used to generate some commands in the textarea-field at the bottom of the page with the JavaScript-feature of your browser.

Configuration options
Hostname	Hostname of the source server: automatic will auto-detect your hostname.
Installation-directory	The directory to install raqbackup.sh /etc/cron.daily is recommended. This will start raqbackup.sh every morning
Working directory	raqbackup.sh needs a directory to store some files.
E-Mail-Notifications	eMail reports of the backup-process. yes no
	E-Mail:
	Detailed reporting: always never first day of a month every Monday every Tuesday every Wednesday every Thursday every Friday every Saturday every Sunday
Version checking	Should raqbackup.sh check and report the current version available? This is not an auto-update. yes no

What do you want to backup?

WHAT do you want to backup?
Backup sites and users with CMU	Do you want to use CMU to backup site and user data? yes no
	Do you want to exclude a directory from being cmuExported? yes no raqbackup.sh moves the complete directory to a secure place before it starts cmuExport and moves it back to the original place after the end of cmuExport. Please never exclude any important system-directory!
	Do you want to compress the several xml-files to a single archive? yes no
	Location of cmuExport:
	CMU-directory:
Backup MySQL-databases	Do you want to backup mysql-databases? yes no
	Location of mysqldump: Do a locate mysqldump to be sure the path is correct. You'll need MySQL 3.23.x or newer!
	MySQL user: usually this is the MySQL user root. This is not the same user as your system user root.
	Password of this user: this is the passoword of the MySQL user above.
	Do you want to compress the resulting sql-file? yes no
Backup other directories	Do you want to backup any additional directories? yes no
Backup other directories	directories: /etc/named Each directory in a new line, please. raqbackup.sh will backup the specified dirs and their subdirectories.

Where should raqbackup.sh store the backup?

Locations to store the backup
Store on source server	Do you want to store the backup on the source server? yes no This backup would be stored under /home/raqbackup/data. If you have enough diskspace it's a good idea to activate this option.
FTP to another server	Do you want to transfer the backup to another server? yes no
	Hostname or ip-address of target machine
	FTP-user on target machine
	Password of this user
	Target directory e.g. /home/backup - leave blank if raqbackup.sh should use the initial directory of the ftp-session (where it will create a directory hostname.of.source)
	Port for FTP if you don't use the standard-port (which is 21)

SSH to the BlueOnyx server and su to root
copy the following text to your clipboard and paste it into your Telnet/SSH-client. These commands download the script from our server and replace default-values with the values you entered above.
If you have JavaScript enabled and you changed something above, you should see some lines of code here - and NOT this text ;-)
That's it. raqbackup.sh is installed and configured. If you want to start it manually, SSH or telnet to your RaQ, change to the installation-directory and execute raqbackup.sh with the screen-parameter: ./raqbackup.sh screen

You should know...

raqbackup.sh is not supported by Sun Cobalt and comes without any warranty.
if you like you can modify the script to your own needs under the terms of the GNU General Public License.
the Cobalt Migration Utility (CMU) exports (cmuExport) and imports (cmuImport) sites and users. raqbackup.sh uses cmuExport only. cmuExport exports all sites und users with all data and configuration to workingdirectory/data (default: /home/raqbackup/data)
raqbackup.sh starts cmuExport and transfers this export to the target machine
on my machines (RaQ3/RaQ4) raqbackup.sh needs 20-60 minutes to cmuExport all sites and to ftp them to the backup-machine. I have arround 150 sites with 1.5 GB data per raq
if you run raqbackup.sh every day you'll have two backup-versions (the cmuExport from today and yesterday) per source server on your target machine
to store these two versions I need arround 1 GB (500 MB each). To be sure you should have a lot of quota on the target machine.
you'll get the output of raqbackup.sh via mail. Be sure to check this mail.
source and target machine should be located in the same LAN (security, traffic!)
if you have two RaQs and you want that one RaQ backups the other please note: cmuExport exports all data under /home/sites/somesite/. You should be sure that you don't backup the backup of a backup of a backup and so on. This will result in very large backup-files. raqbackup.sh has two options to prevent this behaviour:
1. exclude directory (recommended): with this option you can exclude a directory under /home/sites/somesite/ from being cmuExported. If you use backup as username on the target machine and backup is a member of the site home you should specify /home/sites/home/users/backup as exclude-directory.
2. target directory: with this option you can ftp the backup to a directory outside of /home/sites/somesite/ on the target RaQ. You can use something like /home/backup. This directory won't be cmuExported when you run raqbackup.sh on the target machine. To use this option create the corresponding directory on the target RaQ and make sure that the ftp-user has write-access to this directory.
Plugins
1. plugin start: raqbackup.sh will search for scripts or programs with the names start.sh, start.pl, start.cgi or start in your plugin-directory working-directory/plugins and executes them before the script starts.
2. plugin end: raqbackup.sh will search for scripts or programs with the names end.sh/.pl/.cgi or end in your plugin-directory and executes them before the end of raqbackup.sh
3. plugin precmu: raqbackup.sh will search for scripts or programs with the names precmu.sh/.pl/.cgi or precmu and executes them before it executes CMU.
4. plugin postcmu: analog, but after CMU
5. plugin preftp: you get it, right? ;-)
6. plugin postftp
7. plugin premysqldump
8. plugin postmysqldump
9. plugin pretardirs
10. plugin posttardirs

Hosting Support for over 25 years

Experienced support means fast repairs, fast migrations, and fast Servers. Support for cPanel and blueOnyx control panels, Centos and Redhat back to the first versions!
With over 25 years providing hosting support online, your problem can be diagnosed and repaired fast at a reasonable price. Ask about our monthly package for ongoing support.

cPanel, Sun Cobalt, and BlueOnyx Support

We've supported the Sun Cobalt, and Cobalt Networks line of products since they were new. This includes building hundreds of RPM's and packages and a line o‪f updates that keep a Cobalt RaQ4 current for DNS.
Migration and data recovery services, troubleshooting, repair, and monitoring for cPanel, Sun Cobalt RaQ, Sun Cobalt Qube, BlueQuartz, and BlueOnyx families of systems.

Managed Co-Location

It's great to have your own server in a datacenter and even better if you have someone you know for hands on work.
Co-Location prices start at $100 a month and it's high speed to everywhere on the internet from a fully certified datacenter.
Contact us with your requirements for a quote today!