Skip to main content
Skip table of contents

Appliance installation and setup

The VM image installation instructions are similar to the instructions for standard engines, where an OVA file is downloaded and installed. The OVA file or link to the AMI can be found on the Delphix downloads site, under the DCT Engine folder of the DCT area (not in the Delphix Engines area).

image-20241002-224507.png

With a structure similar to (but with fewer options than) standard engines:

image-20241002-224625.png

You must then use the VM console and wait for the Delphix Management Service and Delphix DCT Service (new) to come online, which can take up to 30 minutes (longer than for standard engines):

image-20241002-225546.png

Just like standard engines, you must use sysadmin credentials to configure network, then use a web browser to access the server setup UI application.

The server setup UI is a slightly modified version of the setup of standard engines. Since it is a distinct build from standard engines, users do not have to select the type of engine to install. When the setup starts, a Welcome screen shows text detailing the DCT setup process:

image-20241003-130932.png

On the next page, you must choose a password for the sysadmin user and enter an email address. While standard engines require them to choose a password for the Engine admin and optionally Masking admin, the DCT engine requires them to copy and save a DCT bootstrap API key:

image-20241003-131001.png

This process replaces the need to generate a bootstrap API key and obtain it from the Docker-Compose/Kubernetes logs for existing DCT form factors.

After initial setup, users will have the ability to re-generate a bootstrap API key via the server setup screen.

Users then go through the same Time, Network, Network Security, Storage, and Registration pages as for standard engines:

  • In the Network Security page, the KeyStore/HTTPs configuration must be used to configure the TLS certificate of the inbound HTTPs interface (nginx) of the DCT engine. This replaces the need to configure an ingress for Kubernetes deployments.

The Trust Store configuration can be used to configure certificate authorities that DCT should trust when verifying TLS connections to Engines or Hyperscale orchestrators, which will be connected to this DCT Engine. This replaces the manual edits to values.yaml for Kubernetes deployments.

The DSP and STUNNEL SERVER sections can be ignored for DCT Engines.

  • Note on the Storage page, use of Object Storage for DCT Engines is not supported. Block storage disks will be used to store both the Management service metadata (very minimal) and DCT metadata, we recommend a minimum of 50GB of storage (but the enforced minimum is lower).

Some sections (SSO/LDAP, etc.) which are not relevant to DCT Engines are not displayed. Configuration of Phone home, SAML/SSO, LDAP reside in the DCT application itself (accessible post setup) and not in the server setup.

Users then review the Summary screen and hit Submit, which configures the engine and restarts the applications.

image-20241003-131037.png

Post restart, browsers are redirected to the DCT UI application, which runs exclusively on HTTPs (HTTP redirects to HTTPs) under the /dct prefix. For example, https://<engine-url>/dct.

image-20241003-131058.png

Via the Sign in and Api Key hyperlinks, users can log in using the Bootstrap API key retrieved during initial setup. Another option is to regenerate a new Bootstrap API key via the Setup app; a Hyperlink to the Setup app is shown on the DCT login screen and vice versa.

image-20241003-131155.png

Post login, the Engine DCT UI and API experience is indistinguishable from the DCT UI experience on Docker-Compose and Kubernetes.

image-20241003-131221.png

DCT accounts, roles, authentication, etc. is managed via the DCT UI, while sysadmin authentication, TrustStore/KeyStore, engine registration, network, and storage can be configured via the Setup UI, as well as regenerating a DCT bootstrap API key (in case admin access to DCT has been lost).

image-20241003-131238.png

Limitations

The “Software version” component of the setup app is currently reporting the engine’s “Appliance version” on top of which DCT is built—not the DCT Engine version. Multiple DCT Engines versions may (in the future) be built on top of the same appliance version; but at present, this number is not a good characterization of the DCT Engine version. There is an RFE filed to include the DCT Engine version as well.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.