Firebird DocsetFirebird Commandline UtilitiesGSPLIT - Firebird Backup File Splitting Filter → Splitting Backups
Firebird home Firebird home Prev: GSPLIT Command ParametersHome: Firebird DocsetUp: GSPLIT - Firebird Backup File Splitting FilterNext: Joining Backup Files

Splitting Backups

To run GSPLIT , you need to use it as a filter on the command line for GBAK, as the following example shows :

C:\>gbak -b norman.fdb stdout | 
    gsplit -split norman_1.fbk 1m norman_2.fbk 1m norman_3.fbk

Warning

The command above assumes that ISC_USER and ISC_PASSWORD have been defined. For the sake of this demonstration, this is acceptable, but in a real system, consider the security implications before defining these variables.

In addition, the above command line has been split over two lines to allow the pdf generation of this manual to work. In reality, the command must be typed on a single line.

It is unfortunate that the utility doesn't seem to work, as the following shows :

C:\>gbak -b norman.fdb stdout | 
    gsplit -split norman_1.fbk 1m norman_2.fbk 1m norman_3.fbk
fail to read input from ib_stdin, errno = 9
gsplit: progam fails to generate multi-volumn back-up files
Done with volume #0, "stdout"
        Press return to reopen that file, or type a new
        name followed by return to open a different file.
  Name:^C

If you type a filename at the prompt it will simply be used as a destination for a full dump of the database, so be careful not to overwrite anything important. I tend to hit CTRL-C at this point to avoid problems.

The utility has actually created the first file in the above list, norman_1.fbk, and written 100 bytes to a special header which identifies it as a GSPLIT created file.

Warning

The command above assumes that ISC_USER and ISC_PASSWORD have been defined. For the sake of this demonstration, this is acceptable, but in a real system, consider the security implications before defining these variables.

In addition, the above command line has been split over two lines to allow the pdf generation of this manual to work. In reality, the command must be typed on a single line.

Note

The spelling errors in 'program' and 'volume' above are as produced by the utility.

Prev: GSPLIT Command ParametersHome: Firebird DocsetUp: GSPLIT - Firebird Backup File Splitting FilterNext: Joining Backup Files
Firebird DocsetFirebird Commandline UtilitiesGSPLIT - Firebird Backup File Splitting Filter → Splitting Backups