| 1 | .. -*- coding: utf-8-with-signature -*- |
|---|
| 2 | |
|---|
| 3 | ======================= |
|---|
| 4 | Old Configuration Files |
|---|
| 5 | ======================= |
|---|
| 6 | |
|---|
| 7 | Tahoe-LAFS releases before v1.3.0 had no ``tahoe.cfg`` file, and used |
|---|
| 8 | distinct files for each item listed below. If Tahoe-LAFS v1.9.0 or above |
|---|
| 9 | detects the old configuration files at start up it emits a warning and |
|---|
| 10 | aborts the start up. (This was issue ticket #1385.) |
|---|
| 11 | |
|---|
| 12 | =============================== =================================== ================= |
|---|
| 13 | Config setting File Comment |
|---|
| 14 | =============================== =================================== ================= |
|---|
| 15 | ``[node]nickname`` ``BASEDIR/nickname`` |
|---|
| 16 | ``[node]web.port`` ``BASEDIR/webport`` |
|---|
| 17 | ``[node]tub.port`` ``BASEDIR/client.port`` (for Clients, not Introducers) |
|---|
| 18 | ``[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) |
|---|
| 19 | ``[node]tub.location`` ``BASEDIR/advertised_ip_addresses`` |
|---|
| 20 | ``[node]log_gatherer.furl`` ``BASEDIR/log_gatherer.furl`` (one per line) |
|---|
| 21 | ``[node]timeout.keepalive`` ``BASEDIR/keepalive_timeout`` |
|---|
| 22 | ``[node]timeout.disconnect`` ``BASEDIR/disconnect_timeout`` |
|---|
| 23 | ``BASEDIR/introducer.furl`` ``BASEDIR/private/introducers.yaml`` |
|---|
| 24 | ``[client]helper.furl`` ``BASEDIR/helper.furl`` |
|---|
| 25 | ``[client]key_generator.furl`` ``BASEDIR/key_generator.furl`` |
|---|
| 26 | ``BASEDIR/stats_gatherer.furl`` Stats gatherer has been removed. |
|---|
| 27 | ``[storage]enabled`` ``BASEDIR/no_storage`` (``False`` if ``no_storage`` exists) |
|---|
| 28 | ``[storage]readonly`` ``BASEDIR/readonly_storage`` (``True`` if ``readonly_storage`` exists) |
|---|
| 29 | ``[storage]sizelimit`` ``BASEDIR/sizelimit`` |
|---|
| 30 | ``[storage]debug_discard`` ``BASEDIR/debug_discard_storage`` |
|---|
| 31 | ``[helper]enabled`` ``BASEDIR/run_helper`` (``True`` if ``run_helper`` exists) |
|---|
| 32 | =============================== =================================== ================= |
|---|
| 33 | |
|---|
| 34 | Note: the functionality of ``[node]ssh.port`` and |
|---|
| 35 | ``[node]ssh.authorized_keys_file`` were previously (before Tahoe-LAFS |
|---|
| 36 | v1.3.0) combined, controlled by the presence of a |
|---|
| 37 | ``BASEDIR/authorized_keys.SSHPORT`` file, in which the suffix of the |
|---|
| 38 | filename indicated which port the ssh server should listen on, and the |
|---|
| 39 | contents of the file provided the ssh public keys to accept. Support |
|---|
| 40 | for these files has been removed completely. To ``ssh`` into your |
|---|
| 41 | Tahoe-LAFS node, add ``[node]ssh.port`` and |
|---|
| 42 | ``[node].ssh_authorized_keys_file`` statements to your ``tahoe.cfg``. |
|---|
| 43 | |
|---|
| 44 | Likewise, the functionality of ``[node]tub.location`` is a variant of |
|---|
| 45 | the now (since Tahoe-LAFS v1.3.0) unsupported |
|---|
| 46 | ``BASEDIR/advertised_ip_addresses`` . The old file was additive (the |
|---|
| 47 | addresses specified in ``advertised_ip_addresses`` were used in |
|---|
| 48 | addition to any that were automatically discovered), whereas the new |
|---|
| 49 | ``tahoe.cfg`` directive is not (``tub.location`` is used verbatim). |
|---|
| 50 | |
|---|
| 51 | The stats gatherer has been broken at least since Tahoe-LAFS v1.13.0. |
|---|
| 52 | The (broken) functionality of ``[client]stats_gatherer.furl`` (which |
|---|
| 53 | was previously in ``BASEDIR/stats_gatherer.furl``), is scheduled to be |
|---|
| 54 | completely removed after Tahoe-LAFS v1.15.0. After that point, if |
|---|
| 55 | your configuration contains a ``[client]stats_gatherer.furl``, your |
|---|
| 56 | node will refuse to start. |
|---|
