To upgrade (or downgrade) to a specific release::
- # ceph upgrade start --version <version>
+ # ceph orch upgrade start --version <version>
For example, to upgrade to v15.2.1::
- # ceph upgrade start --version 15.2.1
+ # ceph orch upgrade start --version 15.2.1
Monitoring the upgrade
Determine whether an upgrade is in process and what version the cluster is
upgrading to with::
- # ceph upgrade status
+ # ceph orch upgrade status
While the upgrade is underway, you will see a progress bar in the ceph
status output. For example::
You can stop the upgrade process at any time with::
- # ceph upgrade stop
+ # ceph orch upgrade stop
Potential problems
You can cancel the existing upgrade and specify a different target version with::
- # ceph upgrade stop
- # ceph upgrade start --version <version>
+ # ceph orch upgrade stop
+ # ceph orch upgrade start --version <version>
Using customized container images
You can also upgrade to an arbitrary container image. For example, to
upgrade to a development build::
- # ceph upgrade start --image quay.io/ceph-ci/ceph:recent-git-branch-name
+ # ceph orch upgrade start --image quay.io/ceph-ci/ceph:recent-git-branch-name
For more information about available container images, see :ref:`containers`.
- cephadm.shell:
env: [sha1]
mon.a:
- - ceph upgrade start --image quay.io/ceph-ci/ceph:$sha1
+ - ceph orch upgrade start --image quay.io/ceph-ci/ceph:$sha1
- cephadm.shell:
env: [sha1]
mon.a:
- - while ceph upgrade status | jq '.in_progress' | grep true ; do ceph orch ps ; ceph versions ; sleep 30 ; done
+ - while ceph orch upgrade status | jq '.in_progress' | grep true ; do ceph orch ps ; ceph versions ; sleep 30 ; done
- ceph orch ps
- ceph versions
- ceph versions | jq -e '.overall | length == 1'
assert c.has_result
@_cli_write_command(
- 'upgrade check',
+ 'orch upgrade check',
'name=image,type=CephString,req=false '
'name=ceph_version,type=CephString,req=false',
desc='Check service versions vs available and target containers')
return HandleCommandResult(stdout=completion.result_str())
@_cli_write_command(
- 'upgrade status',
+ 'orch upgrade status',
desc='Check service versions vs available and target containers')
def _upgrade_status(self):
completion = self.upgrade_status()
return HandleCommandResult(stdout=out)
@_cli_write_command(
- 'upgrade start',
+ 'orch upgrade start',
'name=image,type=CephString,req=false '
'name=ceph_version,type=CephString,req=false',
desc='Initiate upgrade')
return HandleCommandResult(stdout=completion.result_str())
@_cli_write_command(
- 'upgrade pause',
+ 'orch upgrade pause',
desc='Pause an in-progress upgrade')
def _upgrade_pause(self):
completion = self.upgrade_pause()
return HandleCommandResult(stdout=completion.result_str())
@_cli_write_command(
- 'upgrade resume',
+ 'orch upgrade resume',
desc='Resume paused upgrade')
def _upgrade_resume(self):
completion = self.upgrade_resume()
return HandleCommandResult(stdout=completion.result_str())
@_cli_write_command(
- 'upgrade stop',
+ 'orch upgrade stop',
desc='Stop an in-progress upgrade')
def _upgrade_stop(self):
completion = self.upgrade_stop()