Versions Compared

Old Version 54

changes.mady.by.user Leena Gopal

Saved on

compared with

New Version 55

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

Overview

SnapLogic support for the Groundplex (also known as an on-premise Snaplex) on a Docker container empowers customers to optimize IT infrastructure costs while benefiting from containerized technology.

The latest SnapLogic Docker image is based on AlmaLinux. Since we host the Docker image in the Docker Hub, you need to perform a pull operation to retrieve the latest Docker image.

For Docker-based Snaplex installation, updating the Docker images updates the JRE version.

Info

We recommend installing the latest JRE 11 version available at https://adoptium.net/temurin/releases/?version=11.

If you are running with 11.0.10 onwards, endpoint connections to TLS 1.0 and 1.1 are disabled by default. We recommend that you update the endpoint to support TLS 1.2 or higher, for security.

Prerequisites

Installing Groundplex in a Docker Container

  1. Retrieve the latest Docker image from Docker Hub using the following pull command:

    Code Block
    docker pull registry.hub.docker.com/snaplogic/snaplex:main-<build number>>

  2. In SnapLogic Manager, navigate to your target Groundplex instance and click it to display the Update dialog.

  3. In the Downloads tab, click image-20240710-122356.png next to Configuration option to download the slpropz file for your Groundplex node.

image-20240625-064502.pngImage Removedupdate-snaplex.pngImage Added

After downloading the configuration file, you are ready to launch your Groundplex as a Docker container.

Create a Docker Image for a Groundplex

You can now create a Docker image from Linux/RPM, available in the Downloads tab as a more secure alternative using the Docker file. The Docket file lists all the commands required to build the Docker image. 

image-20240625-064502.png
Info

Prerequisite

Before launching the Docker build command ensure the following:

  • The SnapLogic war file is in the proper location (“/tmp/snaplogic-sidekick-*.rpm”)

  • The nomenclature includes sidekick.

  1. To execute the Docker build with the Docker File, use the command: docker build - < Dockerfile>

  2. The docker build command builds the Docker images from a Docker file and a context, which is the set of files located in the specified PATH or URL. Learn more at Docker File.

You can download the RPM from the Snaplex tab and the run.sh script can be copied from the published containers. The details of the image layer are shown in the repeating video.

Running a Snaplex Node from Docker

To run the Snaplex node from Docker:

  1. Create a local directory <Configuration_Path>/etc, and add the slpropz configuration file to the folder, ensuring that the file extension is .slpropz.

  2. Create an empty log folder <Log_Path>/log. The JCC logs are written to this directory.

  3. Enter the following command to create and run the latest version of the Docker container image:

    Code Block
    docker run -itd -h <Container_Host_Name> \
-p 8090:8090 -p 8081:8081 \
-v <CONFIG_PATH>/etc:/opt/snaplogic/etc \
-v <LOG_PATH>/log:/opt/snaplogic/run/log \
snaplogic/snaplex:latest

    where:

    • -p enables port mapping, so that you can use the local dashboard and FeedMaster. You can also use other Docker networks, if required.

    • -v enables you to specify the Docker volume to use. Store the <Snaplex_Name>.slpropz in the /opt/snaplogic/etc directory.

Note

For this command to work, you need to complete the following tasks:

  • Expose ports 8090 and 8081 for standard Snaplex nodes.

  • Expose port 8084 for FeedMaster nodes.

  • Mount the configuration file to the /opt/snaplogic/etc directory.


Example

Info

Depending on how you install Docker, you may need to use sudo. For more information on the Docker run command, see Docker Run.

See Also