Skip to content

Commit

Permalink
Leasedb and cloud backend merge is scheduled for v1.12.0.
Browse files Browse the repository at this point in the history
Signed-off-by: Daira Hopwood <daira@jacaranda.org>
  • Loading branch information
daira committed Apr 9, 2014
1 parent 05fb403 commit 1cddcb6
Show file tree
Hide file tree
Showing 5 changed files with 11 additions and 11 deletions.
2 changes: 1 addition & 1 deletion docs/backends/disk.rst
Expand Up @@ -3,7 +3,7 @@ Storing Shares on a Local Filesystem
====================================

The "disk" backend stores shares on the local filesystem. Versions of
Tahoe-LAFS before v1.11.0 always stored shares in this way.
Tahoe-LAFS before v1.12.0 always stored shares in this way.

``[storage]``

Expand Down
4 changes: 2 additions & 2 deletions docs/garbage-collection.rst
Expand Up @@ -205,13 +205,13 @@ The ``tahoe.cfg`` file uses the following keys to control lease expiration:

In previous versions, the ``expire.immutable`` and ``expire.mutable`` keys
could be used to selectively expire only mutable or only immutable shares.
As of Tahoe-LAFS v1.11.0, these are no longer supported and will cause an
As of Tahoe-LAFS v1.12.0, these are no longer supported and will cause an
error if set to ``False``.

Expiration Progress
===================

As of Tahoe-LAFS v1.11.0, leases are stored in a database that can be queried
As of Tahoe-LAFS v1.12.0, leases are stored in a database that can be queried
and updated quickly, rather than in share files. However, an "accounting
crawler" is still needed to discover shares when upgrading from a previous
version, and to actually delete expired shares. The crawler limits the amount
Expand Down
2 changes: 1 addition & 1 deletion docs/proposed/leasedb.rst
Expand Up @@ -5,7 +5,7 @@ Lease database design
=====================

The target audience for this document is developers who wish to understand
the new lease database (leasedb) planned to be added in Tahoe-LAFS v1.11.0.
the new lease database (leasedb) planned to be added in Tahoe-LAFS v1.12.0.


Introduction
Expand Down
12 changes: 6 additions & 6 deletions src/allmydata/interfaces.py
Expand Up @@ -101,7 +101,7 @@ def allocate_buckets(storage_index=StorageIndex,
"""
Allocate BucketWriters for a set of shares on this server.
renew_secret and cancel_secret are ignored as of Tahoe-LAFS v1.11.0,
renew_secret and cancel_secret are ignored as of Tahoe-LAFS v1.12.0,
but for backward compatibility with older servers, should be
calculated in the same way as previous clients (see
allmydata.util.hashutil.file_{renewal,cancel}_secret_hash).
Expand Down Expand Up @@ -139,7 +139,7 @@ def add_lease(storage_index=StorageIndex,
longer lease), but expiration behaviour also depends on the server's
configured policy (see docs/garbage-collection.rst).
renew_secret and cancel_secret are ignored as of Tahoe-LAFS v1.11.0,
renew_secret and cancel_secret are ignored as of Tahoe-LAFS v1.12.0,
but for backward compatibility with older servers, should be
calculated in the same way as previous clients (see
allmydata.util.hashutil.file_{renewal,cancel}_secret_hash).
Expand All @@ -156,14 +156,14 @@ def renew_lease(storage_index=StorageIndex, renew_secret=LeaseRenewSecret):
longer lease), but expiration behaviour also depends on the server's
configured policy (see docs/garbage-collection.rst).
renew_secret is ignored as of Tahoe-LAFS v1.11.0, but for backward
renew_secret is ignored as of Tahoe-LAFS v1.12.0, but for backward
compatibility with older servers, should be calculated in the same
way as previous clients (see
allmydata.util.hashutil.file_renewal_secret_hash). In versions
prior to v1.X.0, this method would only renew leases with the given
prior to v1.12.0, this method would only renew leases with the given
renew_secret.
Note that as of Tahoe-LAFS v1.11.0, the lease database does not retain
Note that as of Tahoe-LAFS v1.12.0, the lease database does not retain
information about the node ids of lease holders, so if an IndexError
is raised for a mutable share, it no longer includes that information.
"""
Expand Down Expand Up @@ -212,7 +212,7 @@ def slot_testv_and_readv_and_writev(storage_index=StorageIndex,
The 'secrets' argument is a tuple of (write_enabler, renew_secret,
cancel_secret). The first is required to perform any write.
renew_secret and cancel_secret are ignored as of Tahoe-LAFS v1.11.0,
renew_secret and cancel_secret are ignored as of Tahoe-LAFS v1.12.0,
but for backward compatibility with older servers, should be
calculated in the same way as previous clients (see
allmydata.util.hashutil.file_{renewal,cancel}_secret_hash).
Expand Down
2 changes: 1 addition & 1 deletion src/allmydata/storage/backends/disk/immutable.py
Expand Up @@ -24,7 +24,7 @@

# Footnote 1: as of Tahoe v1.3.0 this field is not used by storage servers.

# Footnote 2: as of Tahoe v1.11.0 this field is not used by storage servers.
# Footnote 2: as of Tahoe v1.12.0 this field is not used by storage servers.
# New shares will have a 0 here. Old shares will have whatever value was left
# over when the server was upgraded. All lease information is now kept in the
# leasedb.
Expand Down

0 comments on commit 1cddcb6

Please sign in to comment.