Release notes (Rehearsal Tool)

Version 2026.2.1

This 2026.2.1 release adds support for cross-process file locking on Windows.

Version 2026.2.0

Rehearsal Tool (dxrt) 2026.2.0 updates its build requirements to Python 3.14 and reduces intermittent timeout failures during concurrent CData reauthentication operations.

Version 2026.1.0

Added support for Salesforce organizations that use Refresh Token Rotation (RTR) and Proof Key for Code Exchange (PKCE).

Rehearsal Tool version 2026.1.0 is included with Continuous Compliance Engine version 2026.4.0.1. To access the Rehearsal Tool from the Continuous Compliance Engine UI, use Continuous Compliance Engine 2026.4.0.1.

For standalone use, download and install Rehearsal Tool version 2026.1.0 from the Delpix download portal.

Version 2025.3.0

This release resolves an issue that incorrectly excluded record-triggered Salesforce flows from disable/enable operations when specific Salesforce objects were targeted using the --sf_objects option. As a result, these flows remained active during masking runs. Record-triggered Salesforce flows are now correctly identified and included in disable/enable operations.

Version 2025.2.0

To install the rehearsal tool, refer to Getting Started.

Features

The Rehearsal Tool now supports network communication through HTTP and HTTPS proxies. This enhancement improves connectivity in enterprise environments, enhances security, and allows for greater control over outgoing requests.

Version 2025.1.1

To install the rehearsal tool, refer to Getting Started.

Features

This release improves the directory structure for storing logs and ZIP artifacts generated by the Delphix Rehearsal Tool (dxrt). Logs and output files are now organized by domain_name to support better separation and easier debugging.

This release also changes the location of the logs from /var/delphix/sfdc/dxrt to /var/delphix/sfdc/dxrt/{domain_name}. The domain name can also be checked by searching for the My Domain in Quick Find.

Version 4.0.0

To install the rehearsal tool, refer to Getting Started.

Features

1. The Salesforce Metadata API has been upgraded to version 60.0.

2. To make password/security tokens secure, CLI uses Interactive mode and Environment variables. With this release, users will be able to pass passwords or security tokens via prompt or environment variables when executing dxrt commands. Refer to CLI References for more details.

3. Introducing Platform Independence: With this release, users will be required to specify the platform type for which the dxrt command is executed. For the time being, the only supported platform type is Salesforce, so all dxrt commands must include "salesforce" as an argument. Refer to CLI References for more details.

Version 3.3.0

To install the rehearsal tool, refer to Getting Started.

Features

The dxrt v3.3.0 release supports the following security enhancements:

This release includes a security enhancement that allows users to prevent credentials from appearing in the shell history or the process list. It is recommended that credentials be provided in the CLI only when prompted.

Version 3.2.3

To install the rehearsal tool, refer to Getting Started.

Features

dxrt v3.2.3 release supports the following functionality:

• Bug fix for handling disable operation when the disable trigger fails at Salesforce.

Version 3.2.1

To install the rehearsal tool, refer to Getting Started.

Features

dxrt v3.2.1 release supports the following functionality:

• Minor bug fixes. 

• Retrieving all the triggers and removing the cap of 2000.

Version 3.2.0

To install the rehearsal tool, refer to Getting started.

Features

dxrt v3.2.0 release supports the following functionality:

• Performance optimization for the disable operation.

• Bug fix for handling Partial Success.

• Improved logging on the console for the disable operation (updating metadata, active component list, etc.)

• Deployment details are added to the exception message.

• The exception response from dxrt changed to a JSON string (disable, enable, and rehearse).

• Increased the polling interval.

Version 3.1.0

To install the rehearsal tool, refer to Getting started.

Features

dxrt v3.1.0 release supports the following functionality:

• Added support for excluding indirect look-up objects during disable operation.

• Minor bug fixes to improve polling status and error handling.

Version 3.0.0

To install rehearsal-tool, refer to Getting Started.

Features

dxrt v3.0.0 release supports the following functionality:

• Added support for OAuth mechanism for authorization apart from already existing username password and security token.

• Changed the -i flag from “is_sandbox” to “is_production”.

• Added support for disabling duplicate rules that are dependent on matching rules.

Breaking Changes

Prior to version 3, the -i flag was used to specify whether the Salesforce Org is a sandbox or not. With version 3.0.0, we are changing the usage of the same flag to identify a production org. Therefore, if you are running the dxrt on a production org, you would have to specify the -i flag explicitly. By default, if no value is provided, dxrt assumes the org to be a sandbox.

Version 2.0.0

To install rehearsal-tool, refer to Getting started.

Features

dxrt v2.0.0 release supports the following functionality:

1. Change the implementation from using salesforce_api to simple_salesforce.

2. Addition of new metadata components.

3. Usability as a library as well as a CLI.

4. Capability to skip fields that are part of managed packages.

Version 1.0.0

To install rehearsal-tool, refer to Getting started.

Features

dxrt v1.0.0 release supports the following functionality:

1. Validate Salesforce metadata package configuration.

2. Upload a Salesforce metadata package.

3. Disable Salesforce metadata packages.

4. Retrieve & download Salesforce metadata packages for specific Salesforce objects into a zip file.