[Gpg4win-commits] r496 - in trunk/doc: . website
scm-commit@wald.intevation.org
scm-commit at wald.intevation.org
Thu Aug 23 11:04:50 CEST 2007
Author: jan
Date: 2007-08-23 11:04:50 +0200 (Thu, 23 Aug 2007)
New Revision: 496
Added:
trunk/doc/website/build-installer-gnulinux.htm4
trunk/doc/website/build-installer-on-vm.htm4
trunk/doc/website/build-installer-on-w32-debian-screenshots.htm4
Modified:
trunk/doc/ChangeLog
trunk/doc/website/build-installer-on-vm-de.htm4
trunk/doc/website/build-installer-on-w32-debian-screenshots-de.htm4
trunk/doc/website/build-installer.htm4
Log:
Prepare english translation of changes in the build descriptions.
* website/build-installer-gnulinux.htm4: New.
* website/build-installer.htm4: Extracted the description for GNU/Linux.
Added hint on Windows.
* website/build-installer-on-vm.htm4: New.
* website/build-installer-on-w32-debian-screenshots.htm4: New.
* website/build-installer-on-w32-debian-screenshots-de.htm4,
website/build-installer-on-vm-de.htm4: Activate english link.
Modified: trunk/doc/ChangeLog
===================================================================
--- trunk/doc/ChangeLog 2007-08-23 08:35:46 UTC (rev 495)
+++ trunk/doc/ChangeLog 2007-08-23 09:04:50 UTC (rev 496)
@@ -1,5 +1,21 @@
2007-08-23 Jan-Oliver Wagner <jan-oliver.wagner at intevation.de>
+ Prepare english translation of changes in the build descriptions.
+
+ * website/build-installer-gnulinux.htm4: New.
+
+ * website/build-installer.htm4: Extracted the description for GNU/Linux.
+ Added hint on Windows.
+
+ * website/build-installer-on-vm.htm4: New.
+
+ * website/build-installer-on-w32-debian-screenshots.htm4: New.
+
+ * website/build-installer-on-w32-debian-screenshots-de.htm4,
+ website/build-installer-on-vm-de.htm4: Activate english link.
+
+2007-08-23 Jan-Oliver Wagner <jan-oliver.wagner at intevation.de>
+
* website/build-installer-de.htm4: Extracted the description for GNU/Linux
* website/build-installer-gnulinux-de.htm4: New.
Added: trunk/doc/website/build-installer-gnulinux.htm4
===================================================================
--- trunk/doc/website/build-installer-gnulinux.htm4 2007-08-23 08:35:46 UTC (rev 495)
+++ trunk/doc/website/build-installer-gnulinux.htm4 2007-08-23 09:04:50 UTC (rev 496)
@@ -0,0 +1,179 @@
+m4_dnl -*-html-*-
+m4_include(`template.m4')
+m4_dnl $Id$
+
+m4_define(`EN')
+m4_define(`DE_FILE', `build-installer-gnulinux-de.html')
+PAGE_START
+
+<h1>Build Gpg4win under GNU/Linux</h1>
+
+<p><b>
+This example specifically describes how to create
+a new Gpg4win installer on a Debian GNU/Linux 'Etch' 4.0.
+In principle, any other GNU/Linux system could be used as well.
+</b></p>
+
+<p>
+ <a href="build-installer.html">Back to overview on building installer</a>
+</p>
+
+<h2>Create a new installer package</h2>
+
+The character '#' indicates commands to be executed as administrator (root)
+and '$' for commands to be executed as regular user.
+
+<ol>
+<li> Install required packages on your Debian GNU/Linux 4.0:<br>
+ <em># apt-get install mingw32 nsis stow unzip texinfo imagemagick</em><br>
+ <em># apt-get install libglib2.0-dev tetex-bin tetex-extra gs-common hyperlatex</em><br>
+
+<li> Get the sources anonymously (i.e. with out write-access):<br>
+ <em>$ svn checkout https://svn.wald.intevation.org/svn/gpg4win/trunk/</em><br>
+ or download the source code package gpg4win-n.n.n.tar.gz, unpack it and
+ change to the directory gpg4win-n.n.n. We recommend to work
+ with the SVN version if you want to do more that just update a single
+ module for yourself.
+
+<li> Download all necessary Gpg4win modules from Internet:<br>
+ <em>$ cd packages</em><br>
+ <em>$ sh download.sh</em><br>
+ (takes some time, especially the first time)<br>
+ <em>$ cd ..</em><br>
+
+<li> If you work with the SVN version:<br>
+ <em>$ ./autogen.sh</em><br>
+ <em>$ ./configure --enable-maintainer-mode --host=i586-mingw32msvc</em><br>
+ else:<br>
+ <em>$ ./configure --host=i586-mingw32msvc</em><br>
+
+<li> Now build the Gpg4win installer package:<br>
+ <em>$ make</em>
+</ol>
+
+<p>
+That's all. The new installer package is here:<br>
+<em>src/gpg4win-n.n.n.exe</em><br>
+The corresponding source code packages (with the sources of all modules, very big!) is here:<br>
+<em>src/gpg4win-src-n.n.n.exe</em><br>
+</p>
+
+<h2>Update a single module for Gpg4win</h2>
+
+Fort this task you should have build at least once a new installer package as
+described above. Consider now we want to update the module
+<em>gnupg</em>.
+
+<ol>
+<li> First, remove the old version:<br>
+ <em>$ cd packages</em><br>
+ <em>$ rm gnupg-*</em><br>
+<li> Then download the desired new release, e.g:<br>
+ <em>$ wget ftp://ftp.gnupg.org/gnupg/gnupg-1.4.3.tar.bz2</em><br>
+ <em>$ wget ftp://ftp.gnupg.org/gnupg/gnupg-1.4.3.tar.bz2.sig</em><br>
+ <em>$ gpg --verify gnupg-1.4.3.tar.bz2.sig</em><br>
+ Only continue if that latter command shows a valid signature.
+ You will find further hints on this at the
+ href="http://www.gnupg.org/download/integrity_check.html">GnuPG
+ Website</a>. If the module does not provide any signature you
+ should ensure authenticity of the file with another reasonable method.
+<li> Build a new installer:<br>
+ <em>$ cd ..</em><br>
+ <em>$ make clean</em><br>
+ <em>$ ./configure --host=i586-mingw32msvc</em><br>
+ <em>$ make</em>
+</ol>
+
+<p>
+Attention: From now on your should not execute the script <em>download.sh</em>
+anymore because it would revert to the previous (i.e. official) version of the module.
+For a permanent activation of the new module version for the official Gpg4win
+installer package, the following steps are necessary.
+</p>
+
+<p>
+Precondition is that you have write access to the
+SVN directory (i.e. a user account at wald.intevation.de
+with developer status for Gpg4win).
+</p>
+
+<ol>
+<li> Adapt file<br>
+ <em>packages.current</em><br>
+ accordingly for the new module version (read the head of this file about
+ the syntax) and upload to Subversion repository:<br>
+ <em>$ svn commit packages.current</em>
+
+<li> Create a signature for this file:<br>
+ <em>$ gpg -sb packages.current</em>
+
+<li> If haven't so far ever authorized an updated package list,
+ you need to add your PGP key to the keyring
+ an den Schlüsselbund<br>
+ <em>packages.keys</em><br>
+ using this command:<br>
+ <em>$ gpg --export --armor YOUR-KEY-ID > gpg_pub_key.asc</em><br>
+ <em>$ gpg --no-default-keyring --keyring ./packages.keys --import gpg_pub_key.asc</em><br>
+ A lost of the current keys is shown with this command:<br>
+ <em>$ gpg packages.keys</em><br>
+
+<li> Upload the two files to the Gpg4win website:<br>
+ <em>$ make update</em><br>
+</ol>
+
+
+<h2>Integrate a new module into Gpg4win</h2>
+
+Hierfür sollte man schon einmal ein Installationspaket wie oben beschrieben
+For this task you should have at least once created a installer package
+according to the description above using the SVN version.
+
+<ol>
+<li>For your new module 'MYMOD' first create constants in the file
+ include/config.nsi.in by adding the following lines:<br>
+ <em>@HAVE_PKG_MYMOD@</em><br>
+ <em>!define gpg4win_pkg_mymod @gpg4win_pkg_mymod@</em><br>
+ <em>!define gpg4win_pkg_mymod_version @gpg4win_pkg_mymod_version@</em><br>
+ You will find various examples in this file, e.g. see 'HAVE_PKG_WINPT'.
+
+<li>Write the NSIS installation script<br>
+ <em>src/inst-mymod.nsi</em><br>
+ In the same directory you will find many examples to learn from.
+
+<li>Write the NSIS de-installation script<br>
+ <em>src/uninst-mymod.nsi</em><br>
+ In the same directory you will find many examples to learn from.
+
+<li>Extend the NSIS main script<br>
+ <em>src/inst-sections.nsi</em><br>
+ with MYMOD. Do this analogous to existing entries
+ and read the explanations in the comments.
+
+<li>Now add rules for integration into the build process into the file<br>
+ <em>configure.ac</em><br>
+ For this you can use macros from the file<br>
+ <em>m4/gpg4win.m4</em><br>
+ Due to the already integrated modules there are plenty
+ of examples given. A main distinction is between cross-compiled
+ modules and those that have been compiled for Windows elsewhere
+ and integrated as compiled binaries.
+
+<li>Now update the package list<br>
+ <em>packages/packages.current</em><br>
+ as described above.
+
+<li>Gpg4win has to be configured anew for the new module:<br>
+ <em>$ AUTOMAKE_SUFFIX=-1.9 ./autogen.sh</em><br>
+ <em>$ ./configure --enable-maintainer-mode --host=i586-mingw32msvc</em><br>
+
+<li>The last step is to build the new package:<br>
+ <em>$ make</em>
+</ol>
+
+<p>
+The new installer package is here:<br>
+<em>src/gpg4win-n.n.n.exe</em><br>
+The corresponding source code packages (with the sources of all modules, very big!) is here:<br>
+<em>src/gpg4win-src-n.n.n.exe</em><br>
+</p>
+
Modified: trunk/doc/website/build-installer-on-vm-de.htm4
===================================================================
--- trunk/doc/website/build-installer-on-vm-de.htm4 2007-08-23 08:35:46 UTC (rev 495)
+++ trunk/doc/website/build-installer-on-vm-de.htm4 2007-08-23 09:04:50 UTC (rev 496)
@@ -3,7 +3,7 @@
m4_dnl $Id$
m4_define(`DE')
-m4_dnl m4_define(`EN_FILE', `build-installer-on-vm.html')
+m4_define(`EN_FILE', `build-installer-on-vm.html')
PAGE_START
<h1>Bau von Gpg4win unter Windows via eines virtualisiertem GNU/Linux</h1>
@@ -24,6 +24,7 @@
<p>
<a href="build-installer-de.html">Zurück zur Übersicht zum Installer-Bau</a>
</p>
+
<h2>Inhalt</h2>
<p>
Added: trunk/doc/website/build-installer-on-vm.htm4
===================================================================
--- trunk/doc/website/build-installer-on-vm.htm4 2007-08-23 08:35:46 UTC (rev 495)
+++ trunk/doc/website/build-installer-on-vm.htm4 2007-08-23 09:04:50 UTC (rev 496)
@@ -0,0 +1,427 @@
+m4_dnl -*-html-*-
+m4_include(`template.m4')
+m4_dnl $Id$
+
+m4_define(`EN')
+m4_define(`DE_FILE', `build-installer-on-vm-de.html')
+PAGE_START
+
+<p>
+<b>Attention: Translation of page into english in progress</b>
+</p>
+
+<h1>Bau von Gpg4win unter Windows via eines virtualisiertem GNU/Linux</h1>
+
+<p><b>
+Dieses Beispiel beschreibt konkret die Herstellung eines neuen Gpg4win Installers
+auf Windows XP/SP2 via Debian 'Etch' 4.0 in QEMU.
+Grundsätzlich können für alle drei Komponenten auch Alternativen verwendet
+werden.
+</b></p>
+
+<p>
+Tipps: <a href="build-installer-gnulinux.html">Bauen unter
+GNU/Linux etwas detaillierter beschrieben</a> und
+<a href="build-installer-on-w32-debian-screenshots.html">Installation von Debian GNU/Linux 'Etch' 4.0 innerhalb einer virtuellen QEMU-Maschine als Screenshot-Serie illustriert</a>.
+</p>
+
+<p>
+ <a href="build-installer-de.html">Zurück zur Übersicht zum Installer-Bau</a>
+</p>
+
+<h2>Inhalt</h2>
+
+<p>
+<a href="#intro">Einleitung</a><br><br>
+<tt>I - </tt><a href="#I">Installation von Debian GNU/Linux 'Etch' 4.0 in einer virtuellen Umgebung</a><br>
+<tt>I-1 - </tt><a href="#I-1">Installation von QEMU</a><br>
+<tt>I-2 - </tt><a href="#I-2">Installation von PuTTY</a><br>
+<tt>I-3 - </tt><a href="#I-3">Bezug eines Debian 'Etch' Boot-Mediums</a><br>
+<tt>I-4 - </tt><a href="#I-4">Öffnen einer CMD-Shell</a><br>
+<tt>I-5 - </tt><a href="#I-5">Erzeugen eines Festplatten-Images</a><br>
+<tt>I-6 - </tt><a href="#I-6">Starten der Etch-Installation</a><br>
+<tt>I-7 - </tt><a href="#I-7">Abschluss der Etch-Installation</a>
+<br><br>
+<tt>II - </tt><a href="#II">Bauen von Gpg4win</a><br>
+<tt>II-1 - </tt><a href="#II-1">Starten der virtuellen Maschine</a><br>
+<tt>II-2 - </tt><a href="#II-2">Installation der für den Bau von Gpg4win wichtigen Pakete</a><br>
+<tt>II-3 - </tt><a href="#II-3">Bau der Gpg4win-Installations-Pakete</a><br>
+<tt>II-4 - </tt><a href="#II-4">Extraktion der fertigen Installationspakete</a>
+<br><br>
+<a href="#references">Referenzen (URLs)</a>
+</p>
+
+
+<h2><a name="intro"></a>Einleitung</h2>
+
+<p>
+ Der Bauprozess von Gpg4win ist auf eine Cross-Kompilierung unter
+ GNU/Linux ausgerichtet. Die Schaffung einer geeigneten Bauumgebung
+ unter Windows oder u. U. auch anderen Systemen ist zwar prinzipiell möglich,
+ erfordert aber umfassende Anpassungsarbeiten an den in Gpg4win integrierten Modulen.
+ Wesentlich einfacher ist die Installation eines virtualisierten
+ GNU/Linux Systems innerhalb von Windows, in dem der Bauprozess
+ dann durchgeführt werden kann.
+</p>
+
+<p>
+ In dieser Anleitung wird beschrieben, wie mit Freier Software
+ ein derartiges virtuelles GNU/Linux aufgesetzt und zur Erzeugung
+ der Installationspakete genutzt werden kann.
+ Als virtuelle Maschine kommt
+ das unter GNU GPL stehende QEMU 0.9.0 <a href="#ref1">[1]</a> zum Einsatz.
+ Als GNU/Linux-Distribution wird Debian 'Etch' 4.0 [2] benutzt.
+</p>
+
+<p>
+ Die Anleitung gliedert sich in zwei Teile:
+ <ol>
+ <li> Der erste Teil beschreibt, wie man unter Windows
+ die Virtualisierungssoftware QEMU installiert,
+ eine virtuelle Festplatte erzeugt und auf dieser
+ ein minimales Debian 'Etch' installiert.
+ <li> Im zweiten Teil wird erläutert, wie der eigentliche
+ Bauprozess innerhalb der virtuellen Maschine ablaufen sollte.
+ Dieser entspricht dem bereits dokumentierten Bauprozess
+ unter GNU/Linux, wird aber der Vollständigkeit halber
+ hier noch einmal aufgeführt.
+ </ol>
+</p>
+
+<h3><a name="I"></a>I - Installation von Debian GNU/Linux 'Etch' 4.0 in einer virtuellen Umgebung</h3>
+
+<p>
+ Resultat dieses Abschnittes wird eine Datei sein, die ein Festplatten-Image
+ eines rudimentären Debian 'Etch' für Ihre Virtualisierungssoftware (Virtual Machine Monitor)
+ enthalten wird. Die finale Image-Datei wird ungefähr 250MB groß sein.
+ Insgesamt sollte für diese Phase der Installation mindestens 1,5GB
+ freien Festplattenplatz auf dem Host-System zur Verfügung stehen.
+</p>
+
+<h4><a name="I-1"></a> I-1 - Installation von QEMU</h4>
+
+<p>
+ QEMU ist eigentlich ein Hardware-Emulator. Mit anderen Worten,
+ er interpretiert den Maschinen-Code des simulierten Gast-Systems
+ und führt ihn auf dem Host-System aus. Dies würde es u.a. auch
+ ermöglichen, den Bau von Gpg4win-Paketen auf einen PPC-System
+ unter Mac OS X-Host durchzuführen. Für den Fall einer Installation
+ unter MS Windows auf einer x86-Architektur empfiehlt es sich,
+ neben dem eigentlichen Emulator noch die Virtualisierungskomponente
+ QEMU Accelerator (KQEMU) zu installieren. Sie sorgt für eine direkte
+ Ausführung des Maschinen-Codes des Gasts- auf dem Host-System, was
+ die Auführung enorm beschleunigt, sofern das Gast-System ebenfalls
+ eine x86-Architektur aufweisst.
+</p>
+
+<p>
+ Auf der "QEMU for Windows" <a href="#ref3">[3]</a> Seite finden sich fertige
+ Installations-Binaries für QEMU <a href="#ref4">[4]</a> und
+ KQEMU <a href="#ref5">[5]</a>.
+ Nach dem Herunterladen müssen die beiden Binaries einfach
+ ausgeführt werden, um sie zu installieren.
+ Bitte merken Sie sich den Pfad zur QEMU-Installation
+ (z.B. also: C:\Programme\QEMU).
+</p>
+
+
+<h4><a name="I-2"></a>I-2 - Installation von PuTTY</h4>
+
+<p>
+ Um Daten zwischen Host- und Gast-System austauschen zu können,
+ existieren mehrere Möglichkeiten. In dieser Anleitung wird vorgeschlagen,
+ auf dem Gast-System einen OpenSSH-Server zu installieren. Um mit diesem
+ kommunizieren zu können, wird eine entsprechende Client-Software benötigt.
+ PuTTY <a href="#ref6">[6]</a> ist hierfür gut geeignet. Ein Windows-Installer
+ findet sich unter <a href="#ref7">[7]</a>.
+ Auch hier wird die Installation durch das Ausführen der
+ Datei gestartet. Es ist empfehlenswert, nach der Installation die
+ PATH-Variable um den Pfad hin zur Putty-Installation zu erweitern.
+ Später wird von den Programmen putty.exe und pscp.exe Gebrauch gemacht.
+</p>
+
+<h4><a name="I-3"></a>I-3 - Bezug eines Debian 'Etch' Boot-Mediums</h4>
+
+<p>
+ Für das Herunterladen der für den Bau von Gpg4win
+ notwendigen Pakete wird ohnehin eine schnelle Internet-Verbindung
+ vorausgesetzt. Von daher reicht es aus, sich das minimale
+ x86-Netz-Installations-Image debian-40r0-i386-netinst.iso (159MB)
+ oder gar das kleinere Business-Card-Image
+ debian-40r0-i386-businesscard.iso (32MB) zu besorgen und den Rest
+ des Debian-Systems bei der Installation aus dem Netz nachzuladen.
+ Das Net-Image ist unter <a href="#ref8">[8]</a> und das Business-Image unter
+ <a href=#ref9">[9]</a>
+ oder alternativ über die entsprechenden Debian-Mirrors zu finden.
+</p>
+
+<p>
+ Es ist nicht nötig, diese Images auf eine CD zu brennen,
+ da QEMU auch direkt von ihnen booten kann.
+</p>
+
+<h4><a name="I-4"></a> I-4 - Öffnen einer CMD-Shell</h4>
+
+<p>
+ Im Start->Ausführen...-Dialog "cmd" eingeben und bestätigen.
+ In der CMD-Shell folgendes eingeben:
+</p>
+
+<pre>
+ cd /d <Arbeitsverzeichnis>
+ QEMU=C:\Programme\Qemu
+ set PATH=%QEMU%;%PATH%
+</pre>
+
+<p>
+ Wobei <Arbeitsverzeichnis> das Verzeichnis sein sollte,
+ in dem das Festplatten-Abbild erstellt werden soll. Z.B. C:\temp
+</p>
+
+<h4><a name="I-5"></a>I-5 - Erzeugen eines Festplatten-Images</h4>
+
+<p>
+ In der offenen CMD-Shell folgendes eingeben:
+</p>
+
+<pre>
+
+ qemu-img create -f qcow2 install.img 2500M
+
+</pre>
+
+<p>
+ Dies legt eine virtuelle Festplatten-Datei der Maximalgröße
+ 2500MB an. Die Datei wird erst bei Bedarf Schritt für
+ Schritt vergrößert.
+</p>
+
+<h4><a name="I-6"></a>I-6 - Starten der Etch-Installation</h4>
+
+<p>
+ In der offenen CMD-Shell folgendes in einer Zeile eingeben
+</p>
+
+<pre>
+
+ qemu -k de -m 256 -boot c -L %QEMU%\pc-bios -hda install.img
+ -cdrom debian-40r0-i386-businesscard.iso -kernel-kqemu
+
+</pre>
+
+<p>
+ Dies startet einen virtuellen PC mit 256MB, der vom
+ Netz-Installations-Image bootet und die eben erzeugte virtuelle
+ Festplatte zugewiesen bekommt. Der Pfad zum Boot-Image
+ sollte natürlich angepasst werden. Die "-k de"-Option wählt das
+ deutsche Tastatur-Layout. Die "-kernel-kqemu"-Option aktiviert
+ die vollständige Virtualisierung des emulierten System, was die
+ Performanz drastisch erhöht. Wenn man während des Bootens
+ Meldungen der Form "hda: lost interrupt" bekommt, sollte man
+ zusätzlich die Option "-no-acpi" in obigem Aufruf ergänzen.
+ Sollte es darüber hinaus unerwarteter Weise zu
+ Problemen mit der virtuellen Maschine kommen, sollte die
+ Flagge "-kernel-kqemu" entfernt werden. Details hierzu finden sich
+ in der Dokumentation zu QEMU.
+</p>
+
+<p>
+ Es sollte nun in einem sich neu öffnenden Fenster der
+ Boot-Prompt der Debian-Installation zu sehen sein. Diese
+ kann durch Betätigen der Return-Taste gestartet werden.
+ Die Installation sollte minimal gehalten werden. Nach
+ Wahl der Sprache sollte die komplette virtuelle Festplatte
+ für die Installation benutzt werden. Eine ext3-Partion+Swap
+ reichen für unsere Zwecke völlig aus.
+ Die Standard-Netzwerk-Konfiguration reicht ebenfalls aus.
+</p>
+
+<p>
+ Neben dem root-Nutzer sollte ein Benutzerkonto "gpg4win" angelegt werden.
+ Über dieses Benutzerkonto wird der eigentlich Bauprozess abgewickelt.
+</p>
+
+<h4><a name="I-7"></a>I-7 - Abschluss der Etch-Installation</h4>
+
+<p>
+ Es sollte die aktuellen Sicherheits-Updates mit
+ 'apt-get update && apt-get upgrade' eingespielt werden.
+</p>
+
+<p>
+ Optional für das Erstellen eines wiederverwendbaren Images:
+ 'apt-get clean; apt-get auto-clean' zum Löschen gecachter
+ Downloads aufrufen.
+</p>
+
+<p>
+ Das Gast-System kann jetzt mit 'shutdown -h now' heruntergefahren
+ werden.
+</p>
+
+<p>
+ Will man ein wiederverwendbares Basis-Image erzeugen, bietet es sich
+ an, das Image zu bereinigen und transparent zu komprimieren.
+ Der Zeitpunkt (damit ist der Umfang des Images gemeint) zu dem Sie ein Basis-Image
+ erzeugen wollen, müssen Sie,
+ abhängig davon ob Sie Gpg4win dauerhaft oder nur zum ausprobieren auf
+ Windows bauen, selbst bestimmen.
+ Dies kann auf der CMD-Shell mit folgenden Befehlen durchgeführt werden.
+</p>
+
+<pre>
+
+ qemu-img convert -f qcov2 install.img -O qcow2 -c temp.img
+ copy temp.img install.img
+
+</pre>
+
+<p>
+ Eine Kopie dieses Images sollte man verwahren und regelmäßig
+ mit Sicherheits-Updates versorgen.
+</p>
+
+<h3><a name="II"></a>II - Bauen von Gpg4win</h3>
+
+
+<h4><a name="II-1"></a>II-1 - Starten der virtuellen Maschine</h4>
+
+<p>
+ In der offenen CMD-Shell bitte in einer Zeile folgendes eingeben:
+</p>
+
+<pre>
+
+ qemu -redir tcp:5555::22 -m 256 -boot c -L %QEMU%\pc-bios
+ -hda install.img -kernel-kqemu
+
+</pre>
+
+<p>
+ Die "-redir"-Option sorgt dafür, dass TCP-Anfragen an den
+ Host-Port 5555 an den Gast-Port 22 (SSH) weitergeleitet werden.
+ Die Firewall von Windows-XP wird ggf. fragen, ob der Port 5555
+ geblockt werden soll. Dies kann man bestätigen, wenn man nur
+ vom eigenen Rechner aus auf die virtuelle Maschine zugreifen
+ möchte. Andernfalls sollte man die Anfragen durchlassen.
+</p>
+
+<h4><a name="II-2"></a>II-2 - Installation der für den Bau von Gpg4win wichtigen Pakete</h4>
+
+<p>
+ Nach dem Booten sollte man als root-Benutzer folgendes
+ nachinstallieren, bzw. mit 'apt-get update && apt-get upgrade'
+ auf den neusten Stand bringen:
+</p>
+
+<pre>
+
+ apt-get install \
+ subversion autoconf automake gettext \
+ mingw32 nsis stow unzip texinfo imagemagick \
+ libglib2.0-dev tetex-bin tetex-extra gs-common hyperlatex \
+ make bzip2 gcc openssh-server
+
+</pre>
+
+<p>
+ <a href="http://de.wikipedia.org/wiki/Subversion_(Software)">Subversion</a>
+ (bzw. das Kommando "svn") gehört zum Quelltext-Management-System mit dem Gpg4win verwaltet
+ wird. Es wird nur benötigt, wenn man Gpg4win direkt aus dem SVN Qelltext-Management-System
+ heraus bauen will. Verwendet man stattdessen die Archivdateien (Endung .tar.gz oder .tar.bz2)
+ einer veröffentlichten Version, so kann man auf Subversion verzichten.
+</p>
+
+<p>
+ Der <a href="http://de.wikipedia.org/wiki/OpenSSH">OpenSSH</a>-Server erleichtert die Kommunikation
+ mit der virtuellen Maschine. Zum einen kann man sich nach
+ der Installation mit PuTTY in den Rechner einwählen und zum
+ anderen mit pscp Dateien aus dem System heraus und hinein kopieren.
+ Ersteres stellt eine erhebliche Bedienungs-Verbesserung
+ (z.B. Copy & Paste) da, letzteres ermöglicht die Extraktion
+ der fertigen Installationspakete.
+</p>
+
+<p>
+ Hat man den OpenSSH-Server im Gast und PuTTY auf dem Host-System
+ installiert, kann man sich mit PuTTY in den Gast einloggen.
+ Die Verbindungsdaten lauten Host: gpg4win at localhost, Port: 5555.
+ Das Passwort im Fall des vorgefertigten Images lautet 'gpg4win'.
+</p>
+
+<p>
+ Um Probleme mit dem Locale (das sind die Einstellungen für die
+ Unterstützung Ihrer Sprache und sonstiger sprach-spezifischer
+ Einstellungen) zu vermeiden, ist es empfehlenswert,
+ das de_DE-Locale (das ist die Unterstützung für deutsch wie in Deutschland verwendet)
+ zu erzeugen. Hierzu als root-Nutzer bitte folgendes eingeben
+</p>
+
+<pre>
+
+ dpkg-reconfigure locales
+
+</pre>
+
+<p>
+ und das Häckchen zusätzlich bei de_DE setzen.
+</p>
+
+<h4><a name="II-3"></a>II-3 - Bau der Gpg4win-Installations-Pakete</h4>
+
+<p>
+ Man logge sich als 'gpg4win' Nutzer ein und gebe auf
+ der Linux-Shell folgendes ein, wenn man Gpg4win aus
+ dem SVN bauen will:
+</p>
+
+<pre>
+
+ export LANG=de_DE
+ svn co https://svn.wald.intevation.org/svn/gpg4win/trunk
+ cd trunk/packages
+ sh download.sh
+ cd ..
+ ./autogen.sh
+ ./autogen.sh --build-32 --enable-maintainer-mode
+ make
+
+</pre>
+
+<p>
+ Nach dem dies erfolgreich durchgelaufen ist, stehen unter
+ trunk/src die fertigen Installationspakete zur Verfügung.
+</p>
+
+<h4><a name="II-4"></a>II-4 - Extraktion der fertigen Installationspakete</h4>
+
+<p>
+ Auf dem Windows-Host-System in einer offenen CMD-Shell
+ folgendes eingeben:
+</p>
+
+<pre>
+
+ pscp -P 5555 gpg4win at localhost:trunk/src/gpg4win-*.exe .
+
+</pre>
+
+<p>
+ Es wird vorausgesetzt, dass sich pscp.exe im PATH befindet.
+ Nachdem der Transfer erfolgreich abgeschlossen wurde, kann
+ das Gast-Linux-System heruntergefahren werden.
+</p>
+
+<h2><a name="references"></a>Referenzen (URLs)</h2>
+
+<tt>
+<a name="ref1">[1]</a> <a href="http://fabrice.bellard.free.fr/qemu/">http://fabrice.bellard.free.fr/qemu/</a> <br>
+<a name="ref2">[2]</a> <a href="http://www.debian.org/">http://www.debian.org/</a> <br>
+<a name="ref3">[3]</a> <a href="http://www.h7.dion.ne.jp/~qemu-win/">http://www.h7.dion.ne.jp/~qemu-win/</a> <br>
+<a name="ref4">[4]</a> <a href="http://www.h6.dion.ne.jp/~kazuw/qemu-win/Qemu-0.9.0-install.exe">http://www.h6.dion.ne.jp/~kazuw/qemu-win/Qemu-0.9.0-install.exe</a> <br>
+<a name="ref5">[5]</a> <a href="http://www.h6.dion.ne.jp/~kazuw/qemu-win/Kqemu-1.3.0pre11-install.exe">http://www.h6.dion.ne.jp/~kazuw/qemu-win/Kqemu-1.3.0pre11-install.exe</a> <br>
+<a name="ref6">[6]</a> <a href="http://www.chiark.greenend.org.uk/~sgtatham/putty">http://www.chiark.greenend.org.uk/~sgtatham/putty</a> <br>
+<a name="ref7">[7]</a> <a href="http://www.tartarus.org/~simon/putty-snapshots/x86/putty-installer.exe">http://www.tartarus.org/~simon/putty-snapshots/x86/putty-installer.exe</a> <br>
+<a name="ref8">[8]</a> <a href="http://cdimage.debian.org/debian-cd/4.0_r0/i386/iso-cd/debian-40r0-i386-netinst.iso">http://cdimage.debian.org/debian-cd/4.0_r0/i386/iso-cd/debian-40r0-i386-netinst.iso</a> <br>
+<a name="ref9">[9]</a> <a href="http://cdimage.debian.org/debian-cd/4.0_r0/i386/iso-cd/debian-40r0-i386-businesscard.iso">http://cdimage.debian.org/debian-cd/4.0_r0/i386/iso-cd/debian-40r0-i386-businesscard.iso</a> <br>
+</tt>
Modified: trunk/doc/website/build-installer-on-w32-debian-screenshots-de.htm4
===================================================================
--- trunk/doc/website/build-installer-on-w32-debian-screenshots-de.htm4 2007-08-23 08:35:46 UTC (rev 495)
+++ trunk/doc/website/build-installer-on-w32-debian-screenshots-de.htm4 2007-08-23 09:04:50 UTC (rev 496)
@@ -3,7 +3,7 @@
m4_dnl $Id$
m4_define(`DE')
-m4_dnl m4_define(`EN_FILE', `build-installer-on-w32-debian-screenshots.html')
+m4_define(`EN_FILE', `build-installer-on-w32-debian-screenshots.html')
PAGE_START
<h2>Installation von Debian GNU/Linux 'Etch' 4.0 innerhalb einer
Added: trunk/doc/website/build-installer-on-w32-debian-screenshots.htm4
===================================================================
--- trunk/doc/website/build-installer-on-w32-debian-screenshots.htm4 2007-08-23 08:35:46 UTC (rev 495)
+++ trunk/doc/website/build-installer-on-w32-debian-screenshots.htm4 2007-08-23 09:04:50 UTC (rev 496)
@@ -0,0 +1,176 @@
+m4_dnl -*-html-*-
+m4_include(`template.m4')
+m4_dnl $Id$
+
+m4_define(`EN')
+m4_define(`DE_FILE', `build-installer-on-w32-debian-screenshots-de.html')
+PAGE_START
+
+<p>
+<b>Attention: Translation of page into english in progress</b>
+</p>
+
+<h2>Installation von Debian GNU/Linux 'Etch' 4.0 innerhalb einer
+ virtuellen QEMU-Maschine</h2>
+
+<p>
+<a href="build-installer-on-vm-de.html">Zurück zur
+Gpg4win-Bauanleitung für Windows</a>
+</p>
+
+<p>
+ Diese Installation wurde mit dem Business-Card-Boot-Medium von
+ Debian 'Etch' durchgeführt. Der Aufruf zum Starten der
+ vituellen Maschine lautete:
+</p>
+
+<pre>
+
+qemu -m 256 -L %QEMU -cdrom debian-40r0-i386-businesscard.iso -hda install.img -boot d -kernel-kqemu</tt>
+
+</pre>
+
+<p>
+ Wobei <em>%QEMU</em> auf den Pfad zur QEMU-Installation gesetzt war.
+ Falls die <em>-kernel-kqemu</em> Option Probleme bereiten sollte,
+ kann sie weggelassen werden. Die Installation wird hierdurch aber verlangsamt.
+</p>
+
+<p>
+ Hinweis: Im folgenden sind nur die interaktiven Teile der Debian-Installation bebildert.
+</p>
+
+<p>
+ <a href="pix/debian-install-de/01.png"><img src="pix/debian-install-de/thumbs/01.png"></a>
+ <br>
+ Im Boot-Screen die Installation durch Eingabe von <tt><Return></tt> starten.
+</p>
+
+<p>
+ <a href="pix/debian-install-de/02.png"><img src="pix/debian-install-de/thumbs/02.png"></a>
+ <br>
+ Als Sprache <em>German</em> auswählen.
+</p>
+
+<p>
+ <a href="pix/debian-install-de/03.png"><img src="pix/debian-install-de/thumbs/03.png"></a>
+ <br>
+ Als Land <em>Deutschland</em> auswählen.
+</p>
+
+<p>
+ <a href="pix/debian-install-de/04.png"><img src="pix/debian-install-de/thumbs/04.png"></a>
+ <br>
+ Als Tastatur-Layout <em>Deutsch</em> auswählen.
+</p>
+
+<p>
+ <a href="pix/debian-install-de/05.png"><img src="pix/debian-install-de/thumbs/05.png"></a>
+ <br>
+ Als Name des Rechners <em>gpg4win</em> eingeben.
+</p>
+
+<p>
+ <a href="pix/debian-install-de/06.png"><img src="pix/debian-install-de/thumbs/06.png"></a>
+ <br>
+ Den Namen der Domain leerlassen.
+</p>
+
+<p>
+ <a href="pix/debian-install-de/07.png"><img src="pix/debian-install-de/thumbs/07.png"></a>
+ <a href="pix/debian-install-de/08.png"><img src="pix/debian-install-de/thumbs/08.png"></a>
+ <br>
+ Als Land des Debian-Archiv-Spiegelservers <em>Deutschland</em>
+ und einen Server in Ihrer Nähe auswählen.<br>
+</p>
+
+<p>
+ <a href="pix/debian-install-de/09.png"><img src="pix/debian-install-de/thumbs/09.png"></a>
+ <br>
+ Proxy-Einstellung leerlassen.
+</p>
+
+<p>
+ <a href="pix/debian-install-de/10.png"><img src="pix/debian-install-de/thumbs/10.png"></a>
+ <a href="pix/debian-install-de/11.png"><img src="pix/debian-install-de/thumbs/11.png"></a>
+ <a href="pix/debian-install-de/12.png"><img src="pix/debian-install-de/thumbs/12.png"></a>
+ <a href="pix/debian-install-de/13.png"><img src="pix/debian-install-de/thumbs/13.png"></a>
+ <a href="pix/debian-install-de/14.png"><img src="pix/debian-install-de/thumbs/14.png"></a>
+ <br>
+ <ul>
+ <li>Als Festplatten-Partitionierungs-Methode
+ <em>Geführt - verwende vollständige Festplatte</em>
+ auswählen.
+ </li>
+ <li>Die <em>IDE1 Master (hda)</em> Festplatte auswählen.</li>
+ <li><em>Alle Dateinen auf eine Partition</em> auswählen.</li>
+ <li><em>Partitionierung beenden und Änderungen übernehmen</em> auswählen.</li>
+ <li><em>Änderungen auf die Festplatte schreiben?</em> mit <em>Ja</em> bestätigen.</li>
+ </ul>
+</p>
+
+<p>
+ <a href="pix/debian-install-de/15.png"><img src="pix/debian-install-de/thumbs/15.png"></a>
+ <a href="pix/debian-install-de/16.png"><img src="pix/debian-install-de/thumbs/16.png"></a>
+ <br>
+ Das root-Passwort eingeben und zuer Bestätigung wiederholen.
+</p>
+
+<p>
+ <a href="pix/debian-install-de/17.png"><img src="pix/debian-install-de/thumbs/17.png"></a>
+ <a href="pix/debian-install-de/18.png"><img src="pix/debian-install-de/thumbs/18.png"></a>
+ <!-- 19.png war versehentlich eine Kopie von 18.png :-/ -->
+ <a href="pix/debian-install-de/20.png"><img src="pix/debian-install-de/thumbs/20.png"></a>
+ <br>
+ <ul>
+ <li>Einen neuen Benutzer <em>gpg4win</em> anlegen.</li>
+ <li>Konto-Bezeichnung des neuen Nutzes soll <em>gpg4win</em> lauten.</li>
+ <li>Passwort festlegen und durch Wiedereingabe bestätigen</li>
+ </ul>
+</p>
+
+<p>
+ <a href="pix/debian-install-de/21.png"><img src="pix/debian-install-de/thumbs/21.png"></a>
+ <br>
+ Nicht an der Paketverwendungserfassung teilnehmen.
+</p>
+
+<p>
+ <a href="pix/debian-install-de/22.png"><img src="pix/debian-install-de/thumbs/22.png"></a>
+ <br>
+ Nur ein <em>Standard-System</em> installieren.
+</p>
+
+<p>
+ <a href="pix/debian-install-de/23.png"><img src="pix/debian-install-de/thumbs/23.png"></a>
+ <br>
+ Den GRUB-Bootloader in den Master Boot Record installieren.
+</p>
+
+<p>
+ <a href="pix/debian-install-de/24.png"><img src="pix/debian-install-de/thumbs/24.png"></a>
+ <a href="pix/debian-install-de/25.png"><img src="pix/debian-install-de/thumbs/25.png"></a>
+ <br>
+ <ul>
+ <li>Die Beendigung der Installation mit <em>weiter</em> bestätigen.</li>
+ <li>Nach dem Neustart sollte sich QUEMU beschweren, dass es
+ nicht vom angebenen Medium booten kann. QUEMU kann nun beendet werden.</li>
+ </ul>
+</p>
+
+<p>
+Die virtuellen Maschine wurde jetzt mit folgendem Befehl neu gestartet:
+</p>
+
+<pre>
+
+qemu -m 256 -L %QEMU -hda install.img -kernel-kqemu -redir tcp:5555::22
+
+</pre>
+
+<p>
+ <a href="pix/debian-install-de/26.png"><img src="pix/debian-install-de/thumbs/26.png"></a>
+ <br>
+ Nach dem Boot-Vorgang sollte man sich erfolgreich als root-Nutzer anmelden
+ und System-Aktualisierungen bzw. weitere Installation durchführen können.
+</p>
Modified: trunk/doc/website/build-installer.htm4
===================================================================
--- trunk/doc/website/build-installer.htm4 2007-08-23 08:35:46 UTC (rev 495)
+++ trunk/doc/website/build-installer.htm4 2007-08-23 09:04:50 UTC (rev 496)
@@ -8,182 +8,45 @@
<h1>Build Installer Package</h1>
-Building a new Gpg4win installer package is
-mostly automized.
-
<p>
-What you need: A Debian GNU/Linux 'Etch' 4.0 system.
-For this system the follwing instructions are tested.
-In principle the procedure should also work for other
-system, perhaps some adapations are necessary.<br>
-Furthermore, you need at least 503 MByte on your harddisk
-and a acceptable fast internet connection for downloading
-about 60 MBytes.
+Building a new Gpg4win installer package is
+mostly automized. The build procedure can be executed
+on a GNU/Linux system or within a virtual maschine also
+on Windows and other systems.
</p>
-<p>
-Typical tasks:
<ul>
-<li> Update a single module (occasionally, ca. 1-4 hours)
-</ul>
-</p>
+<li> <b>Build Gpg4win on GNU/Linux</b>:
-<h2>Create a new installer package</h2>
+ <p>
+ In principle, any current GNU/Linux system is
+ sufficient as the base system. Some minor
+ adaptions might be necessary though.
+ The <a href="build-installer-gnulinux-de.html">specific
+ GNU/Linux guide</a> is tested with a Debian GNU/Linux 'Etch' 4.0 system.
+ <br>
+ Furthermore, you need at least 503 MByte on your harddisk
+ and a acceptable fast internet connection for downloading
+ about 60 MBytes.
+ </p>
+<li> <p>Build Gpg4win on Windows</b>:
-The character '#' indicates commands to be executed as administrator (root)
-and '$' for commands to be executed as regular user.
+ <p>
+ In principle, any current Windows system is
+ sufficient as the base system. Some minor
+ adaptions might be necessary though.
+ The <a href="build-installer-on-vm.html">specific
+ Windows guide</a> is tested with Windows XP SP2.
+ <br>
+ Furthermore, you need at least 1.5 GByte on your harddisk
+ and a acceptable fast internet connection for downloading
+ about 360 MBytes.
+ </p>
+</ul>
-<ol>
-<li> Install required packages on your Debian GNU/Linux 4.0:<br>
- <em># apt-get install mingw32 nsis stow unzip texinfo imagemagick</em><br>
- <em># apt-get install libglib2.0-dev tetex-bin tetex-extra gs-common hyperlatex</em><br>
-
-<li> Get the sources anonymously (i.e. with out write-access):<br>
- <em>$ svn checkout https://svn.wald.intevation.org/svn/gpg4win/trunk/</em><br>
- or download the source code package gpg4win-n.n.n.tar.gz, unpack it and
- change to the directory gpg4win-n.n.n. We recommend to work
- with the SVN version if you want to do more that just update a single
- module for yourself.
-
-<li> Download all necessary Gpg4win modules from Internet:<br>
- <em>$ cd packages</em><br>
- <em>$ sh download.sh</em><br>
- (takes some time, especially the first time)<br>
- <em>$ cd ..</em><br>
-
-<li> If you work with the SVN version:<br>
- <em>$ ./autogen.sh</em><br>
- <em>$ ./configure --enable-maintainer-mode --host=i586-mingw32msvc</em><br>
- else:<br>
- <em>$ ./configure --host=i586-mingw32msvc</em><br>
-
-<li> Now build the Gpg4win installer package:<br>
- <em>$ make</em>
-</ol>
-
<p>
-That's all. The new installer package is here:<br>
-<em>src/gpg4win-n.n.n.exe</em><br>
-The corresponding source code packages (with the sources of all modules, very big!) is here:<br>
-<em>src/gpg4win-src-n.n.n.exe</em><br>
+Typical tasks:
+<ul
+<li> Update a single module (occasionally, ca. 1-4 hours)
+</ul>
</p>
-
-<h2>Update a single module for Gpg4win</h2>
-
-Fort this task you should have build at least once a new installer package as
-described above. Consider now we want to update the module
-<em>gnupg</em>.
-
-<ol>
-<li> First, remove the old version:<br>
- <em>$ cd packages</em><br>
- <em>$ rm gnupg-*</em><br>
-<li> Then download the desired new release, e.g:<br>
- <em>$ wget ftp://ftp.gnupg.org/gnupg/gnupg-1.4.3.tar.bz2</em><br>
- <em>$ wget ftp://ftp.gnupg.org/gnupg/gnupg-1.4.3.tar.bz2.sig</em><br>
- <em>$ gpg --verify gnupg-1.4.3.tar.bz2.sig</em><br>
- Only continue if that latter command shows a valid signature.
- You will find further hints on this at the
- href="http://www.gnupg.org/download/integrity_check.html">GnuPG
- Website</a>. If the module does not provide any signature you
- should ensure authenticity of the file with another reasonable method.
-<li> Build a new installer:<br>
- <em>$ cd ..</em><br>
- <em>$ make clean</em><br>
- <em>$ ./configure --host=i586-mingw32msvc</em><br>
- <em>$ make</em>
-</ol>
-
-<p>
-Attention: From now on your should not execute the script <em>download.sh</em>
-anymore because it would revert to the previous (i.e. official) version of the module.
-For a permanent activation of the new module version for the official Gpg4win
-installer package, the following steps are necessary.
-</p>
-
-<p>
-Precondition is that you have write access to the
-SVN directory (i.e. a user account at wald.intevation.de
-with developer status for Gpg4win).
-</p>
-
-<ol>
-<li> Adapt file<br>
- <em>packages.current</em><br>
- accordingly for the new module version (read the head of this file about
- the syntax) and upload to Subversion repository:<br>
- <em>$ svn commit packages.current</em>
-
-<li> Create a signature for this file:<br>
- <em>$ gpg -sb packages.current</em>
-
-<li> If haven't so far ever authorized an updated package list,
- you need to add your PGP key to the keyring
- an den Schlüsselbund<br>
- <em>packages.keys</em><br>
- using this command:<br>
- <em>$ gpg --export --armor YOUR-KEY-ID > gpg_pub_key.asc</em><br>
- <em>$ gpg --no-default-keyring --keyring ./packages.keys --import gpg_pub_key.asc</em><br>
- A lost of the current keys is shown with this command:<br>
- <em>$ gpg packages.keys</em><br>
-
-<li> Upload the two files to the Gpg4win website:<br>
- <em>$ make update</em><br>
-</ol>
-
-
-<h2>Integrate a new module into Gpg4win</h2>
-
-Hierfür sollte man schon einmal ein Installationspaket wie oben beschrieben
-For this task you should have at least once created a installer package
-according to the description above using the SVN version.
-
-<ol>
-<li>For your new module 'MYMOD' first create constants in the file
- include/config.nsi.in by adding the following lines:<br>
- <em>@HAVE_PKG_MYMOD@</em><br>
- <em>!define gpg4win_pkg_mymod @gpg4win_pkg_mymod@</em><br>
- <em>!define gpg4win_pkg_mymod_version @gpg4win_pkg_mymod_version@</em><br>
- You will find various examples in this file, e.g. see 'HAVE_PKG_WINPT'.
-
-<li>Write the NSIS installation script<br>
- <em>src/inst-mymod.nsi</em><br>
- In the same directory you will find many examples to learn from.
-
-<li>Write the NSIS de-installation script<br>
- <em>src/uninst-mymod.nsi</em><br>
- In the same directory you will find many examples to learn from.
-
-<li>Extend the NSIS main script<br>
- <em>src/inst-sections.nsi</em><br>
- with MYMOD. Do this analogous to existing entries
- and read the explanations in the comments.
-
-<li>Now add rules for integration into the build process into the file<br>
- <em>configure.ac</em><br>
- For this you can use macros from the file<br>
- <em>m4/gpg4win.m4</em><br>
- Due to the already integrated modules there are plenty
- of examples given. A main distinction is between cross-compiled
- modules and those that have been compiled for Windows elsewhere
- and integrated as compiled binaries.
-
-<li>Now update the package list<br>
- <em>packages/packages.current</em><br>
- as described above.
-
-<li>Gpg4win has to be configured anew for the new module:<br>
- <em>$ AUTOMAKE_SUFFIX=-1.9 ./autogen.sh</em><br>
- <em>$ ./configure --enable-maintainer-mode --host=i586-mingw32msvc</em><br>
-
-<li>The last step is to build the new package:<br>
- <em>$ make</em>
-</ol>
-
-<p>
-The new installer package is here:<br>
-<em>src/gpg4win-n.n.n.exe</em><br>
-The corresponding source code packages (with the sources of all modules, very big!) is here:<br>
-<em>src/gpg4win-src-n.n.n.exe</em><br>
-</p>
-
More information about the Gpg4win-commits
mailing list