Troubleshoot - hello world quickstart

Try this first

The Vamp hello world quickstart is a self contained testing package. If you run into problems or unexpected behaviour, we advise that you clear everything out and reinstall.

  1. Stop all running containers - for example using docker ps | awk '{print $1}' | xargs docker stop 2>/dev/null
  2. Clean up your docker environment (remove stopped containers, dangling images and volumes). A script to do this:

    docker rmi -f $(docker images -q -f dangling=true) 2>/dev/null
    
    echo "removing exited docker containers..."
    docker ps -a | grep 'Exited' | awk '{print $1}' | xargs docker rm
    docker ps -a | grep 'Created' | awk '{print $1}' | xargs docker rm
    
    echo "removing dangling docker volumes..."
    docker volume rm $(docker volume ls -qf dangling=true) 2>/dev/null `
    
  3. Restart docker machine using docker-machine restart.

  4. Reinstall Vamp hello world.

  5. If everything is installed ok and you’re running into problems using Vamp, check the troubleshooting tips for using Vamp.

Report an issue

If you’ve tried the above steps and are still stuck, then let us know. We accept bug reports and pull requests on the GitHub repo for each project (github.com - magneticio).

When reporting issues, please include the following details:

  • Description of issue.
  • Vamp info, from the API: GET <vamp url>/api/v1/info
  • Vamp config, from the API; GET <vamp url>/api/v1/config
  • Reproduction steps.
  • Which orchestrator are you using, DC/OS, Kubernetes, Rancher, etc.
  • Log output from Vamp and it’s various components. You can get these from the docker logs command on the relevant containers.
  • Any other information that you might consider important.

Did this help?

If you find some of the instructions not clear enough or lacking information, please raise an issue on GitHub.