BROOKLYN-212: more improvements

- Resizable.resize: throw InsufficientCapacityException if didn’t
  manage to reach target size, rather than only if didn’t manage to
  increase in size at all.
- DynamicCluster: delete nodes that throw NoMachinesAvailableException,
  rather than putting them in quarantine.
- Fix AutoScalerPolicy’s max-capacity high-water mark, when
  resizeUpStabilizationDelay is used.

AutoScaler test: remove unnecessary timeout config

succeedsEventually calls can just use the default timeout (unless it’s
a performance test where it must complete in a faster time!)

BROOKLYN-212: AutoScaling doesn’t retry if InsufficientCapacity

- Adds Resizable.InsufficientCapacityException, thrown by
  Resizable.resize() if could not grow at all.
- DynamicCluster catches NoMachinesAvailableException, and rethrows
  as InsufficientCapacityException in resize().
- AutoScalerPolicy catches InsufficientCapacityException, and sets
  insufficientCapacityHighWaterMark to record the max size it can get
  to. Does not try again to resize above that, unless the highWaterMark
  is explicitly cleared by reconfiguring that config value.
- Tests:
  - Changes TestCluster to include history of sizes and desiredSizes
  - Changes TestCluster, so can throw InsufficientCapacityException
    when gets to a particular size.
  - Test for DynamicCluster throwing InsufficientCapacityException
  - Test for AutoScalerPolicyMetricTest, to not resize above the failure
    level again.
  - Test for AutoScalerPolicyNoMoreMachinesTest, for when BYON location
    has run out of machines in a DynamicCluster.

Asserts: expectedFailureOfType checks caused-by as well

This closes #1115

This closes #1139

Remove karaf-features auto-generated dependencies.xml

This closes #1137

BROOKLYN-214: fix cancelling of AttributeWhenReady task

This closes #1133

BROOKLYN-213 Fix localhost external IP loader

[BROOKLYN-183] Remove dangling file

The real stuff is karaf/src/feature/feature.xml

[BROOKLYN-183] Remove karaf dependencies.xml from git

The dependencies.xml file can be used to track dependency changes for
karaf features. For this reason it has to be added to the git repository
so such changes can be detected between commits.

However, developers complained about having this file on git, since it
confusingly keeps showing up in commits. Also, at this stage this
tracking is unnecessary.

BROOKLYN-214: fix cancelling of AttributeWhenReady task

This closes #1134

Expose BrooklynFeatureEnablement.setDefault

add LoopOverGroupMembersTestCase & TargetableTestComponent. Should have been in previous commit but were excluded due to re-org

Remove discontinued IP lookup service - BROOKLYN-213

The IP lookup service http://www.telize.com/ip was discontinued on the 15th of November 2015.

Fix LocalhostExternalIpLoader blocking - BROOKLYN-213

Lookups will now block until the first successful resolve attempt or all services have been tried.

fixes for restructured directory

Added new components to documentation

Added LoopOverGroupMembersTestCase. Removed some targeting functionality from BaseTest and added it to a new Interface called TargetabeTestComponent
Made TestCase and ParallelTestCase TargetabeTestComponent
InfrastructureDeploymentTestCaseImpl can now deploy multiple specs
TestEffector will now check assertions
InfrastructureDeploymentTestCaseImpl made more resilient

This closes #1120

This closes #1129

Fix getRequiredOpenPorts in SameServerDriverLifecycleEffectorTasks

This closes #1126

Fix docs typo

Fix getRequiredOpenPorts in SameServerDriverLifecycleEffectorTasks

Previously any entity config with a value that TypeCoercions could coerce
to PortRange was included in the list of ports.

Fix docs typo

This closes #1116

"Getting Started" with CLI documentation updates - for review.

Merge pull request #2 from aledsage/googlielmo/feature/deferred-supplier-persistence-aled

More yaml AttributeWhenReady tests

More yaml AttributeWhenReady tests

Address comments

This closes #1121

This closes #1122

Test AWR value is not leaked in the persistent state

- set test-cluster sensor `sensor` e.g. to `foo` and then ensure that
  `foo` is not being written

Add new test for attributeWhenReady in EntitySpec

 - tests ATW is persisted correctly while a task is waiting for its value
 - rebase to master

Address comments

- sanity check on serialized value
- set up test for attributeWhenReady in entity spec (not working ATM see
  FIXME comment)

Test correct persistence of attributeWhenReady

Update for using a file for complex / multi-line invoke parameter values.

Update command to examine policy to be more succinct by using its ID.

Update documentation notes on cluster size.

Some fixes to quotation style.

Updated to remove catalog related remarks.

Maybe restore this when we update the catalog pages with the new registry commands.

Fix `VaultAppIdExternalConfigSupplier` dynamic constructor

Removing previous "Getting Started" pages.

Updates following Scott's comments.

