SSDM-9972: modify and improve the section about highwater mark in DSS service.properties template

openbis_standard_technologies/dist/etc/service.properties

@@ -64,14 +64,27 @@ shutdown-timeout = 180
 # for the data stream url. If not specified default value (20 seconds) will be used.
 # minimum-time-to-keep-streams-in-sec = 20
 
-# If free disk space goes below value defined here, a notification email will be sent.
-# Value must be specified in kilobytes (1048576 = 1024 * 1024 = 1GB). If no high water mark is
-# specified or if value is negative, the system will not be watching. There are 2 different kinds
-# of highwater mark supported: the one that is checking the space on the store, and one that is
-# checking the amount of free space for recovery state (on the local filesystem). 
+#===============================
+# Data Set Registration Halt:
+#
+# In order to prevent the data store from having no free disk space a limit (so called highwater mark) can be
+# specified. If the free disk space of the associated share goes below this specified value, 
+# DSS halts to register data sets. Also a notification log and an email will be produced. 
+# When the free disk space is again above the limit registration will be continued.
+
+# The value must be specified in kilobytes (1048576 = 1024 * 1024 = 1GB). If no high water mark is
+# specified or if the value is negative, the system will not be watching. There are 2 different kinds
+# of highwater mark supported: the one 'highwater-mark' that is checking the space on the store, and 
+# one 'recovery-highwater-mark' that is checking the amount of free space for recovery state (on the local filesystem).
+# 
+# Core plugins of type drop box and ingestion services (special type of reporting-plugins) can override the
+# highwater mark value individually by specifying the property 'incoming-share-minimum-free-space-in-gb' 
+# in their plugin.properties. 
 highwater-mark = -1
 recovery-highwater-mark = -1
 
+
+
 # If a data set is successfully registered it sends out an email to the registrator. 
 # If this property is not specified, no email is sent to the registrator. This property
 # does not affect the mails which are sent, when the data set could not be registered.