{"id":8884,"date":"2023-10-24T21:59:35","date_gmt":"2023-10-24T21:59:35","guid":{"rendered":"https:\/\/www.use-snip.com\/kb\/?post_type=ht_kb&#038;p=8884"},"modified":"2023-10-30T21:27:24","modified_gmt":"2023-10-30T21:27:24","slug":"release-3_12_00-changes","status":"publish","type":"ht_kb","link":"https:\/\/www.use-snip.com\/kb\/knowledge-base\/release-3_12_00-changes\/","title":{"rendered":"Release 3_12_00 Changes"},"content":{"rendered":"<p>What is new in the<strong><span style=\"color: #0000ff;\"> SNIP<\/span> 3_12_00 release<\/strong> &#8211; released October 30th, 2023<br \/>\n(updating the prior release of 3_11 issued on September 08th, 2023)<\/p>\n<p>This is the next production release of <span style=\"color: #0000ff;\"><strong>SNIP<\/strong><\/span> following the Rev 3_11 release.\u00a0 This release contains both <em>major and <\/em><em>minor<\/em> improvements in response to user requests.\u00a0 This release supports both 32-bit and 64-bit installations on all Windows Platforms from Windows 7 to the current editions.<\/p>\n<p>It is recommended that all Windows <span style=\"color: #0000ff;\"><strong>SNIP<\/strong> <\/span>installations now update to using this release.<\/p>\n<h2><strong>Changes in this release include<\/strong><\/h2>\n<h3><strong>Reports<\/strong><\/h3>\n<p>All requests for any report, GIS map, or various other summaries are now processed in different ways based on \u00a0the callers source IP.\u00a0 This provides two important benefits, improved security, and correct IP use in linkages in the report. \u00a0This also has value with <span style=\"color: #0000ff;\"><strong>SNIP<\/strong><\/span> hosted on \u00a0virtual machines (VMs, such as an AWS hosted deployments) whenever local loop-back rules prohibit the machine from asking for web pages from itself.\u00a0 In more detail\u2026\u00a0\u00a0 When the request is made from <strong><em>inside<\/em><\/strong> <span style=\"color: #0000ff;\"><strong>SNIP<\/strong><\/span> (using the <a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/the-document-viewer\/\" target=\"_blank\" rel=\"noopener\">document viewer<\/a> or various menu commands), the local IP of the host machine is used in the replies and the request is always granted admin rights. \u00a0When the request is made from <strong><em>inside<\/em><\/strong> the machine using any local browser, the host machine local IP is used in the replies and the request may be granted admin rights depending on the report.\u00a0 When the request is made from <strong><em>outside<\/em><\/strong> the machine (from an IP that is not the host or the public IP of the machine) the request is processed as usual, complete with security checks for the requesting parties privileges. \u00a0Various links found in the report are adjusted to follow this process as well.<\/p>\n<p>As a result of the above most \u201cs-reports\u201d (<span style=\"color: #0000ff;\"><strong>SNIP<\/strong><\/span> reports) are now only used with inside the <span style=\"color: #0000ff;\"><strong>SNIP<\/strong><\/span> <a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/the-document-viewer\/\">document viewer<\/a>.<\/p>\n<p>In Rev 3.11 Base Station reports were providing details regarding connected users (<a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/question-what-is-an-ntrip-client\/\" target=\"_blank\" rel=\"noopener\">NTRIP Clients<\/a>) when they should not have. These reports should <strong>ONLY<\/strong> provide such details when a user with Admin rights has requested the report. This has now been corrected.<\/p>\n<p>A few additional map display reports also now make use of the newer display style and format that was introduced in Rev 3.11 \u00a0\u00a0The older map style has not yet been removed, this will occur in a future release.<\/p>\n<h3><strong>NEAR Streams<\/strong><\/h3>\n<p>A minor bug was found and corrected in <a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/adding-serial-uart-data-streams\/\" target=\"_blank\" rel=\"noopener\">serial port<\/a> data streams when this type of stream was used in any <a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/nearest-streams-tab\/\" target=\"_blank\" rel=\"noopener\">NEAR streams<\/a>.\u00a0 Short lapses in data resulting in no observational message content were not being detected as they are in other <a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/stream-types\/\" target=\"_blank\" rel=\"noopener\">stream types<\/a>. \u00a0As a result of this, any users (<a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/question-what-is-an-ntrip-client\/\" target=\"_blank\" rel=\"noopener\">NTRIP Clients<\/a>) which were connected to serial stream by way of a NEAR stream were being starved and were not being automatically switched to a more suitable data stream. \u00a0The operation is now working correctly; should there be any data starvation events, after ~5 seconds, the base station serial stream is removed from the NEAR pool and any connected users are then automatically connected to the best alternative stream.\u00a0 The offending base station may rejoin the after a period of correct operation has again elapsed.<\/p>\n<h3><strong>IP Processing<\/strong><\/h3>\n<p>This release corrects a bug where URL strings with \u201c4-part\u201d names (in other words, a domain with <em>two<\/em> levels of sub-domains like \u201cpositionz-rt.linz.govt.nz\u201d) were not being resolving into the correct IP value.<\/p>\n<p>Also corrected a bug where some newly blocked IP values, when the value was \u00a0entered using the menu command:\u00a0 <strong>Setup<\/strong> \u21d2 <strong>IP Ban\/Block Settings<\/strong> \u21d2 <strong>Block an IP<\/strong> were not always being saved to the settings file.<\/p>\n<h3><strong>Map and GIS Displays <\/strong><\/h3>\n<p>The simple \u201cmap it\u201d link (used in base station reports and tool tips) was not shown at all times for some base stations.\u00a0 This has been corrected. Pressing this link will open the default browser on the host machine and open a &#8220;plain Jane&#8221; Goggle map which is centered at the base station location.\u00a0 \u00a0This allow general GIS browsing of the nearby area, while some of the other map produce specialty maps which are centered on the base station along with coverage circles and also show other nearby base stations and any connected users \u2013 each with detailed pop up reports.<\/p>\n<p>In tables for several reports the country of origin has now been added to the display even when the specific city is not known.<\/p>\n<h3><strong><span style=\"color: #0000ff;\">SNIP<\/span> Service Monitor Update<br \/>\n<\/strong><\/h3>\n<p>The Service monitor tool has been updated to <strong>Rev 1.3<\/strong> with this release.\u00a0 The new release is installed automatically with the update (the program is called: \u201c<strong>SNIPserviceMon.exe<\/strong>\u201d).\u00a0\u00a0 This update was promoted by a Danish deployment that reported that the tool falsely presumed that the &#8220;fall back&#8221; the seasonal change in the local time (daylight saving time) was a stalled copy of <span style=\"color: #0000ff;\"><strong>SNIP<\/strong><\/span> needing a restart.\u00a0 The new tool correctly detects system time changes and processes them correctly.<\/p>\n<p>&nbsp;<\/p>\n<h3><strong>Misc. Improvments<br \/>\n<\/strong><\/h3>\n<ul>\n<li>In the decoding of NTRIP Client connection details shown in the <a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/console-logging\/\">console log<\/a>, <span style=\"color: #0000ff;\"><strong>SNIP<\/strong><\/span> now shows the user name and password in their fully decoded format after the Base64 format line which is used in transmission.\u00a0\u00a0 Enable the display of these connection details by checking the box marked <em>Show Protocol Details<\/em> on the <a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/the-caster-and-clients-tab\/\" target=\"_blank\" rel=\"noopener\"><em>Caster and Clients<\/em> tab<\/a> and set the <em>Log Threshold <\/em>value to be \u201cminor.\u201d\u00a0 An example of this is displayed below:<\/li>\n<\/ul>\n<pre style=\"padding-left: 40px;\">GET \/ExampleAgBaseStation HTTP\/1.1\r\nUser-Agent: NTRIP AgOpenGPSClient\/20221020\r\nAuthorization: Basic VXNlckBFeGFtcGxlLmNvbTpub25l \u00a0 [Decodes as: <strong>User@Example.com:none<\/strong>] \r\nAccept: *\/*\r\nConnection: close<\/pre>\n<ul>\n<li>Report layouts were revised in in minor ways to improve the visual layout of the display on Android phones and other small screen devices.[spacer height=&#8221;20px&#8221;]<\/li>\n<li>Long lists of NTRIP Agents are no longer shown at the bottom of the <a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/status-button-report\/\">STATUS command<\/a> and other reports.\u00a0 Rather, a summary count of the different agent is provided if more then 50 are in use.\u00a0 The user can push the <strong>NTRIP Agents<\/strong> button to see the full list. [The other nearby buttons, <strong>All Agents<\/strong>,\u00a0 <strong>SNIP NTRIP Agents<\/strong>, and <strong>Browser Agents<\/strong> produce similar lists when pressed.][spacer height=&#8221;20px&#8221;]<\/li>\n<li>A bug in the Customer &#8220;<a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/adding-staff-accounts\/\" target=\"_blank\" rel=\"noopener\">staff accounts<\/a>&#8221; process has been corrected where newly created staff members could not log in until <span style=\"color: #0000ff;\"><strong>SNIP<\/strong> <\/span>was restarted.\u00a0 Also note that any changes made to staff account are not saved into a long term file until the owning customer it itself saved with the updates.[spacer height=&#8221;20px&#8221;]<\/li>\n<li>When a <a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/adding-customer-accounts\/\" target=\"_blank\" rel=\"noopener\">Customer Account<\/a> logs into the <span style=\"color: #0000ff;\"><strong>SNIP<\/strong><\/span> <a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/web-api-login\/\" target=\"_blank\" rel=\"noopener\">Web API<\/a>, they can now either provide the name of their <em><strong>realm<\/strong> <\/em>on the screen, or skip it and <span style=\"color: #0000ff;\"><strong>SNIP<\/strong><\/span> will match it to existing records. When any customer&#8217;s staff accounts logs in, they always MUST provide the realm.[spacer height=&#8221;20px&#8221;]<\/li>\n<li>A few debugging comments inadvertently appearing in the console log from the Rev 3.11 release have been removed.[spacer height=&#8221;20px&#8221;]<\/li>\n<\/ul>\n<p>&nbsp;<\/p>\n<h2><em>How to Update\u2026<\/em><\/h2>\n<p>Updates to <span style=\"color: #0000ff;\"><strong>SNIP<\/strong> <\/span>are always free and easy.\u00a0 Your Caster will be offline about 3 minutes.\u00a0 From within <span style=\"color: #0000ff;\"><strong>SNIP<\/strong><\/span>, simply use the menu item <strong>Help<\/strong> \u21d2 <strong>Check for Updates\u2026<\/strong> \u00a0 Your update will be downloaded from our secure servers and then you will be asked to allow <span style=\"color: #0000ff;\"><strong>SNIP<\/strong><\/span> to restart and update itself.\u00a0 On some Windows 10 systems you must also manually exit the current copy of <span style=\"color: #0000ff;\"><strong>SNIP<\/strong><\/span> to update.\u00a0 Takes under three minutes to do and have your Caster back on-line. That\u2019s all there is to it!<\/p>\n","protected":false},"excerpt":{"rendered":"<p>What is new in the SNIP 3_12_00 release &#8211; released October 30th, 2023 (updating the prior release of 3_11 issued on September 08th, 2023) This is the next production release of SNIP following the Rev 3_11 release.\u00a0 This release contains both major and minor improvements in response to user requests.\u00a0 [&hellip;]<\/p>\n","protected":false},"author":13,"comment_status":"open","ping_status":"closed","template":"","format":"standard","meta":{"_exactmetrics_skip_tracking":false,"_exactmetrics_sitenote_active":false,"_exactmetrics_sitenote_note":"","_exactmetrics_sitenote_category":0,"footnotes":""},"ht-kb-category":[286],"ht-kb-tag":[363,221],"class_list":["post-8884","ht_kb","type-ht_kb","status-publish","format-standard","hentry","ht_kb_category-release-history","ht_kb_tag-features","ht_kb_tag-release"],"_links":{"self":[{"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/ht-kb\/8884","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/ht-kb"}],"about":[{"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/types\/ht_kb"}],"author":[{"embeddable":true,"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/users\/13"}],"replies":[{"embeddable":true,"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/comments?post=8884"}],"version-history":[{"count":11,"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/ht-kb\/8884\/revisions"}],"predecessor-version":[{"id":8900,"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/ht-kb\/8884\/revisions\/8900"}],"wp:attachment":[{"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/media?parent=8884"}],"wp:term":[{"taxonomy":"ht_kb_category","embeddable":true,"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/ht-kb-category?post=8884"},{"taxonomy":"ht_kb_tag","embeddable":true,"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/ht-kb-tag?post=8884"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}