/[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.3 - (hide annotations) (download) (as text)
Sun Oct 28 15:21:07 2012 UTC (5 years, 10 months ago) by swift
Branch: MAIN
Changes since 1.2: +1 -1 lines
File MIME type: application/xml
Removing link attribute from guides

1 jforman 1.1 <?xml version='1.0' encoding="UTF-8"?>
2    
3    
4     <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
5    
6 swift 1.3 <guide>
7 jforman 1.1 <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 robbat2 1.2 <warn>
25     This document is mostly outdated, and remains only for reference. The torrents are created differently now.
26     </warn>
27 jforman 1.1 <p>
28 robbat2 1.2
29 jforman 1.1 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