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.