CD-Utils - Linux CD Backup and Burning Files

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 <extract-directory>
     >tar -zxvf /mnt/cdrom/Data* <path/filename1 to restore> \
                                 <path/filename2 to restore> ...


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