ExternalVendorCode/tahoe-lafs
1
0
Fork 0
mirror of https://github.com/tahoe-lafs/tahoe-lafs.git synced 2025-02-21 10:01:54 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

relnotes.txt: edit and update relnotes and clarify licence

Browse Source
This commit is contained in:
Zooko O'Whielacronx 2007-08-17 12:25:09 -07:00
parent e4f07a975f
commit 2e6039644f
2 changed files with 87 additions and 78 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
COPYING
View File

@ -2,9 +2,9 @@ In addition to the terms of the GNU General Public License, this licence also
comes with the added permission that, if you become obligated to release a comes with the added permission that, if you become obligated to release a
derived work under this licence (as per section 2.b), you may delay the derived work under this licence (as per section 2.b), you may delay the
fulfillment of this obligation for up to 12 months ("grace period"). If you fulfillment of this obligation for up to 12 months ("grace period"). If you
are obligated to release code under section 2.b of this licence, such code are obligated to release code under section 2.b of this licence, you are
must be released under these same terms including the 12-month grace period obligated to release it under these same terms, including the 12-month
clause. grace period clause.
This licence also comes with the added permission that you may link this This licence also comes with the added permission that you may link this
program with the OpenSSL library and distribute executables, as long as you program with the OpenSSL library and distribute executables, as long as you

159
relnotes.txt
View File

