Skip to main content
Delphix

TB060 Improper Command Line Interface (CLI) Responses

 

 

Alert Type

Functional Regression

Impact

When using the Command Line Interface (CLI) of the Delphix Platform with public-key authentication, the output of some operations may return unexpected results.  Output may occur where customer-assigned names of objects, such as dSources or Virtual Databases (VDBs), are replaced with internally-referenced names.

Customer scripting or automation employing the CLI may be adversely affected by the unexpected format and content of CLI output.

Contributing Factors

The issue can only occur when using the following Delphix software releases

Major Release

 Sub Releases

5.3

5.3.3.0, 5.3.3.1

The issue only occurs when using the CLI.  Scripts making direct API calls via the Web API are unaffected.

The issue only occurs when using SSH public-key authentication to access the CLI.  Password-based authentication is unaffected.

Symptoms

Enumerating objects using the "list" or "ls"  command may produce incorrect results:

database> list
NAME                     PROVISIONCONTAINER       DESCRIPTION
`ORACLE_DB_CONTAINER-3   -                        
`ORACLE_DB_CONTAINER-27  `ORACLE_DB_CONTAINER-3   -
`ORACLE_DB_CONTAINER-28  `ORACLE_DB_CONTAINER-27  -

whereas expected results could be like:

database> list
NAME                     PROVISIONCONTAINER       DESCRIPTION
prod123                  -
vdbprod1                 prod123                  -
vdbprod2                 vdbprod1

Relief/Workaround

Defer upgrades to affected Delphix software releases.

When in the CLI, you may switch the version of the API to a value other than the current version. Once done, the issue will not occur for the remainder of the CLI session.  For example:

> /version
1.10.3
> /version 1.10.2

Resolution

The issue is resolved in Delphix 5.3.4.0 and later.