Install a Groundplex on Linux

Overview

This article describes the procedures for installing an on-premise Snaplex in a Linux environment. An on-premise Snaplex is also known as a Groundplex. This document uses the term Groundplex to distinguish this type of Snaplex (on-premise) from a Cloudplex, which SnapLogic manages. However, in command syntax and references to the UI, the generic term Snaplex is used.

Groundplex installation covers the following tasks:
  1. Download the Groundplex installation files from the project you want to associate with the Groundplex.
  2. Run the installer on the Linux machine.
    • CentOS or Red Hat
    • Debian or Ubuntu
     $ sudo yum install fontconfig zip
$ sudo rpm -i filename.rpm
    where
    • fontconfig and zip are the required dependencies.
    • filename is the name of the installation file.
     $ sudo apt-get install fontconfig zip
$ sudo dpkg -i filename.deb
    where
    • fontconfig and zip are the required dependencies.
    • filename is the name of the installation file.
  3. Copy the downloaded configuration file to c:\opt\snaplogic\etc.
    Important: The file extention must be slpropz. Example: mysnaplex.slpropz
  4. Set snapuser as the owner of the .slpropz file. 
     $ sudo chown snapuser:snapuser /opt/snaplogic/etc/myplex.slpropz
$ sudo chmod 600 /opt/snaplogic/etc/myplex.slpropz
  5. Start the JCC node as a Snaplex service. 
    $ sudo /opt/snaplogic/bin/jcc.sh start
  6. Verify that Snaplex started.

    Go to https://elastic.snaplogic.com/sl/dashboard.html#Health.

    The newly installed JCC node will appear in the list of nodes for the Snaplex.

java.lang.OutOfMemoryError: unable to create new native thread

  • Some Linux installations have system ulimit settings that are set to lower values. This low setting can cause errors when running higher Pipeline loads on the Groundplex JCC node.

    1. Increase the system limits for the snapuser user.

      Add the following in the /etc/security/limits.conf file:

       snapuser soft nproc 8192
snapuser hard nproc 65536
snapuser soft nofile 8192
snapuser hard nofile 65536
    2. Restart the JCC process.
  • Enhance the security of your groundplex with an SSL/TLS certificate. Learn how to import a certificate into your JCC nodes.
  • Disable the noexec setting. Some Snaps, such as the Azure Synapse SQL Bulk Load Snaps, require write and execute permissions to the /tmp directory. Make sure you disable the noexec setting in the mount used for the /tmp directory. Otherwise, the Snap execution could fail with an error like Failed to map segment from shared object: Operation not permitted. You can also specify a different location as the temporary folder.
  • Set up a FeedMaster. Ultra Pipelines require a FeedMaster in addition to the JCC (Java Component Container) nodes in your Groundplex. Learn more: Deploying a FeedMaster Node