Skip to content
Marcin Przepiorowski edited this page Oct 26, 2016 · 20 revisions

Overview

DxToolkit is a set of scripts, which are delivered by Delphix professional services team. DxToolkit scripts look and feel like UNIX executables, following the typical conventions of using flags for arguments. DxToolkit is written in Perl, but no knowledge of Perl is required unless you want to extend it. In fact, no programming experience whatsoever is required to use the DxToolkit.

Working with DxToolkit

Configuration

DxToolkit reads the configuration file dxtools.conf in JSON format.

Field description

  • hostname Delphix identifier
  • ip_address Delphi appliance IP address or hostname
  • username Delphix username
  • password Delphix username password
  • port Delphix port no
  • default true|false
  • encrypted true|false <true – encrypted password in dxtools.conf>
  • protocol http|https

Example

{
	"data":[
	{
		"hostname" : "Landshark",
		"ip_address" : "delphix01",
		"username" : "delphix_admin",
		"password" : "delphix",
		"port" : "80",
		"default" : "false",
		"encrypted" : "false",
		"timeout" : "60"
	},
	{
		"hostname" : "Landshark2",
		"ip_address" : "delphix02",
		"username" : "delphix_admin",
		"password" : "delphix",
		"port" : "443",
		"default" : "true",
		"encrypted" : "false",
    "protocol" : "https"
	},
	{
		"hostname" : "Delphix32",
		"ip_address" : "192.168.1.32",
		"username" : "delphix_admin",
		"password" : "#papapaewiru32472931u12",
		"port" : "80",
		"default" : "true",
		"encrypted" : "true"
	}
	]
}

Connecting to Delphix engines

DxToolkit can run an operation on one or all engines configured in configuration file. After successful connection to the Delphix Engine a session is saved for a future usage. Default expired time for a session is set to 30 min and it's a Delphix Engine not a DxToolkit parameter. An existing user session can be destroyed using dx_logout command.

  • -d or –engine Run command for one Delphix Engine specified by
  • -all Run command for all Delphix Engines defined in configuration file
  • -dever Set version of API to particular Delphix Engine version. Supported values are 4.1, 4.2, 4.3, 5.0

Common parameters

  • -version Display version
  • -debug n Enable debug mode at level n
  • -help Display help
  • -format Format ( [pretty] | csv | json )
  • -nohead Turns off header

DxToolkit commands

List of DxToolkit command can be found here

Examples

Delphix

Clone this wiki locally