openstack/trove
Code Issues Proposed changes

Add instruction for upgrading trove guest agent

Browse Source 
Change-Id: I574f93d2023d35b2ede0e6e532a06ea1bdddad5f
This commit is contained in:
Lingxian Kong 2020-08-07 09:08:48 +12:00
parent cf3e9a6e74
commit 6b1c31e2ed
2 changed files with 21 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

1
doc/source/admin/index.rst
View File

@ -9,4 +9,5 @@
datastore
building_guest_images
secure_oslo_messaging
upgrade-trove-guest-agent
troubleshooting

20
doc/source/admin/upgrade-trove-guest-agent.rst Normal file
View File

@ -0,0 +1,20 @@
=========================
Trove guest agent upgrade
=========================
Normally, during Trove service upgrade, a new guest image needs to be rebuilt and used to rebuild the guest instance when the interfaces between Trove controller and guest agent change. Otherwise, the newer version Trove controller can't talk to the older version guest agent.
Prior to Victoria release, the process to upgrade guest agent is:
#. The cloud administrator builds a new guest image based on the target Trove code version.
#. The cloud user creates backup for their instance.
#. The cloud administrator upgrades Trove controller service.
#. The cloud administrator updates the existing datastore version using the new image.
#. The cloud user creates a new instance using the backup created above.
#. The cloud user deletes the old instance.
From Victoria release, the upgrade process is much simpler:
#. The cloud administrator builds a new guest image based on the target Trove code version.
#. The cloud administrator updates the existing datastore version using the new image.
#. The cloud administrator triggers rebuild for the existing instances using the new image.