Differences

This shows you the differences between two versions of the page.

--- technote:journal_history [2025/01/20 00:32] – created Scott Cunliffe
+++ technote:journal_history [2025/01/21 22:07] (current) – external edit 127.0.0.1
@@ Line 1: / Line 1: @@
 ====== Disabling Journal And Volume History Entries ======
-When Volume are added, moved or altered by default TapeTrack adds entries to the journal database and historical records for that volume.
+When Volumes are added, moved or altered, by default TapeTrack adds entries to the Journal and History databases.
-If moves are required, for example moving a Volume from one location to another within your racking, journal records would cause the client to be charged for the move that is not billable.  Temporarily turning off the journal and/or historical records can bypass this issue.
+If you wish to change this behavior you can pass arguments to the TapeTrack Server to completely disable this logging, or selectively disable this logging for specific Customers.
+\\
+<note warning>
+We strongly recommend against ever using this feature unless you:
+  * do not use the Journal facilities and want to save overhead and disk space, or
+  * have a very specific need to perform operations without Volume History being created.
+ **We strongly recommend that you never do this.**
+----
+**When this feature is used a record will be written to the Journal to record that it has been used.**</note>
 ===== Disabling Journal Entries =====
+[[server:start_stop|Stop the Framework Server]].
+<note warning>[[technote:registry_edit|Backup Registry]] before making any alterations.  Do not edit the registry unless you are competent to do so.</note>
+Disabling the journal entries is achieved by adding an attribute to the registry entry for the Framework Sever.  Once you have a current backup of the registry, navigate to ''Computer\HKEY_LOCAL_MACHINE\SYSTEM\ControlSet001\Services\TMSS10SVC'' in Registry Editor.
+{{registry_edit_x.png}}
+Double click on the ''Image Path'' to open up the ''Edit String'' window.
+At the end of the Value data string, add the string required to disable the journal entries for the required Customer-ID's based on the following examples and click OK to commit the changes.
+Disable journal entries for all Customers:
+<code>
+"C:\Program Files\TapeTrack\TapeTrack Framework Server\TMSS10Server.exe" -J #DiSaBlE
+</code>
+If you have replication disabled on your server, the registry entry will have a ''-X'' option, if this is the case simply add the ''-J'' option after that.
+<code>
+"C:\Program Files\TapeTrack\TapeTrack Framework Server\TMSS10Server.exe" -X -J #DiSaBlE
+</code>
+Disable journal entries for all Customer US01:
+<code>
+"C:\Program Files\TapeTrack\TapeTrack Framework Server\TMSS10Server.exe" -J US01
+</code>
+Disable journal entries for all Customers US01 and US03:
+<code>
+"C:\Program Files\TapeTrack\TapeTrack Framework Server\TMSS10Server.exe" -J "*(US01|US03)"
+</code>
+[[server:start_stop|Start the Framework Server]].
+===== Enabling Journal Entries =====
+TapeTrack will no longer add journal entries for the Customers added to the registry entry. To restore the database back to adding journal entries:
+[[server:start_stop|Stop the Framework Server]].
+Open the registry and edit the ImagePath string entry to remove the ''-J value'' entry and click OK to commit the change.
+[[server:start_stop|Start the Framework Server]].
+===== Disabling History Entries =====
+[[server:start_stop|Stop the Framework Server]].
+<note warning>[[technote:registry_edit|Backup Registry]] before making any alterations.  Do not edit the registry unless you are competent to do so.</note>
+Disabling the history entries is achieved by adding an attribute to the registry entry for the Framework Sever.  Once you have a current backup of the registry, navigate to ''Computer\HKEY_LOCAL_MACHINE\SYSTEM\ControlSet001\Services\TMSS10SVC'' in Registry Editor.
+{{registry_edit_x.png}}
+Double click on the ''Image Path'' to open up the ''Edit String'' window.
+At the end of the Value data string, add the string required to disable the journal entries for the required Customer-ID's based on the following examples and click OK to commit the changes.
+Disable history entries for all Customers:
+<code>
+"C:\Program Files\TapeTrack\TapeTrack Framework Server\TMSS10Server.exe" -H #DiSaBlE
+</code>
+If you have replication disabled on your server, the registry entry will have a ''-X'' option, if this is the case simply add the ''-H'' option after that.
+<code>
+"C:\Program Files\TapeTrack\TapeTrack Framework Server\TMSS10Server.exe" -X -H #DiSaBlE
+</code>
+Disable history entries for all Customer US01:
+<code>
+"C:\Program Files\TapeTrack\TapeTrack Framework Server\TMSS10Server.exe" -H US01
+</code>
+Disable history entries for all Customers US01 and US03:
+<code>
+"C:\Program Files\TapeTrack\TapeTrack Framework Server\TMSS10Server.exe" -H "*(US01|US03)"
+</code>
+[[server:start_stop|Start the Framework Server]].
+===== Enabling History Entries =====
+TapeTrack will no longer add history entries for the Customers added to the registry entry. To restore the database back to adding history entries:
+[[server:start_stop|Stop the Framework Server]].
+Open the registry and edit the ImagePath string entry to remove the ''-H value'' entry and click OK to commit the change, remembering to leave the ''-X'' if it was previously present.
+<code>
+"C:\Program Files\TapeTrack\TapeTrack Framework Server\TMSS10Server.exe"
+</code>
+<code>
+"C:\Program Files\TapeTrack\TapeTrack Framework Server\TMSS10Server.exe" -X
+</code>
+[[server:start_stop|Start the Framework Server]].
+===== Disabling Journal And History Entries =====
+If you want to disable both journal and history entries, add the -J and -H the registry string ImagePath consecutively.
+Disable journal entries for all Customers:
+<code>
+"C:\Program Files\TapeTrack\TapeTrack Framework Server\TMSS10Server.exe" -J #DiSaBlE -H #DiSaBlE
+</code>
+If you have replication disabled on your server, the registry entry will have a ''-X'' option, if this is the case simply add the ''-J'' option after that.
+<code>
+"C:\Program Files\TapeTrack\TapeTrack Framework Server\TMSS10Server.exe" -X -J #DiSaBlE -H #DiSaBlE
+</code>
+Disable journal entries for all Customer US01:
+<code>
+"C:\Program Files\TapeTrack\TapeTrack Framework Server\TMSS10Server.exe" -J US01 -H US01
+</code>
+Disable journal entries for all Customers US01 and US03:
+<code>
+"C:\Program Files\TapeTrack\TapeTrack Framework Server\TMSS10Server.exe" -J "*(US01|US03)" -H "*(US01|US03)"
+</code>
+[[server:start_stop|Start the Framework Server]].
+===== Enable Journal And History Entries =====
+TapeTrack will no longer add journal or history entries for the Customers added to the registry entry. To restore the database back to adding journal entries:
+[[server:start_stop|Stop the Framework Server]].
+Open the registry and edit the ImagePath string entry to remove the ''-J value'' entry and click OK to commit the change, remembering to leave the ''-X'' if it was previously present.
+<code>
+"C:\Program Files\TapeTrack\TapeTrack Framework Server\TMSS10Server.exe"
+</code>
+<code>
+"C:\Program Files\TapeTrack\TapeTrack Framework Server\TMSS10Server.exe" -X
+</code>
+[[server:start_stop|Start the Framework Server]].
+{{tag> technote registry server new_feature}}