diff -Nru grid-updates-1.1.3/CHANGES grid-updates-1.2.0/CHANGES --- grid-updates-1.1.3/CHANGES 2012-06-30 13:49:20.000000000 +0000 +++ grid-updates-1.2.0/CHANGES 2012-09-09 14:42:10.000000000 +0000 @@ -1,3 +1,15 @@ +2012-09-09 (version 1.2.0) + * Subscription URIs need to be file caps now + * Changed repair routines + - Removed former --repair; renamed --repair-list to --repair + - Changed the default repair subscription to the former community repair list + * Added a new repair mode (level-check) + * Changed source file format for --make-news to reStructuredText + * Removed arch as an option to --format + * Switched from Optparse to Argparse + * Catch non-JSON responses from Tahoe (see ticket #1799) + * Minor bug fixes and improvements + 2012-06-30 (version 1.1.3) * Add arch as an option for --format * Bugfixes: diff -Nru grid-updates-1.1.3/INSTALL.html grid-updates-1.2.0/INSTALL.html --- grid-updates-1.1.3/INSTALL.html 2012-06-30 13:49:30.000000000 +0000 +++ grid-updates-1.2.0/INSTALL.html 2012-09-09 14:59:27.000000000 +0000 @@ -1,31 +1,364 @@ + - +
- - - -See README.html and the man page +for more information about grid-updates.
+Python version 2.6 and later. A Python installation is not required +for Windows users.
See README.html and the man page for more information about grid-updates.
-Python version 2.6 and later. Python is not a requirement for Windows users.
-Users with an available Python installation can install grid-updates with the command python setup.py install
from within the source archive.
Debian users can build packages with the command fakeroot debian/rules binary
. This will build a package that can be installed using dpkg
. This package will include the script and its documentation.
Users with an available Python installation can install grid-updates +with the command python setup.py install from within the source +archive.
+Debian users can build packages with the command +fakeroot debian/rules binary. This will build a package that can be +installed using dpkg. This package will include the script and its +documentation.
Windows users have the following available options:
-grid-updates-$ver.py2exe.exe
)grid-updates-$ver.win32.exe
)python setup.py install
as above)In short: if you're running Windows and don't know which file to get, download the py2exe version.
-Consider running grid-updates --patch-tahoe
after installation. This will apply a small patch to Tahoe-LAFS's web console to allow displaying news from grid-update's in an Iframe. The web console can be restored to its original state with grid-updates --undo-tahoe-patch
.
In order for this script to work, it needs to have read and write permission for the Tahoe-LAFS node's directory. This directory is typically located at %appdata%\.tahoe
for Windows users and ~/.tahoe
for other systems.
If asked to, grid-updates
will update your introducers file and make a backup of it. When fetching NEWS, the script will write a plain text version to ~/.tahoe/NEWS
. Additionally, an HTML version and an Atom news feed will be saved to your Tahoe node's web.static
directory (typically ~/.tahoe/public_html
). NEWS.html and NEWS.atom can be viewed in the node's /static directory, or (having patched Tahoe's Web UI) right on your node's front page
In short: if you're running Windows and don't know which file to get, download +the py2exe version.
+Consider running grid-updates --patch-tahoe after installation. This will +apply a small patch to Tahoe-LAFS's web console to allow displaying news from +grid-updates in an Iframe. The web console can be restored to its original +state with grid-updates --undo-tahoe-patch.
+In order for this script to work, it needs to have read and write permission +for the Tahoe-LAFS node's directory. This directory is typically located at +%APPDATA%\.tahoe for Windows users and ~/.tahoe for other systems.
+If asked to, grid-updates will update your introducers file and make a +backup of it. When fetching NEWS, the script will write a plain text version to +~/.tahoe/NEWS. Additionally, an HTML version and an Atom news feed will be +saved to your Tahoe node's web.static directory (typically +~/.tahoe/public_html). NEWS.html and NEWS.atom can be viewed in the node's +/static directory, or (having patched Tahoe's Web UI) right on your node's +front page
+grid-updates - Helper Script for Tahoe-LAFS Nodes
@@ -31,10 +31,7 @@Retrieve the news feed. See the NEWS section below.
Maintain or repair the health of the subscription service's URIs.
-Retrieve a list of shares and maintain/repair them.
+Maintain the health of Tahoe shares listed in a subscription.
Patch the Tahoe-LAFS web console to display the grid-updates news feed in an Iframe.
@@ -43,7 +40,7 @@Remove the grid-updates patch to the Tahoe web console and restore its original version.
Create a grid-updates-compatible NEWS.tgz file from a Markdown source file.
+Create a grid-updates-compatible NEWS.tgz file from a reStructuredText source file.
Check for a new version of this script on the grid.
@@ -63,20 +60,20 @@Specify the node directory (default: ~/.tahoe),
Specify in which format to download the update. Choices are: 'tar' (unix source archive), 'deb' (Debian package), 'arch' (ArchLinux package), 'zip' (Windows source archive), 'exe' (Windows installer [requires Python]), 'py2exe' (Windows installers [doesn't require Python]).
+Specify in which format to download the update. Choices are: 'tar' (unix source archive), 'deb' (Debian package), 'zip' (Windows source archive), 'exe' (Windows installer [requires Python]), 'py2exe' (Windows installer [doesn't require Python]).
Override the default location of the introducers list.
Override the default location of the NEWS.tgz file.
Override the default location of script updates.
Override the default location of the --repair-list subscription file.
+Override the default location of the --repair subscription file.
Increase verbosity of output.
@@ -96,32 +93,26 @@URIs, in this context, are Tahoe-LAFS directories like, for example URI:DIR2-RO:22s6zidugdxaeikq6lakbxbcci:mgrc3nfnygslyqrh7hds22usp6hbn3pulg5bu2puv6y3wpoaaqqq
.
If you choose to download the news feed, grid-updates will place a plain text version of it in your node's directory and print it to stdout. This is intended to be sent by cron mail.
There is also an HTML version of the news feed that you can view in a web browser. You can access it either directly (http://127.0.0.1:3456/static/NEWS.html) or have it be displayed on your Tahoe node's web console. You can prepare the console by running grid-updates --patch-tahoe
once.
The Atom news feed (http://127.0.0.1:3456/static/NEWS.atom) can be used by regular feed readers to check for grid-updates news. (Please note, however, that you cannot "refresh" the feed with regular news readers. These files have to always be fetched by grid-updates first.)
-All grid-updates subscriptions reside on the Tahoe grid, which means that they need to be maintained (renewal of leases, repairs). Please contribute to their maintenance by running --repair
from time to time.
If the script repeatedly fails to retrieve files from the grid, the share may be damaged and you will have to find a new set of URIs to subscribe to. One way to possibly get them is to run --check-version
to see if there is a new version of grid-updates available. Newer versions might already include new default URIs.
If you want to offer a grid-updates subscription service, you will have to provide users with URIs to directories that contain the subscription files. The available subscription types are the news feed (called NEWS.tgz), the introducer list (called introducers.json.txt) and the repair list (called repair-list.json.txt).
+If you want to offer a grid-updates subscription service, you will have to provide users with the URIs of your subscription files. They can be either in the form DIR CAP/filename or the the file cap itself. In the latter case you must make sure to create mutable files.
For the specific requirements of the JSON lists, please see the included example files in the share directory.
-Please note that grid-updates expects the URIs of directories, not of the files themselves. It will append the filenames itself.
Currently Tahoe doesn't return JSON data if it encounters exceptions (see Trac ticket #1799). If you see this grid-updates error, you can rerun your command in debug mode (-vvv
) to see Tahoe's actual response.
This error is most likely to occur during deep-check operations. If it does, it probably encountered the NotEnoughSharesError error, which means that a file was unrecoverable. You should investigate the problem using Tahoe directly.
+This error is related to the one above but happens during one-check operations. If a file is not retrievable (due to not enough remaining shares) Tahoe responds with HTTP error 410.
+Please report bugs in #tahoe-lafs on Irc2p or via email (see above).
The grid-updates Git repositories:
diff -Nru grid-updates-1.1.3/PKG-INFO grid-updates-1.2.0/PKG-INFO --- grid-updates-1.1.3/PKG-INFO 2012-06-30 13:49:31.000000000 +0000 +++ grid-updates-1.2.0/PKG-INFO 2012-09-09 14:59:28.000000000 +0000 @@ -1,6 +1,6 @@ Metadata-Version: 1.1 Name: grid-updates -Version: 1.1.3 +Version: 1.2.0 Summary: Tahoe-LAFS helper script Home-page: http://killyourtv.i2p/grid-updates Author: darrob, KillYourTV diff -Nru grid-updates-1.1.3/README.html grid-updates-1.2.0/README.html --- grid-updates-1.1.3/README.html 2012-06-30 13:49:30.000000000 +0000 +++ grid-updates-1.2.0/README.html 2012-09-09 14:59:27.000000000 +0000 @@ -1,59 +1,414 @@ + - + - - - -grid-updates
is a Python script intended to help keep Tahoe-LAFS nodes' configurations up-to-date. It can retrieve lists of introducers 1 as well as news feeds from the Tahoe grid. This is useful for any public grid that relies solely on volunteers.
On some public grids (especially the one on I2P) all nodes, even introducers, are run by volunteers and may disappear at any given time. Maintaining a list of all known introducers and distributing it to all participants of the grid will ensure the best possible connectivity for everyone.
-Furthermore, there is no reliable way to contact node operators. This is why we want to encourage users to subscribe to a news feed relevant to their Tahoe grid. We hope it's going to be a way to inform unknown node operators about their wrongly configured nodes, necessary updates, recommended configuration changes and such.
-grid-updates
can be downloaded from any of the following locations.
Git
-grid-updates is a Python script intended to help keep Tahoe-LAFS nodes' +configurations up-to-date. It can retrieve lists of introducers [1] as well as +news feeds from the Tahoe grid. This is useful for any public grid that relies +solely on volunteers.
+On some public grids (especially the one on I2P) all nodes, even +introducers, are run by volunteers and may disappear at any given time. +Maintaining a list of all known introducers and distributing it to all +participants of the grid will ensure the best possible connectivity for +everyone.
+Furthermore, there is no reliable way to contact node operators. This is +why we want to encourage users to subscribe to a news feed relevant to +their Tahoe grid. We hope it's going to be a way to inform unknown node +operators about their wrongly configured nodes, necessary updates, +recommended configuration changes and such.
+grid-updates can be downloaded from any of the following locations.
+See INSTALL.html for information on how to install grid-updates.
-grid-updates
was designed as a cron job script but can be run manually just as well.
Run this script with either --sync-introducers
or --merge-introducers
to make sure your Tahoe-LAFS node will know about as many introducers as possible.
If you also want to receive the news feed, add the --download-news
action. It will fetch and display (email if run by a cron job) the news feed from the grid. It will also allow you to view the news your browser (using --patch-tahoe
even in Tahoe's web console) and to be notified of news by a regular news reader using an Atom news feed. Following the grid-updates news is recommended.
The subscriptions and script installation files are stored on the grid itself and -- like all other shares -- need maintenance and repairs 3. If you can, please also add the --repair
action to your cron job, or run it separately every once in a while. This is necessary to keep the service available.
--repair-list
is another subscription-based service. It will download download a list of shares and check/repair them. This is supposed to make it easier for a community or group of people to support each others Tahoe shares. (The default subscription includes shares such as the DeepWiki on the I2P grid.)
Please refer to the man page for detailed usage information.
-See INSTALL.html for information on how to install +grid-updates.
+grid-updates was designed as a cron job script but can be run +manually just as well.
+Run this script with either --sync-introducers or +--merge-introducers to make sure your Tahoe-LAFS node will know +about as many introducers as possible.
+If you also want to receive the news feed, add the --download-news +action. It will fetch and display (email if run by a cron job) the news +feed from the grid. It will also allow you to view the news your browser +(using --patch-tahoe even in Tahoe's web console) and to be notified +of news by a regular news reader using an Atom news feed. Following the +grid-updates news is recommended.
+--repair is another subscription-based service. It will download a list of +shares and check/repair them. This is supposed to make it easier for a +community or group of people to support each other's Tahoe shares. (The +default subscription includes shares such as the DeepWiki on the I2P grid.)
+Please refer to the man page for detailed usage information.
+--+0 0 * * * grid-updates --sync-introducers --download-news --check-version -30 0 */2 * * grid-updates --repair
+0 0 * * * grid-updates --sync-introducers --download-news --check-version +30 0 */2 * * grid-updates --repair +
grid-updates
has been released into the public domain. You may do what you wish with it.
For Bug reports and support join #tahoe-lafs on Irc2P or send an email.
-You need at least Tahoe version 1.8.3 patched for multiple introducer support. See <http://killyourtv.i2p/tag/multiple_introducer/>↩
The Tahoe URI of the script is URI:DIR2-RO:hgh5ylzzj6ey4a654ir2yxxblu:hzk3e5rbsefobeqhliytxpycop7ep6qlscmw4wzj5plicg3ilotq
↩
See also the tahoe-repair-all.sh script at <http://killyourtv.i2p/tahoe-lafs/scripts/>↩
grid-updates has been released into the public domain. You may do +what you wish with it.
+For Bug reports and support join +#tahoe-lafs on Irc2P or send an +email.
+[1] | You need at least Tahoe version 1.8.3 patched for multiple introducer +support. See <http://killyourtv.i2p/tag/multiple_introducer/> |