93_DbRep: Commandref edited

git-svn-id: https://svn.fhem.de/fhem/trunk@26865 2b470e98-0d58-463d-a4d8-8e2adae1ed80

fhem/FHEM/93_DbRep.pm

@@ -57,6 +57,7 @@ no if $] >= 5.017011, warnings => 'experimental::smartmatch';
 
 # Version History intern
 my %DbRep_vNotesIntern = (
+  "8.50.7"  => "17.12.2022  Commandref edited ",
   "8.50.6"  => "14.12.2022  remove ularm from Time::HiRes, Forum: https://forum.fhem.de/index.php/topic,53584.msg1251313.html#msg1251313 ", 
   "8.50.5"  => "05.12.2022  fix diffValue problem (DbRep_diffval) for newer MariaDB versions: https://forum.fhem.de/index.php/topic,130697.0.html ", 
   "8.50.4"  => "04.11.2022  fix daylight saving bug in aggregation eq 'month' (_DbRep_collaggstr) ",
@@ -15482,12 +15483,26 @@ sub dbval {
   <li><b>dumpCompress </b>    - if set, the dump files are compressed after operation of "dumpMySQL" bzw. "dumpSQLite" </li> <br>
 
   <a name="dumpDirLocal"></a>  
-  <li><b>dumpDirLocal </b>    - Target directory of database dumps by command "dumpMySQL clientSide" or "dumpSQLite"
+  <li><b>dumpDirLocal </b>  <br><br> 
-                                (default: "{global}{modpath}/log/" on the FHEM-Server). <br>
+  <ul>
-                                In this directory also the internal version administration searches for old backup-files 
+    Destination directory for creating dumps with "dumpMySQL clientSide" or "dumpSQLite".  <br>
-                                and deletes them if the number exceeds attribute "dumpFilesKeep". 
+    
-                                The attribute is also relevant to publish a local mounted directory "dumpDirRemote" (dumpMySQL serverSide) to
+    Setting this attribute activates the internal version management.
-                                DbRep. </li> <br>
+    In this directory backup files are searched and deleted if the found number exceeds the attribute value 
+    "dumpFilesKeep". 
+    The attribute is also used to make a locally mounted directory "dumpDirRemote" (for dumpMySQL serverSide)
+    known to DbRep. <br>
+    
+    (default: "{global}{modpath}/log/")   
+    <br><br>
+    
+    <b>Example: </b> <br>
+    attr &lt;Name&gt; dumpDirLocal /sds1/backup/dumps_FHEM/
+ 
+  <br>
+  <br>
+  </li>
+  </ul>
 
   <a name="dumpDirRemote"></a>                              
   <li><b>dumpDirRemote </b>   - Target directory of database dumps by command "dumpMySQL serverSide" 
@@ -15504,10 +15519,18 @@ sub dbval {
                                 This parameter impacts the run-time and consumption of resources directly.  </li> <br>
 
   <a name="dumpFilesKeep"></a>
-  <li><b>dumpFilesKeep </b>   - The specified number of dumpfiles remain in the dump directory (default: 3). 
+  <li><b>dumpFilesKeep </b>   <br><br>
-                                If there more (older) files has been found, these files will be deleted after a new database dump 
+  <ul>
-                                was created successfully. 
+    The integrated version management leaves the specified number of backup files in the backup directory. <br>
-                                The global attrubute "archivesort" will be considered. </li> <br> 
+    Version management must be enabled by setting the "dumpDirLocal" attribute. <br>
+    If there are more (older) backup files, they will be deleted after a new backup has been successfully created. 
+    The global attribute "archivesort" is taken into account. <br>
+    (default: 3)
+    
+  <br>
+  <br>
+  </li> 
+  </ul>
   
   <a name="executeAfterProc"></a>
   <li><b>executeAfterProc </b> - you can specify a FHEM command or perl function which should be executed 
@@ -18322,12 +18345,26 @@ sub dbval {
   <li><b>dumpCompress </b>    - wenn gesetzt, werden die Dumpfiles nach "dumpMySQL" bzw. "dumpSQLite" komprimiert </li> <br>
 
   <a name="dumpDirLocal"></a>  
-  <li><b>dumpDirLocal </b>    - Zielverzeichnis für die Erstellung von Dumps mit "dumpMySQL clientSide" oder "dumpSQLite". 
+  <li><b>dumpDirLocal </b>  <br><br> 
-                                default: "{global}{modpath}/log/" auf dem FHEM-Server. <br>
+  <ul>
-                                Ebenfalls werden in diesem Verzeichnis alte Backup-Files durch die interne Versionsverwaltung 
+    Zielverzeichnis für die Erstellung von Dumps mit "dumpMySQL clientSide" oder "dumpSQLite".  <br>
-                                gesucht und gelöscht wenn die gefundene Anzahl den Attributwert "dumpFilesKeep"
+    
-                                überschreitet. Das Attribut dient auch dazu ein lokal gemountetes Verzeichnis "dumpDirRemote" (bei dumpMySQL serverSide)
+    Durch Setzen dieses Attributes wird die interne Versionsverwaltung aktiviert.
-                                DbRep bekannt zu machen. </li> <br>
+    In diesem Verzeichnis werden Backup Dateien gesucht und gelöscht wenn die gefundene Anzahl den Attributwert 
+    "dumpFilesKeep" überschreitet. 
+    Mit dem Attribut wird ebenfalls ein lokal gemountetes Verzeichnis "dumpDirRemote" (bei dumpMySQL serverSide)
+    DbRep bekannt gemacht. <br>
+    
+    (default: {global}{modpath}/log/)   
+    <br><br>
+    
+    <b>Beispiel: </b> <br>
+    attr &lt;Name&gt; dumpDirLocal /sds1/backup/dumps_FHEM/
+ 
+  <br>
+  <br>
+  </li>
+  </ul>
   
   <a name="dumpDirRemote"></a>                              
   <li><b>dumpDirRemote </b>   - Zielverzeichnis für die Erstellung von Dumps mit "dumpMySQL serverSide". 
@@ -18343,9 +18380,18 @@ sub dbval {
                                 Dieser Parameter hat direkten Einfluß auf die Laufzeit und den Ressourcenverbrauch zur Laufzeit.  </li> <br>
 
   <a name="dumpFilesKeep"></a>
-  <li><b>dumpFilesKeep </b>   - Es wird die angegebene Anzahl Dumpfiles im Dumpdir belassen (default: 3). Sind mehr (ältere) Dumpfiles 
+  <li><b>dumpFilesKeep </b>   <br><br>
-                                vorhanden, werden diese gelöscht nachdem ein neuer Dump erfolgreich erstellt wurde. Das globale
+  <ul>
-                                Attribut "archivesort" wird berücksichtigt. </li> <br> 
+    Die integrierte Versionsverwaltung belässt die angegebene Anzahl Backup Dateien im Backup Verzeichnis. <br>
+    Die Versionsverwaltung muß durch Setzen des Attributs "dumpDirLocal" eingeschaltet sein. <br>
+    Sind mehr (ältere) Backup Dateien vorhanden, werden diese gelöscht nachdem ein neues Backup erfolgreich erstellt wurde. 
+    Das globale Attribut "archivesort" wird berücksichtigt. <br>
+    (default: 3)
+    
+  <br>
+  <br>
+  </li> 
+  </ul>                                
 
   <a name="executeAfterProc"></a>
   <li><b>executeAfterProc </b> - Es kann ein FHEM-Kommando oder eine Perl-Funktion angegeben werden welche <b>nach der