Policy updates.

Updated blueprint-cli and managing-cli.

Initial copy of cli docs.

move cli docs from #1118 to reorg structure

This closes #1118

This closes #1119

[DIST] fix url in readme

[ALL] keep version properties in one place

in server/pom.xml (inherited by parent) for most things, but library/pom.xml for software

[DIST]  put a minimal README in the dist (instead of the "historical repo" readme!)

[JCLOUDS] fix unit test so it uses empty context and runs much faster

[ALL] comment about relativePath in pom

and prevent root from misbehaving if their is a pom in its parent dir

[SERVER] fix load of JS UI in BrooklynJavascriptGuiLauncher

[ALL]  pom hints for eclipse to exclude certain maven build steps

prevents errors when opening project in eclipse

Add CLI documentation to the Operations Guide

941b427: Includes CLI Reference Guide and Usage Guide
c6daba9: Provide info and links between Server CLI and Client CLI docs
dfc6799: Updates for typo errors

[SPLITPREP] apply version reversion in missed places, and add BROOKLY_VERSION label for script to work in future

[SPLITPREP] revert version to 0.9.0-SNAPSHOT

[DIST] reparent the downstream project so it doesn't get rat check, plus comments

[DIST] revert parent updates and move archetype to last built module (currently failing Rat)

[LIBRARY] move camp webapp related tests from software-webapp to qa module
adding them to software-webapp had introduced a dependency on software-database

[LIBRARY] add database dependency for camp tests

[SERVER] use catalog entities from software-base in rest-server tests
removes dependency on software-library submodule repo

[UI] fix jasmine tests
copies rest-api fixtures from brooklyn-server submodule repo

[SERVER] [LIBRARY] fix/move rest-server and camp-brooklyn tests
*note* this includes an update to VersionResourceTest.java to disable the version test, due to the use of the dummy 0.9.SPLITWIP-SNAPSHOT version and must be reverted before merging

[ALL]  update README file in each repo to be appropriate to that repo, with building instructions

[UBER]  add pom in brooklyn uber project subdir to build everything

it's the same as the pom in the root, but referring to ../ for submodules

[SERVER]  fix rat violations

one in the proxy ssl config replacement test file,
the other in README.md (but curiously only for library, not for server/README.md)

[SERVER] updated BrooklynJavascriptGuiLauncherTest to use a non brooklyn-library test entity

[SERVER] [LIBRARY] [DIST] multiple pom updates to pull brooklyn-parent via relative path to brooklyn-server repo, added dist and a root pom to build the all modules that are built in the pre-split incubator-brooklyn repo

Conflicts:
pom.xml - versions removed in root, hazelcast version updated in PR's; new version applied to server/library poms

[SERVER] [UI] moved BrooklynJavascriptGuiLauncher from ui to server repo, relative paths updated, tested in both IntelliJ and Eclipse

[LIBRARY] switch back to using brooklyn-parent

[SERVER] minor fixes to existing poms

[SERVER] [LIBRARY] moved missing resources and fixed CAMP tests moved in 7007c65

[SERVER] [UNDO HACK] readded test deps after fixing/moving tests - undoes commit 906ad0c

[SERVER] replaced ProxySslConfig with a dummy POJO

[SERVER] [LIBRARY] moved webapp related CAMP tests to brooklyn-library

[LIBRARY] added root brooklyn-library pom (dumb copy of incubator-brooklyn root and parent), updated submodule poms. This currently builds successfully after brooklyn-server

[LIBRARY] removed brooklyn-dist depdency

Conflicts:
brooklyn-library/qa/pom.xml -- added rat exclude for README in downstream

[SERVER] [HACK] commented out dependencies on test jars to allow use of -Dmaven.test.skip=true, even though tests are being skipped the test jars are considered during buildplan creation which causes the build to fail. At this point in the repo-fix some tests fail to compile so we need to exclude them, they will be fixed for the split, *but* it should be possible to build Brooklyn without test jars having been generated imho.

[SERVER] delete dependencies on software-* jars from brooklyn-library repo

[SERVER] omit jsgui feature from launcher build (no code update)

[SERVER] omit jsgui feature from karaf

[SERVER] simple pom.xml updates post-reorg

[SPLITPREP] brookly version 0.9.SPLITWIP-SNAPSHOT  for test purposes

[LIBRARY] fix GeoDns test

[SPLITPREP] move more PR items to the right place

Merge commit 'e430723' into reorg2

Newer PR's moved to the right place.

