> #### Dumping, backing up, and restoring the Fathom configuration database

> Using the command-line interface, you can dump the Fathom configuration database, even while Fathom is running, to a readable XML file. You can use the dump file as a backup of the configuration database; in the event of a catastrophic failure, you can use the backup dump file to restore the Fathom configuration database. Because the dump file is readable, you can also use the file when you are performing diagnostics.

> You can also perform a dump and load to reduce the disk space that the Fathom configuration database is using.

> ##### Dumping the Fathom configuration database

> You can dump the Fathom configuration database to a file whose name you specify by typing the following command:

>     fathom -dump <filename>

> The resulting file will be in XML format and will contain an XML representation of all definitions in the Fathom configuration database. You can use this resulting file either as a potential single-file backup of the database or to assist with diagnostics regarding database performance.

> Note that you can run the dump command whether Fathom is online (running) or offline (not running). If you run the command when Fathom is online, the dump command is sent to Fathom for processing. You can also use the `-httpport` argument, as follows, to identify the port of the Fathom Web server:

>     fathom -httpport <port-number> -dump <filename>

> ##### Restoring the Fathom configuration database from a backup file

> You can load a dump file you created from the Fathom configuration database. To run the load command, be sure that Fathom is offline; if Fathom is running, you must stop the AdminServer before you run the command.

> To load the file, type the following command:

>     fathom -load <filename>

> The `-load` command recreates the Fathom configuration database and populates it with definitions in the file whose name you specify.

> ##### Reducing Fathom configuration database disk space usage

> You can perform both the `-dump` and`-load` commands to reduce the amount of disk space consumed by the Fathom configuration database. You might want to perform this reduction in space if Fathom has been performing a lot of resource modifications over an extended period of time, in which case some database fragmentation might have occurred causing more disk space to be consumed than is actually required.

> Note that Fathom must be offline when you run the `-load` command.

> If Fathom is online, be sure to stop the AdminServer.

> To dump the data, do the following:

> 1. Back up the `fathom.o*` files that are in the following location:

>     <fathom-install-dir>\config

> 2. Remove the `fathom.o*` files from the location identified in Step 1.
> 3. Copy the `fathom.xml` file to the `\config` directory.
> 4. Restart the AdminServer.

Copyright © 2004 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095