/[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.1 - (show annotations) (download) (as text)
Fri Jun 2 00:36:01 2006 UTC (11 years, 7 months ago) by jforman
Branch: MAIN
File MIME type: application/xml
initial add

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

  ViewVC Help
Powered by ViewVC 1.1.20