  Notes on the KDE-1.1 RPM Packages for Red Hat Linux
  The KDE Packaging Team, kde-packager@kde.org
  v1.6, 26 January 1999

  Information and quick installation instructions to accompany KDE-1.1
  "rh42", "rh50egcs", "rh5x" and "rh5xegcs11" packages for Red Hat Linux
  4.2, 5.0, 5.1 and 5.2, available at ftp.kde.org.

  The i386 versions of these RPM packages  are available at
  ftp://ftp.kde.org/pub/kde/stable/1.1/contrib/distribution/rpm/ in the
  RReeddHHaatt--44..22//ii338866, RReeddHHaatt--55..00//eeggccss//ii338866, RReeddHHaatt--55..11//ii338866, and
  RReeddHHaatt--55..22//ii338866 subdirectories.  RPM packages for other architectures
  may be available; substitute the architecture name (e.g, alpha) for
  i386 in these instructions,



      11.. WWhhiicchh vveerrssiioonn ooff tthhee QQTT ttoooollkkiitt ttoo uussee??
        These rpms are built to use QT v1.42.  The rpm packages should
        be available where you obtain the KDE rpms; if not look for them
        at ftp://ftp.troll.no/pub/contrib/qt-packages/linux

        For RH4.2 (Red Hat 4.2), get the RPM package
        qt-1.42-1rh42.i386.rpm.  This is compiled with gcc-2.7.2.3 and
        libc5.

        For RH5.0, RH5.1, or RH5.2, get the RPM package
        qt-1.42-3rh51.i386.rpm.  This is compiled with egcs-1.0.3a and
        glibc2.  (For those who requested it, this package now includes
        the qimageio extension.)

        (A special series of "rh5xegcs11" KDE rpms compiled with
        egcs-1.1 may be available for the Digital/Compaq (tm) alpha/AXP
        processor architecture.  These will require special
        qt-1.42-3rh5xegcs11.alpha.rpm RPM packages  compiled with
        egcs-1.1.)

        If you plan to compile additional KDE applications, also obtain
        the corresponding qt-devel RPM package.

        If QT-2.0 maintains backwards compatibilty, appropriate
        qt-2.0-*rh*.i386.rpm RPM packages may work with KDE-1.1.


     22.. WWhhyy aarree tthheerree vvaarriioouuss ddiiffffeerreenntt sseettss ooff KKDDEE RRPPMM ppaacckkaaggeess??
        The evolution of the Red Hat distribution means that there are
        binary incompatibilities between different releases (except
        between RH5.1 and RH5.2, which use the same RPM package).

     +o  The "rrhh4422" packages are for Red Hat 4.2, compiled with
        gcc-2.7.2.3 and libc5,

     +o  The "rrhh5500eeggccss" packages are for Red Hat 5.0, and are compiled
        with egcs-1.0.3a glibc2, and libncurses-3.0

     +o  The "rrhh55xx" packages are for Red Hat 5.1 and 5.2, and are
        compiled with egcs-1.0.3a, glibc2, and libncurses-4.0.

     +o  The "rrhh55xxeeggccss1111" packages are for Red Hat 5.1 and 5.2 ((pprroobbaabbllyy
        aavvaaiillaabbllee oonnllyy ffoorr tthhee DDiiggiittaall//CCoommppaaqq ((ttmm)) aallpphhaa ((AAXXPP)) pprroocceessssoorr
        aarrcchhiitteeccttuurree)) are compiled with the latest egcs-1.1 compiler, as
        some alpha users have requested this.  These will also require
        that libstdc++-2.0.9 is installed.

        Since the "rh50egcs" RPM packages are nnoott compiled with the
        gcc-2.7.2.3 compiler supplied with RH5.0, they require that the
        C++ library libstdc++-2.8.0 taken from the Red Hat 5.1 or 5.2
        distribution is added to your RH5.0 installation.  (KDE RPM
        packages for RH5.0 compiled with the gcc-2.7.2.3 compiler and
        glibc2 currently have broken PAM support, and will not be
        released unless this is fixed).




     33.. TThhiinnggss ttoo ddoo bbeeffoorree iinnssttaalllliinngg tthhee RRPPMM ppaacckkaaggeess..
        (For more information, see the Installation Guide for the KDE
        RPM packages for Red Hat Linux; this will be available in
        /usr/doc/KDE-1.1/ after the kdesupport RPM package is
        installed).


        _O_N_L_Y _I_N_S_T_A_L_L _K_D_E _I_F _Y_O_U _C_U_R_R_E_N_T_L_Y _H_A_V_E _A _W_O_R_K_I_N_G _X _W_I_N_D_O_W _S_Y_S_T_E_M
        _O_N _Y_O_U_R _R_E_D _H_A_T _S_Y_S_T_E_M_.  _F_I_X _A_N_Y _P_R_O_B_L_E_M_S _W_I_T_H _"_X_" _B_E_F_O_R_E
        _I_N_S_T_A_L_L_I_N_G _K_D_E_.

        Then login as the superuser (root).

        The standard KDE installation is in $KDEDIR = /opt/kde, but the
        RPM packages are rreellooccaattaabbllee: you can install them to another
        location such as /usr/kde with the  rpm ... --prefix=/usr/kde
        option.  If you use this option, you will have to make sure that
        any KDE applications you later install that are not part of this
        distribution install to the correct location.

        You will need 30-40Mb disk space for a full KDE installation.
        Type "df" to see available space (in Kb) on your disk
        partitions.

        Ideally, /opt is the mount point of a separate partition, but
        this is not part of the current Linux File System Standard
        followed by Red Hat.  (It is however part of the new FFiillee
        HHeeiirraarrcchhyy SSttaannddaarrdd (FHS) v2.0, which has been announced to be
        part of the forthcoming Linux Standard Base (LSB) standard).  If
        you do not have (or do not wish to create) an /opt partition,
        (and do not wish to relocate the RPM packages), you can either:


        1. Do nothing: in this case, KDE will install to a directory
           /opt/kde on the root partition /.  (If not enough space is
           available, this may cause problems by filling your root
           partition!)

        2. Create a directory /opt, and make /opt/kde a symbolic link to
           a directory on a partition with free space, e.g.:


             mkdir /opt
             mkdir /usr/local/kde
             ln -s ../usr/local/kde /opt/kde




        This provides the greatest flexibility, as other packages that
        install to /opt can be then be placed on different partitions
        using symbolic links.  (DDoo tthhiiss BBEEFFOORREE iinnssttaalllliinngg KKDDEE !! ):

        If you have an older version of KDE installed you should:

     +o  uninstall if it is older than KDE-1.1 (or move it out of the way
        so the installation to /opt/kde will be clean).
         IInn ppaarrttiiccuullaarr,, yyoouu mmaayy hhaavvee pprroobblleemmss oonn RReedd HHaatt 55..11//55..22 iiff yyoouu
        uuppggrraaddee ffrroomm kdesupport-1.0-*rh51, as the kdesupport-1.1-*rh5x
        rpms no longer supply libgdbm.  (Sorry: rpm _s_h_o_u_l_d provide
        graceful upgrades without uninstalling the KDE-1.1 rpms, but our
        decision (starting with KDE-1.1) to rely on Red Hat's RPM
        packages for libgdbm, libjpeg, and libungif has made that
        difficult this time.)


        RedHat 5.1/5.2 users must either first uninstall kde*-1.0, or
        use  rpm --nodeps ...  when upgrading.  Also  make sure the Red
        Hat rpm packages gdbm, libjpeg-6b, and libungif are installed.
        (For Red Hat 5.1, the last two packages must be the updated RPM
        packages found at Red Hat's ftp site ftp://updates.redhat.com/
        in the jpeg subdirectory of the Red Hat 5.1 updates).  (This
        only applies to the "rh5x" rpms).


     +o  remove any special KDE customizations in system files like
        /etc/profile to set KDEDIR, put KDE executables in the system
        path, etc.  This will be handled automatically by this
        installation (by scripts in /etc/profile.d), and your older
        customizations may interfere with this.



     44.. IInnssttaallll lliibbssttddcc++++ iiff nneeeeddeedd ((RReedd HHaatt 55..00,, oorr iiff uussiinngg eeggccss--11..11))
        Red Hat 5.0 users need to obtain the libstdc++-2.8.0 RPM package
        from the Red Hat 5.2 (or 5.1) distribution, and install it on
        your Red Hat 5.0 system.

        Get it from
        ftp://ftp.redhat.com/pub/redhat/redhat-5.2/i386/RedHat/RPMS/libstdc++-2.8.0-14.i386.rpm
        and install it:


          rpm -Uvh libstdc++-2.8.0-*.i386.rpm




     If you intend to compile KDE applications for your Red Hat 5.0
     system, you will also need to install the egcs-1.0.3a compiler from
     the Red Hat 5.2 distribution (or the egcs-1.0.2 compiler from Red
     Hat 5.1) on your Red Hat 5.0 system.  See the document ggcccc__ttoo__eeggccss--
     HHOOWWTTOO for details (kdesupport installs it in /usr/doc/KDE-1.0).

     If you are still using Red Hat 5.0 (Red Hat's first glibc release)
     you should seriously consider upgrading to Red Hat 5.2.

     Similarly, if you are using the "rh5xegcs11" RPM packages compiled
     with egcs-1.1 for the alpha/AXP processor, you should  at this time
     install the libstdc++-2.0.9 RPM package that accompanies them.



     55.. IInnssttaalllliinngg tthhee RRPPMM ppaacckkaaggeess..
        From the directory that contains the RPM packages: First install
        QT:


          rpm -Uvh qt-1.41-*rh*.i386.rpm




     where *rh* is 1rh42 for RH4.2, and 1rh51 for RH5.0, RH5.1 and
     RH5.2.  Also install the corresponding qt-devel RPM package if you
     plan to compile any KDE applications.

     Now install the KDE base system:


          rpm -Uvh kdesupport-1.1-*rh*.i386.rpm
          rpm -Uvh kdelibs-1.1-*rh*.i386.rpm
          rpm -Uvh kdebase-1.1-*rh*.i386.rpm




     where *rh* is *rh42 for RH4.2, *rh50egcs for RH5.0, and *rh5x for
     RH5.1, RH5.2.



     Now install the optional KDE RPM packages


          rpm -Uvh k*-1.1-*rh*.i386.rpm




     where k* is any of: kdeadmin, kdegames, kdegraphics, kdemultimedia,
     kdenetwork, kdetoys, kdeutils,  or korganizer.


     66.. TThhiinnggss ttoo ddoo aafftteerr iinnssttaalllliinngg tthhee RRPPMM ppaacckkaaggeess..
        To use the KDE X Display Manager kdm as a substitute for xdm,
        type


          /opt/kde/bin/kdm_on




     kdm_on makes small changes to two Red Hat configuration files
     (/etc/inittab, /etc/X11/xdm/Xsetup_0). (These changes can be
     reversed by typing "/opt/kde/bin/kdm_off").  If the system is
     already running xdm in runlevel 5, (and no X Window sessions are
     active) type


          telinit 3 ; telinit 5




     to shut down xdm and start kdm.

     For each user who wants to use KDE as their desktop, type


          /opt/kde/bin/usekde <username>




     (Users may also do this for themselves by just typing "usekde"
     after they next log in.)  A hidden file .Xclients installed in the
     user's home directory starts the KDE desktop in their next X Window
     session; they can simply delete this file in the (unlikely) event
     that they no longer wish to use KDE.

     It is also simple to  configure the system  so all users get a KDE
     desktop by default, and to customize the initial KDE desktop that
     they see.  For details, see IInnssttaallllaattiioonn GGuuiiddee, which also includes
     troubleshooting hints, and is installed by the kdesupport RPM
     package into /usr/doc/KDE-1.0, along with other Red Hat-specific
     documentation.

     The KDE configuration initially installed by these RPM packages
     places icons for printing, and for mounting/unmounting floppy-disk
     and cdrom drives on the desktop.  The System Manager must ensure
     these are correctly configured for the system before they will work
     (or delete them if they are not wanted).  The System Manager  may
     wish to customize the default KDE Desktop (that is installed by the
     "usekde" script) for your system; see the Installation Guide for
     more details.


  Now enjoy KDE on your Red Hat system next time you open an X Window
  session!

  The KDE Packaging Team

  Send comments or corrections to: redhat-rpms@kde.org








































