diff --git a/site/install/plugin/plugin-v2.md b/site/install/plugin/plugin-v2.md index be5ecb4d..19016a45 100644 --- a/site/install/plugin/plugin-v2.md +++ b/site/install/plugin/plugin-v2.md @@ -78,3 +78,4 @@ Or to start a container: * [Integrating Docker via the Network Plugin (Legacy)](/site/install/plugin/plugin.md) * [How the Weave Network Plugins Work](/site/install/plugin/plugin-how-it-works.md) + * [Troubleshooting the V2 plugin](/site/troubleshooting.md#v2plugin) diff --git a/site/kubernetes/kube-addon.md b/site/kubernetes/kube-addon.md index 9a5d2769..678ed08e 100644 --- a/site/kubernetes/kube-addon.md +++ b/site/kubernetes/kube-addon.md @@ -164,7 +164,7 @@ definition](http://kubernetes.io/docs/api-reference/extensions/v1beta1/definitio all multicast traffic) by adding `--allow-mcast=false` as an argument to `weave-npc` in the YAML configuration. -## Troubleshooting +## Troubleshooting The status of Weave Net can be checked by running its CLI commands. This can be done in various ways: diff --git a/site/troubleshooting.md b/site/troubleshooting.md index 03661925..7ade9e43 100644 --- a/site/troubleshooting.md +++ b/site/troubleshooting.md @@ -14,6 +14,7 @@ search_type: Documentation - [List attached containers](#list-attached-containers) * [Stopping Weave](#stop) * [Reboots](#reboots) + * [Troubleshooting the V2 plugin](#v2plugin) * [Snapshot Releases](#snapshots) ## Basic Diagnostics @@ -284,11 +285,32 @@ on reboot. This can be disabled via: weave launch --no-restart -Note that the Weave Net router will create the `weave` network bridge -if necessary when it restarts, and the [Weave Net Docker API -Proxy](/site/tasks/weave-docker-api/weave-docker-api.md) will re-attach any application -containers that it originally attached to the Weave network when they -restart. +Note that the Weave Net router creates the `weave` network bridge if +necessary when it restarts. The [Weave Net Docker API +Proxy](/site/tasks/weave-docker-api/weave-docker-api.md) then +re-attaches any application containers that it originally attached to +the Weave network when they restart. + +## Troubleshooting the V2 plugin + +If Weave Net is installed via `docker plugin install`, download the +`weave` script to run `weave status`, `weave ps` or `weave report` as +above. Install Weave Net by following the [install +instructions](/site/install/installing-weave.md). + +Docker "v2" plugins do run as containers, but at a lower level within +the Docker environment. Because of this, you cannot view them with +`docker ps`, `docker inspect`, etc. + +Do not run `weave launch`, `weave stop` or similar commands when using +this plugin; use the `docker plugin` commands instead. You can run +`weave reset`, but only after disabling the plugin via `docker plugin disable`. + +Diagnostic logs from the plugin go to the same place as the Docker +daemon, which will depend on your Linux install. For example, if it +uses `systemd`, then do this to view the Docker and plugin logs: + + sudo journalctl -u docker ## Snapshot Releases