On 2023/04/18 08:58, Renaud Allard wrote:
> Hello,
>
> Here is an update to geo/traccar 5.7.
> There are no imcompatible changes. However default.xml config file has
> changed and now needs 3 times ../ in the changelog path for some reason.
oh, that is a nuisance (and I don't see which commit does it..)
Do you mind if I add a readme change as well, to reduce the chance that
users might need to edit default.xml?
Index: pkg/README
===================================================================
RCS file: /cvs/ports/geo/traccar/pkg/README,v
retrieving revision 1.3
diff -u -p -r1.3 README
--- pkg/README 1 Mar 2022 17:58:56 -0000 1.3
+++ pkg/README 19 Apr 2023 09:26:55 -0000
@@ -46,13 +46,18 @@ Open Network Ports
==================
By default, traccar will listen on many network ports. Each tracker protocol
-requires its own open port. So you should really block those ports using pf and
-only allow the protocols you actually use.
+requires its own open port, which requires a large number of file descriptors
+and may conflict with other software.
-You can also restrict the open ports by altering the default.xml file and
remove
-all the protocols you don't use. However, the default.xml file will change on
-almost every revision, so if you do that you should do it on a copy of
-default.xml and reference that copy in traccar.xml configuration file. Also,
you
-should ensure that at every upgrade, you track the changes in default.xml as
-the file contains important informations about SQL queries. This is definitely
-more complex than firewalling the unused ports.
+The list of protocols can be seen in ${SYSCONFDIR}/traccar/default.xml, along
+with various other settings, but do not edit defalut.xml. Instead, you can
+list the specific protocols to enable in ${SYSCONFDIR}/traccar/traccar.xml.
+For examply, to allow only teltonika and osmand protocols, add this:
+
+ <entry key='protocols.enable'>teltonika,osmand</entry>
+
+You may like to override other settings from default.xml - again, change
+traccar.xml instead by copying the entry to override. For example, to
+avoid sending positions to a network-based geocoder service:
+
+ <entry key='geocoder.enable'>false</entry>
