Versions Compared

Old Version 83

changes.mady.by.user Leena Gopal

Saved on

compared with

New Version 84

changes.mady.by.user Leena Gopal

Saved on

Key

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

In this article

Table of Contents
maxLevel2

...

Groundplex installation covers the following tasks:

  1. Setting up a Groundplex.

  2. Importing a certificate.

For prerequisites, see Groundplex Deployment Planning. 

Note

Linux-based Groundplex Installation Tips

  • The Linux installer comes bundled with the JRE necessary for this Snaplex. We recommend you use the patch version of Java 11 that is bundled with the installer for your Linux environment. 

  • Before you begin, learn more about memory configuration for dynamic workloads here.

Setting up a Groundplex

  1. Log into SnapLogic Manager as an Org admin.

  2. Navigate to the project where you want to create your Groundplex, and perform one of the following steps:

    • Click the Snaplex tab, then click  (blue star)  to display the Snaplex dialog.
      OR

    • Click (blue star) to display the Assets drop-down list, then select Snaplex; the Snaplex dialog appears.

      Image RemovedImage Added

  3. Enter the required information on the Create Snaplex form. Once completed, the Downloads tab on the Snaplex popup appears. The Downloads tab has links to the installer and configuration files.

  4. Download the RPM or DEB-based installer and configuration files onto a Linux machine, where <filename> is the name of the current installer file and fontconfig and zip are the required dependencies:

    • For CentOS (or Redhat) 6.3 or newer, run the following commands:
      $ sudo yum install fontconfig zip
      $ sudo rpm -i <filename>.rpm

    • For Ubuntu 14.04 or newer, run the following command: 
      $ sudo apt-get install fontconfig zip
      $ sudo dpkg -i <filename>.deb

  5. After the software is installed, place the downloaded configuration file in the /opt/snaplogic/etc directory and make sure the file name ends with .slpropz. Change the .slpropz file so that snapuser owns it by running the following commands:

    Code Block
    $ sudo chown snapuser:snapuser /opt/snaplogic/etc/myplex.slpropz
$ sudo chmod 600 /opt/snaplogic/etc/myplex.slpropz

  6. To start the Snaplex service, run:
    $ sudo /opt/snaplogic/bin/jcc.sh start

  7. To verify the Snaplex has started, visit https://elastic.snaplogic.com/sl/dashboard.html#Health. The newly installed Snaplex node should appear in the list of nodes for the Snaplex.

Note

Disable noexec Setting

Some Snaps, such as the 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. Else, 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.

Info

FeedMaster Installation

Ultra Pipelines require that you set up a FeedMaster along with the JCC (Java Component Container) nodes in your Groundplex. For details, see Deploying a FeedMaster Node.

...

To generate and import a self-signed certificate on all the JCC nodes in the Snaplex:

  1. Obtain the certificate (.pem) file by using SSH.

  2. Import the file by using the following command in the JCC node:

    Paste code macro
    /opt/snaplogic/pkgs/jre1.8.0_45/bin/keytool -import -file <path_to_pem_file_from_step_1> -alias <alias_name_optional> -keystore /opt/snaplogic/pkgs/jre1.8.0_45/lib/security/cacerts -vEnter keystore password: changeit
    Note

    This example is an excerpt from 1.8.0_45; the directory path might vary based on the Java installation directory.

  3. Restart the JCC node process to confirm the import.

  4. Run the following command to list certificates from the CAcerts file:

    Paste code macro
     /opt/snaplogic/pkgs/jre1.8.0_45/bin/keytool -list --keystore /opt/snaplogic/pkgs/jre1.8.0_45/lib/security/cacerts -v+

...

Info

Setting limits for Docker Containers

For Docker deployments, you may not be able to set these limits because of permissions issues with the su – user user. Instead you can set the ulimits using the --ulimit parameter when running the docker run command. The limits described above also apply to the Docker container ulimits.

...

Related content

Video: Installing a Groundplex through a Debian-based Linux Distribution

...