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:
  2. <fathom-install-dir>\config 
    

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


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