This article provides instructions to completely back-up all critical data used by the SNIP NTRIP Caster.
To make a complete backup of all settings
There are six key ‘settings’ files you should back up periodically to save every detail plus of course all the log files that are created every day/week
The six key setting files are as follows, and their default install paths are also shown
This file holds all the various setting used by SNIP; note that it is placed in a ‘hidden’ folder based on the user name. [You can make such folders visible on your machine with the View tab of the Folders and Search Options dialog,]
- C:\Program Files (x86)\SNIP\SNIP\bin\license.dat
This file holds the encoded license file which is node locked to the machine. It is used to enable various SNIP features. This file is decommissioned when the license is moved to another machine. It can only be used on the machine for which it was created.
- C:\Program Files (x86)\SNIP\SNIP\bin\reservations
This file holds all the various setting used for PUSH_In reservations (NTRIP Servers), and is often updated when running.
- C:\Program Files (x86)\SNIP\SNIP\bin\FileList.ini
This file holds a list of data files created by SNIP and their status, such as if they are to be compressed and/or have been transferred to a remote machine
- C:\Program Files (x86)\SNIP\SNIP\bin\ClientTable.txt
This file holds the list of all users (NTRIP Client accounts) who have access accounts for the Caster (this will be a sql table in the next major release)
- C:\Program Files (x86)\SNIP\SNIP\bin\RunCounts.dat
This file holds various current and historical logging counts for your machine covering periods from the past few hours to several years of operation. It is used in various system wide charting and reports. This file was added in the Rev 2.13.00 release.
These six files allow the complete restoration a SNIP Caster to a prior state.
Please do not try to edit these files by hand, as it is easy to damage them and there are a few hidden consistency tests to avoid abuse.
To Make a backup of Event Logs
SNIP also keeps connection event logs on a daily and weekly basis. These files are kept alongside the raw base station data files.
The data streams from Base Stations and the running log of SNIP events are placed in the /data folder. This folder is wherever you elect put it. Use the menu Misc -> Data File Settings… to display the dialog and the current path.
Because the file collection can become very large, it is typically not backed up but is stored on a separate hard drive with large capacity. The default location is: C:\Program Files (x86)\SNIP\SNIP\bin\data\ You may receive periodic console ‘nag’ messages urging you to clean up this folder when its size and contents become large. As a general best practice, keep the folder contents under a few thousand files.
Within this folder are also found the SNIP event logs. The raw data logs from any Base Station mountPt are here as well as the daily and weekly connection logs in a folder within the data folder marked /SNIPlogs
The event log file names use the following three formats:
- Console_YYMMDD_00.cvs or Console_YYMMDD_12.cvs
These files (a new file every 12 hours) hold connection and periodic log events for Clients and Data Streams.
- AVL_log_YYMMDD_00.csv or AVL_log_YYMMDD_12.csv
These files (a new file every 12 hours) hold NMEA-183 $GGA data used for AVL tracking of connected users. These files may not be present on all models of SNIP.
These files (one per week) hold connection event summaries for Clients and Data Streams.
Because these are simple comma separated value files (CSV), they can be opened and read by many 3rd party programs such as Excel or Notepad.
Where the current data is striped into the file name using this format:
- YY – The current year, example: 2018 = 18
- MM – The current Month, example: January = 01
- DD – The current Day of the month, example: 01~31
- WK – The current week of the year, as used in GPS time numbering, example: 01~52
The data in the log file is used to produce the Base Station reports and charts on one or more prior week operational states, such as the one shown below. The number of prior weeks that can be plotted ranges from one to over 3 years.
[Aside: The data kept in the file RunCounts.dat overlaps and compliments the above log data files. The run counts file in in an ASCII CSV format, but should not be edited. While the above daily and weekly logs provide a detailed event by event summary style; the run counts file provides various summary counts of key event types occurring over a defined period of time (e.g. the number of new user connections over 5 minute period shown for the past 72 hours). The event log files are written out periodically as they occur, changing to a new file name when needed. The RunCounts.dat file is updated and kept in memory, only being fully written out every few hours. Only the single file is used for all data.]
The data in the run counts file is used to produce a number of different System-wide reports and charts.
Note: This System wide reporting functionality is a pending feature for the Rev 3.x release.
From release 2.05 onwards there is also a new safety feature that if a copy of SNIP starts up and cannot find the license.dat file AND it also sees an existing simpleNTRIP.ini file with contents, it will make a backup copy of that file before going into the “Evaluation” mode (its normal behavior when no license is found).
This can occur when the SNIP program has been moved to a new location on the host machine. Some operators prefer to install upgrade copies of SNIP into their own folder. If they failed to copy the above files into this folder, before stating the new copy of SNIP, content in the simpleNTRIP.ini file could be reduced when SNIP presumed it was an evaluation use. This logic prevents such a loss.
In the Event of a machine failure:
You can transfer the SNIP license file to another machine by UN-installing the current license and key and moving that key to the new machine. If the machine is destroyed, SNIP support staff can invalidate the old key to prevent abuse and provide you with another key to create a new license.
See this link:
When you initially downloaded and/or purchased SNIP, a user account was also created for you, using the email you downloaded with. This can be used to re-download SNIP, to see your download and installation histories, and to recover your purchased keys. It can also be used to purchase additional slot licenses or other services. Need to recover you log-in credentials, see this article.