From 63cbb34decf1b0ca1769bfeaea7a178fb885e0d8 Mon Sep 17 00:00:00 2001 From: Matthias Radestock Date: Fri, 15 Jul 2016 08:19:01 +0100 Subject: [PATCH 1/4] Make use of `sudo -s` more explicit since people keep tripping over that. Also - add new error message spat out by recent dockers correct the socket - URLs - they had fallen victim to a 'docker'->'Docker' replacement - shorten the note on using the plugin --- site/using-weave.md | 28 +++++++++++++++++++++++----- 1 file changed, 23 insertions(+), 5 deletions(-) diff --git a/site/using-weave.md b/site/using-weave.md index ccc76988..94bc8a27 100644 --- a/site/using-weave.md +++ b/site/using-weave.md @@ -29,12 +29,30 @@ Where, * The second line configures the Weave Net environment, so that containers launched via the Docker command line are automatically attached to the Weave network, and, * The third line runs the [application container](/site/faq.md#own-image) using [a Docker command](https://docs.docker.com/engine/reference/run/). ->**Note:** If the first command results in an error like - `http:///var/run/Docker.sock/v1.19/containers/create: dial unix - /var/run/Docker.sock: permission denied. Are you trying to connect to a TLS-enabled daemon without TLS?` then you likely need to be 'root' in order to connect to the Docker daemon. If so, run the above and all subsequent commands in a *single* root shell (e.g. one created with `sudo -s`). Do *not* prefix individual commands with `sudo`, since some commands modify environment entries and hence they all need to be executed from the same shell. - +If the first command results in an error like ->**Important!** if you are running the Weave Docker Network Plugin do not run `eval $(weave env)`. See [Using the Weave Net Docker Network Plugin](/site/plugin.md) for more information. + Cannot connect to the Docker daemon. Is the docker daemon running on this host? + +or + + http:///var/run/docker.sock/v1.19/containers/create: dial unix/var/run/docker.sock: permission denied. Are you trying to connect to a TLS-enabled daemon without TLS? + +then you likely need to be 'root' in order to connect to the Docker +daemon. If so, run the above and all subsequent commands in a +*single* root shell: + + host1$ sudo -s + host1# weave launch + host1# eval $(weave env) + host1# docker run --name a1 -ti weaveworks/ubuntu + +Do *not* prefix individual commands with `sudo`, since some commands +modify environment entries and hence they all need to be executed from +the same shell. + +> **Important!** If you intend to use the +> [Weave Docker Network Plugin](/site/plugin.md) do not run `eval +> $(weave env)`. Weave Net must be launched once per host. The relevant container images will be pulled down from Docker Hub on demand during `weave launch`. From 3755906689ba99dc40455ad8818926acaa7a4a9d Mon Sep 17 00:00:00 2001 From: Matthias Radestock Date: Wed, 20 Jul 2016 06:22:30 +0100 Subject: [PATCH 2/4] blockquote sudo-ing --- site/using-weave.md | 40 ++++++++++++++++++++-------------------- 1 file changed, 20 insertions(+), 20 deletions(-) diff --git a/site/using-weave.md b/site/using-weave.md index 94bc8a27..e8096acd 100644 --- a/site/using-weave.md +++ b/site/using-weave.md @@ -29,26 +29,26 @@ Where, * The second line configures the Weave Net environment, so that containers launched via the Docker command line are automatically attached to the Weave network, and, * The third line runs the [application container](/site/faq.md#own-image) using [a Docker command](https://docs.docker.com/engine/reference/run/). -If the first command results in an error like - - Cannot connect to the Docker daemon. Is the docker daemon running on this host? - -or - - http:///var/run/docker.sock/v1.19/containers/create: dial unix/var/run/docker.sock: permission denied. Are you trying to connect to a TLS-enabled daemon without TLS? - -then you likely need to be 'root' in order to connect to the Docker -daemon. If so, run the above and all subsequent commands in a -*single* root shell: - - host1$ sudo -s - host1# weave launch - host1# eval $(weave env) - host1# docker run --name a1 -ti weaveworks/ubuntu - -Do *not* prefix individual commands with `sudo`, since some commands -modify environment entries and hence they all need to be executed from -the same shell. +> **Note** If the first command results in an error like +> ``` +> Cannot connect to the Docker daemon. Is the docker daemon running on this host? +> ``` +> or +> ``` +> http:///var/run/docker.sock/v1.19/containers/create: dial unix/var/run/docker.sock: permission denied. Are you trying to connect to a TLS-enabled daemon without TLS? +> ``` +> then you likely need to be 'root' in order to connect to the Docker +> daemon. If so, run the above and all subsequent commands in a +> *single* root shell: +> ``` +> host1$ sudo -s +> host1# weave launch +> host1# eval $(weave env) +> host1# docker run --name a1 -ti weaveworks/ubuntu +> ``` +> Do *not* prefix individual commands with `sudo`, since some commands +> modify environment entries and hence they all need to be executed from +> the same shell. > **Important!** If you intend to use the > [Weave Docker Network Plugin](/site/plugin.md) do not run `eval From 25e7868cd59904fb8909f9dc11c4248e5689331f Mon Sep 17 00:00:00 2001 From: Matthias Radestock Date: Wed, 20 Jul 2016 07:03:17 +0100 Subject: [PATCH 3/4] fix some indentation in docs block quote --- site/using-weave.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/site/using-weave.md b/site/using-weave.md index e8096acd..58200316 100644 --- a/site/using-weave.md +++ b/site/using-weave.md @@ -31,20 +31,20 @@ Where, > **Note** If the first command results in an error like > ``` -> Cannot connect to the Docker daemon. Is the docker daemon running on this host? +> Cannot connect to the Docker daemon. Is the docker daemon running on this host? > ``` > or > ``` -> http:///var/run/docker.sock/v1.19/containers/create: dial unix/var/run/docker.sock: permission denied. Are you trying to connect to a TLS-enabled daemon without TLS? +> http:///var/run/docker.sock/v1.19/containers/create: dial unix/var/run/docker.sock: permission denied. Are you trying to connect to a TLS-enabled daemon without TLS? > ``` > then you likely need to be 'root' in order to connect to the Docker > daemon. If so, run the above and all subsequent commands in a > *single* root shell: > ``` -> host1$ sudo -s -> host1# weave launch -> host1# eval $(weave env) -> host1# docker run --name a1 -ti weaveworks/ubuntu +> host1$ sudo -s +> host1# weave launch +> host1# eval $(weave env) +> host1# docker run --name a1 -ti weaveworks/ubuntu > ``` > Do *not* prefix individual commands with `sudo`, since some commands > modify environment entries and hence they all need to be executed from From f6e6926171c8819ba1296fe7bb9984cd04323fa9 Mon Sep 17 00:00:00 2001 From: Matthias Radestock Date: Wed, 20 Jul 2016 07:09:09 +0100 Subject: [PATCH 4/4] cosmetic: fix wrapped quote apparently our wp md renderer does not handle this correctly --- site/using-weave.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/site/using-weave.md b/site/using-weave.md index 58200316..f71de569 100644 --- a/site/using-weave.md +++ b/site/using-weave.md @@ -51,8 +51,7 @@ Where, > the same shell. > **Important!** If you intend to use the -> [Weave Docker Network Plugin](/site/plugin.md) do not run `eval -> $(weave env)`. +> [Weave Docker Network Plugin](/site/plugin.md) do not run `eval $(weave env)`. Weave Net must be launched once per host. The relevant container images will be pulled down from Docker Hub on demand during `weave launch`.