This section provides a summary of the notable changes in Swarm for the 2022.2 release. Full details are available in the distribution's
Swarm now ships with a new Slack integration module baked-in. Enable Slack integration for the Swarm projects you want to be notified about, and the Slack integration will post Swarm activity in the appropriate Swarm project Slack channel each time:
a change is committed
a review is created
a review is updated (threaded on the original review)
See Slack integration.
You can now manage your Swarm Helix Core Server extension with a script, see Extensions Management.
You can now configure Swarm with specific settings for each Helix Core Server instance. For example, you can make Swarm use a different Jira configuration for each of the Helix Core Servers it is connected to. See Configure a specific Helix Core Server.
You can now run Swarm using a Docker container, see Run Swarm using a Docker container.
Swarm 2022.2 no longer supports Swarm deployment from an OVA image.
From Swarm 2022.2, Swarm no longer supports APIs older than v9.
We continue to work hard to improve the Swarm review preview page. The preview review page will replace the original page in a later release.
To access the review page preview, use the Preview toggle at the top of the review page. In this way, you can freely switch between the original review page and the preview review page. See Review display.
The new page is currently missing a few features that will be added in a later release, see Review page (preview) for details. Please share your feedback with us if there is anything you miss from the original review page. For contact details, see Getting help
Help for the original Swarm review page is available in the Swarm 2021.2 documentation, see Review display.
A number of new endpoints have been added to the API, see the Swarm API.
For Swarm 2022.1, we introduced a new set of v11 APIs. These refine and extend the v10 APIs, and further standardize the endpoint and response pattern. The v10 APIs will continue to be available for some time to come
- Any improvements made in the migration to v11 will not be backported to v9 or v10.
- New API endpoints will be created as v11 and will not be backported to v9 or v10.
We have removed support for PHP 7.0 and 7.1 for Swarm 2022.1. This is part of our commitment to move away from using versions of platforms that have reached End-of-Life (EOL).
Swarm 2022.1 and later no longer supports Microsoft Internet Explorer. This is part of our commitment to move away from using platforms that have reached End-of-Life (EOL).
Swarm 2022.1 and later no longer supports Swarm installation on CentOS 8. This is part of our commitment to move away from using versions of platforms that have reached End-of-Life (EOL).
Swarm 2021.1 and later no longer supports Swarm installation on Ubuntu 16.04. This is part of our commitment to focus on supported technology platforms.
Swarm 2020.2 does not support Swarm installation on CentOS 6 and RHEL 6. This is part of our commitment to focus on supported technology platforms.
Helix Core Server 2020.1 and later, permissions have changed for viewing and editing stream spec files in Swarm. To view and edit stream spec files in Swarm, the Swarm user must have admin permissions for the entire depot //...
The swarm.shelvedel shelve-del trigger script has been updated in Swarm 2020.1, the trigger script must be updated in the Helix Core Server trigger table or added if it does not already exist, see Update the Helix Core Server triggers table to run the trigger script.
The Zend 3 Framework project has been forked to an open source project called Laminas, see https://getlaminas.org/about/. Swarm 2020.1 now uses the Laminas framework, this is part of our commitment to move away from using versions of platforms that have reached End-of-Life (EOL).
If you have existing custom Swarm modules created for Swarm 2019.3 or earlier, you must update them to use the Laminas framework. For instructions on updating your Zend custom modules to Laminas, see Migrate existing custom modules to the Laminas framework.
Swarm 2019.2 introduced a Redis in-memory cache to improve performance and reduce the load on the Helix Core Server. This replaces the file-based cache that was previously used by Swarm.
On Swarm systems with a large number of users, groups, and projects, the initial population of this cache can take some time. If you have a large Swarm system you should read through the Redis server connection and configuration options before installing or upgrading Swarm, see Redis server.
We have started adding a new set of v10 APIs to Swarm. These will provide a new endpoint and response pattern, and are designed for use with the new rich User Interface that is being introduced in 2020. Swarm will continue to support the v9 APIs for some time, see API versions.
APIs older than v9 are being deprecated, support for them will be removed in a future release. See API versions.
The Swarm workflow feature is enabled by default. If you are upgrading from an earlier version you will need to update your triggers, see Upgrading Swarm.
We have removed support for versions of PHP older than 7.0 in Swarm 2019.1. As a result of this change, support for Apache 2.2 has also been removed. This is part of our commitment to move away from using versions of platforms that have reached End-of-Life (EOL).
The latest version of P4PHP is included in the Swarm package, OVA, and tarball installations.
Swarm 2022.2: Some review page features are not yet supported by the new review page preview. This will be addressed in a later release of Swarm. In the meantime, if you need to use any of the unsupported features, switch back to the original Swarm review page with the Preview toggle. Help for the original Swarm review page is available in the Swarm 2021.2 documentation, see Review display.
Comment likes: you cannot add a like to a comment.
Show full context: the Show full context: button is not available.
File view controls: the Show whitespace, Inline, and Side-by-side view settings are not sticky and are reset on a page reload
Show whitespace: is not showing CRLF line endings or tabs correctly
3D model files: 3D model files are not displayed.
Terminating list of files/file if size is too large: we do not limit how many files we display.
Inline comments added using the comment or review API (v11) are sometimes displayed on the wrong side of the diff on the original Swarm review page.
Issue: Swarm will lose connection to all of the Helix Core Servers if you edit the base_url configurable value in the environment block of <swarm_root>/data/config.php. This will stop your system working.
Fix: Remove the base_url configurable from the environment block of <swarm_root>/data/config.php.
Individual branch views display the commits correctly.
Run p4 login2error.
p4 login2for a super user account configured for Helix Authentication Service before deploying the Swarm OVA. For
p4 login2detail, see p4 login2 in Helix Core Command-Line (P4) Reference.