From: Zooko O'Whielacronx Date: Tue, 13 Sep 2011 16:58:26 +0000 (-0700) Subject: docs: release notes for Tahoe-LAFS v1.8.3 X-Git-Tag: allmydata-tahoe-1.9.0a2~34 X-Git-Url: https://git.rkrishnan.org/pf/content/quickstart.html?a=commitdiff_plain;h=fcedf5f1435514b9504455971442428542247ad4;p=tahoe-lafs%2Ftahoe-lafs.git docs: release notes for Tahoe-LAFS v1.8.3 --- diff --git a/NEWS.rst b/NEWS.rst index b9168444..69d4fadb 100644 --- a/NEWS.rst +++ b/NEWS.rst @@ -2,93 +2,7 @@ User-Visible Changes in Tahoe-LAFS ================================== -Release 1.9.0 (2011-??-??) --------------------------- - -WORK IN PROGRESS - - -New Features -'''''''''''' -- MDMF! #393 -- blacklist #1425 -- immutable-download timeline viz (#?) -- drop-upload feature (experimental) #1429 - -Configuration/Behavior Changes -''''''''''''''''''''' -- reject old-style (discrete) config files from =10.1 -- bump zope.interface dep to <=3.6.2 or >=3.6.6 #1435 -- extra-permission changes in license -- no longer need to patch Twisted for FTP, when using Twisted >= 10.1 - -Minor Changes -''''''''''''' -- minor: #1355, #1366, #1388, #1389, #1391, #1297, #1342, #1404, #1392, - #1412, #1344, #1345, #1347, #1334, #1274, #1438, #1120, #1359, #636, #1469, - #1149, #1441, #1503, #1510, #1507, #1505 -- minor SFTP fixes: #1442, #1446 -- finish .rst-ifying all docs -- shuffle configuration.rst to add Frontend section -- add man page #1420 -- IServer refactoring #1363 -- Nodes now emit "None" for percentiles with higher implied precision - than the number of observations can support. Older stats gatherers - will throw an exception if they gather stats from a new storage - server and it sends a "None" for a percentile. (`#1392`_) - - -Compatibility and Dependencies -'''''''''''''''''''''''''''''' - -- An incompatibility of zope.interface version 3.6.4 with Nevow has - been resolved. Tahoe-LAFS now requires one of the exact versions - v3.3.1, v3.5.3, or v3.6.1 of zope.interface. (`#1435`_) -- The Twisted dependency has been raised to version 10.1. This ensures - that we no longer require pywin32 on Windows, and that it is never - necessary to patch Twisted in order to use the FTP frontend. - (`#1274`_, `#1438`_) - -.. _`#1274`: http://tahoe-lafs.org/trac/tahoe-lafs/ticket/1274 -.. _`#1392`: http://tahoe-lafs.org/trac/tahoe-lafs/ticket/1392 -.. _`#1409`: http://tahoe-lafs.org/trac/tahoe-lafs/ticket/1409 -.. _`#1435`: http://tahoe-lafs.org/trac/tahoe-lafs/ticket/1435 -.. _`#1438`: http://tahoe-lafs.org/trac/tahoe-lafs/ticket/1438 - - -** Security-related Bugfix - - - Fix flaw that would allow a person who knows a storage index of a file to - delete shares of that file (#1528). - - Remove corner cases in mutable file bounds management which could expose - extra lease info or old share data (from prior versions of the mutable - file) if someone with write authority to that mutable file exercised these - corner cases in a way that no actual Tahoe-LAFS client does. (Probably not - exploitable.) (#1528). - - -Release 1.8.2 (2011-01-30) --------------------------- +* Release 1.8.2 (2011-01-30) Compatibility and Dependencies '''''''''''''''''''''''''''''' diff --git a/docs/quickstart.html b/docs/quickstart.html new file mode 100644 index 00000000..781eed5f --- /dev/null +++ b/docs/quickstart.html @@ -0,0 +1,98 @@ + + + + + Getting Tahoe-LAFS + + + + + + + +

