[Debtorrent-commits] r55 - /debtorrent/trunk/README.txt
camrdale-guest at users.alioth.debian.org
camrdale-guest at users.alioth.debian.org
Sun May 20 23:24:29 UTC 2007
Author: camrdale-guest
Date: Sun May 20 23:24:29 2007
New Revision: 55
URL: http://svn.debian.org/wsvn/debtorrent/?sc=1&rev=55
Log:
Modify the README for the new method.
Modified:
debtorrent/trunk/README.txt
Modified: debtorrent/trunk/README.txt
URL: http://svn.debian.org/wsvn/debtorrent/debtorrent/trunk/README.txt?rev=55&op=diff
==============================================================================
--- debtorrent/trunk/README.txt (original)
+++ debtorrent/trunk/README.txt Sun May 20 23:24:29 2007
@@ -1,65 +1,97 @@
To start testing DebTorrent, do the following:
-1. Download the source from the Alioth project:
+1. Download the source from the Alioth project:
- https://alioth.debian.org/frs/?group_id=31109
+ https://alioth.debian.org/frs/?group_id=31109
-2. Unpack it:
+2. Unpack it:
- tar -xzvf debtorrent_<version>.tar.gz
+ tar -xzvf debtorrent-<version>.tar.gz
-3. Change into the debtorrent directory:
+3. Change into the debtorrent directory:
- cd debtorrent-<version>
+ cd debtorrent-<version>
-4. Choose an archive to download:
+4. Update your package lists (as root):
- a) Choose a .dtorrent file from the dtorrents directory
+ apt-get update
+
+5. Choose package lists to download from:
+
+ a) Either download from all lists in /var/lib/apt/lists/
- You can view the contents of the file using the btshowmetainfo.py command
+ b) Or, create a directory containin only the Packages files from
+ /var/lib/apt/lists/ that you want to download from.
+
+6. Create a directory for the download:
+
+ mkdir /tmp/debtorrent
+
+7. Start the download:
+
+ btlaunchmany.py /var/lib/apt/lists --saveas /tmp/debtorrent/ --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)
- To determine if the dtorrent has peers/seeds, go to
-
- http://dttracker.debian.net:6969
-
- and look for the info hash shown by btshowmetainfo.
+ 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.
+
+8. Wait for the download to complete:
- b) Or, create a .dtorrent file using btmakemetafile from a Packages file:
+ 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 btmakemetafile on a Packages file:
+
+ btmakemetafile.py Packages Packages.dtorrent
+
+ and then btshowmetainfo on the result to display the info hash of the file:
+
+ btshowmetainfo.py Packages.dtorrent | 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
- btmakemetafile.py http://dttracker.debian.net:6969/announce \
- /var/lib/apt/lists/<mirror>_debian_dists_<suite>_<section>_binary-<arch>_Packages \
- --target test.dtorrent
+9. Copy the Packages files into the download directories, for example:
- c) Or, choose a Packages file from /var/lib/apt/lists/
-
- d) Or, find one on the web, for example:
-
- http://ftp.us.debian.org/debian/dists/stable/contrib/binary-i386/Packages.gz
-
- The recommended Packages file to use is from the stable suite (as it
- doesn't change much), and section contrib (as it's the smallest).
+ cp /var/lib/apt/lists/ftp.us.debian.org_debian_dists_etch_main_binary-amd64_Packages \
+ /tmp/debtorrent/ftp.us.debian.org_debian_dists_etch_main_binary-amd64/Packages
-5. Start the download, depending on which archive was chosen, do the following:
+10. gzip the copied Packages files, for example:
- a) btdownloadheadless.py dtorrents/<file>.dtorrent
-
- b) btdownloadheadless.py test.dtorrent
-
- c) btdownloadheadless.py /var/lib/apt/lists/<mirror>_debian_dists_<suite>_<section>_binary-<arch>_Packages
-
- d) btdownloadheadless.py http://ftp.us.debian.org/debian/dists/stable/contrib/binary-i386/Packages.gz
-
- You can use some of the options to btdownloadheadless (to see them, run it
- without arguments) but most are untested.
+ gzip /tmp/debtorrent/ftp.us.debian.org_debian_dists_etch_main_binary-amd64/Packages
-If you have any problems downloading, go to
+11. Add the download directories to the top of your /etc/apt/sources.list,
+ for example:
- http://dttracker.debian.net:6969
-
-to check if your torrent is active. If it is, 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
+ deb file:/tmp/debtorrent ftp.us.debian.org_debian_dists_etch_main_binary-amd64/
+ deb file:/tmp/debtorrent ftp.us.debian.org_debian_dists_etch_contrib_binary-amd64/
+ etc...
+
+12. Update your package lists (as root):
+
+ apt-get update
+
+13. Install or upgrade packages normally:
+
+ apt-get install ...
+ apt-get upgrade
Known Bugs
@@ -68,8 +100,8 @@
On starting a download, the following error is generated:
Traceback (most recent call last):
- File "/home/user/workspace/debtorrent/DebTorrent/inifile.py", line 113, in ini_read
+ File "DebTorrent/inifile.py", line 113, in ini_read
r = open(f,'r')
-IOError: [Errno 2] No such file or directory: '/home/user/.DebTorrent/config.downloadheadless.ini'
+IOError: [Errno 2] No such file or directory: '/home/user/.DebTorrent/config.launchmany.ini'
The error has no effect on the download.
More information about the Debtorrent-commits
mailing list