docker logs in troubleshooting

- troubleshooting now in own section

1 files changed, 11 insertions, 6 deletions

diff --git a/docker/README.md b/docker/README.md
index 1f5cb68e07c..31766259365 100644
--- a/docker/README.md
+++ b/docker/README.md
@@ -6,17 +6,12 @@
 
 *On Linux, the default storage device is devicemapper with loopback device and max 10GB container size. This size is too small for a full build. Please see [here](http://www.projectatomic.io/blog/2016/03/daemon_option_basedevicesize/) and [here](http://www.projectatomic.io/blog/2015/06/notes-on-fedora-centos-and-docker-storage-drivers/) to overcome this limitation.*
 
+
 ## Building the Vespa RPM
 Execute ```./build-vespa.sh <Vespa version number>``` to build Vespa from this source code.
 
 The produced rpms will be available in this folder after compiliation.
 
-### Troubleshooting
-If the build fails, start from scratch: ```docker rmi -f vesparun vespabuild``` - then build again. Clean local docker if docker image disk full:
-- ```docker rm -v $(docker ps -a -q -f status=exited)```
-- ```docker rmi $(docker images -f "dangling=true" -q)```
-
-_Directory renamed before its status could be extracted_ can be caused by [1219](https://github.com/docker/for-mac/issues/1219) - workaround (from the issue): "It may be an overlay storage driver issue - you can add ```{"storage-driver":"aufs"}``` in the advanced daemon preferences pane and see if that makes a difference."
 
 ## Running Vespa
 Execute ```./run-vespa.sh <Vespa version number>``` to start Vespa.
@@ -25,8 +20,18 @@ This will create a Docker image which has the rpms from the build step (or downl
 
 *On OS X, the container runs inside the Docker VM. Execute ```docker-machine ssh vespa-docker-machine``` to enter the VM. The services can also be reached directly from the host on the IP given by ```docker-machine ip vespa-docker-machine```*
 
+
 ## Building Vespa inside a Docker container
 Execute ```./enter-build-container.sh``` to enter the Vespa build environment inside a Docker container.
 
 The container is entered at the root of the Vespa source repository. Follow the build sections in [README.md](https://github.com/yahoo/vespa/blob/master/README.md) to build and test.
 
+
+## Troubleshooting
+- Use ```docker logs CONTAINER``` for output - useful if the commands above fail
+
+- If the build fails, start from scratch: ```docker rmi -f vesparun vespabuild``` - then build again. Clean local docker if docker image disk full:
+    - ```docker rm -v $(docker ps -a -q -f status=exited)```
+    - ```docker rmi $(docker images -f "dangling=true" -q)```
+
+- _Directory renamed before its status could be extracted_ can be caused by [1219](https://github.com/docker/for-mac/issues/1219) - workaround (from the issue): "It may be an overlay storage driver issue - you can add ```{"storage-driver":"aufs"}``` in the advanced daemon preferences pane and see if that makes a difference."