rev |
line source |
pankso@342
|
1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
|
pankso@342
|
2 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
pankso@342
|
3 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
|
pankso@342
|
4 <head>
|
pankso@342
|
5 <title>SliTaz Cookbook (en) - Build Host</title>
|
pankso@342
|
6 <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" />
|
pankso@342
|
7 <meta name="description" content="slitaz English cookbook" />
|
pankso@342
|
8 <meta name="expires" content="never" />
|
pankso@342
|
9 <meta name="modified" content="2009-03-27 21:30:00" />
|
pankso@342
|
10 <meta name="publisher" content="www.slitaz.org" />
|
pankso@342
|
11 <meta name="author" content="SliTaz contributors"/>
|
pankso@342
|
12 <link rel="shortcut icon" href="favicon.ico" />
|
pankso@342
|
13 <link rel="stylesheet" type="text/css" href="book.css" />
|
pankso@342
|
14 </head>
|
pankso@342
|
15 <body bgcolor="#ffffff">
|
pankso@342
|
16
|
pankso@342
|
17 <!-- Header and quick navigation -->
|
pankso@342
|
18 <div id="header">
|
pankso@342
|
19 <div align="right" id="quicknav">
|
pankso@342
|
20 <a name="top"></a>
|
pankso@342
|
21 <a href="boot-scripts.html">Boot Scripts</a> |
|
pankso@342
|
22 <a href="index.html">Table of contents</a>
|
pankso@342
|
23 </div>
|
pankso@342
|
24 <h1><font color="#3E1220">SliTaz Cookbook (en)</font></h1>
|
pankso@342
|
25 </div>
|
pankso@342
|
26
|
pankso@342
|
27 <!-- Content. -->
|
pankso@342
|
28 <div id="content">
|
pankso@342
|
29 <div class="content-right"></div>
|
pankso@342
|
30
|
pankso@342
|
31 <h2><font color="#DF8F06">SliTaz Build Host (tank)</font></h2>
|
pankso@342
|
32
|
pankso@342
|
33 <p>
|
pankso@342
|
34 SliTaz build host info and howto.
|
pankso@342
|
35 </p>
|
pankso@342
|
36
|
pankso@342
|
37 <ul>
|
pankso@342
|
38 <li><a href="#folders">Folders in: /home/slitaz</a></li>
|
pankso@342
|
39 <li><a href="#scripts">Using scripts: /home/slitaz/scripts</a></li>
|
pankso@342
|
40 <li><a href="#undigest-pkgs">Cooking undigest packages</a></li>
|
pankso@342
|
41 <li><a href="#cooking-pkgs">Cooking official packages</a></li>
|
pankso@342
|
42 <li><a href="#stable-pkgs">Stable packages</a></li>
|
pankso@342
|
43 <li><a href="#mirror-up">Upload by hand on mirror.slitaz.org</a></li>
|
pankso@342
|
44 <li><a href="#website-up">Update website by hand</a></li>
|
pankso@342
|
45 </ul>
|
pankso@342
|
46
|
pankso@342
|
47 <a name="folders"></a>
|
pankso@342
|
48 <h3>Folders in: /home/slitaz</h3>
|
pankso@342
|
49 <ul>
|
pankso@342
|
50 <li>cooking/ - Cooking chroot and flavors.</li>
|
pankso@342
|
51 <li>stable/ - Stable tree.</li>
|
pankso@342
|
52 <li>scripts/ - Small scripts to help maintaining host, project.</li>
|
pankso@342
|
53 <li>repos/ - All the project repos (where the commits are pushed).</li>
|
pankso@342
|
54 <li>www/ - Virtual hosts (website, hg, boot, people, etc).</li>
|
pankso@342
|
55 </ul>
|
pankso@342
|
56
|
pankso@342
|
57 <a name="scripts"></a>
|
pankso@342
|
58 <h3>Using scripts: /home/slitaz/scripts</h3>
|
pankso@342
|
59 <p>
|
pankso@342
|
60 To help maintaining the mirror, flavors and other services some scripts
|
pankso@342
|
61 are used, there are mostly all configured for the cooking version. To
|
pankso@342
|
62 add them to your default path:
|
pankso@342
|
63 </p>
|
pankso@342
|
64 <pre>
|
pankso@342
|
65 $ echo 'export PATH=/home/slitaz/scripts:$PATH' >> ~/.profile
|
pankso@342
|
66 </pre>
|
pankso@342
|
67 <p>
|
pankso@342
|
68 Each script should have a small help and description, if none, just open
|
pankso@342
|
69 it:
|
pankso@342
|
70 </p>
|
pankso@342
|
71 <pre>
|
pankso@342
|
72 $ cd /home/slitaz/script && ls
|
pankso@342
|
73 $ ./script.sh help
|
pankso@342
|
74 </pre>
|
pankso@342
|
75
|
pankso@342
|
76 <a name="undigest-pkgs"></a>
|
pankso@342
|
77 <h3>Cooking undigest packages</h3>
|
pankso@342
|
78 <p>
|
pankso@342
|
79 You can use the undigest wok in the chroot environement to cook some
|
pankso@342
|
80 non supported packages. If you maintain official packages and they cook
|
pankso@342
|
81 succefully on tank you can test it on your local machine and then commit
|
pankso@342
|
82 in the official wok. Mirror maintainers will then rebuild and upload the
|
pankso@342
|
83 packages on mirror.slitaz.org.
|
pankso@342
|
84 </p>
|
pankso@342
|
85 <p>
|
pankso@342
|
86 To build packages in the undigest wok and in the chroot environement,
|
pankso@342
|
87 some commands are better than a long text:
|
pankso@342
|
88 </p>
|
pankso@342
|
89 <pre>
|
pankso@342
|
90 $ ln -s /home/slitaz/cooking/chroot/home/undigest .
|
pankso@342
|
91 </pre>
|
pankso@342
|
92 <p>
|
pankso@342
|
93 You can copy file with gFTP-sftp-scp directly in the wok or from the
|
pankso@342
|
94 current directory:
|
pankso@342
|
95 </p>
|
pankso@342
|
96 <pre>
|
pankso@342
|
97 $ cp -a package undigest/wok
|
pankso@342
|
98 $ su -c chroot.sh
|
pankso@342
|
99 /# cd home/undigest
|
pankso@342
|
100 /# tazwok cook package
|
pankso@342
|
101 /# exit
|
pankso@342
|
102 $ ls undigest/packages
|
pankso@342
|
103 </pre>
|
pankso@342
|
104
|
pankso@342
|
105 <a name="cooking-pkgs"></a>
|
pankso@342
|
106 <h3>Cooking official packages</h3>
|
pankso@342
|
107 <p>
|
pankso@342
|
108 Mirror maintainers have root access and some have write access to the
|
pankso@342
|
109 main mirror at mirror.slitaz.org, if you want to help in this task please
|
pankso@342
|
110 contact one of the most active developpers (check hg repos).
|
pankso@342
|
111 </p>
|
pankso@342
|
112 <p>
|
pankso@342
|
113 Everything is cook in a chroot environement, default path for the main
|
pankso@342
|
114 wok is /home/slitaz, some changes can be done directly in this wok, the
|
pankso@342
|
115 real Hg is out of the chroot and copied in the chroot with wok.sh:
|
pankso@342
|
116 </p>
|
pankso@342
|
117 <pre>
|
pankso@342
|
118 # wok.sh hgup
|
pankso@342
|
119 # chroot.sh
|
pankso@342
|
120 </pre>
|
pankso@342
|
121 <p>
|
pankso@342
|
122 Cook all missing packages, one by one or with 'tazwok cmp --cook', note
|
pankso@342
|
123 that comparaison it not requiert, if you know witch packages you must
|
pankso@342
|
124 cook:
|
pankso@342
|
125 </p>
|
pankso@342
|
126 <pre>
|
pankso@342
|
127 /# tazwok cmp
|
pankso@342
|
128 /# tazwok cook package-name
|
pankso@342
|
129 </pre>
|
pankso@342
|
130 <p>
|
pankso@342
|
131 Remove all old packages and then rebuild the lists:
|
pankso@342
|
132 </p>
|
pankso@342
|
133 <pre>
|
pankso@342
|
134 /# tazwok cmp --remove
|
pankso@342
|
135 /# tazwok gen-list --text
|
pankso@342
|
136 /# exit
|
pankso@342
|
137 </pre>
|
pankso@342
|
138 <p>
|
pankso@342
|
139 If you have write access to the mirror you can make a dry-push to check
|
pankso@342
|
140 and then upload, push will also remove old packages on the mirror.
|
pankso@342
|
141 </p>
|
pankso@342
|
142
|
pankso@342
|
143 <a name="stable-pkgs"></a>
|
pankso@342
|
144 <h3>Stable packages</h3>
|
pankso@342
|
145 <p>
|
pankso@342
|
146 Packages for the stable release are build in a chroot environement like
|
pankso@342
|
147 the Cooking packages.
|
pankso@342
|
148 </p>
|
pankso@342
|
149 <pre>
|
pankso@342
|
150 # chroot.sh stable
|
pankso@342
|
151 </pre>
|
pankso@342
|
152
|
pankso@342
|
153 <a name="mirror-up"></a>
|
pankso@342
|
154 <h3>Upload by hand on mirror.slitaz.org</h3>
|
pankso@342
|
155 <p>
|
pankso@342
|
156 Mirror maintainers can upload by hand with the script mirror.sh:
|
pankso@342
|
157 </p>
|
pankso@342
|
158 <pre>
|
pankso@342
|
159 # mirror.sh help
|
pankso@342
|
160 </pre>
|
pankso@342
|
161
|
pankso@342
|
162 <a name="website-up"></a>
|
pankso@342
|
163 <h3>Update website by hand</h3>
|
pankso@342
|
164 <p>
|
pankso@342
|
165 Wesite and packages web interface are updated nightly by cron and can
|
pankso@342
|
166 also be update by hand (used the day of release for example):
|
pankso@342
|
167 </p>
|
pankso@342
|
168 <pre>
|
pankso@342
|
169 # website.sh up
|
pankso@342
|
170 # website.sh help
|
pankso@342
|
171 </pre>
|
pankso@342
|
172
|
pankso@342
|
173 <!-- End of content -->
|
pankso@342
|
174 </div>
|
pankso@342
|
175
|
pankso@342
|
176 <!-- Footer. -->
|
pankso@342
|
177 <div id="footer">
|
pankso@342
|
178 <div class="footer-right"></div>
|
pankso@342
|
179 <a href="#top">Top of the page</a> |
|
pankso@342
|
180 <a href="index.html">Table of contents</a>
|
pankso@342
|
181 </div>
|
pankso@342
|
182
|
pankso@342
|
183 <div id="copy">
|
pankso@342
|
184 Copyright © 2009 <a href="http://www.slitaz.org/en/">SliTaz</a> -
|
pankso@342
|
185 <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br />
|
pankso@342
|
186 Documentation is under
|
pankso@342
|
187 <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a>
|
pankso@342
|
188 and code is <a href="http://validator.w3.org/">valid xHTML 1.0</a>.
|
pankso@342
|
189 </div>
|
pankso@342
|
190
|
pankso@342
|
191 </body>
|
pankso@342
|
192 </html>
|