...
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 .properties file properties to available ports:
For HTTP port: jcc.jetty_port = 8x89
For HTTPS port: jcc.cc_secure_port = 8x81
...
Log into the SnapLogic Manager as an Org admin.
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 icon to add a Snaplex.
Complete the details in the Create Snaplex dialog and click the Create button. (later seen as the Update Snaplex dialog in the application).
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.
Create the directory
\opt
on your server in the root of the C: drive.Unzip the zip file to
c:\opt
. This will create a directoryc:\opt\snaplogic
and a directory structure as follows: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.
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.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.
Use any text editing software like Notepad to edit the file
c:\opt\Snaplogic\bin\jcc.bat
and change the entry for theJAVA_HOME
environment variable to the location of the existing installation, putting double quotes around the value.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.
From the command prompt, change to the
\opt\snaplogic\bin
directory. You may start the node by running the command:jcc.bat start
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.To establish if the process started, run the command:
jcc.bat status
. The state should beRunning
.To verify if the Snaplex has started, visit https://elastic.snaplogic.com/sl/dashboard.html#Health
The newly installed node should show up in the list of nodes for the Snaplex.
...
Info |
---|
If you have a customized node configuration, make sure to back up the global . properties file to retain the customized node configuration after the upgrade. |
...
Common Errors | Reason | Response |
---|---|---|
The Groundplex deployed on Windows 2022 has stopped running. | Groundplex on a Windows 2022 Server. | Windows 2022 server is now tested/supported for Groundplexes. For more information on deployment refer to Groundplex Deployment Planning |
...