Transaction Backup

From CometWiki

Revision as of 18:19, 1 February 2010

Transaction Backup/Checkpoint/Rollback

Transaction Backup is both simple and complex.

First, some definitions.

• Live Data -- all of the directories and files that the file server could modify. This is comprised of all directories called for by any user executing a "DirAdd" call.
• Backup repository -- a place, usually a single folder, containing a faithful copy of the live data at some given point in time.
• Checkpoint -- that point in time where all data in the backup repository matches the live data.
• Transaction -- any file activity that changes a file.
  • Create a File
  • Create a Key
  • Erase a File
  • Clear a File
  • Rename a File
  • Delete a record
  • Write a record. (includes all variants such as write, rewrite, update, insert, etc.)
  • Windows -- Create Directory
  • Windows -- Create File
  • Windows -- Move File
• Backup -- a process that makes an exact copy of the live data into the backup repository, creating a checkpoint.
• Snapshot -- a process whereby transactions are applied to the backup repository, creating a checkpoint.
• Rollback -- a process that copies all of the files comprising a Checkpoint back to Live Data and possibly applies transactions to it up to some arbitrary point, reestablishing the Live Data at some past point in time.

Recording Transactions

The server will record every packet that comes to it that modifies data. There are a finite number of these packets that the file server receives. These "transactions" will be written to a file. Each transaction will have a serial number which just increments each time a transaction is written. The transaction file will be "cycled" every so often. That is, a new transaction file will be created whose name contains the first transaction number in it. Cycling will be triggered by an action such as a Backup or Snapshot, some time increment, or some number of transactions. This will produce potentially many transaction files, but will allow them to be transmitted from server to server relatively easily.

• A Transaction File will be a Text file with variable length records.
• Each record in a Transaction file will contain:
  1. Header Length - 4 bytes. Decimal number of bytes before the raw packed data. (includes these 4 bytes)
  2. Transaction number - up to 8 bytes (Decimal)
  3. Time Stamp - Local date and time of the transaction. YYYYMMDDhhmmss
  4. Partition Number - up to 4 bytes (Decimal)
  5. Operation - up to 2 bytes (Hex)
  6. Node Name -- up to 16 bytes (Quoted)
  7. Program Name - up to 8 bytes (Quoted)
  8. File Path - up to 260 bytes (If Keyed File, Points to the data file) (Quoted)
  9. Unpacked Data Length - 4 bytes (Decimal)
  10. Packed Data Length - 4 bytes (Decimal)
  11. Packed Data -- Depends on operation -- up to 8194 bytes -- could contain the Key
• All Header fields will be separated with commas.
• Transaction records end with CR/LF.
• What about encryption? Is this needed? If so, at what point in the process?

Checkpoint

Periodically, the server will perform a "checkpoint". That is, it will replicate all Live Data to the Backup Repository. This operation could take some time and provision must be made for users to keep working during this process.

A Checkpoint could be created in 2 ways:

Backup -- Make a full copy of all of the data.

The Checkpoint will be at the end of this process, not at the beginning. How important is this?

Perform the following steps:

1. Remember the next transaction number (lets call it 1111)
2. Start copying files from the main directories to a backup repository.
3. When copying is finished, remember the last transaction number. (lets call it 2222)
4. "Play" the transactions to the files in the backup repository from the first one to the last one (1111 to 2222)
5. Make a Checkpoint file by compressing the backup folder. Name the compressed file using the last transaction number it contains (2222).

Snapshot -- Use the Transaction Logs to create the Checkpoint.

This method assumes that the Backup Repository already exists, as a result of either a previous Backup or Snapshot. This method will perform better than a Backup, and guarantees that the checkpoint will be up to date at the instant the checkpoint is initiated.

Perform the following steps:

1. Remember the last transaction number (lets call it 2222).
2. Look up the transaction number for the previous checkpoint (Lets call it 1111).
3. Start a new transaction file (2223).
4. Remember this transaction number for the next checkpoint operation (2223).
5. Playback all transactions from 1111 to 2222 to the backup folder.
   • If the destination file does not exist for the transaction, copy the file from the active folder. There may be some danger in this.
6. Make a Checkpoint file by compressing the backup folder. Name the compressed file using the last transaction number it contains (2222).

Compressed Checkpoint files could be retained, in an archive.

Rollback

At any time, the user can "rollback" the whole system by restoring the Live Data up to a Checkpoint and then possibly playing transactions up to a desired point in time. This could be on a completely different system than the main server. This would facilitate migration to a new server, making a test system, or whatever.

Added Benefits

There are several added benefits from this feature

• The Disaster Recovery Service could work with transaction files, potentially speeding up the whole process. Transaction files could be transmitted several times a day making the whole service more valuable.
• Developers could analyze transaction files to determine just how some record was modified etc.