Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: PLAT-7051

...

Known Issue

When deploying a Docker Container as your Snaplex, you must change ownership permissions of the /opt/snaplogic/etc folder from root to snapuser; otherwise, the following message is displayed on the Dashboard > Alerts tab:

Local path has incorrect permissions: found={'owner': 'root', 'path': '/opt/snaplogic/etc', 'perms': 'RWX'}; required={'owner': 'snapuser', 'path': '/opt/snaplogic/etc', 'perms': 'RWX'}

Installing Groundplex in a Dockerized Container

  1. Retrieve the latest Docker image from Docker Hub using the following pull command to retrieve the latest version of the Docker image:

    Paste code macro
     docker pull snaplogic/snaplex:latest
    This retrieves the latest version of the Docker image.


  2. In In SnapLogic Manager, browse navigate to your Groundplex instance and download the configuration file from the control plane:your target Groundplex instance, click it to display the Update dialog.

  3. Click Downloads, and click Image Addedin the Configuration option to download the .slpropz file for your Groundplex node.

Once the configuration file is downloaded, you are ready to launch your Groundplex as a Docker container.

Running

...

a Snaplex Node from Docker

To run the JCC Snaplex node from Docker, use the command below :

  1. Create a local directory <CONFIG_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 will be written to this directory.
  3. Run the following command to create and run the latest version of the Docker container image:

    Paste code macro
    docker run -itd -h 

...

  1. <Container_Host_Name> \
    -p 8090:8090 -p 8081:8081 \
    -v 

...

  1. <CONFIG_

...

  1. PATH>/etc:/opt/snaplogic/etc

...

  1.  

...

  1. \
    -v 

...

  1. <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 regular JCCsstandard Snaplex nodes.
  • Expose port 8084 for a FeedMaster nodes.
  • Mount the config configuration file to /opt/snaplogic/etc directory.


Example
Image Modified


Info

Depending on how Docker is installed, the use of sudo might be required.

For more information on the Docker run command, review the documentation on Docker Run.

...