In this Article
Overview
The SnapLogic Release process accommodates user testing of new features on the UAT control plane. The UAT control plane is intended exclusively for testing Pipelines and Tasks with new features, and therefore is separate from Elastic.
In the quarterly release, a version of the software is available in the UAT control plane a week before the GA date of the release. The GA version becomes available on the UAT control plane, and Snap Pack updates happen during the release of the patches to that release.
We strongly recommend that you only use the UAT control plane during the UAT period for a specific release. After the GA of a release, the Snaplex versions on the UAT control plane might change.
This article describes the process of testing new SnapLogic features on the UAT control plane.
All references to Orgs also apply to environments in Admin Manager.
Prerequisite
Org admin privileges are required to perform most of the procedures referenced in this article.
Workflow
Set up an Org on UAT.
Update Snap Packs and Snaplexes when new versions are available.
Test new features by running your Pipelines on the UAT control plane.
Set up an Org on the UAT control plane
Request an Org
You can request your SnapLogic CSM to provision an Org on the UAT control plane.
Install a Self-managed Snaplex (Groundplex)
Once your Org is provisioned on the UAT control plane, you can create new Project Spaces and Assets for testing your Pipelines and Tasks. Alternatively, you can download your projects and assets, and then migrate them to the UAT control plane using the import and export functionalities in Manager.
For your Snaplex, you can deploy a Self-managed Snaplex (also known as a Groundplex). If your network is behind a firewall, a Self-managed Snaplex is best suited for the internal testing of new features. You can also request a SnaLogic Managed Snaplex (also known as a Cloudplex) for your UAT Org. However, we recommend that you deploy a Self-managed Snaplex so that you can take advantage of all available features in a release--some of which require a Self-managed Snaplex.
When you deploy a Self-managed Snaplex in your UAT Org, you need to add those Snaplexes to the IP Allowlist to allow communication outside of your network, if outbound requests are restricted. Contact support@snaplogic.com or your CSM for more information about Managed and Self managed Snaplexes.
Updates
New features are generally available every month. Snaplex updates are available quarterly, and a UAT version of the new Snaplex version is available a week ahead of GA. You can test new features during the months between the quarterly releases without action. Only during quarterly releases do you have to update the Snaplex nodes in your Org with the new Snaplex version. If you enable the Snaplex auto-update option in Manager for your UAT org, then no action is required to update the Org.
Test Snaplex Versions and Snap Pack Updates
You can test platform features and updates to SnapPacks in your UAT Org.
Snaps with Latest Release Version: Snap Pack updates include new Snaps, enhancements to existing Snaps, and new Snap Packs. You can view the Snap Packs available to your Org in Manager. To view the SnapPack updates for each release, see the patch information section in the quarterly release notes.
Snaplex with the Latest Version: In the case of the quarterly release, you can upgrade the Snaplexes in the UAT Org to the latest version. You can administrate versions of your Snaplexes in Manager. Testing the latest distributions of a SnapLogic release allows you to try out and test new features.
Test Pipelines in UAT
Follow these steps to test Pipelines in your UAT Org.
Export your Pipelines from your Orgs in Elastic by doing one of the following:
If GitHub integration is configured for your Org, you can use the GitHub sync feature to synchronize your Pipelines and Assets on Elastic and UAT control planes.
Export projects from your Production Org. The project downloads as a zipped file of all the Assets contained within that project. You can then import the project zip file into your UAT Org.
Note: You must reconfigure your Accounts once you import them into your Org on the UAT control planes.Manually migrate your Pipelines Use the export and import functions.
Use the export function in Designer to download each Pipeline.
Import each Pipeline into the Designer for your Org.
You can download most files from Manager and upload them to your Org in UAT.
Update all the SnapLogic Account configuration information in the UAT Org.
Find all the target Accounts that are required for your UAT Org.
Create the Accounts in your UAT Org.
Run and test Pipelines by validating and executing them in Designer.
Run your Tasks and monitor them on Dashboard or the Studio Execution Overview.