The Docker Cloud Maker

View On GitHub


You can find below the most common issues (and their solutions) you may face when deploy entities provided by Clocker. For more general troubleshooting, please check out the general troubleshooting or AMP docs.

Persisted State

If you have previously run AMP or Brooklyn you may have to remove the persisted state these have saved on your machine. To do this, delete the folder ~/.brooklyn/brooklyn-persisted-state/ and all of it’s contents.

AWS VPC / Classic

It’s recommended that you use VPC mode to run Clocker within AWS. This is because problems have been recorded with DNS and starting instances withn AWS Classic. For more information on doing this, see the Brooklyn docs.

AWS 401 errors

If you are getting 401 response errors when trying to provision machines make sure that:

High CPU usage

After a few hours of management of a swarm or cluster, AMP or Brooklyn may start to suffer from high CPU and memory usage. This is because of a known issue in the Java garbage collection system. To fix this add the following to your AMP or Brooklyn:

Open bin/brooklyn and add -XX:SoftRefLRUPolicyMSPerMB=1 to the JAVA_OPTS line:

JAVA_OPTS="-Xms256m -Xmx2g -XX:MaxPermSize=256m -XX:SoftRefLRUPolicyMSPerMB=1"

Open bin/setenv and edit or add the following line to the start


RAM Usage

Launching Clocker within some environments may require RAM to be made available. This can be set to more than 2G by editing the following:

Open bin/brooklyn and change the line

JAVA_OPTS="-Xms256m -Xmx2g -XX:MaxPermSize=256m"

Open bin/setenv and edit or add the line to the start

export JAVA_MAX_MEM="2G"

Failed to find machine-unique group on node

This is caused because of a restrictive security group within your cloud. Add a new piece of config to your swarm or cluster in the form kubernetes.sharedsecuritygroup.create or swarm.sharedsecuritygroup.create and set this to false.

Then create a new security group in your cloud and specify this in your location using the securityGroups key.

For more information on setting up a location, see the Getting Started guide.