From 1d570b86220340efbbb41faac00994709b4cd070 Mon Sep 17 00:00:00 2001
From: MCamp859 <mary.camp@ptiglobal.net>
Date: Tue, 12 Jun 2018 20:16:33 -0400
Subject: [PATCH] Edits for branding and format.

Removed $ prompts. Moved links to end of file.
Updated tutorial.rst.

Signed-off-by: MCamp859 <mary.camp@ptiglobal.net>
---
 .../clear-linux/tutorials/kata_migration.rst  | 100 ++++++++++++++++++
 source/clear-linux/tutorials/tutorials.rst    |   1 +
 2 files changed, 101 insertions(+)
 create mode 100644 source/clear-linux/tutorials/kata_migration.rst

diff --git a/source/clear-linux/tutorials/kata_migration.rst b/source/clear-linux/tutorials/kata_migration.rst
new file mode 100644
index 00000000..6d41252a
--- /dev/null
+++ b/source/clear-linux/tutorials/kata_migration.rst
@@ -0,0 +1,100 @@
+.. _kata_migration:
+
+Migrate Clear Containers to Kata Containers\*
+#############################################
+
+`Clear Containers`_ and `Kata Containers`_ can co-exist in the same system.
+Both can be installed through the :file:`containers-virt bundle`. However, we
+recommend that you migrate to Kata Containers because Clear Containers is no
+longer maintained_ and will soon be deprecated on |CLOSIA|.
+
+This guide describes how to migrate to Kata Containers and assumes that:
+
+*  Clear Containers is on a Docker\* system.
+*  Kata Containers is installed. See :ref:`kata`.
+
+
+Stop Clear Containers instances
+*******************************
+
+As an unprivileged user, stop all running instances of Clear Containers:
+
+.. code-block:: bash
+
+    for container in $(sudo docker ps -q); do sudo docker stop $container; done
+
+
+Manually migrate customized configuration files
+***********************************************
+
+If you have made changes to your `Clear Containers configuration`_, review
+those changes and decide whether to manually apply those changes to your
+`Kata Containers configuration`_.
+
+Make any required changes before continuing this process.
+
+.. note::
+
+  You do not need to manually remove any Clear Containers packages.
+
+Disable Clear Containers manager configuration
+**********************************************
+
+Remove the Clear Containers configuration file: 
+
+.. code-block:: bash
+
+    sudo rm /etc/systemd/system/docker.service.d/clear-containers.conf
+
+Enable Kata Containers as default
+*********************************
+
+#. Configure Docker to use the Kata Containers runtime by default.
+
+   .. code-block:: bash
+
+      sudo mkdir -p /etc/systemd/system/docker.service.d/
+      cat <<EOF | sudo tee /etc/systemd/system/docker.service.d/kata-containers.conf
+      [Service]
+      ExecStart=
+      ExecStart=/usr/bin/dockerd -D --add-runtime kata-runtime=/usr/bin/kata-runtime --default-runtime=kata-runtime
+      EOF
+
+#. Restart the Docker systemd services.
+
+   .. code-block:: bash
+
+      sudo systemctl daemon-reload
+      sudo systemctl restart docker
+
+#. Verify Docker is using Kata Containers.
+
+   .. code-block:: bash
+
+      sudo docker info | grep -i 'default runtime'
+      Default Runtime: kata-runtime
+
+Run Kata Containers
+*******************
+
+Use the following command: 
+
+.. code-block:: bash
+
+   sudo docker run -ti busybox sh
+
+**Congratulations!**
+
+You've successfully migrated from Clear Containers to Kata Containers.
+
+
+.. _Clear Containers: https://github.com/clearcontainers
+
+.. _Kata Containers: https://github.com/kata-containers
+
+.. _maintained: https://github.com/kata-containers/documentation/blob/master/Upgrading.md#maintenance-warning
+
+.. _Clear Containers configuration: https://github.com/clearcontainers/runtime#configuration
+
+.. _Kata Containers configuration: https://github.com/kata-containers/runtime#configuration
+
diff --git a/source/clear-linux/tutorials/tutorials.rst b/source/clear-linux/tutorials/tutorials.rst
index 3cbb1f17..209dc3b0 100644
--- a/source/clear-linux/tutorials/tutorials.rst
+++ b/source/clear-linux/tutorials/tutorials.rst
@@ -20,3 +20,4 @@ specific |CLOSIA| use cases.
    telemetry-backend/telemetry-backend
    smb/smb
    spark
+   kata_migration