From: Brian Warner Date: Tue, 22 Feb 2011 01:43:23 +0000 (-0800) Subject: docs/configuration.rst: add a "Frontend Configuration" section X-Git-Url: https://git.rkrishnan.org/components/%22news.html/frontends/about.html?a=commitdiff_plain;h=0f3fe545300f8fe075c7e94df756bf28e6f08325;p=tahoe-lafs%2Ftahoe-lafs.git docs/configuration.rst: add a "Frontend Configuration" section this points to docs/frontends/*.rst, which were previously underlinked --- diff --git a/docs/configuration.rst b/docs/configuration.rst index 1bb2d333..1d1a1cd6 100644 --- a/docs/configuration.rst +++ b/docs/configuration.rst @@ -5,12 +5,13 @@ Configuring a Tahoe-LAFS node 1. `Overall Node Configuration`_ 2. `Client Configuration`_ 3. `Storage Server Configuration`_ -4. `Running A Helper`_ -5. `Running An Introducer`_ -6. `Other Files in BASEDIR`_ -7. `Other files`_ -8. `Backwards Compatibility Files`_ -9. `Example`_ +4. `Frontend Configuration`_ +5. `Running A Helper`_ +6. `Running An Introducer`_ +7. `Other Files in BASEDIR`_ +8. `Other files`_ +9. `Backwards Compatibility Files`_ +10. `Example`_ A Tahoe-LAFS node is configured by writing to files in its base directory. These files are read by the node when it starts, so each time you change them, you @@ -320,6 +321,39 @@ Client Configuration (Mutable files use a different share placement algorithm that does not currently consider this parameter.) +Frontend Configuration +====================== + +The Tahoe client process can run a variety of frontend file-access protocols. +You will use these to create and retrieve files from the virtual filesystem. +Configuration details for each are documented in the following +protocol-specific guides: + +HTTP + + Tahoe runs a webserver by default on port 3456. This interface provides a + human-oriented "WUI", with pages to create, modify, and browse + directories and files, as well as a number of pages to check on the + status of your Tahoe node. It also provides a machine-oriented "WAPI", + with a REST-ful HTTP interface that can be used by other programs + (including the CLI tools). Please see ``_ for full + details, and the ``web.port`` and ``web.static`` config variables above. + The ``_ document also describes a few WUI + status pages. + +CLI + + The main "bin/tahoe" executable includes subcommands for manipulating the + filesystem, uploading/downloading files, and creating/running Tahoe + nodes. See ``_ for details. + +FTP, SFTP + + Tahoe can also run both FTP and SFTP servers, and map a username/password + pair to a top-level Tahoe directory. See ``_ + for instructions on configuring these services, and the ``[ftpd]`` and + ``[sftpd]`` sections of ``tahoe.cfg``. + Storage Server Configuration ============================