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 five ‘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 five 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)
These five files allow the complete restoration a SNIP Caster to a prior state.
Note: In Ubuntu machines, the simpleNTRIP.ini file is place alongside the others.
Please do not try to edit these files by hand, as it is easy to damage them and there are a few hidden traps to avoid abuse.
To Make a backup of Event Logs
SNIP also keeps connection logs on a daily and weekly basis.
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\
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 with the data folder marked /SNIPlogs
The file names used follow 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 reports 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.
As of release 2.05.01 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).
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.