docs/historical/configuration.rst

   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 ``[client]introducer.furl``      ``BASEDIR/introducer.furl``
  24 ``[client]helper.furl``          ``BASEDIR/helper.furl``
  25 ``[client]key_generator.furl``   ``BASEDIR/key_generator.furl``
  26 ``[client]stats_gatherer.furl``  ``BASEDIR/stats_gatherer.furl``
  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).