Install Groundplex in a Docker container

1. For Docker-based Snaplex installation, updating the Docker images also updates the Java Runtime Environment (JRE) version.

   Important: We recommend installing the latest JRE 11 version available at Latest Releases | Adoptium.
   Note: 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.
2. Retrieve the latest Docker image from Docker Hub using the following pull command:

   docker pull snaplogic/snaplex:main-<build number>

3. In Admin Manager, navigate to Snaplexes screen to view pages listing the Snaplexes and select the Groundplex instance to display the Update screen.
4. In the Downloads tab, click in the Configuration option to download the slpropz file for your Groundplex node.
   
   
   
   
5. After downloading the configuration file, you are ready to launch your Groundplex as a Docker container.

Create a Docker image for the Groundplex

Using the Docker file, you can now create a Docker image from the Linux/RPM available in the Downloads tab. This option serves as a more secure alternative. The Docker file contains a list of all the commands needed to build the Docker image.

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
   Note: The run.sh script can be copied from the published containers. The details of the image layer are shown in the repeating video.
   
   
   
   
   

Run a 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:

   
                      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 
                   

   • -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.