From 2fe82ce0220e9fd02f51d732443a82e0b5adcbc4 Mon Sep 17 00:00:00 2001
From: Olena Logvinova <ologvinova@mirantis.com>
Date: Wed, 18 May 2016 18:09:07 +0300
Subject: [PATCH] [UG] Change configuration drive format

This patch adds steps how to change the
configuration drive format through Fuel CLI.

backport: mitaka

Change-Id: I3722ef4ca9965ac7e69e818d021bc06feb05530f
Closes-Bug: #1563722
---
 .../fuel-user-guide/configure-environment.rst |  1 +
 .../config-drive-format.rst                   | 40 +++++++++++++++++++
 2 files changed, 41 insertions(+)
 create mode 100644 userdocs/fuel-user-guide/configure-environment/config-drive-format.rst

diff --git a/userdocs/fuel-user-guide/configure-environment.rst b/userdocs/fuel-user-guide/configure-environment.rst
index 67d1fc550..35739f45d 100644
--- a/userdocs/fuel-user-guide/configure-environment.rst
+++ b/userdocs/fuel-user-guide/configure-environment.rst
@@ -33,6 +33,7 @@ This section includes the following topics:
    configure-environment/map-logical-to-physical-nic.rst
    configure-environment/verify-networks.rst
    configure-environment/customize-partitions.rst
+   configure-environment/config-drive-format.rst
    configure-environment/settings.rst
    configure-environment/dns-ntp-support.rst
 
diff --git a/userdocs/fuel-user-guide/configure-environment/config-drive-format.rst b/userdocs/fuel-user-guide/configure-environment/config-drive-format.rst
new file mode 100644
index 000000000..946e818d1
--- /dev/null
+++ b/userdocs/fuel-user-guide/configure-environment/config-drive-format.rst
@@ -0,0 +1,40 @@
+.. _config-drive-format:
+
+Change the configuration drive format
+-------------------------------------
+
+For legacy reasons, Fuel uses the VFAT configuration drive format which is the
+default option for live migration. But as the default format of the
+configuration drive for OpenStack environments is ISO 9660, you can change the
+VFAT to the ISO 9660 format using the ``config_drive_format`` option.
+
+**To change the configuration drive format using Fuel CLI:**
+
+#. Log in to the Fuel Master node CLI.
+#. Download the configuration files:
+
+   .. code-block:: console
+
+     fuel --env=<env_ID> deployment --default
+
+   The default deployment information is downloaded to
+   ``/<cwd>/deployment_<env_ID>``.
+
+#. Edit *every* ``<node-id>.yaml`` file:
+
+   #. Find or add the ``compute`` section to the ``<node-id>.yaml`` file.
+   #. In this section, add the following parameter:
+
+      .. code-block:: console
+
+        compute:
+         config_drive_format option: iso9660
+
+#. Upload the updated configuration files to the ``/<cwd>/deployment_<env_ID>``
+   directory:
+
+   .. code-block:: console
+
+     fuel --env=<env_ID> deployment --upload
+
+   Now, you can proceed with the environment deployment.
\ No newline at end of file