mirror of
https://github.com/tahoe-lafs/tahoe-lafs.git
synced 2024-12-23 23:02:25 +00:00
57 lines
3.5 KiB
ReStructuredText
57 lines
3.5 KiB
ReStructuredText
.. -*- coding: utf-8-with-signature -*-
|
|
|
|
=======================
|
|
Old Configuration Files
|
|
=======================
|
|
|
|
Tahoe-LAFS releases before v1.3.0 had no ``tahoe.cfg`` file, and used
|
|
distinct files for each item listed below. If Tahoe-LAFS v1.9.0 or above
|
|
detects the old configuration files at start up it emits a warning and
|
|
aborts the start up. (This was issue ticket #1385.)
|
|
|
|
=============================== =================================== =================
|
|
Config setting File Comment
|
|
=============================== =================================== =================
|
|
``[node]nickname`` ``BASEDIR/nickname``
|
|
``[node]web.port`` ``BASEDIR/webport``
|
|
``[node]tub.port`` ``BASEDIR/client.port`` (for Clients, not Introducers)
|
|
``[node]tub.port`` ``BASEDIR/introducer.port`` (for Introducers, not Clients) (note that, unlike other keys, ``tahoe.cfg`` overrode this file from Tahoe-LAFS v1.3.0 up to and including Tahoe-LAFS v1.8.2)
|
|
``[node]tub.location`` ``BASEDIR/advertised_ip_addresses``
|
|
``[node]log_gatherer.furl`` ``BASEDIR/log_gatherer.furl`` (one per line)
|
|
``[node]timeout.keepalive`` ``BASEDIR/keepalive_timeout``
|
|
``[node]timeout.disconnect`` ``BASEDIR/disconnect_timeout``
|
|
``BASEDIR/introducer.furl`` ``BASEDIR/private/introducers.yaml``
|
|
``[client]helper.furl`` ``BASEDIR/helper.furl``
|
|
``[client]key_generator.furl`` ``BASEDIR/key_generator.furl``
|
|
``BASEDIR/stats_gatherer.furl`` Stats gatherer has been removed.
|
|
``[storage]enabled`` ``BASEDIR/no_storage`` (``False`` if ``no_storage`` exists)
|
|
``[storage]readonly`` ``BASEDIR/readonly_storage`` (``True`` if ``readonly_storage`` exists)
|
|
``[storage]sizelimit`` ``BASEDIR/sizelimit``
|
|
``[storage]debug_discard`` ``BASEDIR/debug_discard_storage``
|
|
``[helper]enabled`` ``BASEDIR/run_helper`` (``True`` if ``run_helper`` exists)
|
|
=============================== =================================== =================
|
|
|
|
Note: the functionality of ``[node]ssh.port`` and
|
|
``[node]ssh.authorized_keys_file`` were previously (before Tahoe-LAFS
|
|
v1.3.0) combined, controlled by the presence of a
|
|
``BASEDIR/authorized_keys.SSHPORT`` file, in which the suffix of the
|
|
filename indicated which port the ssh server should listen on, and the
|
|
contents of the file provided the ssh public keys to accept. Support
|
|
for these files has been removed completely. To ``ssh`` into your
|
|
Tahoe-LAFS node, add ``[node]ssh.port`` and
|
|
``[node].ssh_authorized_keys_file`` statements to your ``tahoe.cfg``.
|
|
|
|
Likewise, the functionality of ``[node]tub.location`` is a variant of
|
|
the now (since Tahoe-LAFS v1.3.0) unsupported
|
|
``BASEDIR/advertised_ip_addresses`` . The old file was additive (the
|
|
addresses specified in ``advertised_ip_addresses`` were used in
|
|
addition to any that were automatically discovered), whereas the new
|
|
``tahoe.cfg`` directive is not (``tub.location`` is used verbatim).
|
|
|
|
The stats gatherer has been broken at least since Tahoe-LAFS v1.13.0.
|
|
The (broken) functionality of ``[client]stats_gatherer.furl`` (which
|
|
was previously in ``BASEDIR/stats_gatherer.furl``), is scheduled to be
|
|
completely removed after Tahoe-LAFS v1.15.0. After that point, if
|
|
your configuration contains a ``[client]stats_gatherer.furl``, your
|
|
node will refuse to start.
|