@ -1,27 +1,24 @@
NEW VERSION RELEASED NEW VERSION RELEASED
We are pleased to announce the release of version 0.5 of We are pleased to announce the release of version 0.5 of allmydata.org
Allmydata-Tahoe, a secure, decentralized storage grid under a "Tahoe", a secure, decentralized storage grid under a free-software
free-software licence. This is the follow-up to v0.4 which was licence. This is the follow-up to v0.4 which was released June 29,
released June 29, 2007 (see [1]). 2007 (see [1]).
Since then we've made several improvements, including: Since then we've made several improvements, including:
* a RESTful API for programmatically controlling your tahoe node with * a RESTful API for programming your Tahoe node in the language of
* the programming language of your choice: your choice [2]
http://allmydata.org/trac/tahoe/browser/docs/webapi.txt * a command-line interface in the Unix style for uploading and
downloading files (ticket #53)
* a command-line interface for uploading and downloading files in the
Unix style (ticket #53)
* ported to Solaris * ported to Solaris
* significantly reduced the memory used when uploading files * reduced the memory used when uploading large files (ticket #29)
(ticket #29)
* significantly reduced the bandwidth and disk space used when * reduced the bandwidth and disk space used when uploading many small
uploading many small files (tickets #80, 81, #85) files (tickets #80, 81, #85)
* added configurable erasure-coding parameters: how many total shares * added configurable erasure-coding parameters: how many total shares
to produce, and how many shares are required to reconstruct the to produce, and how many shares are required to reconstruct the
@ -34,35 +31,36 @@ Since then we've made several improvements, including:
For complete details, see this web page which shows all ticket For complete details, see this web page which shows all ticket
changes, repository checkins, and wiki changes from June 29 to today, changes, repository checkins, and wiki changes from June 29 to today,
August 16: [2]. August 17: [3].
Allmydata-Tahoe v0.5 is incompatible with v0.4 due to XXX Allmydata.org Tahoe v0.5 is incompatible with v0.4 due to a change in
the formatting of URIs to make them more human-friendly.
WHAT IS IT GOOD FOR? WHAT IS IT GOOD FOR?
With Tahoe, you can store your files in a distributed way across a set With Tahoe, you can store your files in a distributed way across a set
of computers, such that if some of the computers fail or become of computers, such that if some of the computers fail or become
unavailable, you can still retrieve your data from the remainder. You unavailable, you can still retrieve your data from the remaining
can also securely share your files with other users. computers. You can also securely share your files with other users.
This release is targeted at hackers and users who are willing to use a This release is targeted at hackers and users who are willing to use a
text-oriented web user interface, or a command-line user interface. text-oriented web user interface, or a command-line user interface.
(Or a RESTful API. Just telnet to localhost and type HTTP requests to (Or a RESTful API. Just telnet to localhost and type HTTP requests to
get started...) get started.)
Because this software is new, it is not yet recommended for storage of Because this software is new, it is not yet recommended for storage of
highly confidential data nor for important data which is not otherwise highly confidential data nor for important data which is not otherwise
backed up, but it works and there are no known security flaws which backed up. Given that caveat, this software works and there are no
would compromise confidentiality. known security flaws which would compromise confidentiality or data
integrity.
This release of Allmydata-Tahoe is suitable for the "friendnet" Use This release of Tahoe is suitable for the "friendnet" use case [4].
Case (see the wiki page "UseCases": [3]). It is easy to set up a It is easy to set up a private grid which is securely shared among a
private grid which is securely shared among a specific, limited set of specific, limited set of friends. Files uploaded to this shared grid
friends. Files uploaded to this shared grid will be available to all will be available to all friends, even when some of the computers are
friends, even when some of the computers are unavailable. It is also unavailable. It is also easy to encrypt individual files and
easy to use a public grid, but to encrypt individual files and directories so that only designated recipients can read them.
directories so that only intended recipients can read them.
LICENCE LICENCE
@ -71,54 +69,64 @@ Tahoe is offered under the GNU General Public License (v2 or later),
with the added permission that, if you become obligated to release a with the added permission that, if you become obligated to release a
derived work under this licence (as per section 2.b), you may delay derived work under this licence (as per section 2.b), you may delay
the fulfillment of this obligation for up to 12 months. If you are the fulfillment of this obligation for up to 12 months. If you are
obligated to release code under section 2.b of this licence, such code obligated to release code under section 2.b of this licence, you are
must be released under these same terms including the 12-month grace obligated to release it under these same terms, including the 12-month
period clause. grace period clause.
INSTALLATION INSTALLATION
This release of Tahoe works on Linux, Mac OS X, Windows-native, This release of Tahoe works on Linux, Mac OS X, Windows, Cygwin, and
Cygwin, and Solaris. Solaris.
To install, download the tarball [4], untar it, go into the resulting To install, download the tarball [5], untar it, go into the resulting
directory, and follow the directions in the README [5]. directory, and follow the directions in the README [6].
USAGE USAGE - web interface
Once installed, create a "client node". Instruct this client node to Once installed, create a "client node". Instruct this client node to
connect to a specific "introducer node" by means of config files in connect to a specific "introducer node" by means of config files in
the client node's working directory. To join a public grid, copy in the client node's working directory. To join a grid, copy in the
the .furl files for that grid. To create a private grid, run your own .furl files for that grid. To create a private grid, run your own
introducer, and copy its .furl files. See the README for step-by-step introducer, and copy its .furl files. See the README for step-by-step
instructions. instructions.
Each client node runs a local webserver (enabled by writing the Each client node runs a local webserver (enabled by writing the
desired port number into a file called 'webport'). The front page of desired port number into a file called 'webport'). The welcome page
this webserver shows the node's status, including which introducer is of this webserver shows the node's status, including which introducer
being used and which other nodes are connected. Links from the status is being used and which other nodes are connected. Links from the
page lead to others that give access to a shared virtual filesystem,
in which each directory is represented by a separate page. Each
client node also has a separate (non-shared) virtual filesystem. Each
directory page shows a list of the files available there, with
download links, and forms to upload new files.
Other ways to access the filesystem are planned: please see the Links from the welcome page lead to other pages that give access to a
roadmap.txt [6] for some rough details. virtual filesystem, in which each directory is represented by a
separate page. Each directory page shows a list of the files
available there, with download links, and forms to upload new files.
USAGE - command-line interface
Run "allmydata-tahoe ls [VIRTUAL DIRECTORY NAME]" to list the contents
of a virtual directory. Run "allmydata-tahoe get [VIRTUAL FILE NAME]
[LOCAL FILE NAME]" to download a file. Run "allmydata-tahoe put
[LOCAL FILE NAME] [VIRTUAL FILE NAME]" to upload a file.
USAGE - other
You can control the filesystem through the RESTful web API [2]. Other
ways to access the filesystem are planned: please see the roadmap.txt
[7] for some plans.
HACKING AND COMMUNITY HACKING AND COMMUNITY
Please join the mailing list [7] to discuss the ideas behind Tahoe and Please join the mailing list [8] to discuss the ideas behind Tahoe and
extensions of and uses of Tahoe. Patches that extend and improve extensions of and uses of Tahoe. Patches that extend and improve
Tahoe are gratefully accepted -- roadmap.txt shows the next Tahoe are gratefully accepted -- roadmap.txt shows the next
improvements that we plan to make and CREDITS lists the names of improvements that we plan to make and CREDITS lists the names of
people who've contributed to the project. You can browse the revision people who've contributed to the project. You can browse the revision
control history, source code, and issue tracking at the Trac instance control history, source code, and issue tracking at the Trac instance
[8]. Please see the buildbot [9], which shows how Tahoe builds and [9]. Please see the buildbot [10], which shows how Tahoe builds and
passes unit tests on each checkin, and the code coverage results [10] passes unit tests on each checkin, and the code coverage results [11]
and percentage-covered graph [11], which show how much of the Tahoe and percentage-covered graph [12], which show how much of the Tahoe
source code is currently exercised by the test suite. source code is currently exercised by the test suite.
@ -159,18 +167,18 @@ Tahoe is a "from the ground-up" rewrite, inspired by Allmydata's
existing consumer backup service. It is primarily written in the existing consumer backup service. It is primarily written in the
Python programming language. Python programming language.
Tahoe is based on the Foolscap library [12] which provides a remote Tahoe is based on the Foolscap library [13] which provides a remote
object protocol inspired by the capability-secure "E" programming object protocol inspired by the capability-secure "E" programming
language [13]. Foolscap allows us to express the intended behavior of language [14]. Foolscap allows us to express the intended behavior of
the distributed grid directly in object-oriented terms while relying the distributed grid directly in object-oriented terms while relying
on a well-engineered, secure transport layer. on a well-engineered, secure transport layer.
The network layer is provided by the Twisted library [14]. The network layer is provided by the Twisted library [15].
Computationally intensive operations are performed in native compiled Computationally intensive operations are performed in native compiled
code, such as the "zfec" library for fast erasure coding (also code, such as the "zfec" library for fast erasure coding (also
available separately: [15]). available separately: [16]).
Tahoe is sponsored by Allmydata, Inc. [16], a provider of consumer Tahoe is sponsored by Allmydata, Inc. [17], a provider of consumer
backup services. Allmydata, Inc. contributes hardware, software, backup services. Allmydata, Inc. contributes hardware, software,
ideas, bug reports, suggestions, demands, and money (employing several ideas, bug reports, suggestions, demands, and money (employing several
Allmydata-Tahoe hackers and allowing them to spend part of their work Allmydata-Tahoe hackers and allowing them to spend part of their work
@ -178,26 +186,27 @@ time on the next-generation, free-software project). We are eternally
grateful! grateful!
Zooko O'Whielacronx and Brian Warner Zooko O'Whielacronx
on behalf of the Allmydata-Tahoe team on behalf of the Allmydata-Tahoe team
June 29, 2007 August 17, 2007
Boulder, Colorado and San Francisco, California Grand Junction, Colorado
[1] http://allmydata.org/trac/tahoe/browser/relnotes.txt?rev=849 [1] http://allmydata.org/trac/tahoe/browser/relnotes.txt?rev=849
[2] http://allmydata.org/trac/tahoe/timeline?from=2007-08-16&daysback=50&changeset=on&ticket=on&wiki=on&update=Update [2] http://allmydata.org/trac/tahoe/browser/docs/webapi.txt
[3] http://allmydata.org/trac/tahoe/wiki/UseCases [3] http://allmydata.org/trac/tahoe/timeline?from=2007-08-17&daysback=51&changeset=on&ticket=on&wiki=on&update=Update
[4] http://allmydata.org/source/tahoe/tahoe-0.4.tar.gz [4] http://allmydata.org/trac/tahoe/wiki/UseCases
[5] http://allmydata.org/trac/tahoe/browser/README?rev=844 [5] http://allmydata.org/source/tahoe/tahoe-0.5.tar.gz
[6] http://allmydata.org/trac/tahoe/browser/roadmap.txt [6] http://allmydata.org/trac/tahoe/browser/README?rev=1102
[7] http://allmydata.org/cgi-bin/mailman/listinfo/tahoe-dev [7] http://allmydata.org/trac/tahoe/browser/roadmap.txt
[8] http://allmydata.org/trac/tahoe [8] http://allmydata.org/cgi-bin/mailman/listinfo/tahoe-dev
[9] http://allmydata.org/buildbot [9] http://allmydata.org/trac/tahoe
[10] http://allmydata.org/tahoe-figleaf/figleaf/ [10] http://allmydata.org/buildbot
[11] http://allmydata.org/tahoe-figleaf-graph/hanford.allmydata.com-tahoe_figleaf.html [11] http://allmydata.org/tahoe-figleaf/figleaf/
[12] http://twistedmatrix.com/trac/wiki/FoolsCap [12] http://allmydata.org/tahoe-figleaf-graph/hanford.allmydata.com-tahoe_figleaf.html
[13] http://erights.org/ [13] http://twistedmatrix.com/trac/wiki/FoolsCap
[14] http://twistedmatrix.com/ [14] http://erights.org/
[15] http://allmydata.org/trac/tahoe/browser/src/zfec [15] http://twistedmatrix.com/
[16] http://allmydata.com [16] http://allmydata.org/trac/tahoe/browser/src/zfec
[17] http://allmydata.com