README.0.3 version 1 - cd-utils Author: Haydn Lowe - 14 Aug 2004 Brief Installation / Upgrade notes for cd-utils release 0.3 ----------------------------------------------------------- Easily burn CDs/DVDs from a web browser, or the command line! --------------------------- Table of Contents --------------------------- - Compatibility - Configuration Overview - Usage - Installation - Upgrade - Uninstallation - Troubleshooting --------------------------- Compatibility ------------- This has been built and tested on an SME 6.0.1 server - kernel 2.4.20-18.7 SME 6.0.1 is based on the RedHat 7.3 distribution of RedHat. rpm packages used: dvdrecord-0.1.2-1, mkisofs-1.10-11, cdrecord-1.10-11 This should be able to work on many other redhat systems. For other SME versions, server-manager burning should work. The backup functions are more specific to SME version, and depend on the event model used. Please comment on your experiences at http://cd-utils.sourceforge.net Configuration Overview: ----------------------- CD Utils is designed to be simple on the command line. It uses a minimal set of commands, and command line arguments (outlined below) There are 3 files to configure in /etc: cd_utils.conf cdbackup_includes cdbackup_excludes For users of SME, there is a plugin for server-manager which lets you configure and use CD Utils from a web browser /etc/cd_utils.config -------------------- cd-utils needs two directories for burning: DATA_SOURCE - the directory where files to be burnt are placed CD_STAGING_DIR - the directory used to store a backup image before burning it to CD this means HD space required = the size of the CD you want to burn cd/dvd burner configuration: >cdrecord -scanbus will show you where your cd/dvd burner is located /etc/cdbackup_includes ---------------------- - files/directories to be included in the backup - as per GNU tar /etc/cdbackup_excludes ---------------------- - files/directories to be excluded from the backup - as per GNU tar /dev/cdrom (or the mount point you specify in cd_utils.conf) ------------------------------------------------------------ - must be a valid mount point for your drive (ie mount /dev/cdrom) - for verifying a backup image - for running a restore Usage: ------ cd_backup.pl runs a backup, exits when complete or an error occurs configuration cd_burn.pl [data|audio|multi-mode] burns files as a data image (or an .iso image if present), audio (needs .wav - or types supported by cdrecord), or a multi-mode CD. For more information: >less /opt/cd_burn.pl dvd_burn.pl burns files as a data image (or an .iso image if present) For more information: >less /opt/dvd_burn.pl cd_restore.pl CAUTION - this will overwrite data! restores files from a CD/DVD onto the system selective file restore If you only want to restore a single file - simply use tar! You can confirm a file's location using the index file on the CD/DVD. >mount /dev/cdrom >less /mnt/cdrom/toc* To extract: >cd >tar -zxvf /mnt/cdrom/Data* \ ... Installation: ------------- 1. install dvdrecord, cdrecord and mkisofs packages (for SME 6 use the rpms which are distributed with RH 7.3) 2. install cd-utils RPMS: >rpm -Uvh cd-utils-0.3.2-1.rpm >rpm -Uvh e-smith-cd-utils-0.2.1-1.rpm (if you want the SME server-manager plugin) TAR BALLS: >tar zxvf cd-utils-0.3.2.tgz >tar zxvf e-smith-cd-utils-0.2.1.tgz (if you want the SME server-manager plugin) 3a. FOR SME configure cd-utils using server manager - look in: "CD Utils" and "CD Backup" 3b. FOR OTHERS Edit the configuration files >vi /etc/cd_utils.conf >vi /etc/cdbackup_includes >vi /etc/cdbackup_excludes 4. make sure that /dev/cdrom points to the right place (required for backup and restore to work) It should be a scsi device of some sort. If you are running an IDE drive it will look like a scsi device now. probably try: >mv /dev/cdrom /dev/cdrom-old >ln -s /dev/scd0 /dev/cdrom Upgrade: -------- CAUTION: upgrading may overwrite your configuration! 1. Take a copy of your current configuration files: > cd /etc; mkdir cd_utils_old; cp cdbackup* cd_utils_old; > cp cd_utils.conf cd_utils_old 2. - If you have previously used an RPM for cd-utils - first uninstall it (rpm -e ...) - If you previously used the tar installation, you should be able to simply follow the standard installation (this will overwrite the existing installation). 3. Follow standard installation - except for configuration: 4. Restore your backup config: >cd /etc; mv cd_utils_old/cdbackup* . Manually edit cd_utils.conf to merge with cd_utils_old/cd_utils.conf (there are only a few simple differences) OR Re-Save your configuration from Server-Manager (for SME) Uninstallation: --------------- use rpm -e cd-utils If tgz installation was used, then simply delete the files installed by the tar archive. Troubleshooting: ---------------- Look in /tmp for .err files Look in /var/log/messages Check for bugs at http://cd-utils.sourceforge.net Try the forums at http://cd-utils.sourceforge.net