Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

In this Page

Table of Contents
maxLevel2
absoluteUrltrue

...

Snaplex TypeIndicates if it is a standard Snaplex.
Name

The name of your Snaplex. Rename your Snaplex to provide a better description of the type or location. The name must not exceed 100 characters.

Note
titleRenaming Snaplex Instances

If you rename a Snaplex, then you must perform the following actions:

  • Do a rolling restart on all the nodes in the Snaplex.
  • Update any Pipe Execute Snaps that reference the old Snaplex name with the new name.


LocationIndicates whether the Snaplex is in the cloud or on the ground.
Environment

Enter the value used to configure the Snaplex nodes. Alphanumeric characters and the following special characters are allowed:  - +

Example: Dev-10

Default value: No default value.

Snaplex nodes are typically configured using a slpropz configuration file, located in the $SL_ROOT/etc folder. 

If you use the slpropz file as your Snaplex configuration, then:

  • After a Snaplex node is started with the slpropz configuration, subsequent configuration updates are applied automatically.
  • Changing the Snaplex properties in Manager causes each Snaplex node to download the updated slpropz and does a rolling restart with no downtime on Snaplex instances with more than one node.
  • Some configuration changes, such as an update to the logging properties does not require a restart and are applied immediately.
Info
titleOlder Installations

If you have an older Snaplex installation and its configuration is defined in the global.properties file, then the Environment value must match the jcc.environment value In the JCC global.properties file. To migrate your Snaplex configuration to the slpropz mechanism, see Migrating Older Snaplex Nodes.


Note

You should always configure your Snaplex instances using the slpropz file because you do not have to edit the slpropz files manually and changes to the Snaplex done through Manager are applied automatically to all nodes in that Snaplex, making configuration issues, which may prevent the Snaplex from starting, automatically reverted.


Version

The version of the Snaplex.

Update the version of your Snaplex by setting the Version in Manager. This manual update initiates a rolling restart of the nodes in the Snaplex. Each node is put offline with no new pipelines being sent to the node. The node waits a maximum of 15 minutes for currently running pipelines to finish and then restart itself with the new version of the Snaplex binaries. This process is repeated for each node. The Dashboard shows the updated nodes to be running with the new version.

Consider the following three designations when selecting the Snaplex version:

  • Recommended. Indicates that this distribution is the version you should use.
  • Restricted Distribution. Indicates that this version has a configuration intended for specific customers only.
  • Deprecated. Indicates that this version is being phased out and should not be selected.
Info
titleUpdate Notifications

When you choose not to update your Snaplex manually and wait for the Automatic Update instead, you receive notifications until the Snaplex upgrade occurs. You can configure  your Snaplex instances within an Org to update automatically in Manager when a new version is available.


Minimum node per Snaplex

This option makes sure that the application master keeps a certain number of nodes alive even when there is no activity in the Snaplex (useful for Pipeline validation through Designer).

Minimum number is 1.

Email address for notifications

Enter the email addresses for notification if one of the Snaplex nodes does not respond for fifteen minutes.

Slack Channel for notifications

Enter the Slack channels, separated by commas, for notification if one of the Snaplex nodes does not respond for fifteen minutes.

Example: dev

Default value: None

Slack Channel for notifications

Enter the Slack recipients, separated by commas, for notification if one of the Snaplex nodes does not respond for fifteen minutes.

Example: testuser

Default value: None

Load balancerThe URL for the load balancer for Triggered Task  execution requests.

Ultra load balancer

The URL for the FeedMaster load balancer for Ultra Pipeline execution requests.

This is available only to those Orgs subscribed to Ultra Pipeline Tasks.

...

Level

The logging level that log messages must meet to be captured in the main log file. 

Select one of the following options:

  • Trace. Captures events at the most granular level, which is useful for deep analysis by developers.
  • Debug. Captures fine grained events and is typically used by Technical Support.
  • Info. Captures informational events that highlight the progress of the application.
  • Warning. Captures unexpected situations that might require attention.
  • Error. Captures error events that might still allow the application to continue running, but requires monitoring.
Note
titleRecommended Level

We recommend you use either Debug or Info logging levels to facilitate troubleshooting.


Log file sizeThe maximum log file size, given as a number with a unit. For example, 300 50 MB for 50 megabytes.
Main backup countThe number of backup log files to keep for the main log (jcc.json).
Error backup countThe number of backup log files to keep for the error log (jcc_error.json).
Access backup countThe number of backup log files to keep for the access log (jcc_access.json).

...

Maximum slots

The maximum number of slots available on each node in a Snaplex. Each Snap in a Pipeline will consume a slot, so Pipelines will only be executed on nodes where the number of slots currently in use is below this threshold. Otherwise, they will fail or be placed in the Queued state, 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 on the Monitoring Snaplex Health dashboard.

A restart is not required with a change to this setting, which can be set to a user-specified value.

Default value: 4000

Reserved slots %

The percentage of slots to reserve on a node for pipelines executed through the Designer tab. A restart is not required with a change to this setting.

Default value: 15

Note

Pipelines executed using Tasks or the ForEach Snap will not have access to these slots.


Maximum memory %

The threshold at which no more pipelines will be assigned to a node.

A restart is not required with a change to this setting.

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
Anchor
HTTP interface
HTTP interface

Groundplex only.Choose where the Snaplex node will accept HTTP network connections from. Options include:

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

Groundplex only.The HTTP port the Snaplex node will listen on for connections.

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

HTTPS port

Groundplex only.The HTTPS port the Snaplex node will listen on for connections. 

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

Restart Max Wait Time

The maximum wait time before restarting a node. Enter the maximum wait time before restarting a node or click Forever for an infinite wait time.

Default: 15 minutes

Recommended. No greater than 60 minutes.

Note

We recommend that you avoid setting the Restart Max Wait Time for too long because Snaplex nodes on an older version will stop accepting new Pipeline execution requests after the mandatory upgrade. This scenario can cause the nodes to wait for running Pipelines to complete and new Pipeline executions to not start as the older Snaplex version is no longer supported. The automatic Snaplex update has a 60-minute window during which the older version is supported. 


Snaplex node types: 
Hostname/Server type pairs

Groundplex only.Specify the type of service a Snaplex node should provide.

Applicable in Ultra-enabled environments.

Global properties: 
Key/Value pairs

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

...