Administration: Remove Host

Removes a host from an existing cluster. If the host to be removed has any ranks running on it, the ranks must be removed using Administration: Remove Ranks or manually switched over to a new host using Administration: Switch Over Process prior to host removal. If the host to be removed has the graph server or SQL planner running on it, these must be manually switched over to a new host using Administration: Switch Over Process.

NOTE: This endpoint should be used for on-premise deployments only.

Input Parameter Description

NameTypeDescription
hoststringIdentifies the host this applies to. Can be the host address, or formatted as 'hostN' where N is the host number as specified in gpudb.conf
optionsmap of string to strings

Optional parameters. The default value is an empty map ( {} ).

Supported Parameters (keys)Parameter Description
dry_run

If set to true, only validation checks will be performed. No host is removed. The default value is false. The supported values are:

  • true
  • false

Output Parameter Description

NameTypeDescription
infomap of string to stringsAdditional information.