dtr troubleshooting: improve ping test docs

Signed-off-by: Trapier Marshall <trapier.marshall@docker.com>
This commit is contained in:
Trapier Marshall 2018-06-28 12:55:49 -04:00 committed by Joao Fernandes
parent c6d64230a0
commit 141dc80d33
4 changed files with 42 additions and 46 deletions

View File

@ -8,32 +8,31 @@ This guide contains tips and tricks for troubleshooting DTR problems.
## Troubleshoot overlay networks ## Troubleshoot overlay networks
High availability in DTR depends on having overlay networking working in UCP. High availability in DTR depends on swarm overlay networking. One way to test
One way to test if overlay networks are working correctly you can deploy if overlay networks are working correctly is to deploy containers to the same
containers in different nodes, that are attached to the same overlay network overlay network on different nodes and see if they can ping one another.
and see if they can ping one another.
Use SSH to log into a UCP node, and run: Use SSH to log into a node and run:
```none ```bash
docker run -it --rm \ docker run -it --rm \
--net dtr-ol --name overlay-test1 \ --net dtr-ol --name overlay-test1 \
--entrypoint sh docker/dtr --entrypoint sh docker/dtr
``` ```
Then use SSH to log into another UCP node and run: Then use SSH to log into another node and run:
```none ```bash
docker run -it --rm \ docker run -it --rm \
--net dtr-ol --name overlay-test2 \ --net dtr-ol --name overlay-test2 \
--entrypoint ping docker/dtr -c 3 overlay-test1 --entrypoint ping docker/dtr -c 3 overlay-test1
``` ```
If the second command succeeds, it means that overlay networking is working If the second command succeeds, it indicates overlay networking is working
correctly. correctly between those nodes.
You can run this test with any overlay network, and any Docker image that has You can run this test with any attachable overlay network and any Docker image
`sh` and `ping`. that has `sh` and `ping`.
## Access RethinkDB directly ## Access RethinkDB directly

View File

@ -8,32 +8,31 @@ This guide contains tips and tricks for troubleshooting DTR problems.
## Troubleshoot overlay networks ## Troubleshoot overlay networks
High availability in DTR depends on having overlay networking working in UCP. High availability in DTR depends on swarm overlay networking. One way to test
One way to test if overlay networks are working correctly you can deploy if overlay networks are working correctly is to deploy containers to the same
containers in different nodes, that are attached to the same overlay network overlay network on different nodes and see if they can ping one another.
and see if they can ping one another.
Use SSH to log into a UCP node, and run: Use SSH to log into a node and run:
```none ```bash
docker run -it --rm \ docker run -it --rm \
--net dtr-ol --name overlay-test1 \ --net dtr-ol --name overlay-test1 \
--entrypoint sh {{ page.dtr_org }}/{{ page.dtr_repo }} --entrypoint sh {{ page.dtr_org }}/{{ page.dtr_repo }}
``` ```
Then use SSH to log into another UCP node and run: Then use SSH to log into another node and run:
```none ```bash
docker run -it --rm \ docker run -it --rm \
--net dtr-ol --name overlay-test2 \ --net dtr-ol --name overlay-test2 \
--entrypoint ping {{ page.dtr_org }}/{{ page.dtr_repo }} -c 3 overlay-test1 --entrypoint ping {{ page.dtr_org }}/{{ page.dtr_repo }} -c 3 overlay-test1
``` ```
If the second command succeeds, it means that overlay networking is working If the second command succeeds, it indicates overlay networking is working
correctly. correctly between those nodes.
You can run this test with any overlay network, and any Docker image that has You can run this test with any attachable overlay network and any Docker image
`sh` and `ping`. that has `sh` and `ping`.
## Access RethinkDB directly ## Access RethinkDB directly

View File

@ -8,32 +8,31 @@ This guide contains tips and tricks for troubleshooting DTR problems.
## Troubleshoot overlay networks ## Troubleshoot overlay networks
High availability in DTR depends on having overlay networking working in UCP. High availability in DTR depends on swarm overlay networking. One way to test
One way to test if overlay networks are working correctly you can deploy if overlay networks are working correctly is to deploy containers to the same
containers in different nodes, that are attached to the same overlay network overlay network on different nodes and see if they can ping one another.
and see if they can ping one another.
Use SSH to log into a UCP node, and run: Use SSH to log into a node and run:
```none ```bash
docker run -it --rm \ docker run -it --rm \
--net dtr-ol --name overlay-test1 \ --net dtr-ol --name overlay-test1 \
--entrypoint sh {{ page.dtr_org }}/{{ page.dtr_repo }} --entrypoint sh {{ page.dtr_org }}/{{ page.dtr_repo }}
``` ```
Then use SSH to log into another UCP node and run: Then use SSH to log into another node and run:
```none ```bash
docker run -it --rm \ docker run -it --rm \
--net dtr-ol --name overlay-test2 \ --net dtr-ol --name overlay-test2 \
--entrypoint ping {{ page.dtr_org }}/{{ page.dtr_repo }} -c 3 overlay-test1 --entrypoint ping {{ page.dtr_org }}/{{ page.dtr_repo }} -c 3 overlay-test1
``` ```
If the second command succeeds, it means that overlay networking is working If the second command succeeds, it indicates overlay networking is working
correctly. correctly between those nodes.
You can run this test with any overlay network, and any Docker image that has You can run this test with any attachable overlay network and any Docker image
`sh` and `ping`. that has `sh` and `ping`.
## Access RethinkDB directly ## Access RethinkDB directly

View File

@ -8,12 +8,11 @@ This guide contains tips and tricks for troubleshooting DTR problems.
## Troubleshoot overlay networks ## Troubleshoot overlay networks
High availability in DTR depends on having overlay networking working in UCP. High availability in DTR depends on swarm overlay networking. One way to test
One way to test if overlay networks are working correctly you can deploy if overlay networks are working correctly is to deploy containers to the same
containers in different nodes, that are attached to the same overlay network overlay network on different nodes and see if they can ping one another.
and see if they can ping one another.
Use SSH to log into a UCP node, and run: Use SSH to log into a node and run:
```bash ```bash
docker run -it --rm \ docker run -it --rm \
@ -21,7 +20,7 @@ docker run -it --rm \
--entrypoint sh {{ page.dtr_org }}/{{ page.dtr_repo }} --entrypoint sh {{ page.dtr_org }}/{{ page.dtr_repo }}
``` ```
Then use SSH to log into another UCP node and run: Then use SSH to log into another node and run:
```bash ```bash
docker run -it --rm \ docker run -it --rm \
@ -29,11 +28,11 @@ docker run -it --rm \
--entrypoint ping {{ page.dtr_org }}/{{ page.dtr_repo }} -c 3 overlay-test1 --entrypoint ping {{ page.dtr_org }}/{{ page.dtr_repo }} -c 3 overlay-test1
``` ```
If the second command succeeds, it means that overlay networking is working If the second command succeeds, it indicates overlay networking is working
correctly. correctly between those nodes.
You can run this test with any overlay network, and any Docker image that has You can run this test with any attachable overlay network and any Docker image
`sh` and `ping`. that has `sh` and `ping`.
## Access RethinkDB directly ## Access RethinkDB directly