In this article

Overview

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

Pre-requisites

Anti-virus

...

requirements

To ensure the smooth functioning of the Snaplex node, we suggest disabling any anti-virus or firewall software (, including the Windows firewall) installed on the Snaplex node. If you cannot disable disabling the software cannot be done, then ensure that the Snaplex process is not scanned by the anti-virus software does not scan the Snaplex process. The specific action depends required may vary depending on the type of antivirus software type and scanning rules enabled. The following are the guidelines:

• Disable the network firewall functionality for the following ports: 8081, 8084, 8089, and 8090.

  See

  Refer to the Required Ports section

  below

  for more information about workarounds for other applications using the required ports.

• Disable filesystem scanning for the c:\opt\snaplogic folder.

• Disable process-level scanning for the SnapLogic service.

Required Ports

If another application already uses one of the JCC ports used by SnapLogic, the JCC nodes do not complete a full start cycle. The workaround is to override the default port by assigning the following entries in the global.the global properties  file to available ports that are available:

• For HTTP port: jcc.jetty_port = 8x89

• For HTTPS port: jcc.cc_secure_port = 8x81

Java Development Kit (JDK)

You must install the Java Development Kit (JDK) before installing your on-premise Snaplex. The SnapLogic platform supports Java 11. We recommend you use , and we recommend using the latest patch version available of for Java 11 for your Windows environment. To  To update your Snaplex to the Java 11, see refer to Upgrading Your Groundplex to Java 11.

...

...

JDK11 Distribution

Only AdoptOpenJDK 11 (Adoptium) is certified by SnapLogic.

...

As no other JDK 11 distribution is currently certified by SnapLogic, we recommend

...

only using Adoptium's JDK when upgrading to Java 11

...

. Select the appropriate Operating System, Architecture, Package Type, and Version from the Adoptium site and download the Zip file and then unzip the files to the appropriate directory.

File Name Length

File names generated by SnapLogic for suggest suggested data can be longer than 260 characters long. We recommended that you configure the Snaplex node to allow longer file paths. See Learn more at Maximum Path Length Limitation - Win32 apps for details.

Installing the Snaplex

...

Installing the Snaplex

1. Log into the SnapLogic Manager as an Org admin.

2. Under Project Spaces on the left,

...

1. create a project space or locate the project where you want to create your Groundplex (or the global shared project)

...

1. . Select the Snaplexes tab on the right and click the icon to add a Snaplex.
   

...

1. Image AddedImage Added

    

2. Complete the details in the Create Snaplex dialog and click the Create button. (later seen as the Update Snaplex dialog in the application). 
   

...

1. Image Added

2. The Update Snaplex dialog opens with the Downloads tab for selecting and installing the appropriate package for the operating system. Download the Windows/ ZIP

...

1. configuration

...

1. files onto the Windows machine where you want the Groundplex installed.
   

   Image Added

2. Create the directory \opt on your server in the root of the C: drive.

3. Unzip the zip file to c:\opt. This will create a directory c:\opt\snaplogic and a directory structure as follows:
   

...

1. Image Added

2. After installing the software, move the Configuration file (you can get this from the Update Snaplex dialog) to the \opt\snaplogic\etc directory and ensure the file extension is .slpropz.

3. Check your Windows environment to see if you have

...

...

1. Java 11 version. This can be done by executing the command java -version

...

1.  from the command window.
   

...

1. Image Added

   1. If the installed version of Java is

...

1. 1. below JDK 11,

...

1. 1. download and install the JDK for Windows. The existing installation can be used if JRE 11 is

...

1. 1. available on the machine

...

1. 1. .

   2. Use any text editing software like Notepad to edit the file c:\opt\Snaplogic\bin\jcc.bat and change the entry for the JAVA_HOME environment variable to the location of the existing installation, putting double quotes around the value.
      

...

1. 1. Image Added

   2. If the host machine is configured for JDK auto-update, then each time a JDK update occurs, the older JRE installation is deleted by default. As a result, the Snaplex fails to start after the JDK update. To avoid this issue, use the static installation feature of the JDK installer.  
      To do a static install:

      • Add the STATIC=1 option when running the JDK installer from the command line or from the Run dialog.

      • When the JRE auto-update occurs, uncheck the uninstall option for older JDK installations. This prevents the older installation from being removed. 
        

...

1. From the command prompt, change to the \opt\snaplogic\bin directory. You may start the node by running the command: jcc.bat start

...

1. To install

...

1. Snaplex as a Windows service, run the following command as an administrator: jcc.bat install_service.

...

1. From the Windows Control Panel

...

1. ,

...

1. view the entry for the SnapLogic Snaplex, and start the service from Tools in the Services window.

2. To establish if the process started, run the command: jcc.bat status. The

...

1. state should be Running.

2. To verify if the Snaplex has started, visit https://elastic.snaplogic.com/sl/dashboard.html#Health

3. The newly installed node should show up in the list of nodes for the Snaplex

...

1. .

Upgrading on Windows

Updating Cygwin Binaries

When running the Windows-based Snaplex as a service, performing a service restart causes the Monitor process to start with the old binaries files. 

...

When upgrading your Snaplex to the

...

latest version, you need to reinstall the Snaplex using the

...

latest version of the installer zip file for Windows. Upgrading through the Manager will only upgrade the war file,

...

not the binaries. 

...

To update the service to use the latest binaries, you can choose from one of the two following options:

Option 1: Perform a

...

complete reinstallation

...

1. Stop the Windows-based Snaplex service.

2. Remove using bin\jcc.bat remove_service.

3. Back up the configuration files from the \etc folder.

...

1. Remove C:\opt\snaplogic.
   

   Image Added

2. Reinstall the Windows-based Snaplex using the latest version zip file.

...

...

...

...

Reinstall the Windows-based Snaplex using the 4.29 zip file.

Option 2: Install the Latest Cygwin Binaries Only

1. Unzip the

...

1. version zip into a different location.

2. Copy bin\cygwin1.dll and bin\cygrunsrv.exe from the new zip to the existing installation location.

3. Update and restart the service using bin\jcc.bat update_service.

...

Disabling Automatic Update

...

Uninstall the SnapLogic Snaplex package from your environment

To uninstall the SnapLogic Windows-based package from your environment:

1. Stop the Snaplex service before uninstalling or installing the Snaplex elsewhere by using the following command.
   run bin\jcc.bat stop.

2. If Snaplex is installed as a service, the service needs to be removed by running the command.
   bin\jcc.bat remove_service.

3. Clean up the directory \opt on your server in the root of the C: drive.
   

   Image Added

If you are reinstalling a JCC node, stop the Snaplex service that is already installed.

Older Versions of JRE and TLS

JRE versions before 11.0.8 have issues connecting to TLS 1.3 endpoints. We recommend using an updated version of JRE.

Renabling Support for Older Versions

If updating the TLS endpoint is not possible, then the Snaplex JRE can be updated to re-enable support for older TLS versions by doing these steps:

1. Open the jre/conf/security/java.security file in the JRE installation folder that you configured during installation.

2. Change the jdk.tls.disabledAlgorithms configuration property by removing TLSv1, TLSv1.1.

3. Restart the Snaplex to re-enable support for TLS 1.0 and 1.1.

Renaming Snaplexes

1. In the Manager tab, navigate to the Shared or specific Project folder and click on the Snaplexes filter.

2. Select the Groundplex you wish to rename.

3. In the Groundplex Update dialog, change the name to your desired name and click the Update button. The change will immediately be visible in the Dashboard; however, in Designer, the drop-down box for pipeline design will reflect the old name for some time. Despite the difference in name in the Designer tab, the pipelines continue to validate or execute.

Groundplex - Windows Service Account Settings

1. Create an Active Directory Service Account User and provide the required permissions on the network objects on the Groundplex.                                                          

2. Set the Service Account user to be able to run the Snaplogic Snaplex service.

   1. Add the Service Account user to the local Administrators group.

   2. Add the Service Account user to Windows Administrative Tools > Local Security Policy > Local Policies > User Rights Assignment > Log on as a service.

3. From Command Prompt as Administrator

   1. Install as a service (C:\opt\snaplogic\

...

1. 1. bin\

...

jcc.enable_auto_download = False

...

1. 1. jcc.bat install_service)

2. From Windows Services

   1. Change login to the Service Account user

   2. Start the service

Learn more at Service Accounts | Microsoft Learn

FAQ

...

...

...

...

...

...

...

...

...

Older Versions of JRE and TLS

JRE versions prior to 11.0.8 have issues connecting to TLS 1.3 endpoints. We recommend using a newer JRE version.

Renabling Support for Older Versions

If updating the TLS endpoint is not possible, then the Snaplex JRE can be updated to re-enable support for older TLS versions by doing these steps:

1. Open the jre/conf/security/java.security file in the JRE installation folder that you configured during installation.

2. Change the jdk.tls.disabledAlgorithms configuration property by removing TLSv1, TLSv1.1.

3. Restart the Snaplex to re-enable support for TLS 1.0 and 1.1.

...

Troubleshooting

...

Related Content

• The SnapLogic Snaplex

• Updating a Snaplex

• SnapLogic Release Process

• Adding the SnapLogic Platform to your Allowlist

Reference

• Video: Installing Groundplex on Windows