In this article

Overview

Previously, when the SnapLogic control plane was updated for a quarterly release, Snaplex nodes and Snap Packs were automatically updated at the same time. When a quarterly release goes out, each SnapLogic customer can decide to keep their existing version of Snaplex (Cloudplex or Groundplex) and Snap Packs for up to 35 days before upgrading. This gives you the opportunity to make sure the new Snaplex and Snap Packs are stable and working as expected before rolling them out to your entire company.  

You can update Snaplex instances within an Org automatically by selecting the checkbox on Manager > Settings > Auto Upgrade Snaplex. This updates the Snaplex to the latest available version.

Upgrade Rules

This new release process allows the following combinations:

Control Plane, User InterfaceSnaplexSnap PacksSupported Configuration?
Updated

OldOldYes. The Stable and Latest options for older Snap Packs running on an older Snaplex are supported, as well as Snap Pack overrides.
NewNo1. New Snap Packs require a new Snaplex.
NewOldNo. Old Snap Packs do not run on a new Snaplex. If an issue is found with a new Snap Pack, it can be overridden with an older version in consultation with SnapLogic Support.
NewYes. The Stable and Latest options for newer Snap Packs running on a newer Snaplex are supported, as well as Snap Pack overrides. 
1An older Snaplex has to use the older Snap Packs until the Snaplex is upgraded. New Snap Packs require a New Control Plane and a New Snaplex.

Impact on your SnapLogic instance during the release maintenance window

SnapLogic sets-up a maintenance notice of one hour on elastic.snaplogic.com during the GA release to facilitate updating the Platform. Hence, you cannot access the SnapLogic UI; however, all scheduled Pipelines and Ultra Tasks continue to run as expected during the one hour window. Similarly, you can make API calls as well, since those do not require UI access. Essentially, even during the maintenance window, the Platform continues to function at the backend.

Grace Period for Upgrades

Thirty-five days after a quarterly release, Snaplex and Snap Pack upgrades automatically occur. Older Snaplex nodes and Snap Packs are automatically updated and Snaplex rollbacks are not allowed. Warning messages are provided well before the grace period ends. 

If you do not select the checkbox in Manager > Settings > Auto Upgrade Snaplex, then for the first 35 days after a quarterly release, automatic updates for Snaplex nodes are suspended and the version is not changed. During this grace period, you can manually upgrade the new Snaplex War file to make sure everything is working as expected, then try out the new Snap Packs.

  • All nodes within a Snaplex must be configured to run the same Snaplex version and Snap Pack versions.
  • Snap Catalog displays older version of Snap Packs until all JCCs in an Org upgrade to the new version. Newly published premium Snap Packs are not available in the Snap Catalog until all JCCs are upgraded. Pipeline execution do use the appropriate Snap Pack, based on whether the JCC is upgraded or not. 
  • Private Snap Packs can be used regardless of the JCC version.

To upgrade automatically to the latest available version, select the checkbox in Manager > Settings > Auto Upgrade Snaplex

Snap Pack Configuration Options

The options you set on the Manager > Snap Pack page control which Snap Packs are used when Pipelines run. As an Org administrator, you can choose the options that work best for your Org or project. For example, you might configure a developer Org to always have the Latest Snap Packs to test new features. But for a production Org, you might choose Stable Snap Packs to make sure everything works as expected. 


The Snap Pack page includes a View distribution menu. Options include: 

You can use this menu to test the new Snaplex version and Snap Packs independently from the older Snaplex and Snap Packs.

The Latest/Stable menu provides an Org-wide setting that controls which Snaps are used when a Pipeline runs. Choices are:

The Snap Packs used in a Pipeline can vary depending on your configuration. For example, Pipelines with the Kafka Snaps could use any of the following:

Snaplex OptionsOrg OptionsSnap Used
NewLatestKafka 275
StableKafka 273
OldLatestKafka 271
StableKafka 270

Local Overrides

In addition to the menu choices (Latest/Stable, Old/New), you can also configure individual Snap Pack "local overrides" to use when a Pipeline runs. For example, you might have a Stable set of Snap Packs configured for your Org, but you can select a later (or earlier) version for a few of the Snap Packs, depending on your needs. 

In some cases, instead of the Latest or Stable Snap Pack, you may have a local override set for one or more Snap Packs. These local settings are preserved until you update the Snap Packs. Once you update the Snap Pack, you will need to re-apply the local overrides. 

Recommended Upgrade Process for an Org

When a quarterly release occurs, follow these steps to test the new Snaplex and Snap Packs:

  1. For the Org you want to test, log in to SnapLogic as an Org administrator.
  2. For all Snaplexes, update to the latest version in Manager. Since the updates are automatic, no manual JCC process restarts are required.
  3. Selectively execute and monitor a few Pipelines to ensure that they are working as expected.

When you've finished testing Pipelines for an Org, you can manually roll out the changes to your other Orgs. Alternatively, you can wait until the grace period ends and the Orgs are updated automatically.

Verifying the Snap Pack Upgrade

To verify if the upgraded Snap Pack has taken effect, follow these steps:

  1. Either validate or execute a Pipeline in the given Org where you have upgraded a Snap Pack.
  2. Click the Pipeline statistics  icon to open the Pipeline Validation Statistics screen and hover over a Snap row—notice the associated Snap build number on the right bottom of the following image.


Rollbacks 

During the grace period, you might need to downgrade a Snaplex or Snap Pack because of compatibility issues, platform restrictions, and so on. In this case, you can rollback a Snaplex. Change the Snaplex version to an older version in the Manager.

Rolling back a Snaplex

To rollback a Snaplex, replace your existing Snaplex software with an older version. 

  1. Follow the instructions in How to Update a Snaplex War file. In the Update Snaplex dialog, select the Recommended version from the Version dropdown list. 



    Do not select the version with the designation Deprecated or Restricted Distribution unless advised by SnapLogic Support.

  2. Click Update

Downgrading from a new Snaplex to an older Snaplex automatically switches to the older version of Snap Packs.

Snap Pack Distribution Rules

Because Snap Pack versions are now tied to Snaplex versions, the following rules apply:

For Snap Pack patches: