Versions Compared

Old Version 63

changes.mady.by.user Leena Gopal

Saved on

compared with

New Version Current

changes.mady.by.user Leena Gopal

Saved on

Key

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

...

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

Info

Groundplexes can now run on Windows Server 2022.

Installing the Snaplex

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

  2. Under Project Spaces on the left, create a project space or locate the project where you want to create your Groundplex (or the global shared project). Select the Snaplexes tab on the right and click the (blue star) icon to add a Snaplex.

     

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

  4. The Update Snaplex dialog opens with the Downloads tab for selecting and installing the appropriate package for the operating system. Download the Windows/ ZIP configuration files onto the Windows machine where you want the Groundplex installed.

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

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

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

  8. Check your Windows environment to see if you have Java 11 version. This can be done by executing the command java -version from the command window.

    1. If the installed version of Java is below JDK 11, download and install the JDK for Windows. The existing installation can be used if JRE 11 is available on the machine.

    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.

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

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

  10. To install Snaplex as a Windows service, run the following command as an administrator: jcc.bat install_service. From the Windows Control Panel, view the entry for the SnapLogic Snaplex, and start the service from Tools in the Services window.

  11. To establish if the process started, run the command: jcc.bat status. The state should be Running.

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

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

...

Expand
titleAre you starting the JCC node as an administrator? Is the c:\opt\snaplogic\run\log folder full? If it is full, delete the logs and try restarting again.

Temporary files created by the Snaplex service are stored under the user account that started the JCC process. In some cases, if the user account used to start Snaplex is changed or if Snaplex was previously started as an application and is now being started as a service, you might encounter startup errors because the user account is different. In such cases, deleting the following folders can help fix the issue:

  • run\log

  • run\fs

  • run\broker54

Expand
titleIs JAVA_HOME set correctly?

In a Snaplex installation on a Windows machine, you must install the JRE and configure the JRE location in the jcc.bat property. While a Snaplex auto upgrade updates the SnapLogic binaries in the installed Snaplex, the JRE version is not automatically updated. You must manage the JRE version in your self-managed Snaplex.

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

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

Expand
titleDoes the user running the Snaplex be a member of any specific group to see the Snaplogic metrics?

Yes, the Snaplex user must be a member of the specific group. Add the executing user to the Performance Monitor Users group and restart the service to view CPU usage in Snaplogic.

Expand
titleFor Windows-based Groundplex, do we support installing our software in another drive other than C:\ ?

Yes, we can install it in another drive. You must change the SL_ROOT variable in jcc.bat to another drive or path. The default path is c:\opt\snaplogic and SL_ROOT=c:\opt\snaplogic

Troubleshooting

Common Errors

Reason

Response

The Groundplex deployed on Windows 2022 has stopped running.

Groundplex on a Windows 2022 Server.

Windows 2022 server is

NT

now tested/supported for Groundplexes. For more information on deployment refer to Groundplex Deployment Planning

 

...

Reference