Everything you wanted to know about slpropz

[rdill]

Everything you wanted to know about slpropz

First and foremost slpropz replaces the key & global property files that were previously used. slpropz was introduced in the Fall 2016 release or 4.7. It allows the user to edit groundplex properties using the manager instead of having to edit text files on each node. When a new groundplex is defined the slpropz is created and has to be downloaded and installed, see the documentation instructions:

"To setup a new Groundplex node, download and install the appropriate package for your operating system. 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 a week.

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. Then, 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."

The file only has to be downloaded once, subsequent changes done in the manager will automatically update slpropz. The manager will also prompt the user if a restart is required. If it is required, the manager will sequentially restart node 1, wait until it is back up, then restarts node two, and repeats the process as many times as there are nodes in the plex.

Linux related notes
When working with Linux, the slpropz needs to be chown and chmod before being used:

1. chown snapuser plexname.slpropz
2. chmod 744 plexname.slpropz

Windows related notes relevant for upgrades to slpropz
“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.”

slpropz is read when the jcc starts. If jcc does not find the file, it will revert to the global and key property files for configuration settings.

For customers who are interested in migrating from using the property files to slpropz, use the following steps.

1. Make a backup copy of global and key property files.
2. Copy the settings from the global and key property files into the snaplex manager dialog box. Save changes to create “mygroundplexname.slpropz.”
3. Download slpropz to /opt/snaplogic/etc on each node of the groundplex. * see OS notes below for Linux or Windows specific requirements
4. Using the command: jcc.sh, (or .bat) stop all nodes
5. Using the command jcc.sh, (or .bat) start all nodes

The groundplex will now be configured according to the settings in slpropz.

If for any reason the customer wishes to go back to the previous property files.

1. Using the command: jcc.sh stop all nodes
2. Delete slpropz on all nodes
3. Using the command jcc.sh start all nodes

When the jcc starts it looks for slpropz, if it finds it, it will use it and ignore the property files. slpropz is the recommended way to manage groundplex’s. It is recommended that customers migrate to using slpropz as soon as possible.