Adding a Groundplex Node to your Snaplex

After you create a Self-managed Snaplex, you can still add nodes to your existing Groundplex by using the following procedure to update the Snaplex properties file.

1. Download and install the appropriate package for your operating system.

   The Downloads tab is not visible until after a Snaplex is created. You must be an Org admin to access the Download links.

2. After the software has been installed, download the following configuration file and place it in the /opt/snaplogic/etc directory and make sure the file name ends with .slpropz. The download link is valid for one hour. 
   

3. To migrate existing Groundplex nodes to use the .slpropz configuration file, make sure the values in the Node Properties and Node Proxies match what you have configured in your global.properties file.
   

4. Download the. slpropz configuration file, place it in the /opt/snaplogic/etc directory and restart the JCC service. 

If the Groundplex fails to restart after a new configuration is installed, it reverts back to the last working configuration.

Best Practices

• When upgrading a Windows Groundplex to use the slpropz configuration file, the Monitor process would need to be updated by running jcc.bat update_service. The max heap space for the JCC process can be set incorrectly if the Monitor process is not updated.
  

• If you are unable to create an SLDB file using international language characters (such as æ, Æ, Ø) in the file name, update the jcc.use_lease_urls property in the Snaplex's Global Properties to False. This workaround works for all UTF-8 characters, and hence supports all global languages.
  

• By default, if the first run of an Ultra Task fails, SnapLogic attempts to run it for a total of five times. However, you can configure the number of times you want Ultra Tasks from a specific Snaplex to run by configuring the maximum number of allowed retries for an Ultra Task. To do so, modify the following parameter in Global Properties in Snaplex Update: ultra.max_redelivery_count to indicate the number of times you want a failed Ultra Task to run.
  

• We recommend that for your critical workloads on the production environment, you use a minimum of two worker nodes (and two FeedMaster nodes for Ultra) to avoid service disruption during Snaplex upgrades.

Migrating older Snaplex nodes 

If you have a Snaplex  running with a global.properties file in the $SL_ROOT/etc folder, you should consider migrating the Snaplex to use the slpropz mechanism for the configuration. Running with global.properties file requires that for any configuration change you must manually update the global.properties file, copy the updated configuration to all the nodes, and then restart all the nodes.

To migrate the Snaplex configuration to the slpropz mechanism:

1. Update the Snaplex properties in Manager by adding custom configurations, which remain in the global.properties into the Snaplex properties.

   If you do not complete this step, then the configuration changes applied to the nodes are not available when running with slpropz.

2. Navigate to the Manager > Update Snaplex > Downloads tab, and download slpropz file into the $SL_ROOT/etc folder.
   

3. Backup the global.properties and keys.properties files, then remove them from the $SL_ROOT/etc folder.
   

4. Restart the JCC process on all the nodes through the Public API. Alternatively, as an Org admin, you can restart the JCC node through the Dashboard by clicking on the target node and selecting Node Restart.

The Snaplex nodes should run with the new slpropz mechanism, allowing for remote configuration updates.