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