# AMP Release 6.1.0

* [Introduction](#introduction)
* [Major New Features](#major-new-features)
* [Other Enhancements](#other-enhancements)
* [Bug And Vulnerability Fixes](#bug-and-vulnerability-fixes)
* [Known Issues](#known-issues)
* [Upgrade Instructions](#upgrade-instructions)

## Introduction

Thank you to our community who have contributed a lot of improvements and feedback!
Thanks also go to Brooklyn's commercial users who have funded this development and
made some major contributions.

For more information, please visit https://cloudsoft.io/amp, https://docs.cloudsoft.io
and http://brooklyn.apache.org

This is a minor upgrade from AMP version 6.0.0.

## New Features

* The version of the jclouds API used to communicate with the AWS cloud has been
  updated, and now includes *arm*-based as well as *x86_64* architectures when
  searching for suitable hardware for a virtual machine image. This means that
  blueprint authors need be more careful when specifying the provisioning
  properties such as `minCores` and `minRam` and may want to consider using
  the desired `hardwareId` explicitly if the default instance type returned by
  jclouds is not appropriate.

* Major enhancements added to `brooklyn-terraform` bundle for support of Terraform.
  * Terraform version bumped to `1.0.11`.
  * New deployment option to deploy from an archive rather than a single file added.
  * Support for discovery of an existing Terraform deployment using a Terraform backend.
  * Improved support for Terraform entity sensors.
  * UI changes to create entities for terraform managed resources (based on the SHOW command output).
  * Added support for drift recognition and management for Terraform resources.
  * Terraform documentation updated.

* Introduction of additional Kubernetes support via the `brooklyn-kubernetes` bundle:
  * Kubernetes discovery to allow representing an existing Kubernetes elements (such as Pods, Services, Deployments or Replica Sets) as AMP entities.
  * Auto-arrangement by helm best-practice labels.
  * Kubernetes documentation updated.

* Support for importing applications from external CMDBs such as ServiceNow and AppRegistry.

* Support for updating external CMDBs such as ServiceNow and AppRegistry automatically when applications are deployed, changed, or removed in AMP.

* Support for creating incidents in an external issue tracker such as ServiceNow.

## Other Enhancements

* Various UI Enhancements, including:
  * Cloudsoft branding and color scheme updated.
  * Activities list updates, including:
    * JSON/YAML displayed neatly in sensor/config table
    * Kilt diagram updated dynamically as activities table is filtered.
  * Session persistence for the composer Graphical view added:
    * View mode (list, compact list, etc.)
    * Query/search term
    * Item group (entities, policies, etc.).
  * Logbook widget added to the Debug Console page.
  * Debug Console design updated.
  * Composer entity version selection.
  * Dashboard UI improvements.

* `brooklyn.parameters` elements can use `reconfigurable` property to allow their modification via API or in the App Inspector UI
  (in the `Config` tab of an entity's `Summary` page).

* Update of the version of `guava` to `27.1-jre`.

* Support to customise CAMP/TOSCA editors based on feature flags (`editor.camp.enabled`, `editor.tosca.enabled`) coming from the AMP server added.

* New entitlement of HA Admin (`Entitlements.HA_ADMIN`) for executing High Availability requests e.g. changing the master node, or removing terminated servers.

## Bug and Vulnerability Fixes

* Update to very latest versions of Karaf (4.3.5) and Pax Logging (2.0.13) to incorporate the latest Log4j2 release (2.17.0) to avoid the critical release-delaying CVE-2021-44228 and all subsequent related vulnerabilities known as of the release date.

* Karaf by default no longer ships with a default user enabled to use the Karaf console.  Thus you will be unable to connect to that console use bin/client  out of the box.  To re-enable the default login, add custom lines or uncomment the default lines:
```
karaf = karaf,_g_:admingroup
_g_\:admingroup = group,admin,manager,viewer,systembundles,ssh
```
in `etc/users.properties`.

* Various fixes to make the rebind process from previous versions of AMP more robust.

* Composer deleted entity behaviour correction - in graphical editor focus parent when an entity is deleted.

* Ability to add a policy using the `management` tab on the app-inspector for newly added policies.

* Various app dashboard fixes.

## Known Issues

* TOSCA entities and docs examples are not installed by default into the catalog. To use those, change line 22 of the file `catalog/catalog-extras.bom`
  to refer to
  `  - mvn:io.cloudsoft.amp/amp-docs-support-bundle/6.1.0-20211223.1435` instead of
  `  - mvn:io.cloudsoft.amp/amp-docs-support-bundle/6.1.0 # AMP_VERSION`.
  You can of course make any other changes here, to load whichever resources you would like into the catalog.
  
* Some effectors for newly introduced Terraform/Kubernetes entities currently have no functionality and are reserved for future use.

## Installation and Upgrade Instructions

To install see https://docs.cloudsoft.io/operations/production-installation.html

To upgrade existing installations see https://docs.cloudsoft.ioq/operations/upgrades/