<chapter id="installation">
<title
>Installation </title>

<epigraph>
<attribution
>Linus Torvalds, after finding one of his file systems smashed by a
new Beta kernel</attribution>
<para
>Core dumping fsck's tend to make me nervous</para>
</epigraph>

<para
>Keine Panik! Obwohl die Verwendung von Betaversionen einige Nerven kosten kann, ist es unwahrscheinlich, das die KDE-Installation die Festplatte beschädigt. Dieses Kapitel soll durch den Installationsprozess führen, damit man so schnell (und mit so wenig Problemen wie möglich) einen Blick auf die neue Arbeitsoberfläche werfen kann. Wie bei allen neuen Fenstermanagern sollte man auch für diese Installation alle X11-spezifischen Konfigurationsdateien vor der Installation sichern. Im Zweifelsfall sind das alle versteckten Dateien (<filename
>.*</filename
>) im Persönlichen Verzeichnis und das Verzeichnis <filename
>/usr/X11/lib/X11/xdm</filename
>. </para
> 

<sect1 id="requirements">
<title
>Voraussetzungen </title>

<para
>Vor der Installation von KDE sollte man sicher stellen, dass das eigene System folgende Voraussetzungen erfüllt: </para>

<itemizedlist
> <listitem
><para
>Ein funktionstüchtiges POSIX-kompatibles UNIX-System sollte es sein. KDE funktioniert unter anderem auf: Linux, FreeBSD, Solaris, HP-UX und MkLinux. An der Verfügbarkeit auf anderen Plattformen wird gearbeitet. </para
></listitem
> <listitem
><para
>Genügend freien Festplattenplatz auf der Partition, auf der <filename
>/opt/kde</filename
> erzeugt wird. Man sollte ca. 50MB reservieren, falls das System Bibliotheken (shared libraries) unterstützt, ansonsten erheblich mehr. Für die Kompilierung von KDE aus Quelldateien benötigt man zusätzlich ca. 100MB in <filename
>/usr/src</filename
>.</para
></listitem
> <listitem
><para
>Ein funktionierendes X11-System mit oder ohne <application
>xdm</application
>. Falls man bisher nicht über ein solches System verfügt, sollte man zunächst prüfen, ob sich eines auf den Installationsmedien des Systems befindet. Falls man keine funktionsfähige Version findet, kann man auf der <ulink url="http://www.xfree86.org"
>XFree86 Internetseite</ulink
> weitere Informationen zum Auffinden und Installieren des X-Window-Systems finden. </para
></listitem
> <listitem
><para
>Die Qt-Bibliotheken, Version 3.0.2. Man kann diese von <ulink url="ftp://ftp.trolltech.com/qt"
>Troll Techs FTP-Server</ulink
> im tgz-Format beziehen. </para
> </listitem
> </itemizedlist>

<warning
><para
>Warnung: Falls man KDE von einer älteren Version aktualisiert, sollte man vorher das Folgende tun:</para>

<screen
> 
<command
>cd <filename
>/opt/kde</filename
></command
> 
<command
>tar <option
>cfvz <replaceable
>~/KDE-old-version-backup.tar.gz</replaceable
> * </option
></command>
</screen>
</warning>

</sect1>

<sect1 id="linux-installing-rpms">
<title
>Linux: Installation von RPMs für RedHat, Caldera und SuSE.</title>

<para
>Die Installation aus RPMs ist der einfachste Weg zu einem funktionstüchtigen KDE. Suchen Sie einfach im Verzeichnis <filename
>/pub/kde/stable/distribution/rpm</filename
> auf dem bevorzugten KDE-Mirror. Dort finden sich Verzeichnisse für die verschiedenen Betriebssysteme. Aktuell werden die Architekturen i386, Alpha und Sparc unterstützt. Die RPM-Pakete finden sich auch auf den Red-Hat-Contrib-Seiten wie sunsite.unc.edu oder ftp.redhat.com. </para>

<para
>Das Grundsystem besteht aus den Dateien mit der Bezeichnung <filename
>kde-<replaceable
>Komponente</replaceable
>.<replaceable
>Architektur</replaceable
>.rpm</filename
>. Man benötigt mindestens kdesupport, kdelibs und kdebase. Zusätzlich zu diesem Grundsystem kann man alle die RPMs herunterladen, die man für nützlich hält. </para>

<para
>Man sollte die Installation mit dem Grundpaket beginnen. Falls man KDE zum ersten Mal installiert, sind das die Befehle </para>

