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:
  2. 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.

  3. 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