<p>Die <em>dfsbuild</em>-Dokumentation ist noch recht spärlich. Du kommst aber kaum in direkten Kontakt mit <em>dfsbuild</em>, da es durch 'cbox-build' aufgerufen wird. Die folgenden Links helfen dir vielleicht trotzdem weiter: </p>
<p>Die <em>dfsbuild</em>-Dokumentation ist noch recht spärlich. Du kommst aber kaum in direkten Kontakt mit <em>dfsbuild</em>, da es durch 'scripts/cbox-build.sh' aufgerufen wird. Die folgenden Links helfen dir vielleicht trotzdem weiter: </p>
<ul>
<li><p><aclass="external"href="http://www.debian-administration.org/articles/125">Debian Administration: Building Debian CD-ROMS Part 1 - dfsbuild</a></p>
<p>Die wichtige Kleinarbeit, damit aus dem dfsbuild-System eine <ahref="/cryptobox?action=doc&page=CryptoBox">CryptoBox</a> wird, erledigt <em>cbox-build.sh</em>.<br>
<p>Die wichtige Kleinarbeit, damit aus dem dfsbuild-System eine <ahref="/cryptobox?action=doc&page=CryptoBox">CryptoBox</a> wird, erledigt <em>scripts/cbox-build.sh</em>.<br>
Das Script und die bestehenden Konfigurationsdateien liegen im <aclass="interwiki"title="SubVersion"href="/websvn/cryptobox">cryptobox-Repository</a>. </p>
<p>Mit diesem Script baust du deine eigene <ahref="/cryptobox?action=doc&page=CryptoBox">CryptoBox</a>-CD. Hier ein verkürzter Überblick: </p>
<div>
@ -206,11 +206,11 @@
<dd><p><tt>./cbox-build.sh dfsbuild</tt></p>
</dd>
<dt>Anpassungen vornehmen, ISO-Image erstellen und per ''qemu'' testen</dt>
<p>run <tt>./cbox-build.sh release</tt> as <em>root</em> - hopefully, there should be no errors <imgsrc="/cryptobox-img/smile.png"alt=":)"height="15"width="15"></p>
<p>Hint: This step will fail, if you did not install <em>apt-cacher</em>. See <ahref="/cryptobox?action=doc&page=CryptoBoxDevCustomBuild">CryptoBoxDevCustomBuild</a> for details on how to change build-configuration settings (in this case: <em>mirror</em> in <em>dfs.cbox.conf</em>). </p>
<p>run <tt>scripts/cbox-build.sh release</tt> as <em>root</em> - hopefully, there should be no errors <imgsrc="/cryptobox-img/smile.png"alt=":)"height="15"width="15"></p>
<p>Hint: This step will fail, if you did not install <em>apt-cacher</em>. See <ahref="/cryptobox?action=doc&page=CryptoBoxDevCustomBuild">CryptoBoxDevCustomBuild</a> for details on how to change the build-configuration settings (in this case: <em>mirror</em> in <em>dfs.cbox.conf</em>). </p>
<p>Run <tt>tools/validate.sh check_all</tt> to conduct all tests of all groups. See <tt>tools/validate.sh help</tt> for other actions. </p>
<p>Run <tt>scripts/validate.sh check_all</tt> to conduct all tests of all groups. See <tt>scripts/validate.sh help</tt> for other actions. </p>
<p>The results will be saved at <em>validation/report</em>. </p>
<p>In addition to every single retrieved page, a html page called <em>summary.html</em> is created, which contains the state checks of all tests in a group. </p>
@ -53,7 +53,7 @@
<aid="bottom"></a>
</div>
<pid="pageinfo"class="info"lang="en"dir="ltr">last edited 2005-09-05 19:48:55 by <spantitle=""></span></p>
<pid="pageinfo"class="info"lang="en"dir="ltr">last edited 2005-09-08 14:52:42 by <spantitle="">lars</span></p>
<h3id="head-0ace019b2e7f624b4af95b328aa511a0453bd656">Build the base system</h3>
<p>Run <tt>./cbox-build.sh dfsbuild</tt> to create the base system for the LiveCD. </p>
<p>Run <tt>scripts/cbox-build.sh dfsbuild</tt> to create the base system for the LiveCD. </p>
<p>The result can be found in <em>_builddir/cd1/image</em>. </p>
<p>If you do not want to use the <em><aclass="interwiki"title="DebianPackage"href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&subword=1&version=all&release=all&keywords=apt-cacher">apt-cacher</a></em> to save bandwith and time, then you should modify the <em>mirror</em>-setting in <em>dfs-cbox.conf</em> (see <ahref="/cryptobox?action=doc&page=CryptoBoxDevCustomBuild">CryptoBoxDevCustomBuild</a> for details). </p>
<p>If you do not want to use the <em><aclass="interwiki"title="DebianPackage"href="http://packages.debian.org/cgi-bin/search_packages.pl?searchon=names&subword=1&version=all&release=all&keywords=apt-cacher">apt-cacher</a></em> to save bandwidth and time, then you should modify the <em>mirror</em>-setting in <em>dfs-cbox.conf</em> (see <ahref="/cryptobox?action=doc&page=CryptoBoxDevCustomBuild">CryptoBoxDevCustomBuild</a> for details). </p>
<h3id="head-b12afd5dca3afd8290b311944f1dd1ab3d16fa6f">Configure the base image</h3>
<p>Run <tt>./cbox-build.sh config</tt> to copy the <ahref="/cryptobox?action=doc&page=CryptoBox">CryptoBox</a>-specific files to the base image. </p>
<p>Run <tt>scripts/cbox-build.sh config</tt> to copy the <ahref="/cryptobox?action=doc&page=CryptoBox">CryptoBox</a>-specific files to the base image. </p>
<p>TODO: link to cbox-build.sh-manpage </p>
<h3id="head-22535d762de22b1c0b1be445d1ee560bc72a481f">Remove development features</h3>
<p>The original base system, that was created by <em>dfsbuild</em> contains a lot packages and some scripts, that are only useful during development. You should remove them, as they case severe security implications. </p>
<p>To reduce the <ahref="/cryptobox?action=doc&page=CryptoBox">CryptoBox</a>-LiveCD to the usable minimum for operational use, you should run <tt>./cbox-build.sh harden</tt>. </p>
<p>To reduce the <ahref="/cryptobox?action=doc&page=CryptoBox">CryptoBox</a>-LiveCD to the usable minimum for operational use, you should run <tt>scripts/cbox-build.sh harden</tt>. </p>
<h3id="head-09b84611139bf8f53380587b5b09588d97b4ff1c">Create an iso image</h3>
<p>To burn a <ahref="/cryptobox?action=doc&page=CryptoBox">CryptoBox</a>-LiveCD, you need an bootable <em>iso9660</em>-image. </p>
<p>Create the <em>iso</em> image with <tt>./cbox-build.sh iso</tt>. The resulting file can be found at <em>_builddir/cd1/cryptobox.iso</em>. </p>
<p>Create the <em>iso</em> image with <tt>scripts/cbox-build.sh iso</tt>. The resulting file can be found at <em>_builddir/cd1/cryptobox.iso</em>. </p>
<h3id="head-c78fdb473369885eacd6cb10fcfb00cad50f2670">Burn the CD</h3>
<p>Do it manually: <tt>cdrecord -v dev=0,0,0 _builddir/cd1/cryptobox.iso</tt> (change the <em>dev</em> setting according to your setup). </p>
<p>Let the script do it for you: <tt>./cbox-build.sh burn</tt> (maybe you have to change the <em>CDWRITER</em> setting in <em>cbox-dev.conf</em> - see <ahref="/cryptobox?action=doc&page=CryptoBoxDevCustomBuild">CryptoBoxDevCustomBuild</a>). </p>
<p>Of course, it is not wise to use CD-R media. Use CD-RW instead. </p>
<p>Let the script do it for you: <tt>scripts/cbox-build.sh burn</tt> (maybe you have to change the <em>CDWRITER</em> setting in <em>cbox-dev.conf</em> - see <ahref="/cryptobox?action=doc&page=CryptoBoxDevCustomBuild">CryptoBoxDevCustomBuild</a>). </p>
<p>Of course, it is not wise to use CD-R media. CD-RW consume less resources. </p>
<h2id="head-995d4701e181a853fd1d87811b76e802a1c61d96">Test the CryptoBox-LiveCD</h2>
@ -112,7 +112,7 @@
<h3id="head-25203ae5362d0bbc82ec84b349fb463c1e615b48">Chroot: quick & dirty tests</h3>
<p>If you modified the <em>perl</em>- or <em>shell</em>-scripts of the <ahref="/cryptobox?action=doc&page=CryptoBox">CryptoBox</a>, then you can check for syntax errors by running them in a <em>chroot</em> environment. Be careful: you have access to all ressources of your computer, while you are working within a <em>chroot</em> environment - so you can easily repartition your real disk ... </p>
<p>To start a <em>chroot</em> environment, you can execute <tt>./cbox-dev.sh chroot</tt>. </p>
<p>To start a <em>chroot</em> environment, you can execute <tt>scripts/cbox-dev.sh chroot</tt>. </p>
<p>For more intensive tests, you may use <em>qemu</em> (see below) or burn real LiveCDs - of course this would take much more time. </p>
<p>To start a <em>qemu</em> emulation of the <em>iso</em> image, you may type: <tt>./cbox-dev.sh qemu</tt>. </p>
<p>To start a <em>qemu</em> emulation of the <em>iso</em> image, you may type: <tt>scripts/cbox-dev.sh qemu</tt>. </p>
<h2id="head-0692ec42b1a03fdbc5eb920dd05b86c5f04130e6">Debugging and merging</h2>
@ -135,17 +135,17 @@
<h3id="head-b163acd694c2681db27c18414367513219cfc06f">Development on a running system</h3>
<p>When you run an emulation or test a real LiveCD, you may encounter problems and bugs. To test your fixes for these problems, it is convenient, to change the running test system. Afterwards you can merge these changes to your local development copy. </p>
<p>Type <tt>./cbox-dev.sh diff</tt> to see the changes, you made on the running <ahref="/cryptobox?action=doc&page=CryptoBox">CryptoBox</a> system. </p>
<p>Type <tt>./cbox-dev.sh merge</tt> to merge these changes to your local working copy. </p>
<p>Type <tt>scripts/cbox-dev.sh diff</tt> to see the changes, you made on the running <ahref="/cryptobox?action=doc&page=CryptoBox">CryptoBox</a> system. </p>
<p>Type <tt>scripts/cbox-dev.sh merge</tt> to merge these changes to your local working copy. </p>
<h3id="head-4bfb5d81f79e604fd8a4eb20a6d709bc65562fe3">Uploading a new release</h3>
<p>Alternatively you may also upload a new version of your local working copy to the running <ahref="/cryptobox?action=doc&page=CryptoBox">CryptoBox</a> system. </p>
<p>Type <tt>./cbox-dev.sh upload</tt> - beware: all recent changes you made to the running <ahref="/cryptobox?action=doc&page=CryptoBox">CryptoBox</a> system, are lost. </p>
<p>Type <tt>scripts/cbox-dev.sh upload</tt> - beware: all recent changes you made to the running <ahref="/cryptobox?action=doc&page=CryptoBox">CryptoBox</a> system, are lost. </p>
<aid="bottom"></a>
</div>
<pid="pageinfo"class="info"lang="en"dir="ltr">last edited 2005-09-05 19:45:51 by <spantitle=""></span></p>
<pid="pageinfo"class="info"lang="en"dir="ltr">last edited 2005-09-08 14:50:57 by <spantitle="">lars</span></p>
<p><em>This is a first overview of the <ahref="/cryptobox?action=doc&page=CryptoBox">CryptoBox</a> Live-CD. We apologize for publishing the documentation atm in german only. We started the <ahref="/cryptobox?action=doc&page=CryptoBox">CryptoBox</a> project for a german speaking association. For now we're deeply into bringing this CD up and running, so we prefer coding than translating docs ;). Sorry!</em></p>
<p><em>Feel free to start a translation in this wiki. Otherwise just be patient a few weeks. (it's 12th of july as i'm writing)</em></p>
<p><em><strong>Update [8th of September]</strong>: nearly all development related documentations are written in english - take a look at the links in <ahref="/cryptobox?action=doc&page=CryptoBoxDev">CryptoBoxDev</a></em></p>
<p>We plan to release the first <ahref="/cryptobox?action=doc&page=CryptoBox">CryptoBox</a>-LiveCD before October 02005. </p>
<p>The <ahref="/cryptobox?action=doc&page=CryptoBox">CryptoBox</a> is a Debian/Linux based live-cd. This CD boots up, starting a secure fileserver. Even non-technical users are able to store their data on its encrypted harddisk. There is no special knowledge about cryptgraphy or servers required at all. </p>
<ahref="https://systemausfall.org/prj/cryptobox"title="Projekt-Seite">CryptoBox-Home</a> Die CryptoBox ist ein Projekt von <ahref="https://systemausfall.org/senselab"title="systemausfall.org">sense.lab</a>