<screen
> 
<userinput
><command
>rpm</command
> <option
>-i</option
> <filename
>kdesupport.arch.rpm</filename
></userinput>
<userinput
><command
>rpm</command
> <option
>-i</option
> <filename
>kdelibs.arch.rpm</filename
></userinput>
<userinput
><command
>rpm</command
> <option
>-i</option
> <filename
>kdebase.arch.rpm</filename
></userinput>
</screen>
 
<important
><para
>Es ist notwendig, dass diese Komponenten in der beschriebenen Reihenfolge und vor jeder weiteren Komponente von KDE installiert werden.</para
></important>

<para
>Falls man eine ältere Version aktualisiert, sollte man folgende Befehle verwenden: <screen
> 
<userinput
><command
>rpm</command
> <option
>-Uvh</option
> <filename
>kde-<replaceable
>component</replaceable
>.<replaceable
>arch</replaceable
>.rpm</filename
></userinput>
</screen
> </para>

<para
>Wiederum muss die oben angegebene Reihenfolge beachtet werden. Die genannten Komponenten müssen zuerst installiert werden.</para>

<para
>Damit wird das Grundsystem ausgepackt und standardmäßig unter <filename
>/opt/kde</filename
> installiert.</para>

<para
>Falls die Installation der Grundpakete erfolgreich war, kann man weitere Pakete auf die gleiche Art installieren (wiederum muss man für eine Aktualisierung <option
>-Uvh</option
> an Stelle von <option
>-i</option
> verwenden). </para>

</sect1>

<sect1 id="installing-debian">
<title
>Linux: Installation von <acronym
>DEB</acronym
>s für Debian</title>

<para
>Die Installation auf einem Debian-System ist ebenfalls einfach. Für Debian 2.2 (Potato) und 3.0 (Woody) findet man nur KDE 2.0-Pakete. Hier wird lediglich die Installation auf der stabilen Version Debian 2.2 beschrieben, da sich Debian 3.0 immer noch in der Entwicklung befindet. Die Installation für beide Versionen ist allerdings beinahe identisch. Im Unterschied zu 2.2 ist KDE offizieller Bestandteil von Debian 3.0, weshalb man keine besondere Stelle angeben muss, damit die KDE-Pakete gefunden werden.</para>

<para
>Im ersten Schritt muss man dem Rechner mitteilen, wo sich die DEB-Pakete für KDE befinden. Eine Liste der Debian-Pakete befindet sich auf der Festplatte unter <filename
>/etc/apt/sources.list</filename
>. Zu dieser Liste muss man die Zeile <userinput
>http://kde.tdyc.com/ stable kde2</userinput
> hinzufügen.</para>

 
<para
>Jetzt muss die lokale Paketdatenbank aktualisiert werden, damit dem System bekannt ist, dass neue Pakete verfügbar sind. Dazu tippt man den folgenden Befehl ein:</para>

<screen>
<userinput
><command
>apt-get</command
> <option
>update</option
></userinput>
</screen>
 
<para
>Schließlich wird das KDE-Grundsystem installiert durch folgenden Befehl:</para>

<screen>
<userinput
><command
>apt-get</command
> <option
>install kdebase</option
></userinput>
</screen>
 
<para
>Falls man andere Komponenten installieren möchte, sollte man einige oder alle dieser Optionen versuchen:</para>

<screen>
<userinput
><command
>apt-get</command
> <option
>install task-kdenetwork</option
></userinput>
<userinput
><command
>apt-get</command
> <option
>install task-kdeadmin</option
></userinput>
<userinput
><command
>apt-get</command
> <option
>install task-kdetoys</option
></userinput>
<userinput
><command
>apt-get</command
> <option
>install task-kdeutils</option
></userinput>
<userinput
><command
>apt-get</command
> <option
>install task-kdemultimedia</option
></userinput>
<userinput
><command
>apt-get</command
> <option
>install task-kdegraphics</option
></userinput>
<userinput
><command
>apt-get</command
> <option
>install task-kdepim</option
></userinput>
<userinput
><command
>apt-get</command
> <option
>install task-kdegames</option
></userinput>
<userinput
><command
>apt-get</command
> <option
>install task-koffice</option
></userinput>
<userinput
><command
>apt-get</command
> <option
>install kdebase-docs</option
></userinput>
<userinput
><command
>apt-get</command
> <option
>install kdm</option
></userinput>
</screen>

<para
>Weiterhin möchte man vermutlich das Paket zur eigenen Sprache installieren.</para>

