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

1 jforman 1.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