source: kde4/intro/pre-install-config.xml@ 0e25c32

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
  <!ENTITY % general-entities SYSTEM "../../general.ent">
  %general-entities;
]>

<sect1 id="kde4-pre-install-config">
  <?dbhtml filename="pre-install-config.html"?>

  <sect1info>
    <othername>$LastChangedBy$</othername>
    <date>$Date$</date>
  </sect1info>

  <title>KDE4 Pre-installation Configuration</title>

  <para>Based on your preference, set <envar>&kde4-dir-var;</envar>. In
  contrast to the previous version of <application>KDE</application> 
  which uses <envar>KDE_PREFIX</envar>, the prefix is stored in
  <envar>&kde4-dir-var;</envar> to avoid interferences. This prefix is
  used to specify where <application>KDE4</application> should be
  installed.</para>

<!--
  <para>You should consider installing the <xref linkend="desktop-file-utils"/>
  package. Though not required, this package will allow you to easily use
  existing <filename>.desktop</filename> files in
  <filename class='directory'>/usr/share/applications</filename> (and any other
  locations identified by <envar>XDG_DATA_DIRS</envar>), and automatically add
  these applications to the <application>KDE4</application> menu system.</para>
-->

  <para>Remember to execute <command>ldconfig</command> after installation
  of libraries to update the library cache.</para>

  <sect2><title>Dependencies</title>

    <para>As <application>KDE4</application> is a huge software collection 
    providing a desktop, tools for system and development tasks as well as 
    fun and educational stuff, it makes use of a tremendous amount of 
    non-KDE packages. While nearly all of those packages are optional,
    some others are are highly recommended.</para>
    <para>You should consider to install following packages. Installing
    this packages will switch on some useful features in the resulting
    <application>KDE4</application>.

    <itemizedlist>
      <listitem>
        <para><ulink url="http://qjson.sourceforge.net">QJSON</ulink> - Qt library for handling JavaScript objects</para>
      </listitem>
      <listitem>
         <para><ulink url="http://gpsd.berlios.de/">libgps</ulink> - interface to GPS devices (kdeedu)</para>
      </listitem>
      <listitem>
        <para><ulink url="http://eigen.tuxfamily.org/">eigen2</ulink> - a C++ template library for linear algebra</para>
      </listitem>
      <listitem>
        <para><xref linkend="desktop-file-utils"/> - a few command line utilities for working with desktop entries</para>
      </listitem>
      <listitem>
        <para><ulink url="http://www.riverbankcomputing.com/software/sip/intro">pySIP</ulink> - Python Service Integration Platform</para>
      </listitem>
      <listitem>
        <para><ulink url="http://www.riverbankcomputing.com/software/pyqt/">pyQT4</ulink> - Python interface to Qt4 (kdebindings)</para>
      </listitem>
      <listitem>
        <para><xref linkend="ruby"/> - Ruby language (kdebindings)</para>
      </listitem>
      <listitem>
        <para><xref linkend="poppler"/> - Utility and library to show PDF files (kdegraphics)</para>
        <para>make sure the --enable-xpdf-headers switch is set</para>
      </listitem>
      <listitem>
        <para><xref linkend="libical"/> - library handling calendar entries (kdepimlibs)</para>
      </listitem>
      <listitem>
        <para><ulink url="http://cyberelk.net/tim/data/pycups/">pyCUPS</ulink> - Python interface to CUPS (kdeadmin)</para>
      </listitem>
      <listitem>
        <para><ulink url="http://cyberelk.net/tim/data/system-config-printer/">system-config-printer</ulink> - Printer config (kdeadmin)</para>
      </listitem>
      <listitem>
        <para><xref linkend="libidn"/> - en-/decode internationalized domain names (kdenetwork)</para>
      </listitem>
      <listitem>
        <para><xref linkend="polkit"/> - Policy handling (nearly all of KDE)</para>
      </listitem>
      <listitem>
        <para><xref linkend="consolekit"/> - Runtime dependency of polkit</para>
      </listitem>
      <listitem>
        <para>U-tools - udisks and upower instead of HAL</para>
        <para>and all of its dependencies: <xref linkend="libatasmart"/>, <xref linkend="sg3_utils"/>, 
        <xref linkend="libffi"/>, <xref linkend="acl"/>, <xref linkend="gobject-introspection"/>,
        <xref linkend="udev"/>, <xref linkend="Device-mapper"/>, <xref linkend="parted"/> and than
        <xref linkend="udisks"/> and <xref linkend="upower"/></para>
      </listitem>
      <listitem>
        <para><xref linkend="libiodbc"/> - iODBC library</para>
      </listitem>
      <listitem>
        <para><xref linkend="virtuoso"/> - a Universal Database</para>
      </listitem>
      <listitem>
        <para><xref linkend="exiv2"/> - Image data processing library</para>
      </listitem>
      <listitem>
        <para>RDF tools - Handling of RDF data</para>
        <para>Including: <xref linkend="raptor"/>, <xref linkend="rasqal"/> and <xref linkend="redland"/></para>
      </listitem>
      <listitem>
        <para><xref linkend="clucene"/> - Text search engine</para>
      </listitem>
      <listitem>
        <para><xref linkend="boost"/> - collection of free C++ libraries</para>
      </listitem>
      <listitem>
        <para><xref linkend="qca"/> - Cryptographic library for Qt platform</para>
      </listitem>
      <listitem>
        <para><xref linkend="libdbusmenu-qt"/> - Qt interface to D-Bus menue</para>
      </listitem>
      <listitem>
        <para><xref linkend="soprano"/> - object-oriented C++/Qt4 framework for RDF data</para>
      </listitem>
      <listitem>
        <para><xref linkend="strigi"/> - Desktop indexing engine</para>
      </listitem>
      <listitem>
        <para><ulink url="http://www.grantlee.org">Grantlee</ulink> - a template system for Qt</para>
      </listitem>
    </itemizedlist>
    </para>
  </sect2>

  <sect2><title>Installing in /usr</title>
    <para>One option is to put <application>KDE4</application> into the
    <filename class='directory'>/usr</filename> hierarchy.  This creates
    a simpler setup but is more difficult to try multiple versions
    of <application>KDE4</application>.</para>