<screen>
<userinput
><command
>apt-get</command
> <option
>install
kde-i18n-<replaceable
>xx</replaceable
></option
></userinput>
 </screen>
<para
>Dabei muss <replaceable
>xx</replaceable
> durch die passende Länderkennung ersetzt werden.</para>

<para
>Die Steuerdateien einiger KDE-Programme findet man unter <filename class="directory"
>/etc/kde2</filename
>, die Programme unter <filename class="directory"
>/usr/bin</filename
> und die meisten Hilfsdateien unter <filename class="directory"
>/usr/share</filename
> in verschiedenen Unterverzeichnissen. </para>

<para
>Falls man eine ältere KDE-Version aktualisiert, sollte man vorher die folgenden Schritte unternehmen. Zuerst aktualisiert man die Datei <filename
>/etc/apt/sources.list</filename
>, indem man die Zeile für die KDE-Pakete durch die Zeile <userinput
>http://kde.tdyc.com/ stable kde2</userinput
> ersetzt. Dann aktualisiert man die Paketdatenbank:</para>

<screen>
<userinput
><command
>apt-get</command
> <option
>update</option
></userinput>
</screen>
 
<para
>Schließlich installiert man das KDE-Grundsystem:</para>

<screen>
<userinput
><command
>apt-get</command
> <option
>install kdebase</option
></userinput>
<userinput
><command
>apt-get</command
> <option
>dist-upgrade</option
></userinput>
</screen>
 
<para
> Falls man weitere KDE-Komponenten installieren möchte, sollte man einige oder alle dieser hier ausprobieren.</para>

<screen>
<userinput
><command
>apt-get</command
> <option
>install task-kdenetwork</option
></userinput>
<userinput
><command
>apt-get</command
> <option
>install task-kdeadmin</option
></userinput>
<userinput
><command
>apt-get</command
> <option
>install task-kdetoys</option
></userinput>
<userinput
><command
>apt-get</command
> <option
>install task-kdeutils</option
></userinput>
<userinput
><command
>apt-get</command
> <option
>install task-kdemultimedia</option
></userinput>
<userinput
><command
>apt-get</command
> <option
>install task-kdegraphics</option
></userinput>
<userinput
><command
>apt-get</command
> <option
>install task-kdepim</option
></userinput>
<userinput
><command
>apt-get</command
> <option
>install task-kdegames</option
></userinput>
<userinput
><command
>apt-get</command
> <option
>install task-koffice</option
></userinput>
<userinput
><command
>apt-get</command
> <option
>install kdebase-docs</option
></userinput>
<userinput
><command
>apt-get</command
> <option
>install kdm</option
></userinput>
</screen>

</sect1>

<sect1 id="source-distribution">
<title
>Kompilierung der Quelltexte zur Installation auf anderen Systemen </title>

<para
>Falls die eigene Linux-Distribution keine RPM- oder DEB-Archive verwendet, oder falls man ein andere Betriebssystem verwendet, muss man die KDE-Pakete selbst kompilieren. Zukünftig ist eine Binärdistribution mit eigenem Installationsprogramm geplant. </para>

<para
>Um KDE kompilieren und installieren zu können benötigt man folgende Dinge auf der Festplatte: </para>

<itemizedlist
> <listitem
><para
>Einen ANSI-C-Compiler wie z.B. den <abbrev
>GNU</abbrev
>-C-Compiler. </para
></listitem
> <listitem
><para
>Einen ANSI-C++-Compiler wie z.B. den <abbrev
>GNU</abbrev
>-C++-Compiler. </para
></listitem
> <listitem
><para
>Das Hilfsprogramm <application
>make</application
>. </para
></listitem
> <listitem
><para
>Die Qt-Entwicklungsversion 2.2 oder höher.</para
></listitem
> <listitem
><para
>X11-Entwicklungsversion (häufig fehlen Include-Dateien) </para
></listitem
> </itemizedlist>

<para
>Nachdem man alle diese Programme funktionstüchtig hat, benötigt man folgende Dateien aus dem Verzeichnis <filename
>/pub/kde/stable/<replaceable
>neueste Version</replaceable
></filename
> von einem der KDE-Mirror:</para>

<itemizedlist
> <listitem
><para
><filename
>kdesupport-<replaceable
>version</replaceable
>.tar.gz</filename
></para
></listitem
> <listitem
><para
><filename
>kdelibs-<replaceable
>version</replaceable
>.tar.gz</filename
> </para
></listitem
> <listitem
><para
><filename
>kdebase-<replaceable
>version</replaceable
>.tar.gz</filename
></para
></listitem
> <listitem
><para
>alle anderen Pakete, die man installieren möchte. Sinnvoll ist zumindest kdeutils. </para
></listitem
> </itemizedlist>

