Difference between revisions of "Kde4 Plasma5 Upgrade"

From Funtoo
Jump to navigation Jump to search
(add temporary warning to indicate KDE plasma 4 issue and upcoming page changes)
(upgrade guide work in progress)
Line 1: Line 1:
{{warning|KDE Plasma 4 development and support has ceased. KDE Plasma 4 ebuilds are currently masked upstream and are to be removed from the Portage tree during February 2017. This change will affect Funtoo Linux. Over the next few days this page will be updated to contain information to assist users migrating from KDE Plasma 4. }}
{{warning|This page is under development. [[User:Tassietux|Tassietux]] ([[User talk:Tassietux|talk]]) 05:51, January 31, 2017 (MST)}}
'''KDE SC 4''' (KDE Software Compilation 4) is a collection of software developed by the [https://www.kde.org KDE Community]. KDE SC 4 includes the Plasma [https://en.wikipedia.org/wiki/Desktop_environment desktop environment] (Plasma 4), a number of tightly integrated Applications, and a common platform of libraries and services. KDE SC 4 is based on the [https://en.wikipedia.org/wiki/Qt_%28software%29 Qt] framework.  
'''KDE Plasma 4 development and support has ceased. KDE Plasma 4 ebuilds are currently masked upstream and are due to be removed from the Portage tree during February 2017'''.


KDE Plasma 4 was released in 2008 [https://www.kde.org/announcements/4.0/] and development ceased in 2015 [https://www.kde.org/announcements/announce-applications-15.08.0.php]. Some packages within KDE SC 4 continue to receive updates and bugfixes. Plasma 4 was succeeded by Plasma 5 in 2014 [https://www.kde.org/announcements/plasma5.0/].
'''This change will affect Funtoo Linux'''.


Funtoo Linux continues to offer KDE SC 4.
Plasma 4 was the graphical environment that formed part of the former '''KDE SC 4''' (KDE Software Compilation 4). Plasma 5 is the current graphical environment offered by KDE. Many of the KDE Applications available under KDE SC 4 continue to be available under Plasma 5.


'''The aim of this guide is to detail the steps required to complete a default installation of the KDE Software Compilation 4 (KDE SC 4) on x86 architectures. It assumes the initial completion of the [[Install]] guide.'''
The purpose of this page is to detail the steps required to migrate Funtoo Linux from KDE SC 4 (Plasma 4) to [[KDE Plasma 5]] and KDE Applications. Given incompatibilities between Plasma 4 and Plasma 5 packages, Users undertaking this process are likely to encounter one or more blockers. Users are encouraged to seek assistance in the #funtoo IRC channel on Freenode.
 
To install KDE Plasma 5 instead see the page [[KDE Plasma 5]].


__TOC__
__TOC__


== Pre-Installation ==
== Update Funtoo Profiles ==
The following instructions are written for a new installation of Funtoo Linux performed using the [[Install]] guide.
Changes to Funtoo [[Funtoo_Profiles#Mix-ins|mix-in]] Profiles are required for KDE Plasma 5. Review the selected profiles using [[Funtoo_Profiles#Using_epro|epro]].
 
=== Funtoo Profiles ===
Correctly setting [[Funtoo Profiles]] is required to install KDE. Review the selected profiles using [[Funtoo_Profiles#Using_epro|epro]].


{{console|body=
{{console|body=
###i## epro show
###i## epro show
=== ##g##Enabled Profiles##!g##: ===
        arch: ##bl##x86-64bit##!bl##
      build: ##bl##current##!bl##
    subarch: ##bl##intel64-haswell##!bl##
      flavor: ##bl##core##!bl##
    mix-ins: (not set)
=== ##g##All inherited flavors from core flavor##!g##: ===
                        ##bl##minimal##!bl## (from core flavor)
}}
The recommended [[Funtoo_Profiles#Flavors|flavor]] for KDE is ''desktop''. This can be selected with the command epro flavor desktop
{{console|body=
###i## epro flavor desktop


=== ##g##Enabled Profiles##!g##: ===
=== ##g##Enabled Profiles##!g##: ===
Line 47: Line 22:
     subarch: ##bl##intel64-haswell##!bl##
     subarch: ##bl##intel64-haswell##!bl##
       flavor: ##bl##desktop##!bl##
       flavor: ##bl##desktop##!bl##
     mix-ins: (not set)
     mix-ins: ##bl##kde##!bl##


>>> Set flavor to desktop.
}}
}}


Following a [[Funtoo_Profiles#Flavors|flavor]] change an update of Funtoo packages is required
There are two KDE-related mix-ins available in Funtoo: ''kde'' and ''kde-plasma-5''. To migrate to KDE Plasma 5, users must remove the ''kde'' mix-in and add the ''kde-plasma-5'' mix-in.


{{console|body=
DO NOT combine ''kde'' and ''kde-plasma-5'' at the same time - they are incompatible.
###i## emerge --ask --update --verbose --deep --newuse --with-bdeps=y @world
}}
 
{{tip|This command can be shortened to


{{console|body=
{{console|body=
###i## emerge -auvDN --with-bdeps=y @world
###i## epro mix-in -kde +kde-plasma-5
}}
}}
 
=== Install the X Window System ===
KDE requires the [https://en.wikipedia.org/wiki/X_Window_System X Window System (X11)] to present graphics (video) and receive input (keyboard, mouse, joystick, etc.). Configuration is required for X11 to work with the video card on the target hardware. Use the [[Video]] guide to determine the appropriate VIDEO_CARDS entry for Funtoo Linux. With your favorite editor, edit {{f|make.conf}} to include the setting appropriate for the target video hardware.
 
{{file|name=/etc/portage/make.conf|desc=example for Intel HD Graphics|body=
VIDEO_CARDS="intel i965"
}}
 
Now install the X Window System by merging the meta-package {{Package|x11-base/xorg-x11}}
 
{{console|body=
###i## emerge --ask --verbose x11-base/xorg-x11
}}
 
=== Localization ===
To install KDE for a language other than English (United States) add an appropriate LINGUAS entry to {{f|/etc/portage/make.conf}}
 
{{file|name=/etc/portage/make.conf|desc=Example for English (United Kingdom)|body=
LINGUAS="en_GB"
}}
 
{{tip|More information on Localization can be found at [[Funtoo Linux Localization]].}}
 
== Emerge KDE SC 4 ==
 
The [[Funtoo Profiles]] were earlier set to the ''desktop'' flavor. Now an additional [[Funtoo_Profiles#Mix-ins|mix-in]] profile is required to provide a smooth installation of KDE SC 4.
 
There are two KDE-related mix-ins available in Funtoo: ''kde'' and ''kde-plasma-5''.
 
'''For KDE SC  the correct mix-in is "kde". DO NOT add "kde-plasma-5" instead of "kde" or add both at the same time - they are incompatible.'''
 
Add the mix-in using {{c|epro}}
 
{{console|body=
###i## epro mix-in kde


=== ##g##Enabled Profiles##!g##: ===
=== ##g##Enabled Profiles##!g##: ===
Line 106: Line 39:
     subarch: ##bl##intel64-haswell##!bl##
     subarch: ##bl##intel64-haswell##!bl##
       flavor: ##bl##desktop##!bl##
       flavor: ##bl##desktop##!bl##
     mix-ins: ##bl##kde##!bl##
     mix-ins: ##bl##kde-plasma-5##!bl##


>>> Added kde mix-in.
>>> Removed kde mix-in.
>>> Added kde-plasma-5 mix-in.
}}
}}


Now KDE SC 4 can be merged.
== Review USE Flags ==


This is performed by merging the package '''kde-apps/kde-meta'''. With the mix-in ''kde'' added this will install KDE SC 4 including the Plasma Desktop (Plasma 4), KDE Applications and common libraries from KDE and Qt.  
Details pending.


Since the Profile has changed (added mix-in) the world set of packages must be updated as well. These actions can be performed in one step
== Review Blockers ==
{{console|body=
###i## emerge -auvDN --with-bdeps=y @world kde-apps/kde-meta
}}


Once completed proceed to the chapter [[KDE#Configure_and_Start_KDE|Configure and Start KDE]].
Details pending.


== Configure and Start KDE ==
== Emerge KDE Plasma 5 and KDE Applications ==
 
{{warning|This section is incomplete.}}
=== OpenRC ===
This is performed by merging the package kde-apps/kde-meta:5...
After the many packages have been merged portage will present a variety of post-install messages. A number of these will request that critical services are started first in order for KDE to work. Typically these are ALSA ({{Package|media-libs/alsa-lib}}), ConsoleKit ({{Package|sys-auth/consolekit}}), DBus ({{Package|sys-apps/dbus}}), and UDev ({{Package|sys-fs/eudev}}). Since the ''desktop'' flavor has been set CUPS ({{Package|net-print/cups}}) will also be included.
 
Issue the following commands to set these essential services to start automatically via OpenRC (sys-apps/openrc)


{{console|body=
{{console|body=
###i## rc-update add alsasound boot
###i## emerge -auvDN --with-bdeps=y @world kde-apps/kde-meta:5
###i## rc-update add cupsd default
###i## rc-update add consolekit default
}}
}}


DBus is usually started when these services start.
== Configure and Start Plasma 5 ==
 
=== SSH and GPG Agent Scripts ===
UDev is usually rebuilt during an install of KDE due to changes in USE flags from changing Profile flavor and mix-ins. To accommodate changes it is best to restart the service.
 
{{console|body=
###i## /etc/init.d/udev --nodeps restart
}}


{{tip|Do not confuse the UDev package '''eudev''' (sys-fs/eudev) with '''evdev'''! '''evdev''' is the generic input device driver for the X Window System (x11-drivers/xf86-input-evdev)!}}
Details pending.


=== Create a User Account ===
=== KDE Plasma 5 Display (Login) Manager ===
Now is the appropriate point to create a user account for use with KDE Plasma. The following example creates a user ''alice'' and associates that account with the Groups ''lp'', ''lpadmin'', ''plugdev'', ''users'', ''video'' and ''wheel''. A home directory for the account ''alice'' will be created at {{f|/home/alice}}.
{{warning|This section is incomplete.}}
The default [https://en.wikipedia.org/wiki/X_display_manager_(program_type) Display Manager] for KDE Plasma 4 was KDM (kde-base/kdm). This has been


{{console|body=
To change from KDM to SDDM, edit {{f|/etc/conf.d/xdm}} with your favorite editor, updating the DISPLAYMANAGER entry to equal 'sddm'
###i## useradd -m -G games,lp,lpadmin,plugdev,users,video,wheel alice
}}
 
Now set a password for ''alice''
 
{{console|body=
###i## passwd alice
}}
 
=== Starting KDE with a Display (Login) Manager ===
The default [https://en.wikipedia.org/wiki/X_display_manager_(program_type) Display Manager] for KDE Plasma 4 is KDM (kde-base/kdm).
 
To use KDM first edit {{f|/etc/conf.d/xdm}} with your favorite editor, updating the DISPLAYMANAGER entry to equal 'kdm'


{{file|name=/etc/conf.d/xdm|body=
{{file|name=/etc/conf.d/xdm|body=
DISPLAYMANAGER="kdm"
DISPLAYMANAGER="sddm"
}}
 
Now add xdm to the default runlevel of OpenRC.
 
{{console|body=
###i## rc-update add xdm default
}}
 
The display manager KDM should appear at the end of computer boot. To avoid an unnecessary restart you can launch KDM/KDE from here with a simple command
 
{{console|body=
###i## rc
}}
}}


You should be presented with a graphical login screen. Input devices (mouse, keyboard) should be working at this stage. Logging in will take you to the KDE Plasma desktop of KDE SC 4.
Configure SDDM...
 
'''This concludes the basic installation of KDE Plasma on Funtoo Linux.'''
 
== External Links ==


KDE.org - [https://www.kde.org www.kde.org]
Start SDDM...


KDE Plasma Desktop - [https://www.kde.org/workspaces/plasmadesktop/ www.kde.org/workspaces/plasmadesktop/]
=== Migrate KWallet ===


KDE Applications - [https://www.kde.org/applications/ www.kde.org/applications/]
== Troubleshooting and Further Reading ==


Gentoo Linux Wiki - [https://wiki.gentoo.org/wiki/KDE wiki.gentoo.org/wiki/KDE]
[https://wiki.gentoo.org/wiki/KDE/Plasma_5_upgrade Gentoo Linux KDE Plasma 5 Upgrade]


[[Category:Desktop]]
[[Category:Desktop]]

Revision as of 12:51, January 31, 2017

   Warning

This page is under development. Tassietux (talk) 05:51, January 31, 2017 (MST)

KDE Plasma 4 development and support has ceased. KDE Plasma 4 ebuilds are currently masked upstream and are due to be removed from the Portage tree during February 2017.

This change will affect Funtoo Linux.

Plasma 4 was the graphical environment that formed part of the former KDE SC 4 (KDE Software Compilation 4). Plasma 5 is the current graphical environment offered by KDE. Many of the KDE Applications available under KDE SC 4 continue to be available under Plasma 5.

The purpose of this page is to detail the steps required to migrate Funtoo Linux from KDE SC 4 (Plasma 4) to KDE Plasma 5 and KDE Applications. Given incompatibilities between Plasma 4 and Plasma 5 packages, Users undertaking this process are likely to encounter one or more blockers. Users are encouraged to seek assistance in the #funtoo IRC channel on Freenode.


Update Funtoo Profiles

Changes to Funtoo mix-in Profiles are required for KDE Plasma 5. Review the selected profiles using epro. 

root # epro show

=== Enabled Profiles: ===

        arch: x86-64bit
       build: current
     subarch: intel64-haswell
      flavor: desktop
     mix-ins: kde

There are two KDE-related mix-ins available in Funtoo: kde and kde-plasma-5. To migrate to KDE Plasma 5, users must remove the kde mix-in and add the kde-plasma-5 mix-in.

DO NOT combine kde and kde-plasma-5 at the same time - they are incompatible. 

root # epro mix-in -kde +kde-plasma-5

=== Enabled Profiles: ===

        arch: x86-64bit
       build: current
     subarch: intel64-haswell
      flavor: desktop
     mix-ins: kde-plasma-5

>>> Removed kde mix-in.
>>> Added kde-plasma-5 mix-in.

Review USE Flags

Details pending.

Review Blockers

Details pending.

Emerge KDE Plasma 5 and KDE Applications

   Warning

This section is incomplete.

This is performed by merging the package kde-apps/kde-meta:5... 

root # emerge -auvDN --with-bdeps=y @world kde-apps/kde-meta:5

Configure and Start Plasma 5

SSH and GPG Agent Scripts

Details pending.

KDE Plasma 5 Display (Login) Manager

   Warning

This section is incomplete.

The default Display Manager for KDE Plasma 4 was KDM (kde-base/kdm). This has been

To change from KDM to SDDM, edit /etc/conf.d/xdm with your favorite editor, updating the DISPLAYMANAGER entry to equal 'sddm'

   /etc/conf.d/xdm 
DISPLAYMANAGER="sddm"

Configure SDDM...

Start SDDM...

Migrate KWallet

Troubleshooting and Further Reading

Gentoo Linux KDE Plasma 5 Upgrade

Retrieved from "https://www.funtoo.org/index.php?title=Kde4_Plasma5_Upgrade&oldid=18076"