Release Manual 8.1.x

    Upgrade instructions

    XL Release 7.5.0 shipped with a new database backend. To upgrade to this version, a separate Migrator tool needs to be run.

    For detailed instructions, refer to Upgrade to XL Release 7.5.

    Migration to the new database is only supported from XL Release versions 7.0, 7.1 and 7.2. If you are on a previous version of XL Release, you need to upgrade to 7.0 first.

    Important: If you plan to skip versions when you upgrade, ensure that you read the version-specific upgrade notes for each intermediate version. You may be required to perform manual actions as part of the upgrade.

    XL Release 8.1.0

    XL Release 8.1.0 is a short-term support (STS) version that will be supported until it is superseded by the next STS or long-term support (LTS) version. STS versions do not receive specific maintenance releases. For more information, refer to Short-term support/Long-term support policy.

    XL Release 8.1.0 new features

    Implemented configurations on folder level

    With XL Release version 8.1.0, shared configurations can now be defined on folders. Releases and templates have access to all configurations defined on the folder and inherit all configurations from parent folders, including configurations defined globally. You must have the new "Edit configuration" permission to create or edit configurations on folders. If you use the default set of folder permissions, the Folder Owner team has this permission on new folders.

    Added customizable dashboards

    In XL Release 8.1 and later you can configure customized global dashboards. Custom dashboards can be used to monitor a range of metrics across multiple releases, various folders and templates, Jenkins builds, JIRA tickets, or any custom item you wish to monitor. For more information, see Configure custom dashboards

    Added a task failure handler

    Since XL Release 8.1.0, a new task failure handler is available. You can now set different actions out of the box to be performed when a task fails. For more information, see Task failure handler.

    Storing template versions in Source Control Management

    As of XL Release 8.1.0, you can store template versions in a Source Control Management tool. This provides easier management of all the artifacts, the possibility to store them together with Releasefiles and Jenkinsfiles, to configure and to use them from a release pipeline. For more information, see Store template versions in Source Control Management.

    Upgrade notes

    Added new permissions

    After upgrading to XL Release version 8.1.0, only users with Admin global permission will be able to create or edit configurations for existing folders. To allow other users to edit configurations, you must assign them the new Edit configuration permission.

    As of XL Release 8.1, a new permission is available: Edit folder teams and permissions. Teams with this permission can manage the team composition and the permissions of all the teams within the folder, similar to the Folder Owner permission.

    For more information, see Configure release teams and permissions.

    Upgrade plugins

    When you upgrade to XL Release version 8.1.0, you must also upgrade the following non-bundled plugins. You can download the new versions from the customer download area.

    Contact XebiaLabs Support if you have hotfixes

    If you have hotfixes installed, contact the XebiaLabs support team before upgrading.

    XL Release 8.1.0 release notes

    New features

    • [REL-5195] - Support attachments in exported Releasefile
    • [REL-6551] - Make dashboard configurable
    • [REL-6680] - Use Git as a storage for XLR template versioning control
    • [REL-6681] - Add capability to set shared configuration on folder level
    • [REL-6713] - Add failure handling on task level


    • [REL-5480] - Add capability to switch off variable interpolation in script tasks

    Bug fixes

    • [REL-5126] - Update originTemplateId when moving a template in releases created from that template
    • [REL-6434] - JSON webhook do not recognize UTF-8 characters
    • [REL-6472] - Task head types still visible when trying to change to a restricted task type
    • [REL-6491] - Archiving can start before all updates to a release were persisted
    • [REL-6650] - Gate Task status is not getting resolved when dependent release is completed
    • [REL-6660] - Liquibase upgrade can potentially fail if template was duplicated with gate tasks for derby, h2 or oracle
    • [REL-6661] - Changing a task type to CustomScriptTask generates wrong id for Python script
    • [REL-6662] - Importing templates with unresolved dependencies produces error
    • [REL-6670] - After upgrade to v8.0 XLR fails to start when it attempts to upgrade database
    • [REL-6701] - Resolving ConfigurationId from ReleaseId is done incorrectly
    • [REL-6703] - Releases can't be archived because ClassCastException
    • [REL-6708] - Full row should be highlighted in planner view
    • [REL-6757] - Teams and permissions should be same as parent folder when templates are created from DSL
    • [REL-6760] - XLR removes all opening and closing xml tags
    • [REL-6781] - Dependencies are not inserted properly when importing a template
    • [REL-6809] - Upgrade 7.5.3 -> 8.0.1 fails with Not a proper ID for a children
    • [REL-6830] - Deadlock when release trigger is fired
    • [REL-6848] - Remote completion plugin 8.0.0 is not compatible with xlr 8.1.0
    • [REL-6897] - Fix disabling of Save button for configurations
    • [REL-6927] - Task UI shows old status line when retrying
    • [REL-6952] - Unable to remove jumpstation from SSH jumpstation