<para
>Bei allen genannten Paketen steht <replaceable
>version</replaceable
> für die aktuelle Versionsnummer. Nachdem man alle benötigten Dateien hat, muss man diese unter <filename
>/usr/src</filename
> auspacken. Es ergibt sich folgende Verzeichnisstruktur:</para>

<itemizedlist
> <listitem
><para
><filename
>/usr/src/kdesupport</filename
></para
></listitem
> <listitem
><para
><filename
>/usr/src/kdelibs</filename
></para
></listitem
> <listitem
><para
><filename
>/usr/src/kdebase</filename
></para
></listitem
> <listitem
><para
><filename
>/usr/src/...</filename
> (alle weiteren Pakete)</para
></listitem
> </itemizedlist>

<para
>Man sollte sich vergewissern, dass man über Schreibrechte in <filename
>/opt/kde</filename
> verfügt.</para>

<para
>Nun muss man die Pakete durch folgende Befehle kompilieren und installieren: </para>

<procedure
> <step
><para
><command
>cd</command
> in das Verzeichnis des Paketes, das man installieren möchte (siehe oben)</para
></step
> <step
><para
><command
>./configure</command
> (mit den gewünschten Optionen)</para
></step
> <step
><para
><command
>make</command
></para
></step
> <step
><para
><command
>make install</command
></para
></step
> </procedure>

<para
>Diese Schritte müssen auf jedes zu installierende Paket angewandt werden.</para>

<note
><para
>Diese Instruktionen passen übrigens auf nahezu jedes Quelltextpaket, nicht nur für die KDE-Pakete. </para
></note>

<para
>Jedes configure-Skript stellt verschiedene Optionen bereit. Einige sind allgemeingültig, während Andere paketspezifisch sind. Der folgende Ausschnitt stammt aus der Ausgabe des Befehls <command
>configure <option
>--help</option
></command
> in kdelibs.</para>

<screen>
<computeroutput>
  --disable-fast-perl     disable fast Makefile generation (needs perl)
  --enable-debug          creates debugging code [default=no]
  --enable-strict         compiles with strict compiler options (may not work!)
  --enable-profile        creates profiling infos [default=no]
  --enable-final          build size optimized apps (experimental - needs lots of memory)
  --disable-closure       don't delay template instantiation
  --enable-shared[=PKGS]  build shared libraries [default=yes]
  --enable-static[=PKGS]  build static libraries [default=no]
  --enable-fast-install[=PKGS]  optimize for fast installation [default=yes]
  --with-gnu-ld           assume the C compiler uses GNU ld [default=no]
  --disable-libtool-lock  avoid locking (might break parallel builds)
  --with-pic              try to use only PIC/non-PIC objects [default=use both]
  --with-extra-includes=DIR
                          adds non standard include paths
  --with-extra-libs=DIR   adds non standard library paths
  --with-qt-dir=DIR       where the root of Qt is installed
  --with-qt-includes=DIR  where the Qt includes are.
  --with-qt-libraries=DIR where the Qt library is installed.
  --disable-rpath         do not use the rpath feature of ld
  --disable-path-check    don't try to find out, where to install
  --with-xdmdir           If the xdm config dir can't be found automaticly
  --with-pam[=ARG]        enable support for PAM: ARG=[yes|no|service name]
  --with-shadow           If you want shadow password support
  --with-krb4[=PATH]      Compile in Kerberos v4 support.
  --with-afs              Compile in AFS support (requires KTH krb4).
  --with-ldap[=PATH]      Compile in LDAP support.
  --with-samba-libs=path  Use Samba-tng libs in 'path'                [search]
  --without-gl            disable 3D GL modes
  --without-xpm           disable color pixmap XPM tests
  --without-dpms          disable DPMS power saving
  --with-x                use the X Window System
  --with-motif-includes=DIR    Motif include files are in DIR
  --with-motif-libraries=DIR   Motif libraries are in DIR                           
</computeroutput>
</screen>

<para
>Viele Optionen sind nicht erforderlich und sind nützlich, um bekannte Probleme zu umgehen (z.B. <option
>--disable-FEATURE</option
>). Da einige Optionen sehr wichtig sind (z.B. <emphasis
>--with-shadow</emphasis
>) sollte man immer einen Blick auf die verfügbaren Optionen werfen.</para>

