This content is associated with a legacy version of the Replicated product. For the current Replicated product documentation, see docs.replicated.com.
Upgrading Rook Ceph
Previous versions of Replicated were bundled with Rook version 0.8. When upgrading Replicated the Rook Operator will not be upgraded to the current version.
Rook supports upgrading from one minor version to the next. Rook must first be upgraded from a 0.8 to a 0.9 release before upgrading to a 1.0 release.
Upgrading from release 0.8 to 0.9
Manual steps for upgrading from a 0.8 release to a 0.9 release can be followed using this guide with some amendments below.
NOTE: This guide was created as of release 0.9.3.
Amendments (v0.9)
- The 0.9.3 release can be downloaded with the link https://github.com/rook/rook/archive/v0.9.3.tar.gz.
- In the “Upgrade Process” 2. Update modifed/added resources section there are no pod security policies enabled.
- In the “Upgrade Process” 8. Update optional components section there are no ancillary components to be updated.
- The Ceph Daemon Upgrades section can be skipped as we will upgrade to Nautilus directly following the upgrade from release 0.9 to 1.0.
Upgrading from release 0.9 to 1.0
Manual steps for upgrading from a 0.9 release to a 1.0 release can be followed using this guide with some amendments below.
NOTE: This guide was created as of release 1.0.2.
Amendments (v1.0)
- The 1.0.2 release can be downloaded with the link https://github.com/rook/rook/archive/v1.0.2.tar.gz.
- In “Upgrade Process” 4. Wait for the upgrade to complete the tools pod will not get the
rook-version
label. - In “Upgrade Process” 6. Update the Mon Ports you must follow steps 1-5 for each mon waiting the full 5+ minutes for each mon failover before moving on to the next. The mons will follow the pattern
rook-ceph-mon0
rather thanrook-ceph-mon-a
as stated in the guide. - The Ceph Version Upgrades section must be completed. Replicated recommends the Ceph version
NEW_CEPH_IMAGE='ceph/ceph:v14.2.0-20190410'
.
Ceph Dashboard
In order to get the new Ceph dashboard running with Rook 1.0 the following steps must be taken.
Edit the
rook-ceph
CephCluster to enable the Ceph dashboard.Edit the
rook-ceph
CephCluster:kubectl -n $ROOK_NAMESPACE edit CephCluster rook-ceph
Add the following to the spec:
dashboard: enabled: true urlPrefix: /ceph port: 7000 ssl: false
Set the
CEPH_DASHBOARD_USER
andCEPH_DASHBOARD_PASSWORD
environment variables in thereplicated-ui
container of thereplicated
deployment.To obtain the
CEPH_DASHBOARD_PASSWORD
run the following:kubectl -n rook-ceph get secret rook-ceph-dashboard-password -o jsonpath="{['data']['password']}" | base64 --decode
Edit the
replicated
deploymentkubectl edit deploy replicated
Add the following to the
replicated-ui
containerenv
.- name: CEPH_DASHBOARD_USER value: admin - name: CEPH_DASHBOARD_PASSWORD value: "<the password>"