From 2341d753e2a3d7e202369572d42d715027b48bd3 Mon Sep 17 00:00:00 2001
From: Gabriela Cervantes <gabriela.cervantes.tellez@intel.com>
Date: Mon, 21 May 2018 06:14:17 -0500
Subject: [PATCH] docs: Add installation guide for SLES

This will add the installation guide for SLES.

Fixes #85

Signed-off-by: Gabriela Cervantes <gabriela.cervantes.tellez@intel.com>
---
 install/README.md                     |  1 +
 install/docker/sles-docker-install.md | 70 +++++++++++++++++++++++++++
 install/sles-installation-guide.md    | 34 +++++++++++++
 3 files changed, 105 insertions(+)
 create mode 100644 install/docker/sles-docker-install.md
 create mode 100644 install/sles-installation-guide.md

diff --git a/install/README.md b/install/README.md
index 3b26a239f..ba1934669 100644
--- a/install/README.md
+++ b/install/README.md
@@ -23,6 +23,7 @@ Select your preferred distribution or cloud service:
 * [Fedora](fedora-installation-guide.md)
 * [Red Hat](rhel-installation-guide.md)
 * [Ubuntu](ubuntu-installation-guide.md)
+* [SLES](sles-installation-guide.md)
 
 ### Cloud services
 
diff --git a/install/docker/sles-docker-install.md b/install/docker/sles-docker-install.md
new file mode 100644
index 000000000..497b793e9
--- /dev/null
+++ b/install/docker/sles-docker-install.md
@@ -0,0 +1,70 @@
+# Install Docker for Kata Containers on SLES
+
+> **Note:**
+>
+> - This guide assumes you have
+>   [already installed the Kata Containers packages](../sles-installation-guide.md).
+>
+> - If you do not want to copy or type all these instructions by hand, you can use the
+>   [`kata-manager`](https://github.com/kata-containers/tests/blob/master/cmd/kata-manager/kata-manager.sh)
+>   script to install the packaged system including your chosen container
+>   manager. Alternatively, you can generate a runnable shell script from
+>   individual documents using the
+>   [`kata-doc-to-script`](https://github.com/kata-containers/tests/blob/master/.ci/kata-doc-to-script.sh) script.
+
+1. Install the latest version of Docker with the following commands:
+
+   > **Note:** This step is only required if Docker is not installed on the system.
+
+   ```bash
+   $ sudo zypper -n install docker
+   ```
+
+   For more information on installing Docker please refer to the
+   [Docker Guide](https://www.suse.com/documentation/sles-12/singlehtml/book_sles_docker/book_sles_docker.html).
+
+2. Configure Docker to use Kata Containers with one of the following methods:
+
+   1. systemd
+
+       ```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 --containerd /run/containerd/containerd.sock --add-runtime kata-runtime=/usr/bin/kata-runtime --default-runtime=kata-runtime
+       EOF
+       ```
+
+   2. Docker `daemon.json`
+
+       Add the following definitions to `/etc/docker/daemon.json`:
+
+       ```json
+       {
+         "default-runtime": "kata-runtime",
+         "runtimes": {
+           "kata-runtime": {
+             "path": "/usr/bin/kata-runtime"
+           }
+         }
+       }
+       ```
+
+3. Restart the Docker systemd service with the following commands:
+
+   ```bash
+   $ sudo systemctl daemon-reload
+   $ sudo systemctl restart docker
+   ```
+
+4. Run Kata Containers
+
+   You are now ready to run Kata Containers:
+
+   ```bash
+   $ sudo docker run busybox uname -a
+   ```
+
+   The previous command shows details of the kernel version running inside the
+   container, which is different to the host kernel version.
diff --git a/install/sles-installation-guide.md b/install/sles-installation-guide.md
new file mode 100644
index 000000000..2d2135b28
--- /dev/null
+++ b/install/sles-installation-guide.md
@@ -0,0 +1,34 @@
+# Install Kata Containers on SLES
+
+> **Notes:**
+>
+> - Kata Containers packages are available for [openSUSE\*](https://www.opensuse.org/)
+>   version 43.2 (currently `x86_64` only).
+>
+> - If you are installing on a system that already has Clear Containers or `runv` installed,
+>   first read [the upgrading document](../Upgrading.md).
+>
+> - If you do not want to copy or type all these instructions by hand, you can use the
+>   [`kata-manager`](https://github.com/kata-containers/tests/blob/master/cmd/kata-manager/kata-manager.sh)
+>   script to install the packaged system including your chosen container
+>   manager. Alternatively, you can generate a runnable shell script from
+>   individual documents using the
+>   [`kata-doc-to-script`](https://github.com/kata-containers/tests/blob/master/.ci/kata-doc-to-script.sh) script.
+
+1. Install the Kata Containers components with the following commands:
+
+   > **Note:** This installation channel is not secure since the repository currently
+   > redirects download URLs to `http`.
+
+   ```bash
+   $ sudo -E zypper addrepo "http://download.opensuse.org/repositories/home:/katacontainers:/release/SLE_12_SP3/home:katacontainers:release.repo"
+   $ sudo -E zypper -n --no-gpg-checks install kata-runtime kata-proxy kata-shim
+   $ sudo mkdir -p /usr/libexec/kata-containers
+   $ sudo ln -s /usr/lib64/kata-containers/kata-proxy /usr/libexec/kata-containers/kata-proxy
+   $ sudo ln -s /usr/lib64/kata-containers/kata-shim /usr/libexec/kata-containers/kata-shim
+   ```
+
+2. Decide which container manager to use and select the corresponding link that follows:
+
+   - [Docker](docker/sles-docker-install.md)
+   - [Kubernetes](https://github.com/kata-containers/documentation/blob/master/Developer-Guide.md#run-kata-containers-with-kubernetes)