From 75dcff3b9d227b64e5fee3041dd6c97fb9d7b9ba Mon Sep 17 00:00:00 2001
From: Adam Spiers <aspiers@suse.com>
Date: Fri, 25 Mar 2016 13:13:05 +0000
Subject: [PATCH] Clarify risks of not using shared storage

Make it clearer what the risks of not using shared storage are.
Information is based on:

  http://docs.openstack.org/user-guide-admin/cli_nova_evacuate.html

which says "The command rebuilds the instance from the original image or
volume" but later says that "To preserve the user disk data on the
evacuated server, deploy Compute with a shared file system" and then use
--on-shared-storage.

Change-Id: I09600414eb0d7fff1cf301b11b3fa9a76fc08c77
---
 ocf/NovaCompute  | 7 ++++++-
 ocf/NovaEvacuate | 7 ++++++-
 2 files changed, 12 insertions(+), 2 deletions(-)

diff --git a/ocf/NovaCompute b/ocf/NovaCompute
index fde9c26..3946c9b 100644
--- a/ocf/NovaCompute
+++ b/ocf/NovaCompute
@@ -120,7 +120,12 @@ This option should be used with caution.
 
 <parameter name="no_shared_storage" unique="0" required="0">
 <longdesc lang="en">
-Disable shared storage recovery for instances. Use at your own risk!
+Indicate that nova storage for instances is not shared across compute
+nodes. This must match the reality of how nova storage is configured!
+Otherwise VMs could end up in error state upon evacuation. When
+storage is non-shared, instances on dead hypervisors will be rebuilt
+from their original image or volume, so anything on ephemeral storage
+will be lost.
 </longdesc>
 <shortdesc lang="en">Disable shared storage recovery for instances</shortdesc>
 <content type="boolean" default="0" />
diff --git a/ocf/NovaEvacuate b/ocf/NovaEvacuate
index c5195c6..0fcd041 100644
--- a/ocf/NovaEvacuate
+++ b/ocf/NovaEvacuate
@@ -120,7 +120,12 @@ This option should be used with caution.
 
 <parameter name="no_shared_storage" unique="0" required="0">
 <longdesc lang="en">
-Disable shared storage recovery for instances. Use at your own risk!
+Indicate that nova storage for instances is not shared across compute
+nodes. This must match the reality of how nova storage is configured!
+Otherwise VMs could end up in error state upon evacuation. When
+storage is non-shared, instances on dead hypervisors will be rebuilt
+from their original image or volume, so anything on ephemeral storage
+will be lost.
 </longdesc>
 <shortdesc lang="en">Disable shared storage recovery for instances</shortdesc>
 <content type="boolean" default="0" />