.. highlight:: bash .. index:: Release notes .. _release_notes_3_4: 3.4 Release Notes ================= New capabilities: * Full support for DataPower :ref:`firmware upgrades `. * Configuration reporting: :ref:`configReport` and :ref:`listObjects` commands, can be run against multiple gateways and domains and produce detailed configuration report, including differences in configuration. * Support for DataPower operational analytics via `integration withElasticsearch/Kibana/Logstash `_. * :ref:`Log target management/creation commands `, support for file, syslog and http targets, ability to quickly change log levels. * Support for :ref:`DataPower configuration transformations ` directly from the :ref:`CLI import command `. You can specify what elements to update in-line (``updates`` option) or create more complex :ref:`reusable transform policies ` and then reference them from ``import`` using its ``transformDef`` option. * :ref:`updateConfig` task for in-place configuration updates that can be applied to multiple domains and gateways. * ``assertStatus``, ``updateConfig``, ``import``, ``copy``, ``deleteMutlipleFiles``, ``delConfig``, ``save`` commands now support ``domainPatterns`` (``domains``) option, so they can be executed against :ref:`multiple domains `. * :ref:`DPBuddy docker image ` with pre-installed Java, Apache Ant, Gradle and DPBuddy. New commands/tasks: * :ref:`exportConf` command exports dpbuddy.conf configuration as environment variables to simplify integration with shell scripts. * :ref:`testTcp` command * :ref:`saveAll` command saves all domains. Changes to existing commands/tasks: * :ref:`checkpoint` now supports automatic removal of old checkpoints. * More flexible :ref:`download` command. It now supports ``preserveTimestamp``, ``downloadIfChanged``, ``appendHost`` options/attributes. * :ref:`Export ` now supports ``includeDebug``, ``refObjects``, ``refFiles`` at the command/task level. These settings are applied to all objects being exported by the command. * ``connect`` alias for :ref:`testConnection` command. * :ref:`passwordAliasTask` now automatically updates existing password alias objects. Previously, it could only create the new ones. * Many bug fixes. Changes to the status reporting/state verification commands: * Deleted or disabled objects are excluded from the :ref:`assertState` check. * :ref:`serviceStatus` (listServices) now includes device name and domain in the report, supports querying multiple domains. Changes to querying objects using :ref:`regexp matching ` * Support for ``objects`` and ``exclude`` parameters/attributes in assertState, quiesce, export, updateConfig, delConfig as an alternative to ``classPattern``/``namePattern``. You can provide a comma-delimited list of regexp patterns in the format "class:name, class:name" to ``objects``/``exclude``. Class and name could be optional, e.g., "class, class" or ":name". ``objects`` determines objects to apply a command to, ``exclude`` determines what objects to exclude. * ``-class`` and ``-name`` can be used as an alias for ``-classPattern`` and ``-namePattern``. * Class matching is no longer case sensitive. * Object name matching is not case sensitive in all commands that support ``objects`` option/attribute. * Global ignore list can now take regular expressions. Changes to quiesce commands: * Support for quiescing :ref:`multiple domains `. * Disabled objects are automatically excluded from queisce/unqueisce. * Quiesce support directly from :ref:`restartDP` command. DPBuddy configuration changes: * dpbuddy.conf can now reside in ``$DPBUDDY_HOME/conf``, no need to define ``$DPBUDDY_CONFIG`` in this case. * ``-confFile`` alias for ``-configFile`` in all commands. * Ability to override DPBuddy :ref:`log location ` using ``$DPBUDDY_LOG_HOME``. DPBuddy 3.4 has been thoroughly tested with the latest firmware versions, including the most recent fixpacks for 7.7, 7.6 and 7.5.