<para
>Eine der wichtigsten Optionen ist die Option <option
>--prefix</option
>. Diese Option legt fest, wo configure installieren soll (bei kdesupport und kdelibs) oder wo sich Bibliotheken befinden (für alle anderen Pakete). Standardmäßig verwendet configure das Verzeichnis <filename
>/opt/kde</filename
>. Falls man KDE stattdessen unter <filename
>/usr/local</filename
> installieren möchte, dient dazu die Angabe <command
>configure <option
>--prefix /usr/local/kde</option
></command
>.</para>

<para
>Falls man die Qt-Bibliotheken an einem ungewöhnlichen Platz installiert hat, z.B. unter <filename
>$HOME/src/qt</filename
>, so muss man die Option <command
>configure <option
>--with-qt-dir=$HOME/src/qt</option
></command
> verwenden. Standardmäßig sucht configure nach Qt in einigen üblichen Verzeichnissen.</para>

<para
>Falls man auf Probleme stößt, die man nicht lösen kann, sollte man eine Kopie der Datei <filename
>config.log</filename
> an die in der <filename
>README</filename
>-Datei des problematischen Pakets angegebene Adresse senden.</para>

<para
>Für die Installation von KDE gilt folgende Reihenfolge: kdesupport, kdelibs, dann die Programmpakete (z.B. kdebase). Alle Programme basieren nur auf kdelibs, weshalb man sie gleichzeitig kompilieren kann (falls der Rechner dies hergibt).</para>

<para
>Falls man ein Multiprozessorsystem verwendet, kann man den Befehl <command
>make <option
> -j <replaceable
>Anzahl der Prozessoren</replaceable
></option
></command
> an Stelle von <command
>make</command
> versuchen. </para>

<sect2>
<title
>platformspezifische Hinweise </title>

<sect3>
<title
>Linux </title>

<para
>Die meisten der unter Linux für KDE notwendigen Programme findet man entweder auf <ulink url="ftp://sunsite.unc.edu/pub/Linux/GCC"
>ftp://sunsite.unc.edu/pub/Linux/GCC</ulink
> oder <ulink url="ftp://sunsite.unc.edu/pub/GNU"
>ftp://sunsite/unc.edu/pub/GNU</ulink
>. Die Quelltexte der Qt-Bibliotheken findet man unter <ulink url="ftp://ftp.troll.no/pub/qt/source"
>ftp://ftp.troll.no/pub/qt/source</ulink
>. Detailierte Installationsanweisungen werden mitgeliefert. Include-Dateien der X11-Programme findet man im Abschnitt xdevel unter <ulink url="ftp://ftp.xfree86.org"
>ftp://ftp.xfree86.org</ulink
>. </para>

</sect3>
</sect2>
</sect1>

<sect1 id="suse-install">
<title
>Erforderliche Änderungen an den eigenen Konfigurationsdateien </title>
<para
> Nachdem man die KDE-Binärdateien installiert hat, muss man einige Anpassungen an den Start-Skripten vornehmen. </para>
<para
> Die folgende Vorgehensweise wurde unter SuSE Linux 5.0 getestet und sollte auf allen populären UNIX-Varianten ebenfalls funktionieren. <emphasis
>Man sollte immer Sicherheitskopien der Konfigurationsdateien anfertigen, bevor man etwas ändert.</emphasis
> Folgendes fügt man am Ende von /etc/profile an: </para>
<para
> <screen
>export PATH=$PATH:/opt/kde/bin 
export KDEDIR=/opt/kde
</screen
> </para>
<para
>Als nächstes muss die .xinitrc-Datei im eigenen Persönlichen Verzeichnis angepasst werden. Die Zeile, die den Fenstermanager startet muss durch <literal
>startkde</literal
> ersetzt werden.</para>
<para
>Da nun alle Vorbereitungen zum Start von KDE abgeschlossen sind, kann man zu Kapitel 4 übergehen, in dem der erste Start von KDE beschrieben wird. Falls Probleme auftreten, muss man vermutlich KDE selbst kompilieren. Informationen befinden sich unter <emphasis
><link linkend="source-distribution"
>Kompilierung der Quelltexte zur Installation auf anderen Systemen</link
></emphasis
>. </para>
<para
>Die Installation ist so narrensicher wie möglich, daher sollten keine ernsten Probleme auftreten, solange die eigene Rechnerkonfiguration nicht zu exotisch ist. Bei Problemen sollte man sich an die <link linkend="mailing-lists"
>KDE-Mailinglisten</link
> wenden. </para>
</sect1>
</chapter>

