backupFilePartition

backupFilePartition(backupDir:       String;
                    verifyChecksums: Boolean;
                    compress:        Boolean;
                    overwriteDest:   Boolean);

The backupFilePartition method of the JadeDbFilePartition class initiates a backup of a single partition of a database backupDir parameter. (The backup directory is specified relative to the database server node and must be a valid directory.) This method executes on the database server node, and is implemented and executed by the database engine.

The backup process performs various consistency checks similar to a database certify, to ensure the integrity of the backup.

Set the verifyChecksums parameter to true if you want checksums verified in the backed up file partition. Checksum verification is performed in a separate pass of the backed up file partition immediately after the copy phase. A checksum analysis of your backed up database partition verifies that the file partition has not been corrupted by a hardware or environmental problem during the backup process. You should perform a separate checksum analysis of any backup that has been moved across media, especially if transferred across a network.

Set the compress parameter to true if you want to compress backed up data. You can compress data in a checked or an unchecked backup.

Set the overwriteDest parameter to true if you want to allow file partition backups to overwrite existing files in the destination backup directory. When this parameter is false, an exception is raised if an existing file partition is detected.

Before partitions of a database file can be backed up using the backupFilePartition method, call the beginPartitionedFileBackup method for the corresponding database file instance.

Similarly, call the endPartitionedFileBackup method when the required partitions of a database file have been backed up.

Separate Jade processes can initiate concurrent file partition backups. This allows multiple file partitions to be copied concurrently, which can reduce elapsed backup time when the source and destination volumes are on different physical devices.

Because of increased disk contention and disk head movement, concurrent backup operations run slower if the backup is sent to a single disk drive.

An exception is raised if the database partition was not located or there was an error accessing a database partition control file.

You can use the JadeDatabaseAdmin class enableProgressEvents method to optionally notify operation and progress notifications for file partition backups. You must both enable and subscribe to this event if you want file partition backup operation and progress notification. For more details, see "DbFile Class Event Notifications".