diff --git a/docs/source/advanced/docker/lifecycle_management.rst b/docs/source/advanced/docker/lifecycle_management.rst index cd3385d20..7b9a17b8e 100644 --- a/docs/source/advanced/docker/lifecycle_management.rst +++ b/docs/source/advanced/docker/lifecycle_management.rst @@ -5,7 +5,7 @@ The Docker linux container technology is currently very popular. xCAT can help m This document describes how to use xCAT for docker management, from Docker Host setup to docker container operationis. -**Note:** The document is based on **Docker Version 1.10.x** and **Docker API version 1.22.** And the Docker Host is based on **ubuntu14.04.3 x86_64**. At the time of this writing (February 2016), docker host images are not available for **ppc64** architecture from docker.org. You can search online to find them or build your own. +**Note:** The document was verified with **Docker Version 1.10, 1.11** and **Docker API version 1.22.** The Docker Host was verified on **ubuntu14.04.3 x86_64**, **ubuntu15.10 x86_64** and **ubuntu16.04 x86_64**. At the time of this writing (February 2016), docker host images are not available for **ppc64el** architecture from docker.org. You can follow instructions at the end of this page on how to manually download and install it. Setting up Docker Host ---------------------- @@ -94,7 +94,6 @@ After the dockerhost is ready, a docker instance can be managed through xCAT com dockernics=mynet0 groups=docker,all ip=10.0.120.1 - mac=02:42:0a:00:78:01 mgt=docker postbootscripts=otherpkgs postscripts=syslog,remoteshell,syncfiles @@ -107,7 +106,7 @@ Create docker instance `````````````````````` :: - mkdocker [image= [command=] [dockerflag=]] + mkdocker image= [command=] [dockerflag=]] * node - The node object which represents the docker instance * image - The image name that the docker instance will use @@ -173,3 +172,46 @@ Check docker instance status :: rpower state + +Download and configure docker host on ppc64el +-------------------------- + +Download docker engine for ppc64el +:: + + wget http://launchpadlibrarian.net/251622081/docker.io_1.10.3-0ubuntu4_ppc64el.deb -O /install/docker_ppc64el/docker.io_1.10.3-0ubuntu4_ppc64el.deb + +Follow instructions above for **x86_64** setup with the following exceptions: + +Docker host node definition **otherpkgdir** should be +:: + + otherpkgdir=/install/docker_ppc64el + +Contents of **otherpkglist** file should be +:: + + docker.io + +Troubleshooting +-------------------------- + +If things go wrong: + +* After dockerhost node boots, check contents of **/var/log/xcat/xcat.log** file on the dockerhost for errors. + +* Verify **nicname** specified in **Preparing setup trust connection for docker service and create docker network object** section exists on the docker host. Depending on the version of Ubuntu OS and host architecture, it could be **eth0**, or **em1**, or **eno1**, or **enp0s1**. Verify by running on the dockerhost +:: + + ip addr show dev + +* Run **ps -ef | grep docker** to verify docker engine is running with configured options. It should look something like +:: + + root 3703 1 0 Apr15 ? 00:12:28 /usr/bin/docker daemon -H unix:///var/run/docker.sock -H tcp://host01:2375 --tls --tlscacert=/root/.docker/ca-cert.pem --tlscert=/root/.docker/dockerhost-cert.pem --tlskey=/root/.docker/dockerhost-cert.pem --tlsverify=true --raw-logs + +If the output is missing some options, verify that file **/lib/systemd/system/docker.service** contains the following lines +:: + + EnvironmentFile=-/etc/default/docker + ExecStart=/usr/bin/docker daemon $DOCKER_OPTS -H fd:// diff --git a/xCAT/postscripts/setupdockerhost b/xCAT/postscripts/setupdockerhost index 1babeaaa1..3e252b799 100755 --- a/xCAT/postscripts/setupdockerhost +++ b/xCAT/postscripts/setupdockerhost @@ -17,10 +17,35 @@ if [ "$(uname -s|tr 'A-Z' 'a-z')" = "linux" ];then fi if [[ "$OSVER" != ubuntu* ]]; then - echo "Sorry, only ubuntu have been verified at present" + echo "OS = $OSVER: Setup of Docker host is currently supported only on Ubuntu." exit 1 fi +if [[ "$ARCH" == "x86_64" ]]; then + # Check if docker-engine is installed + dpkg -l docker-engine + if [ $? -ne 0 ]; then + echo "Can not detect docker-engine installation." + exit 1 + fi +fi + +if [[ "$ARCH" == "ppc64el" ]]; then + # Check if docker.io is installed + dpkg -l docker.io + if [ $? -ne 0 ]; then + echo "Can not detect docker.io installation." + exit 1 + fi +fi + +# Docker is installed, check that it is running +docker info +if [ $? -ne 0 ]; then + echo "Docker is not running, Trying to restart." + service docker start +fi + DOCKER_VERSION=`docker info 2>/dev/null | grep "Server Version:" | awk -F: '{print $2}'` if [ -z "$DOCKER_VERSION" ];then echo "Failed to get docker server version" @@ -42,7 +67,7 @@ mask="" gateway="" nicname="" -if [ $# -ne 1]; then +if [ $# -ne 1 ]; then echo "Usage error, must in the format '$0 netname=net/mask@gateway[:nicname]'" exit 1 else @@ -120,7 +145,10 @@ else fi #Restart docker service -service docker restart +service docker stop +sleep 2 +systemctl daemon-reload +service docker start # It is found that sometimes the docker ps will failed if run immediately after restart docker daemon sleep 2 docker ps