Skip to content

dx_ctl_replication

Jump to bottom
Marcin Przepiorowski edited this page Nov 2, 2022 · 7 revisions

SYNOPSIS

dx_ctl_replication [-engine|d <delphix identifier> | -all ]
                   -profilename profile
                   -action create|delete|update|replicate
                   [-enabled yes|no]
                   [-schedule "* * * * *"]
                   [-objects "Groupname/dbname"[,"Groupname"]]
                   [-host hostname]
                   [-user username]
                   [-password password]
                   [-safe]
                   [-nowait]
                   [-help|?]
                   [-debug ]

DESCRIPTION

Start an replication using a profile name

ARGUMENTS

Delphix Engine selection - if not specified a default host(s) from dxtools.conf will be used.

  • -engine|d Specify Delphix Engine name from dxtools.conf file

  • -all Display databases on all Delphix appliance

  • -configfile file Location of the configuration file. A config file search order is as follow:

  • configfile parameter

  • DXTOOLKIT_CONF variable

  • dxtools.conf from dxtoolkit location

  • -profilename profile Specify a profile name to run

  • -action create|delete|update|replicate Specify an action to run with profile name

    - create - to create a new profile

    - delete - to delete an existing profile

    - update - to update an existing profile

    - replicate - to kick off replication

OPTIONS

  • -enabled yes|no Enable automatic replication

  • -schedule "* * * * *" Replication schedule using Quartz-cron expression

    Ex: "0 0 */4 ? * *" - run every 4 hour

  • -objects "Groupname/dbname"[,"Groupname"] Comma separated list of objects [ dataset / group ] to replicate. Database has to be provided with a group name.

    Ex: PRD,TEST/test19 - group PRD and dataset test19 from group TEST will be added to replication

  • -host hostname Replica engine hostname / IP

  • -user username Replica engine username

  • -password password Replica engine password

  • -nowait Don't wait for a replication job to complete. Job will be running in background.

  • -safe Enable "safe" replication. If there was a VDB/dSource deletion operation on primary engine, replication job won't be started

  • -help Print this screen

  • -debug Turn on debugging

Example

Replicate a profile called "backup"

dx_ctl_replication -d DelphixEngine -profilename backup -nowait
Replication job JOB-7425 started in background

Create a replica profile called newprof replicating group PRD and one VDB (test19) from group TEST every 2 hours

dx_ctl_replication -d DE -action create -profilename newprof -objects PRD,TEST/test19 -host 10.0.0.1 -user admin -password xxxxxxxx -enabled yes -type replica  -schedule "0 0 */2 ? * *"

Update an existing replica profile

dx_ctl_replication -d DE -action update -profilename newprof -enabled no

Delete an existing replica profile

dx_ctl_replication -d DE -action delete -profilename newprof

Delphix

Clone this wiki locally