diff --git a/devstack/upgrade/upgrade.sh b/devstack/upgrade/upgrade.sh
index 8f5ac9e040..de91a27661 100755
--- a/devstack/upgrade/upgrade.sh
+++ b/devstack/upgrade/upgrade.sh
@@ -51,6 +51,7 @@ set -o xtrace
 [[ -d $SAVE_DIR/etc.octavia ]] || cp -pr $OCTAVIA_CONF_DIR $SAVE_DIR/etc.octavia
 
 # Install the target octavia
+octavia_lib_install
 octavia_install
 
 # calls upgrade-octavia for specific release
diff --git a/doc/source/admin/guides/upgrade.rst b/doc/source/admin/guides/upgrade.rst
index c0a313b841..6fef161d5b 100644
--- a/doc/source/admin/guides/upgrade.rst
+++ b/doc/source/admin/guides/upgrade.rst
@@ -58,7 +58,10 @@ listeners, pools and members).
 
 #. Optional: Make a backup of the database.
 
-#. Upgrade all Octavia control plane nodes to the next release.
+#. Upgrade all Octavia control plane nodes to the next release. Remember to
+   also upgrade library dependencies (e.g. octavia-lib). If upgrading Octavia
+   from distribution packages, your system package manager is expected to
+   handle this automatically.
 
 #. Verify that all configuration option names are up-to-date with latest
    Octavia version. For example, pay special attention to deprecated