How to configure AmtBackup for incremental backups

[Belinda Frick]

For Amethyst 1.4 and higher, please see the document
Amethyst backup procedures

AmtBackup

If you have an AmtBackup.ini file in the same folder as AmtBackup.exe,
make sure that your values are correct in the file.

Windows Setup
Make sure that the current directory is the folder where AmtBackup.exe
and AmtBackup.ini are located. (E.g. StartIn = C:\Program Files\Datatex\Amethyst)
Then just execute the AmtBackup.exe. It will use the DBCreate.exe to create
the Database files and then start the backup.

Linux Setup
Create a script (run_backup.sh) in the Amethyst folder as following

cd /opt/Amethyst/
./AmtBackup

and enter this entry in your daily cron:

0 19 * * * /opt/Amethyst/run_backup.sh
This will start the backup script at 19:00.


Features:
AmtBackup is a console program that doesn't require a graphical interface.
This program was written to be run from a scheduler, (No user intervention
is required.)
It makes an incremental backup from the Amethyst database.
The backup runs from the previous backup date to the last full day
(00h00 the previous night).
The backup files will be created in the directory specified by
DESTINATION_DIRECTORY_PATH in the INI file.
Each time AmtBackup runs, the backup files will be located in a separate
directory. (The directory name is the date of the previous day
The backup directory for 14 March 2003 will be 20030314. )
Files created with this program can be used in conjunction with the MoveData
program to reconstruct an Amethyst database. (TA030429124557.html)

AmtBackup.INI
If the AmtBackup.ini is not present in the same directory as AmtBackup.exe, a new
file will be created with default values.

Default values for Windows
[Paths]
SourceDB=C:\amt\amt.gdb
;Comment=Only the directory where the Backup database must be created.
Destination_Directory_Path=C:\Program Files\Datatex\Amethyst\Backup\

[Dates]
;Format= yyyy/mm/dd.
StartDate=1899/12/30 00:00:00


Default values for Linux
[Paths]
SourceDB=/opt/Amethyst/Data/Amt.gdb
;Comment=Only the directory where the backup database must be created.
Destination_Directory_Path=/opt/Amethyst/Backup/

[Dates]
;Format= yyyy/mm/dd.
StartDate=1899/12/30 00:00:00

Other default values
If the AmtBackup.ini file doesn't exist on the first run, the date will be
assumed to be 1899. This will cause the program to backup everything from the
beginning of the database to the previous day 00h00 (12 at night).
Once a successful backup has been completed, the date in the .INI file will
be updated to "Yesterday 00h00".

The first file name for the backup will be YYYYMMDD.gb_ and the files that
follow on this one will be YYYYMMDD_X.gb_
Where YYYY is the year, MM is the Month, DD is the Day and X is an
incremental number. On Windows these files will be 4 gig in size and on Linux
2 gig in size. AmtBackup will automatically add an additional file once the
current file has reached it's limit.

Logs
A log file will be created to show the operation of the program.
check in .\logs\XXXXYY\AmtBackup.log and .\logs\XXXXYY\DBCreate.log
where XXXX is the Year and YY is the week of year.

The DBCreate.log will contain information about the database that was created.
The AmtBackup.log will give information about the AmtBackup. If there
were any errors, it will be logged in this file.