Skip to content

dx_ctl_js_container

Marcin Przepiorowski edited this page Mar 21, 2019 · 7 revisions

SYNOPSIS

dx_ctl_js_container    [ -engine|d <delphix identifier> | -all ] [ -configfile file ]
                       -action reset|refresh|restore|create|addowner|deleteowner|enable|disable
                       -container_name container_name
                       [-container_def GroupName,VDBName]
                       [-container_owner username]
                       [-template_name template_name]
                       [-timestamp timestamp]
                       [-bookmark_branchname bookmark_branch_name]
                       [-branch_name branch_name]
                       [-dropvdb yes|no]
                       [-dontrefresh]
                       [ -help|? ] [ -debug ]

DESCRIPTION

Run a action on the JetStream container. If branch is not specified

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
  • -action reset|refresh|recover|create|delete|enable|disable Run a action on the container
    • -create - create JS container
    • -delete - create JS container
    • -reset - reset JS container to latest point
    • -refresh - refresh JS container from latest point of template
    • -restore - restore a JS container to point in time or bookmark name. Bookmark name can be from template or container timeline. If ones want to restore container from template's point in time - template_name and fromtemplate flag is required.
    • -addowner - Add owner to container
    • -deleteowner - Remove owner from container
    • -enable - Enable container
    • -disable - Disable container
  • -container_name container_name Name of container to run action on
  • -template_name template_name Name of container's templates
  • -branch_name branch_name Container branch name for action - default branch name is "default"

OPTIONS

  • -container_def GroupName,VDBName Specify a VDB which will be used for container. This parameter can be repeated if more than one VDB is required.

  • -container_owner de_username Specify a container owner This parameter can be repeated if more than one owner is required.

  • **-timestamp "YYYY-MM-DD HH24:MI:SS" or bookmark name ** Use timestamp or bookmark name to restore container

  • -bookmark_branchname bookmark_branch_name If bookmark name is used as timestamp for restore action, and bookmark name is not unique, this option allows to specify a branch name which will unequally identify bookmark.

    Full name format for template bookmarks is: templatename/master

    Full name format for container bookmarks is: templatename/containername/branchname

  • -dropvdb yes|no Drop VDB when deleteing container

  • -fromtemplate Use template timeline for container restore

  • <-dontrefresh Don't refresh VDB while creating container (req. Delphix Enigne >= 5.1.6)

  • -help Print this screen

  • -debug Turn on debugging

Examples

Reset of the container

dx_ctl_js_container -d Landshark5 -container_name cont -action reset
Starting job JOB-5043 for container cont.
0 - 3 - 4 - 23 - 26 - 29 - 30 - 34 - 47 - 52 - 54 - 57 - 58 - 59 - 60 - 61 - 76 - 90 - 100
Job JOB-5043 finished with state: COMPLETED

Refresh of the container from latest point in time in source

dx_ctl_js_container -d Landshark5 -container_name cont -action refresh
Starting job JOB-5050 for container cont.
0 - 3 - 4 - 12 - 26 - 29 - 30 - 34 - 45 - 47 - 52 - 54 - 57 - 58 - 59 - 60 - 61 - 70 - 77 - 83 - 100
Job JOB-5050 finished with state: COMPLETED

Restore of the cointainer to a bookmark "fixeddate"

dx_ctl_js_container -d Landshark5 -container_name cont1 -action restore -timestamp fixeddate
Starting job JOB-7637 for container cont1.
0 - 3 - 4 - 23 - 26 - 29 - 30 - 34 - 45 - 47 - 52 - 54 - 57 - 58 - 59 - 60 - 61 - 68 - 77 - 82 - 100
Job JOB-7637 finished with state: COMPLETED

Restore if the container from template timeline

dx_ctl_js_container -d Landshark51 -action restore -template_name template2 -container_name cont2 -timestamp "2017-04-15 12:00:00" -fromtemplate
Starting job JOB-2356 for container cont2.
0 - 2 - 3 - 11 - 24 - 26 - 28 - 52 - 53 - 66 - 67 - 68 - 72 - 77 - 100
Job JOB-2356 finished with state: COMPLETED

Create a new container based on template with 2 sources

dx_ctl_js_container -d Landshark51 -action create -container_def "Analytics,testdx" -container_def "Analytics,autotest" -container_name cont2 -template_name template2 -container_owner js
Starting job JOB-2411 for container cont2.
0 - 2 - 3 - 13 - 24 - 26 - 27 - 48 - 52 - 53 - 66 - 67 - 68 - 75 - 81 - 100
Job JOB-2411 finished with state: COMPLETED

Delete a container cont2 without dropping a VDB

dx_ctl_js_container -d Landshark51 -action delete -container_name cont2 -dropvdb no
Starting job JOB-2434 for container cont2.
0 - 100
Job JOB-2434 finished with state: COMPLETED

Adding owner to container

dx_ctl_js_container -d Landshark5 -action addowner -container_name test1 -container_owner js
Waiting for all actions to complete. Parent action is ACTION-16427
Owner js added
You can’t perform that action at this time.