Versions Compared

Key

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

...

  1. As an Org admin, log into SnapLogic Manager.

  2. Under Project Spaces on the left, locate the project where you want to create your Groundplex (or the global shared project), then select the Snaplexes tab on the right.


  3. Click the Create + button and complete the Create dialog (later known as the Update Snaplex dialog). 


  4. Once completed, the dialog reopens to the Downloads panel.
  5. Download the Windows ZIP file and the configuration file onto the Windows machine where you want the Groundplex installed.

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

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


  8. Check your Windows environment to see if you have a version 8 or 11 of Java.

    Note
    titleVersion of Java

    Make sure the version of Java that you are installing matches the type (32-bit or 64-bit) of Windows machine.


    Do this by executing the command java -version in a command window.


    1. If the version of Java is less that 8 (or the latest recommended version, which is JRE 11), download the Windows JRE and install the JRE at c:\opt\java.

    2. If JRE 8  or 11 is already available on the machine, the existing installation can be used. Use 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 JRE auto-update, then each time a JRE update occurs, the older JRE installation is deleted by default. As a result, the Snaplex fails to start after the JRE update. To avoid this issue, use the static installation feature of the JRE installer. (Refer to Static JRE Installation for more information.)
      To do a static install:
      • Add the STATIC=1 option when running the JRE installer from the command line or from the Run dialog.
      • When the JRE auto-update occurs, uncheck the uninstall option for older JRE installations. This prevents the older installation from being removed. 

  9. After the software has been installed, place the downloaded configuration file in the /\opt/\snaplogic/\etc directory and make sure the file name ends with .slpropz.

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

  11. To establish if the process started, run the command: jcc.bat status
    It should be in the RUNNING state.
    To verify 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.
    Image Removed

Starting a Snaplex as a Service

...


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

    Then, go to the Windows Control Panel services,

...

  1. to view the entry for the SnapLogic Snaplex

...

  1. , and start the service from

...

  1. Tools in the

...

The installation instructions are as follows:

...

  • If the version of Java is less that 8 (or the latest recommended version, which is JRE 11), download the Windows JRE and install the JRE at c:\opt\java.
  • If JRE 8 or 11 is already available on the machine, the existing installation can be used. Use 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. Services window.
  2. To establish if the process started, run the command: jcc.bat status

...

  1. . The state should be

...

  1. Running.

  2. To verify

...

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

...

  1. the Snaplex.
    Image Added


Upgrading on Windows

By default the JCC will automatically update itself. To disable this, apply the following setting in c:\opt\snaplogic\etc\global.properties:

...

Note

The autoupgrade process updates the binaries for the JCC process. When running as a service, doing a service restart causes the Monitor process to start with the old binaries files.

To update the service to use the latest binaries, run the command:
c:\opt\snaplogic\bin\jcc.bat update_service

...