Release Manual 8.0.x

    Upgrade instructions

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

    To upgrade to version 8.0.0 from version 7.0.0, you must first upgrade to version 7.5.3 and run XL Release on version 7.5.3. To upgrade from version 7.5.3 to version 8.0.0, copy the contents of your XL_RELEASE_SERVER_HOME/conf directory from the previous installation to the new installation directory.

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

    Migration is 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.0.4

    XL Release 8.0.4 release notes

    New features

    • [REL-7440] - Ability to customize HikariCP configurations
    • [SEC-44] - Added Fortify-on-demand and Checkmarx integrations to the xl-release-distribution

    Improvements

    • [REL-7610] - Nexus is not queried to confirm existence of plugin jars. Presence in aggregated metadata is enough.

    Bug fixes

    • [REL-7500] - Search on releases fails because of class exception
    • [REL-7582] - Plugin manager shows 'Install now' even when the plugin is already installed

    XL Release 8.0.3

    XL Release 8.0.3 release notes

    Improvements

    • [REL-6835] - Allow users to select script language on External Script Task
    • [REL-6960] - Improve performance of template search in Create Release Task

    Bug fixes

    • [REL-6760] - XL Release removes all opening and closing xml tags
    • [REL-7000] - XL Release does not allow an LDAP group user to assign a task if the task is assigned to a team with a role in the LDAP group
    • [REL-7025] - Trigger updates on the runningTriggeredReleasesCount property for a template even when required variables are not set
    • [REL-7027] - Variable defined on trigger level ignored
    • [REL-7032] - Enabling "Allow Concurrent Releases" on Trigger does not work if the releases from the trigger are being archived
    • [REL-7137] - REST-API Documentation about setting teams is incorrect
    • [REL-7138] - Aborting a running script task makes output variables freeze
    • [REL-7182] - NPE when comparing template versions
    • [REL-7198] - Pagination on releases with same title returns same results for different pages
    • [REL-7266] - Actor dispatchers config cannot be overwritten on xl-release.conf
    • [REL-7302] - Http Basic Auth RFC-7235 Compliance Problem
    • [REL-7427] - OIDC Plugin missing license check for APIs

    XL Release 8.0.2

    XL Release 8.0.2 release notes

    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-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-6781] - [ORACLE] Dependencies are not inserted properly when importing a template
    • [REL-6830] - [MSSQL] Deadlock when release trigger is fired
    • [REL-6920] - Update documentation for GET /api/v1/folders/Applications/FOLDER_ID/releases

    XL Release 8.0.1

    XL Release 8.0.1 release notes

    Bug fixes

    • [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

    XL Release 8.0.0

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

    If you are upgrading from XL Release version 7.6.x, review the XL Release 7.6.x release manual before upgrading.

    XL Release 8.0.0 new features

    Browse and install plugins from the plugin manager

    In XL Release 8.0, you can download and install plugins from the plugin manager. To facilitate this new feature, the plugins directory has been refactored. Plugins that were previously installed in plugins, are now installed in plugins/__local__/. Official plugins that are downloaded from the UI are installed in plugins/xlr-official.

    Note: If you installed custom plugins, copy them from the previous installation directory: plugins, to the new installation directory: plugins/__local__/.

    Release groups

    By grouping releases together, you can manage a collection of releases as one group. Releases can be added to multiple release groups, and into multiple folders. The release group feature also provides estimates on when the release group will start and finish, based on the schedule and other tasks that are being executing at the same time.

    Locked tasks

    Lock tasks are mandatory. If a lock task occurs during a release, this task needs to be executed before the release can continue. In regulated environments, lock tasks ensure that standards are adhered to, and also that evidence is stored in activity logs. In an environment that is not highly regulated, lock tasks ensure that mandatory activities are executed.

    Upgrade notes

    Configurable pool size

    As of XL Release version 8.0.0, the maximum number of threads for the reporting database is configurable by changing the value of the max-pool-size parameter. The default value for the max-pool-size parameter is 10.

    Contact XebiaLabs Support if you have hotfixes

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

    XL Release 8.0.0 release notes

    New features

    • [REL-6110] - Add Release Group feature
    • [REL-6124] - Introduce a "locked" property on a task
    • [REL-6156] - Allow Plugin Manager to browse plugins from remote repository
    • [REL-6184] - Restrict file upload
    • [REL-6223] - Add task locking to public API
    • [REL-6403] - Add new sample templates for 8.0

    Improvements

    • [REL-6035] - Login Screen Cross Product Consistency
    • [REL-6146] - XSS vulnerabilities
    • [REL-6152] - Fix MS SQL deadlock
    • [REL-6154] - Make reporting max pool size configurable
    • [REL-6241] - Replace t2bus with MBassador
    • [REL-6256] - Consistent Color Usage (Cross Product)
    • [REL-6258] - Enhancements for Log-in screen
    • [REL-6259] - Top navigation colours update
    • [REL-6271] - Load only direct releases from dependencies
    • [REL-6274] - Use batch updates for XLRelease750ReportingSchemaUpgrade
    • [REL-6276] - Improve speed of getDependencyTargetCandidates
    • [REL-6277] - Improve search speed for my tasks when having hundreds of tasks assigned
    • [REL-6331] - Improve speed on role screen when hundreds of users and roles are present
    • [REL-6355] - Improve XLR performance by reducing total number of times we load releases - release actor cache
    • [REL-6356] - Improve XLR performance by reducing number of SQL statements executed while loading release
    • [REL-6421] - MSSQL: Change indexed column from varchar to nvarchar

    Bug fixes

    • [REL-4586] - Support Git Repository with Proxy in XL-Release
    • [REL-4973] - Large number of gate task dependencies impact performance of XL-Release
    • [REL-5562] - Firefox can bounce folder browsing out to the releases overview
    • [REL-5811] - Clicking ok on a gate task with a dependency that you cannot view causes a forbidden access page
    • [REL-6096] - Shared configuration is inaccessible if a property is eliminated in a custom shared configuration
    • [REL-6120] - XL Release link (in the footer) from notification of "Send Test Notification" is blank
    • [REL-6137] - Task fails when passing value to time variable
    • [REL-6141] - Use UTF-8 when serializing releases/templates
    • [REL-6145] - Opening a "Create release task" created from DSL with list box variables results in a 404
    • [REL-6227] - Fix "DEPENDENCY_ID" column
    • [REL-6231] - Team name is not showing on Table view when longer
    • [REL-6232] - Can't see the Task type names in XL Release
    • [REL-6245] - "Create JIRA Issue" task in XLR doesn't create a JIRA issue
    • [REL-6260] - none.get errors occuring on tempate import and template search
    • [REL-6267] - move task fails with nested groups
    • [REL-6279] - Starting XLR with empty repository database clears archive database
    • [REL-6283] - [MSSQL] SQL statements with LIKE and square brackets must be escaped
    • [REL-6285] - RESTEASY002005: Failed executing POST /deployment/validate
    • [REL-6291] - Move task between containers is broken for Task groups
    • [REL-6314] - Import of template DSL with CreateReleaseTask fails with NPE
    • [REL-6341] - Incorrect tasks are getting moved on templates or releases when phases have parallel/sequential groups
    • [REL-6342] - It's possible to move "in progress" tasks out of phase when you duplicate a phase
    • [REL-6343] - Disappearing tasks when moved to group task type
    • [REL-6358] - Add missing SQLPermission to the script.policy
    • [REL-6373] - Error with ListBox variables referring List variable with template created from DSL
    • [REL-6383] - File content validation corrupts the uploaded file
    • [REL-6401] - All teams are removed from template when importing
    • [REL-6408] - Links are not deleted when task is deleted
    • [REL-6484] - Planner: Identical post requests has been sent several times after changing Show dates
    • [REL-6490] - "Could not find dependency" warnings when skipping a gate task with variable dependency
    • [REL-6495] - Cannot process actor message because dependency update fails
    • [REL-6501] - Unable to create template in Jython without setting riskScore & totalRiskScore
    • [REL-6537] - Jenkins plugin can't handle empty json responses from Jenkins