If you are upgrading from a version lower than 3.2, this implies that an upgrade task will run to pre-calculate historical data. This action is a one-time action and it that will run in the background so that Xray is still available during the upgrade. A re-index operation of your Jira instance is required so that the internal data becomes searchable and usable by Xray.
Note
Please be aware that this upgrade task will run immediately after updating Xray. As this operation can take some time and use a considerable amount of server resources, we suggest scheduling the upgrade of Xray outside of business hours. It is always possible to cancel the recalculation operation in the Xray configuration section → Custom Fields → Maintenance.
Expand
title
Upgrading from versions >= 3.2.x
If you are upgrading from v3.2.x or v3.3.x to v4.1, you must recalculate data in the Xray configuration section → Custom Fields. This recalculation is necessary because of the huge improvement in the amount of data that Xray needs to add to the table and to the Lucene indexes.
Note
As this operation can take some time and use a considerable amount of server resources, we suggest scheduling the upgrade of Xray and the recalculation of the custom fields, outside of business hours.
Column
width
50%
Downgrading from Xray 4.1.x
Expand
title
Downgrading from any version
Downgrading from Xray 4.x to a version less than 3.2.0 implies that you must perform a re-index afterward. This is because from Xray 3.2.0 onwards, the content and format of what Xray indexes have changed.
Historical Coverage Gadget
Some configuration parameters for this gadget were modified as a result of supporting multiple projects whenever using a saved filter as a source. It is possible that some users will get errors on the gadget after downgrading from 4.x. If this happens, please edit the configuration to ensure the gadget is configured properly.
...
Panel
borderColor
#F3F3F3
bgColor
#FAFAFA
borderWidth
1px
Section
Xray Exploratory App
Column
width
60%
Column
width
40%
The Xray Exploratory App (XEA) is desktopis a desktop-based Exploratory Testing Tool that works seamlessly integrated with Xray. It allows users to define exploratory testing sessions, record videos, capture and annotate screenshots, take notes, and much more.
It works integrated with Jira and Xray, but can also be used in a standalone mode (Jira and Xray are not required).
With the Xray Exploratory App you can create tests, run test executions, and explore software testing like never before.