/[gentoo]/xml/htdocs/proj/en/infrastructure/torrent.xml
Gentoo

Contents of /xml/htdocs/proj/en/infrastructure/torrent.xml

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1.2 - (show annotations) (download) (as text)
Mon Oct 6 05:48:45 2008 UTC (9 years, 10 months ago) by robbat2
Branch: MAIN
Changes since 1.1: +4 -0 lines
File MIME type: application/xml
Add warning.

1 <?xml version='1.0' encoding="UTF-8"?>
2
3
4 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
5
6 <guide link="torrent.xml">
7 <title>Maintainers Guide - torrents.gentoo.org</title>
8 <author title="Author">
9 <mail link="curtis119@gentoo.org">Curtis Napier</mail>
10 </author>
11
12 <abstract>
13 Maintainers Guide for torrents.gentoo.org
14 </abstract>
15
16 <version>0.1</version>
17 <date>March- 6-2006</date>
18
19 <chapter>
20 <title>Torrent Tracker</title>
21 <section>
22 <body>
23
24 <warn>
25 This document is mostly outdated, and remains only for reference. The torrents are created differently now.
26 </warn>
27 <p>
28
29 Gentoo offers iso's of our release media and other files via BitTorrent. We host
30 our own torrent tracker at http://torrents.gentoo.org/. The website uses
31 <uri link="http://phpbttrkplus.sourceforge.net/">PHPBTTracker+</uri> to track
32 the torrents.
33 </p>
34
35 </body>
36 </section>
37
38 <section>
39 <title>Initial Setup</title>
40 <body>
41
42 <p>
43 Requirements:
44 </p>
45
46 <ul>
47 <li>Apache2</li>
48 <li>mySQL</li>
49 <li>php (requires USE="session")</li>
50 </ul>
51
52 <p>
53 The tracker resides on sparrow.gentoo.org and is administered by the Infrastructure
54 Project. The administrator assigned to the box will assist you by keeping the
55 software up to date and advising you of any changes. Close coordination with the
56 assigned administrator is very important.
57 </p>
58
59 <p>
60 The tracker runs inside a webserver owned by a special user $TORRENT (the server
61 administrator has the details of the actual account). su to this user when adding
62 or changing any files to the web server. Apache user has group write access to
63 torrents/ in order to upload the .torrent files for storage. All other files and
64 directories are owned by the $TORRENT user.
65 </p>
66
67 <p>
68 Untar the tracker software in htdocs and edit <path>config_example.php</path> and
69 move it to <path>config.php</path>. The php scripts expect config.php to be in the
70 parent directory. Edit the necessary php files to reflect this. Move
71 <path>index_samples/index_sample.php</path> to <path>../index.php</path>. Edit
72 this file and insert the Gentoo header and make any other formatting changes necessary.
73 </p>
74
75 <p>
76 Move <path>index_samples/tracker.css</path> to <path>../tracker.css</path> and
77 insert the Gentoo header information and any other formatting changes. Use
78 <uri link="http://www.gentoo.org/css/main.css">main.css</uri> as a reference.
79 </p>
80
81 <p>
82 The php scripts are heavily commented. Read the INSTALL and README docs for
83 information for other configuration information.
84 </p>
85
86 </body>
87 </section>
88 <section>
89 <title>Administration</title>
90 <body>
91
92 <p>
93 Logon to the <uri link="http://torrents.gentoo.org/administration/">administrative
94 panel</uri> for reports, adding and deleting torrents and grouping functions.
95 Create all of the categories first and then add the torrents. Make sure to fill
96 in the category information on the add torrent panel.
97 </p>
98
99 </body>
100 </section>
101 <section>
102 <title>New Releases and Upgrades</title>
103 <body>
104
105 <p>
106 Because the release media is retired at each release the torrent database will
107 simply be cleared and the tracker software reinstalled. The install process is
108 much easier and less time consuming than retiring each individual torrent. Use
109 mysql to drop all the tables in the database and the install process will
110 automatically recreate it.
111 </p>
112
113 </body>
114 </section>
115 </chapter>
116
117 <chapter>
118 <title>Torrent Client</title>
119 <section>
120 <body>
121
122 <p>
123 The torrent client is <uri link="http://www.bittornado.com/">BitTornado</uri>.
124 Use the various scripts it comes with to create the torrents and seed them.
125 </p>
126
127 <p>
128 The actual release media is stored in <path>/mnt/torrents/</path>. The mirror
129 admin will copy the <path>release/</path> directory directly to this partition.
130 Create a directory for the release, example <path>/mnt/torrents/2006.0</path>.
131 </p>
132
133 <p>
134 Move the files for the individual torrents into a seperate directory in
135 <path>/mnt/torrents/2006.0/*</path>. For instance:
136 <path>/mnt/torrents/2006.0/x86-installcd-2006.0/</path>. Each .iso should be a
137 seperate torrent file. Include the .contents, .digests and .asc files for the .iso.
138 in the directory with the .iso.
139 </p>
140
141 <p>
142 Once you have all of the files sorted use <c>btcompletedir.py</c> to mass create
143 the .torrent files:
144 </p>
145
146 <p>
147 $ btcompletedir.py http://torrents.gentoo.org/tracker.php/announce /mnt/torrents/2006.0/
148 </p>
149
150 <p>
151 The torrent client is hosted on the same machine. Once you have created the torrents
152 use links to <uri link="http://torrents.gentoo.org/administration/">logon</uri>
153 to the tracker and add the torrents.
154 </p>
155
156 <p>
157 Now start a screen session named <c>bittorando</c> and then su to the $TORRENT user.
158 Change to /mnt/torrents/2006.0 and start the torrent client.
159 </p>
160
161 <p>
162 /usr/bin/btlaunchmany.py --display_interval 100 --minport 6881 --maxport 6999 --ip 38.99.80.68 ./
163 </p>
164
165 </body>
166 </section>
167 </chapter>
168
169 <chapter>
170 <title>Resources</title>
171 <section>
172 <body>
173
174 <ul>
175 <li><uri link="http://torrents.gentoo.org/">Gentoo Torrent Tracker</uri></li>
176 <li><uri link="http://torrents.gentoo.org/administration/">Gentoo Torrent
177 Tracker Administration</uri></li>
178 <li><uri link="http://phpbttrkplus.sourceforge.net/">PHPBTTracker+</uri></li>
179 <li><uri link="http://www.bittornado.com/">BitTornado</uri></li>
180 </ul>
181
182 <p>
183 For details of the #TORRENT account and the database account please contact the
184 server admin.
185 </p>
186
187 </body>
188 </section>
189 </chapter>
190
191 </guide>

  ViewVC Help
Powered by ViewVC 1.1.20