r134 - in /debtorrent/trunk: DebTorrent/__init__.py README.txt
camrdale-guest at users.alioth.debian.org
camrdale-guest at users.alioth.debian.org
Sat Jul 7 20:58:44 UTC 2007
Author: camrdale-guest
Date: Sat Jul 7 20:58:44 2007
New Revision: 134
URL: http://svn.debian.org/wsvn/debtorrent/?sc=1&rev=134
Log:
Update readme and version for upcoming release.
Modified:
debtorrent/trunk/DebTorrent/__init__.py
debtorrent/trunk/README.txt
Modified: debtorrent/trunk/DebTorrent/__init__.py
URL: http://svn.debian.org/wsvn/debtorrent/debtorrent/trunk/DebTorrent/__init__.py?rev=134&op=diff
==============================================================================
--- debtorrent/trunk/DebTorrent/__init__.py (original)
+++ debtorrent/trunk/DebTorrent/__init__.py Sat Jul 7 20:58:44 2007
@@ -20,7 +20,7 @@
"""
product_name = 'DebTorrent'
-version_short = 'T-0.1.1'
+version_short = 'T-0.1.2'
version = version_short+' ('+product_name+')'
report_email = 'debtorrent-devel at lists.alioth.debian.org'
Modified: debtorrent/trunk/README.txt
URL: http://svn.debian.org/wsvn/debtorrent/debtorrent/trunk/README.txt?rev=134&op=diff
==============================================================================
--- debtorrent/trunk/README.txt (original)
+++ debtorrent/trunk/README.txt Sat Jul 7 20:58:44 2007
@@ -8,98 +8,56 @@
tar -xzvf debtorrent-<version>.tar.gz
-3. Change into the debtorrent directory:
+3. Change into the debtorrent/downloads (or any empty) directory:
- cd debtorrent-<version>
+ cd debtorrent-<version>/downloads
-4. Copy into dtorrents/ the package lists in /var/lib/apt/lists/ that you
- want to download from:
+4. Start the debtorrent downloader:
- cp /var/lib/apt/lists/ftp.us.debian.org_debian_dists_etch_main_binary-i386_Packages \
- dtorrents/ftp.us.debian.org_debian_dists_etch_main_binary-i386_Packages
+ ../btlaunchmany.py
+
+ The program will run in the foreground forever (until it receives an
+ interrupt signal), so you may want to background it (be sure to redirect
+ the output to a file) or switch to another console for the rest of the
+ testing.
+
+ You can use some of the options to btlaunchmany (to see them, run it
+ with a bad argument) but most are untested.
- Or, if you want to download from all of the package lists:
-
- cp /var/lib/apt/lists/*_Packages dtorrents/
+5. Modify your /etc/apt/sources.list to send all requests through the debtorrent
+ program, for example if your sources.list contains a line like this:
-5. Update your package lists (as root):
+ deb http://ftp.us.debian.org/debian etch main contrib non-free
- apt-get update
+ then replace it with this (add "localhost:9988/" to the beginning):
-6. Start the download:
+ deb http://localhost:9988/ftp.us.debian.org/debian etch main contrib non-free
+
+ The port can be changed by the "--port" option to btlaunchmany, but it
+ defaults to 9988.
- ./btlaunchmany.py dtorrents/ --saveas downloads/ --status_to_download <x>
-
- Set the <x> value to:
-
- 0 - to download all of the packages in each Packages file (a mirror
- of the archives, could be VERY large)
-
- 1 - to download only the packages that are installed, according to
- /var/lib/dpkg/status, and the version available is newer than the
- installed one (this is the smallest download, but may do nothing if
- your system is up to date)
-
- 2 - to download all the packages that are installed, according to
- /var/lib/dpkg/status, regardless of the version
-
- You can use some of the options to btlaunchmany (to see them, run it
- without arguments) but most are untested.
-
-7. Wait for the downloads to complete:
-
- If you have any problems downloading, go to
-
- http://dttracker.debian.net:6969
-
- to check if your download is active. You can find which one is yours by
- running btshowmetainfo on a Packages file to display the info hash of
- the file:
-
- btshowmetainfo.py ftp.us.debian.org_debian_dists_etch_main_binary-i386_Packages | grep "info hash"
-
- If it is active, but you still can't download, or if you get errors from
- running any of the programs, please post the problem/error to:
-
- debtorrent-devel at lists.alioth.debian.org
-
-8. Add the download directories to the top of your /etc/apt/sources.list,
- for example:
-
- deb file:/tmp/debtorrent/downloads/ftp.us.debian.org_debian_dists_etch_main_binary-amd64 ./
- deb file:/tmp/debtorrent/downloads/ftp.us.debian.org_debian_dists_etch_contrib_binary-amd64 ./
- etc...
-
- There should be one entry for every directory in your downloads/ directory
- that completed downloading. Do NOT add directories for downloads that did
- not complete, as the pre-allocated empty files in them will cause MD5 sum
- errors which will prevent apt from installing the packages.
-
- The lines must be added to the top of the sources.list in order for apt
- to get the files from there first rather than downloading them from the
- mirror listed later in the file.
-
-9. Link the Packages files into the download directories, for example:
-
- ln -s dtorrents/ftp.us.debian.org_debian_dists_etch_main_binary-i386_Packages \
- downloads/ftp.us.debian.org_debian_dists_etch_main_binary-i386/Packages
-
- This is necessary for the next step to work, that is for apt to recognize
- that the download directories are in fact package repositories.
-
-10. Update your package lists (as root) to see the newly downloaded files:
+6. Update your package lists (as root):
apt-get update
-11. Install or upgrade packages normally (as root):
+ This will download the Packages files through the debtorrent program, which
+ will automatically start them running (you should be able to see this in the
+ output from btlaunchmany).
+
+7. Proceed to use apt normally (as root), for example:
apt-get install ...
apt-get upgrade
apt-get dist-upgrade
+ All downloads through Apt should work, regardless if there are any peers,
+ since the program will use a backup HTTP download from the mirror in the
+ event that no peers for the download can be found.
-For future upgrades/installs, repeat steps 5-11, omitting step 9 (1-4 and 9
-are not needed as they were only for initialization).
+ If you can't download, or if you get errors from running any of the
+ programs, please post the problem/error to:
+
+ debtorrent-devel at lists.alioth.debian.org
Known Bugs
More information about the Debtorrent-commits
mailing list