The recitaldump command is used to perform backups of either a database or a directory tree. The format of the backup file is machine independent and can be restored onto another machine with a different architecture e.g. backup on aix and restore on linux. You use the recitalrestore command to restore the backup onto another machine.
Note: recitaldump and recitalrestore must be run as root. For systems with a hidden root account, please precede the commands with sudo.
The recitaldump command takes the following arguments.
Using the --help or -h argument will display a list of arguments for all the services.
This argument is used to specify the name of a database to backup. If no -o output file is specified, the backup file will be given the same basename as the database, with a .tar.gz extension.
recitaldump -D southwind
This argument is used to specify the name of a directory to backup. If no -o output file is specified, the backup file will be given the same basename as the directory, with a .tar.gz extension. If there is a file called _reindex.prg located in the directory this file will be executed to recreate single index files when the backup is restored on a target system. You should add the Recital script commands used to rebuild the index files (.ndx) into this file. Multiple tag index files (.dbx) are handled automatically.
recitaldump -d /data/application
This argument is used in conjunction with the -d option to recursively process subdirectories.
recitaldump -d /data/application -r
Specify the output backup file name. When you need to restore this file use the recitalrestore command. For example to create a backup file of the southwind database called accountants.tar.gz;
recitaldump -D southwind -o accountants
This argument is used to add a time stamp to the output file name. For example if today was the 2nd of November 2009 at 03:27pm the following command would create a file called southwind-20091102-1527.tar.gz from backing up the southwind database.
recitaldump -D southwind -t