/clusters/{clusterName}/commands/upgradeCdh
Mount Point: /api/v16/clusters/{clusterName}/commands/upgradeCdh
POST
Perform CDH upgrade to the specified version.
Allows the following upgrades:
- Major upgrades from any CDH 4 to any CDH 5
- Minor upgrades from any CDH 5 to any CDH 5
- Maintenance upgrades or downgrades (a.b.x to a.b.y)
If using packages, CDH packages on all hosts of the cluster must be manually upgraded before this command is issued.
The command will upgrade the services and their configuration to the version available in the CDH5 distribution.
Unless rolling upgrade options are provided, the entire cluster will experience downtime. If rolling upgrade options are provided, command will do a "best-effort" rolling upgrade of the given cluster, i.e. it does plain upgrade of services that cannot be rolling upgraded, followed by first rolling upgrading non-slaves and then rolling restarting the slave roles of services that can be rolling restarted. The slave restarts are done host-by-host.
Available since v9. Rolling upgrade is only available with Cloudera Manager Enterprise Edition. A more limited upgrade variant available since v6.
Parameters
| name | description | type | default |
|---|---|---|---|
| clusterName | The name of the cluster. | path |
Request Body
| element: | cdhUpgradeArgs |
Arguments for the command. See ApiCdhUpgradeArgs.
Response Body
| element: | command |
Information about the submitted command.