Conflicts:
brooklyn-library/sandbox/nosql/src/main/java/org/apache/brooklyn/entity/nosql/hazelcast/HazelcastCluster.java
brooklyn-library/sandbox/nosql/src/main/java/org/apache/brooklyn/entity/nosql/hazelcast/HazelcastClusterImpl.java
brooklyn-library/sandbox/nosql/src/main/java/org/apache/brooklyn/entity/nosql/hazelcast/HazelcastNode.java
brooklyn-library/sandbox/nosql/src/main/java/org/apache/brooklyn/entity/nosql/hazelcast/HazelcastNodeDriver.java
brooklyn-library/sandbox/nosql/src/main/java/org/apache/brooklyn/entity/nosql/hazelcast/HazelcastNodeImpl.java
brooklyn-library/sandbox/nosql/src/main/java/org/apache/brooklyn/entity/nosql/hazelcast/HazelcastNodeSshDriver.java
brooklyn-library/sandbox/nosql/src/main/resources/org/apache/brooklyn/entity/nosql/hazelcast/hazelcast-brooklyn.xml
brooklyn-library/sandbox/nosql/src/test/java/org/apache/brooklyn/entity/nosql/hazelcast/HazelcastClusterEc2LiveTest.java
brooklyn-library/sandbox/nosql/src/test/java/org/apache/brooklyn/entity/nosql/hazelcast/HazelcastClusterSoftlayerLiveTest.java
sandbox/nosql/src/main/java/org/apache/brooklyn/entity/nosql/hazelcast/HazelcastCluster.java
sandbox/nosql/src/main/java/org/apache/brooklyn/entity/nosql/hazelcast/HazelcastClusterImpl.java
sandbox/nosql/src/main/java/org/apache/brooklyn/entity/nosql/hazelcast/HazelcastNode.java
sandbox/nosql/src/main/java/org/apache/brooklyn/entity/nosql/hazelcast/HazelcastNodeDriver.java
sandbox/nosql/src/main/java/org/apache/brooklyn/entity/nosql/hazelcast/HazelcastNodeImpl.java
sandbox/nosql/src/main/java/org/apache/brooklyn/entity/nosql/hazelcast/HazelcastNodeSshDriver.java
sandbox/nosql/src/main/resources/org/apache/brooklyn/entity/nosql/hazelcast/hazelcast-brooklyn.xml
sandbox/nosql/src/test/java/org/apache/brooklyn/entity/nosql/hazelcast/HazelcastClusterEc2LiveTest.java
sandbox/nosql/src/test/java/org/apache/brooklyn/entity/nosql/hazelcast/HazelcastClusterSoftlayerLiveTest.java
software/nosql/src/main/java/org/apache/brooklyn/entity/nosql/hazelcast/HazelcastCluster.java
software/nosql/src/main/java/org/apache/brooklyn/entity/nosql/hazelcast/HazelcastClusterImpl.java
software/nosql/src/main/java/org/apache/brooklyn/entity/nosql/hazelcast/HazelcastNode.java
software/nosql/src/main/java/org/apache/brooklyn/entity/nosql/hazelcast/HazelcastNodeDriver.java
software/nosql/src/main/java/org/apache/brooklyn/entity/nosql/hazelcast/HazelcastNodeImpl.java
software/nosql/src/main/java/org/apache/brooklyn/entity/nosql/hazelcast/HazelcastNodeSshDriver.java
software/nosql/src/main/resources/org/apache/brooklyn/entity/nosql/hazelcast/hazelcast-brooklyn.xml
software/nosql/src/test/java/org/apache/brooklyn/entity/nosql/hazelcast/HazelcastClusterSoftlayerLiveTest.java
software/nosql/src/test/java/org/apache/brooklyn/entity/nosql/hazelcast/HazelcastTestHelper.java

This closes #1073

Conflicts:
core/src/main/java/org/apache/brooklyn/core/typereg/BasicBrooklynTypeRegistry.java -- imports only

This closes #1114

tidy-up following review of #1117, thx @iyovcheva

This closes #1117

Fix jclouds machine subnetHostname

- Fix JcloudsSshMachineLocation.getHostname(): delegate to
  jcloudLocation.getPublicHostname()
- Fix JcloudsSshMachineLocation.getSubnetHostname(): delegate to
  jcloudsLocatoin.getPrivateHostname()
- Persist JcloudsSshMachineLocation.privateHostname
- Adds SshMachineLocation.tryGetPrivateKeyData()
  (extracted from SshMachineLocation.findKeyPair())

Without this fix, single-node Cassandra fails:
* In AWS it got the public IP for the seed (which could not be reached
  from the VM itself).
* In vcloud-director it got the VM’s hostname (which is a random badly
  confirmed name that is not reachable from the VM itself)

MachineEntity.exec: better NPE if no driver

Use Sanitiser.sanitize when logging

misc tidy

resolve the curious Maybe.Present(null) making use of new Absent.isNull()

support isNull on Maybe, including an "absent because null" semantics.
simplifies api usage when contexts handle null differently, but a present null is confusing.

clean-up of type registry work following PR comments; all addressed apart from weird validate semantics

This closes #1110