About Tahoe-LAFS

+

The homepage of Tahoe-LAFS is + http://tahoe-lafs.org. There is a one-page overview at + About Tahoe-LAFS. + +

How To Get Tahoe-LAFS

+ +

This has been verified to work on Windows, Mac, OpenSolaris, + and too many flavors of Linux and of *BSD to list. It's likely to work on + other platforms.

+ +

WARNING! There are a few third-party + libraries that Tahoe-LAFS depends on that might not be easy to set up on + your platform. If the following instructions don't Just Work, please write + to the + tahoe-dev mailing list where fun, friendly, hackers will help you out! + You might also find clues in the Advanced Installation section below.

+ +

Install Python

+ +

Check if you already have an adequate version of Python installed by + running python --version. Python v2.4 (v2.4.4 or + greater), Python v2.5, Python v2.6, or Python v2.7 will + work. Python v3 does not work. On Windows, we recommend the use of + Python v2.6 (native, not Cygwin).

+ +

If you don't have one of these versions of Python installed, then + follow the instructions on + the Python + download page to download and install Python v2.6. Make sure + that the path to the installation directory has no spaces in it (e.g. on + Windows, do not install Python in the "Program Files" directory). +

+ +

Get Tahoe-LAFS

+ +

Download the latest stable release, v1.8.2:

+ 
http://tahoe-lafs.org/source/tahoe-lafs/releases/allmydata-tahoe-1.8.2.zip
+ +

Set Up Tahoe-LAFS

+ +

Unpack the zip file and cd into the top-level directory.

+ +

Run python setup.py build to generate the tahoe + executable in a subdirectory of the current directory named bin. + This will download and build anything you need from various websites.

+ +

On Windows, the build step might tell you to open a new + Command Prompt (or, on XP and earlier, to log out and back in again). + This is needed the first time you set up Tahoe-LAFS on a particular + installation of Windows.

+ +

Optionally run python setup.py test to verify that it + passes all of its self-tests.

+ +

Run bin/tahoe --version (on Windows, + bin\tahoe --version) to verify that the executable tool prints + out the right version number.

+ +

Run Tahoe-LAFS

+ +

Now you are ready to deploy a decentralized filesystem. The + tahoe executable in the bin directory can + configure and launch your Tahoe-LAFS nodes. + See running.html for instructions on how to do + that.

+ + +

Advanced Installation

+ +

For optional features such as tighter integration with your operating + system's package manager, you can see the + AdvancedInstall + wiki page. The options on that page are not necessary to use Tahoe-LAFS + and can be complicated, so we do not recommend following that page unless + you have unusual requirements for advanced optional features. For most + people, you should first follow the instructions on this page, and if that + doesn't work then ask for help by writing to + the + tahoe-dev mailing list.