<screen><userinput>export &kde4-dir-var;=/usr</userinput></screen>
  </sect2>
  
  <sect2><title>Installing in /opt</title>
    <para>A method of building multiple versions installs
    <application>KDE4</application> in the <filename
    class='directory'>/opt</filename> hierarchy:</para>

<screen><userinput>export &kde4-dir-var;=/opt/kde4</userinput></screen>

    <para>If you are not installing <application>KDE4</application> in
    <filename class="directory">/usr</filename>, you will need to make some
    additional configuration changes. Best practice is to add those to your 
    system or personal profile:</para>

<screen><userinput>cat &gt; /etc/profile.d/kde4.sh &lt;&lt;"EOF"
# Begin /etc/profile.d/kde4.sh

&kde4-dir-var;=/opt/kde4
KDE4DIR=&kde4-dir;
KDEDIR=&kde4-dir;

pathappend &kde4-dir;/bin           PATH
pathappend &kde4-dir;/lib/pkgconfig PKG_CONFIG_PATH
pathappend &kde4-dir;/share         XDG_DATA_DIRS
pathappend /etc/kde4/xdg              XDG_CONFIG_DIRS

export KDE4_PREFIX KDE4DIR KDEDIR
export PATH PKG_CONFIG_PATH XDG_DATA_DIRS XDG_CONFIG_DIRS

# End /etc/profile.d/kde4.sh
EOF
</userinput></screen>

    <para>Add to your <filename>/etc/ld.so.conf</filename>:</para>

<screen role="root"><userinput>cat &gt;&gt; /etc/ld.so.conf &lt;&lt; "EOF"
<literal># Begin kde4 addition to /etc/ld.so.conf

/opt/kde4/lib

# End kde4 addition</literal>
EOF</userinput></screen>

    <indexterm zone="kde4-pre-install-config">
      <primary sortas="e-etc-ld.so.conf">/etc/ld.so.conf</primary>
    </indexterm>

    <para>Add to your <filename>/etc/man_db.conf</filename>:</para>

<screen role="root"><userinput>cat &gt;&gt; /etc/man_db.conf &lt;&lt; "EOF"
<literal># Begin kde4 addition to man_db.conf

MANDATORY_MANPATH /opt/kde4/man

# End kde4 addition to man_db.conf</literal>
EOF</userinput></screen>

    <indexterm zone="kde4-pre-install-config">
      <primary sortas="e-etc-man_db.conf">/etc/man_db.conf</primary>
    </indexterm>

    <tip>
      <para>Sometimes, the installation pathes are patched into installed
      files. This is the reason why <filename class="directory">/opt/kde4</filename>
      is used as installation prefix instead of <filename class="directory">/opt/kde-&kde4-version;</filename>.
      After installing <application>KDE4</application>, you may consider to
      rename the directory and create a symlink:</para>

<screen role="root"><userinput>mv /opt/kde{4,-&kde4-version;} &amp;&amp;
ln -v -sf kde-&kde4-version; /opt/kde4</userinput></screen>

      <para>Later on, you may want to install other versions of <application>KDE4</application>.
      To do that, just remove the symlink and use <filename class="directory">/opt/kde4</filename>
      as prefix again (<application>KDE4</application> must not be started). Which 
      version of <application>KDE4</application> you use depends only on 
      where the symlink points to. No other reconfiguration will be needed.</para>
    </tip>

  </sect2>
  
  <sect2><title>The QT4DIR variable</title>
  <para>Some additional packages which are based on <application>Qt4</application>
  will be installed. One of them is <application>Phonon</application>, a direct
  replacement of the implementation which comes with <application>Qt4</application>.
  It's recommended to place such libraries in the same hierarchy where <application>Qt4</application>
  itself resides. Later on, it is refered to <envar>QT4DIR</envar>. If you have placed 
  <application>Qt4</application> in <filename class='directory'>/usr</filename>,
  set <envar>QT4DIR</envar>:</para>
  
<screen><userinput>export QT4DIR=/usr</userinput></screen>

  <para>Alternativly, <application>Qt4</application> is often placed in the
  <filename class='directory'>/opt</filename> hierarchy:</para>
  
<screen><userinput>export QT4DIR=/opt/qt-&qt4-version;
export PATH=$QT4DIR/bin:$PATH</userinput></screen>

  </sect2>
  
</sect1>