Manage replication configurations for requests

This topic explains how to create request replication configurations and define replica sites to which to replicate requests.

Define replication configurations for requests

You can create a request replication configuration for the current DB site. The replication configuration enables you to specify the request types to be replicated.

After defining the configuration, you can define the replica sites that are to receive the replicated requests. When you run Replicator, it replicates the requests that match the configuration to the replica sites.

Guidelines:

  • To avoid conflicts between request numbers from different sites, replication sites for request replication must have a unique site number. Dimensions CM uses the site number to generate unique request IDs between the sites.

    The site number is defined in Administration Console > Network administration. For details, see Manage base databases.

  • All the sites involved in the replication need to be defined in the base database of each of the sites involved, ensuring that the allocated site numbers are consistent.

    Caution: If you have request replication running between different sites, and you want to add a new site, you must perform a replication before creating any requests on the new site. This synchronizes all the databases. Perform this task immediately after you update all the base database site numbers on the affected nodes. Otherwise, you may have conflicting request IDs.

To define a replication configuration for requests:

  1. In the Administration Console, go to Distributed Development > Replication administration > Replication configurations.

  2. In the navigation pane, select Request Primary from the list.

  3. On the toolbar, click New. The New Replication Configuration dialog box opens.

  4. On the General tab, enter a name for the configuration in the Configuration ID field, up to 25 characters long.

  5. (Optional) In the Description field, enter your comment describing the configuration, up 240 characters long.

  6. Keep the option Is replication enabled to the replicas selected.

  7. (Optional) Select the Request Types tab and select the request types you want to replicate.

  8. Click OK to create the configuration.

Back to top

Define remote replicas for requests

After you define a request replication configuration, specify the replica site to which to replicate the requests.

To define a replica site for a request replication:

  1. In the Administration Console, go to Distributed Development > Replication administration > Replication configurations.

  2. In the navigation pane, select Request Primary from the list.

  3. From the Configurations list, select the configuration to which you want to add the replica site.

  4. In the Remote Replicas section, click the Add button.

    Note: If you have not defined the appropriate remote replica network parameters on the primary site, you need to use the Administration Console > Network administration cluster tools before proceeding. For details, see Network administration.

  5. n the New Remote Replica dialog box, enter the following details:

    Field Description
    Node name Select a remote node from the list.
    DB Connection

    Select the connection string to use for connecting to the database server.

    If the list is empty, go to Administration Console > Network administration to add values for this field.
    Base Database

    Select the base database name.

    If the list is empty, go to Administration Console > Network administration to add values for this field.
    Is replication enabled for this replica

    This option specifies whether the primary site can replicate items to the replica site.

    By default, the replication is enabled.
    Is this online replication

    This option specifies if online or offline (air-gap) replication is used.

    Clear this option to use offline (air-gap) replication.
    Is replica replicating back to the primary

    Select this option to allow the replication of requests from the replica site back to the primary site.
    Replicate requests to this site as read-only Select this option to restrict access to the replicated requests to read-only.

  6. (Optional) Select the Requests Types tab, and then select the types of requests to replicate back to the primary site.

  7. Click OK.

Back to top

Modify request replication configurations

You can change the details of a request replication configuration or its replica sites. Delete configurations or replica sites you no longer need.

To edit or delete a request replication configuration:

  1. In the Administration Console, go to Distributed Development > Replication administration > Replication configurations.

  2. In the navigation pane, select Request Primary from the list.

  3. From the Configurations list, select the configuration to edit or delete.

  4. To change the configuration details, click the Edit button in the General section, and make changes, as described in Define replication configurations for requests.

    To delete the configuration, click the Delete button on the toolbar, and confirm.

To edit or delete a replica site:

  1. In the Administration Console, go to Distributed Development > Replication administration > Replication configurations.

  2. In the navigation pane, select Request Primary from the list.

  3. From the Configurations list, select the configuration that contains the replica site you want to edit or delete.

  4. In the Remote Replicas section, select the replica site.

  5. To change the replica site, click the Edit button and make changes, as described in Define remote replicas for requests.

    To delete the replica site, click the Delete button and confirm.

Back to top

See also: