Add Snaplex
The Snaplexes screen allows the Environment admins to create the Groundplex, add nodes to the Groundplex, and also edit the Snaplex details. The Groundplex is required for integrating with endpoints that are not in the Cloud, such as an Oracle database instance in another data center.
The following image shows the fields on the first tab of the page to add a Groundplex:
The following procedure provides the general steps for creating a Snaplex.
- From the Snaplex screen click + Add Snaplex to get the Untitled Groundplex page.
- Specify the details to configure the Groundplex in the Settings, Logging, Node properties, and Node proxies tabs.
- Click Save. The Groundplex created is added to the Snaplex list.
The Downloads tab displays after the Snaplex is created. Learn more about installation files at Download files.
For detailed description of the values to be specified refer to the following table.
- Settings
- Logging
- Node properties
- Node proxies
| Field | Description |
|---|---|
| Name |
Specify a unique name for the Groundplex. The name must not exceed 100 characters and can include characters and numbers. We recommend you use a descriptive, memorable name for your Snaplex using alphabets followed by numbers. Default value: None. Example: Test123 |
| Environment |
Specify the value to configure the Snaplex nodes. Default value: None. Example: Test-10k Important: For existing Snaplexes, stop the nodes before updating
the Environment value. Download the installation
pacakge and restart the nodes for the Environment value to take effect.
|
| Location | Select the default option sidekick. Default value: sidekick |
| Select project | Select your target project or shared folder from the dropdown. |
| Version |
Select the Snaplex version. By default, all new Snaplexes are configured to work with the latest version of the Snaplex. Default value: None. |
| 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. The Load Balancer URLs in the Snaplex settings, are used for the 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. This property is available only to Environments that have subscribed to Ultra Tasks. Default value: None. Example: https://ultralb.mydomain.com |
| Notifications email address |
List the email addresses to notify if one of the Snaplex nodes does not respond for 15 minutes. Default value: N/A Example: [email protected] |
| Notifications Slack channel |
Specify the name of Slack channels (separated by commas) to notify if one of the Snaplex nodes does not respond in 15 minutes. Default value: None. Example: DevOps |
| Notifications Slack user |
Enter the Slack recipients (separated by commas) to notify if one of the Snaplex nodes does not respond for 15 minutes. Default value: N/A Example: testuser |
| Field | Description |
|---|---|
| Level | Specify the minimum level of logging or the type of details that you want to enable for the new Snaplex.
Available values:
|
| Log file size |
The maximum size of the log file to be created for the Snaplex. Default value: 300 |
| Metric | Select the log file size in KB, MB or GB from the dropdown. Default value: MB |
| Main backup count | The number of backup main log files that SnapLogic must maintain for the Snaplex. Default value: 40 |
| Error backup count | The number of backup error log files that SnapLogic must maintain for the Snaplex. Default value: 5 |
| Access backup count |
The number of backup access log files that SnapLogic must maintain for the Snaplex. Default value: 5 |
| Field | Description |
|---|---|
| Max. 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. Else, they will fail or be queued, depending on how they were executed. The number of slots in use corresponds to the number of active threads on a node, which you can be view in the Snaplex . Default value: 4000 |
| 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
Pipeline Execute Snap do not have access to these slots. Changes made to this
setting do not require a restart. Default value: 15 |
| Max. memory | The memory threshold at–and above–which no more pipelines can be assigned
to a node. Changes made to this setting do not require a restart. Default value: 85 |
| Max. restart wait time | The maximum wait time before restarting a node. The toggle allows the
Admin Manager to Set restart wait time to Forever. Once
enabled the default value field gets disabled.
Default value: 15 minutes |
| Max. heap size | The maximum JVM heap size. Default value: auto Important: When the value is auto,
SnapLogic automatically sets the maximum heap size based on the available
machine memory. |
| HTTP Interface | Specify the location from which the Snaplex node can accept HTTP network
connections. The following options are available:
|
| HTTP Port | The HTTP port on which the Snaplex node listens for connections.
Default value: 8090 for a JCC node and 8091 for a FeedMaster. |
| HTTPS Ports |
The HTTPS port on which the Snaplex node listens for connections. Default value: None. |
| Snaplex node types (Hostname/server type) |
Add a Hostname for the type of server JCC or FeedMaster from the dropdown. You can also add new nodes using the + Add new node type. Default value: None. |
| Global properties (Key/Value pairs) |
Internal configuration options. Do not edit these values without contacting your CSM. You can also add new nodes using the + Add new global property. Default value: None. |
| Field | Description |
|---|---|
| HTTP proxy host name | Configuration details associated with the HTTP proxy server. The URL of
the HTTP proxy host. Example: 172.0.10.162 Default value: None. |
| Port |
The port number on which the HTTP proxy host listens. Example: 3127 Default value: None. |
| Non-proxy host |
The hostnames or IP addresses that should be contacted directly instead of through the proxy. Patterns might start or end with a * for wildcards. There is an option to add new proxy host using + Add new non-proxy host. |
| HTTPS proxy host name | Configuration details associated with the HTTPS proxy server. The URL of
the HTTPS proxy host. Example: 172.0.10.162 Default value: None. |
| Port |
The port number on which the HTTPS proxy host listens. Example: 3127 Default value: None. |
| Non-proxy host |
The hostnames or IP addresses that should be contacted directly instead of through the proxy. Patterns might start or end with a * for wildcards. There is an option to add new proxy host using + Add new non-proxy host. |