Versions Compared

Old Version 52

changes.mady.by.user John Brinckwirth

Saved on

compared with

New Version 53

changes.mady.by.user John Brinckwirth

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Removed Minimum Nodes Per Snaplex field since it doesn't exist.

In this article

Table of Contents
maxLevel2
absoluteUrltrue

Overview

Snaplex is a data processing engine used for Pipeline execution. A Snaplex contains multiple nodes and can be a Cloudplex or a Groundplex.

Prerequisites

Note
  • Only an Org Administrator can create a Snaplex.
  • The options available for a Snaplex depend on the Snaplex type.

...

The minimum number of nodes that must be kept alive even when there is no activity in the Snaplex. This property ensures that when a Pipeline that runs on the Snaplex is validated, at least one node is available to perform the validation.

Minimum value: 1

Default Value: 1
Name

Specify a unique name for the Snaplex. The name must not exceed 100 characters.

Note

We recommend you use a descriptive name for your Snaplex, that you can identify it easily.

Default Value: None

Location

Select the location where the Snaplex must be created. The available options are:

  • Cloud: Creates a Snaplex in the cloud.
  • Sidekick: Creates a Snaplex on-premise (Groundplex).

Default Value: Sidekick

Environment

Specify the value to configure the Snaplex nodes. Alphanumeric characters and the following special characters are allowed: ( . - +)

Default Value: None
Example: Dev-10

Note

You cannot update the environment value if there are nodes running in the Snaplex. You must stop the Snaplex nodes first before updating the environment value.
Download the config file for each node and restart the nodes for the environment value to take effect.


Version

Specify the version of the SnapLogic Platform on which you want the Snaplex to run.

Note

By default, all new Snaplexes are configured to work with the latest version of the SnapLogic platform. To update your Snaplex version, from the Version list, select the SnapLogic Platform version (such as mrc216) that you want to use with the Snaplex. Once you save the Snaplex, a rolling restart of the nodes in the Snaplex is initiated. Sequentially each node in the Snaplex is put offline, and no new Pipelines are sent to the node. The node waits for a maximum of 15 minutes for currently running Pipelines to complete their execution. It then restarts itself with the specified version of the Snaplex binaries. Once these restarts are done, the Dashboard displays the updated nodes to be running with the specified version.

Default value: Default

Minimum nodes per Snaplex

Email address for notifications

List the email addresses to notify if one of the Snaplex nodes does not respond for fifteen minutes.

Default Value: N/A
Example: testuser@snaplogic.com

Slack Channel for notifications

Specify the name of Slack channels (separated by commas) to notify if one of the Snaplex nodes does not respond in fifteen minutes.

Default Value: None
Example: DevOps

Slack user for notifications

Enter the Slack recipients (separated by commas) to notify if one of the Snaplex nodes does not respond for fifteen minutes.

Default Value: N/A
Example: testuser

Load balancer

Specify the URL for the load balancer for Triggered Task execution requests. The load balancer URL has to be fully qualified, including the protocol. 

Note

When you save the Load balancer URLs in the Snaplex settings, these details are used for Snaplex Trigger URL.

Default Value: None
Example: https://snaplexlb.mydomain.com

Ultra load balancer

Specify the URL of the FeedMaster load balancer for Ultra Pipeline execution requests.

Note

This property is available only to Orgs that have subscribed to Ultra Pipeline Tasks.

Default Value: None
Example: https://ultralb.mydomain.com

Snaplex Configuration changes

...

Maximum slots

Each Snap in a Pipeline consumes a slot; so Pipelines can only be executed on nodes where the number of slots in use is below this threshold. Otherwise, they will fail or queued, depending on how they were executed. The number of slots in use corresponds to the number of active threads on a node, which can be viewed in the Snaplex Health dashboard.

Default Value: 4000

A heuristic to use is that 2000 slots can be allocated per 8GB of RAM available on each Snaplex node. So for nodes with 16GB of RAM, use 4000 as the slot count.

Reserved slots are used when a Pipeline or validation is executed manually from SnapLogic Designer. If no slots are reserved, then these interactive Pipeline executions—Pipeline executions run from Designer for testing or validation purposes—can be blocked by long running executions. You can adjust this setting based on your experience if the default value is not optimal. To reserve more slots for interactive sessions, set your value lower. If the Snaplex is not being used for interactive Pipeline building, set this value higher.

Reserved slot %

The percentage of slots that you want to reserve on a node for Pipelines executed through the Designer tab. Pipelines executed using Tasks or the ForEach Snap will not have access to these slots.

Note

Changes made to this setting do not require a restart.

Default Value: 15

Maximum memory %

The memory threshold at–and above–which no more Pipelines can be assigned to a node.

Note

Changes made to this setting do not require a restart.

Default Value: 85

Heap max size

Groundplex only. The maximum JVM heap size.

Default Value: auto (meaning that SnapLogic will automatically set the max heap size based on the available machine memory).

HTTP Interface

Groundplex only. Specify the location from which the Snaplex node can accept HTTP network connections. The following options are available:

  • Localhost only (127.0.0.1)
  • Any interface (0.0.0.0)

Default Value: Localhost only (127.0.0.1)

HTTP Port

Groundplex only. The HTTP port on which the Snaplex node listens for connections.

Default Values: 8090 for a JCC node and 8091 for a FeedMaster.

HTTPS Port

Groundplex only. The HTTPS port on which the Snaplex node listens on for connections. 

Default Values: 8081 for a JCC node and 8084 for a FeedMaster.

Restart Maximum Wait Time

The maximum wait time before restarting a node.
Enter the maximum wait time or click Forever for an infinite wait time. When a Snaplex node goes into Maintenance mode or a Cooldown state, any Pipeline executions exceeding this value will cause those Pipelines to fail.
Learn more about the Snaplex states.

Default Value: 15 minutes

Global Properties (Key/Value pairs)

Groundplex only. Internal configuration options. Do not edit these values without contacting SnapLogic Customer Support.

Default Value: None

...