Adds documentation for deugging a remote Brooklyn instance

JAVA_OPTS isn't set in the shell before running the brooklyn script, it's set explicitly in the script:
https://github.com/apache/incubator-brooklyn/blob/master/usage/dist/src/main/dist/bin/brooklyn#L32-L35