+ + diff --git a/relnotes.txt b/relnotes.txt index 35a11009..5a36da4a 100644 --- a/relnotes.txt +++ b/relnotes.txt @@ -1,7 +1,7 @@ -ANNOUNCING Tahoe, the Least-Authority File System, v1.8.2 +ANNOUNCING Tahoe, the Least-Authority File System, v1.8.3 The Tahoe-LAFS team is pleased to announce the immediate -availability of version 1.8.2 of Tahoe-LAFS, an extremely +availability of version 1.8.3 of Tahoe-LAFS, an extremely reliable distributed storage system. Get it here: http://tahoe-lafs.org/source/tahoe/trunk/docs/quickstart.rst @@ -14,12 +14,11 @@ unique security and fault-tolerance properties: http://tahoe-lafs.org/source/tahoe/trunk/docs/about.rst -The previous stable release of Tahoe-LAFS was v1.8.1, which was -released October 28, 2010 [1]. +The previous stable release of Tahoe-LAFS was v1.8.2, which was +released January 30, 2011 [1]. -v1.8.2 is a stable bugfix release, adding compatibility with -the recently-released Twisted-10.2, and correcting a number of -minor issues. See the NEWS.rst file [2] for details. +v1.8.3 is a stable bugfix release which fixes a security issue. See the file +[2] and known_issues.rst [3] file for details. WHAT IS IT GOOD FOR? @@ -36,7 +35,7 @@ have built other projects on top of Tahoe-LAFS and have integrated Tahoe-LAFS with existing systems, including Windows, JavaScript, iPhone, Android, Hadoop, Flume, Django, Puppet, bzr, mercurial, perforce, duplicity, TiddlyWiki, and -more. See the Related Projects page on the wiki [3]. +more. See the Related Projects page on the wiki [4]. We believe that strong cryptography, Free and Open Source Software, erasure coding, and principled engineering practices @@ -47,7 +46,7 @@ This software is developed under test-driven development, and there are no known bugs or security flaws which would compromise confidentiality or data integrity under recommended use. (For all important issues that we are currently aware of -please see the known_issues.rst file [4].) +please see the known_issues.rst file [3].) COMPATIBILITY @@ -61,7 +60,7 @@ all versions since v1.0. Servers from this release can serve clients of all versions back to v1.0 and clients from this release can use servers of all versions back to v1.0. -This is the thirteenth release in the version 1 series. This +This is the fourteenth release in the version 1 series. This series of Tahoe-LAFS will be actively supported and maintained for the foreseeable future, and future versions of Tahoe-LAFS will retain the ability to read and write files compatible @@ -106,19 +105,9 @@ resources for hackers. SPONSORSHIP -Tahoe-LAFS was originally developed by Allmydata, Inc., a -provider of commercial backup services. After discontinuing -funding of Tahoe-LAFS R&D in early 2009, they continued -to provide servers, bandwidth, small personal gifts as tokens -of appreciation, and bug reports. - -Google, Inc. sponsored Tahoe-LAFS development as part of the -Google Summer of Code 2010. They awarded four sponsorships to -students from around the world to hack on Tahoe-LAFS that -summer. - -Thank you to Allmydata and Google for their generous and -public-spirited support. +Atlas Networks has contributed several hosted servers for performance +testing. Thank you to Atlas Networks for their generous and public-spirited +support. HACK TAHOE-LAFS! @@ -132,20 +121,20 @@ Of Fame" [12]. ACKNOWLEDGEMENTS -This is the seventh release of Tahoe-LAFS to be created solely +This is the eighth release of Tahoe-LAFS to be created solely as a labor of love by volunteers. Thank you very much to the team of "hackers in the public interest" who make Tahoe-LAFS possible. -Brian Warner +Zooko Wilcox-O'Hearn on behalf of the Tahoe-LAFS team -January 30, 2011 -San Francisco, California, USA +September 13, 2011 +Boulder, Colorado, USA [1] http://tahoe-lafs.org/trac/tahoe/browser/relnotes.txt?rev=4865 -[2] http://tahoe-lafs.org/trac/tahoe/browser/NEWS?rev=5000 +[2] http://tahoe-lafs.org/trac/tahoe/browser/NEWS.rst?rev=5000 [3] http://tahoe-lafs.org/trac/tahoe/wiki/RelatedProjects [4] http://tahoe-lafs.org/trac/tahoe/browser/docs/known_issues.rst [5] http://tahoe-lafs.org/trac/tahoe/browser/COPYING.GPL @@ -153,6 +142,6 @@ San Francisco, California, USA [7] http://tahoe-lafs.org/source/tahoe/trunk/docs/quickstart.rst [8] http://tahoe-lafs.org/cgi-bin/mailman/listinfo/tahoe-dev [9] http://tahoe-lafs.org/trac/tahoe/roadmap -[10] http://tahoe-lafs.org/trac/tahoe/browser/CREDITS?rev=5000 +[10] http://tahoe-lafs.org/trac/tahoe-lafs/browser/1.8.3/CREDITS?rev=5003 [11] http://tahoe-lafs.org/trac/tahoe/wiki/Dev [12] http://tahoe-lafs.org/hacktahoelafs/