Progress Fathom Replication
User’s Guide

> ## Setting up the source database (online backup)

> This section details some of the tasks you must perform on the source database to prepare to run Fathom Replication. Refer to this section if you are using an online backup of the source database to create the target database.

> To enable online backups, you need to implement the deferred agent startup mode, which is described in the "Overview of implementation tasks for deferred agent startup" section.

> ##### Preliminary tasks

> To set up the source database, you must first perform the following tasks:

> 1. Execute your `PROENV` and `DSRENV` scripts every time you open a command-line window or shell, and ensure that you have `$DLC`, `$PROMSGS`, `$DSRHOME`, and `$PROCFG` environment variables set correctly.

> 2. Shut down the source database.

> For more information on how to perform these tasks see the Progress Database Administration Guide and Reference .

> ##### Creating a structure file

> Once you have shut down your source database, you need to build a structure file (.st) with the following command:

>     PROSTRCT list source_db_name source_db_name.st

> The structure file that originates from the source will be moved to the target machine.

> ##### Enabling After Imaging

> To use Fathom Replication, After Imaging (AI) must be enabled on your source database. If AI is already enabled on your machine, skip this section and go to the "Enable the source for Fathom Replication" section.

> To enable AI on your source database:

> 1. Add AI areas by entering the following command:

>     PROSTRCT add source_db_name addai.st

> where `addai.st` is the name of your structure file. This structure file defines AI areas to be added to the database. You might need to build a structure file that contains the AI area specifications.

> 2. Turn on AI with the `RFUTIL` Utility. For more information on using the `RFUTIL` utility, see the Progress Database Administration Guide and Reference .

> ##### Enable the source for Fathom Replication

> Fathom Replication requires that the source database be enabled before starting the database. To enable the source database, enter the following command:

>     PROUTIL source_db_name -C enableSiteReplication source

> ##### Configure the Fathom Replication server for deferred agent startup

> Online backups require a server that is configured for deferred agent startup. To do so, you must set `defer-agent-startup` property to a valid time-out value (in minutes) in the server property file. In the following example, the time-out is set for 4 hours:

>     [server]
>          defer-agent-startup=240

> For more information, see the "Fathom Replication properties files" section and the "Fathom Replication properties" section.

> ##### Restart the source database

> If you need information about starting databases, see the Progress Database Administration Guide and Reference .

> ##### Perform an online backup

> To perform an online backup, use the `-REPLTargetCreation` and the `-online` options. For example:

>     PROBKUP source_db_name source_db_name.bak -online -REPLTargetCreation

> If you need more information about database backups, see the Progress Database Administration Guide and Reference .

> After you complete the tasks described in this section, go to the "Starting up the target database" section.

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