KDEPIM-4.7 upgrade

From Gentoo Wiki
Jump to: navigation, search

This guide has been shamelessly copied from the Ubuntu Wiki. Please improve and adapt it for Gentoo!

Contents

Introduction

With KDEPIM-4.6 and 4.7, KDE's Personal Information Management suite, Kontact, has seen a major move to the new Akonadi system. This will mean any users of previous versions of of the PIM software will need to have their data migrated to the new system. This includes contacts from KAddressBook, events from KOrganizer, and email messages and accounts from KMail. Unfortunately, this process does not work automatically at this time, and may not be 100% successful when it is performed manually.

On the initial startup of the new KDE PIM suite, the address book and calendar data will be migrated automatically.

Note that the new akonadi backend does not absorb the raw e-mail data. So if the database gets corrupted, you will not lose all of your precious e-mails. See this KDE Akonadi blog post for more details.

Warning
It is not really advisable yet to upgrade KDEPIM on laptops and other devices with an unstable internet connection, as the Akonadi backend tends to crash in these situations.

Backing Up

The move to KMail2 means that email accounts and information are now also using Akonadi's storage and data system. The migration process for this will occur when KMail or Kontact is first run, and can be skipped for those who prefer to create their accounts manually. Unfortunately, at this time, the migration tool does not properly run when you select the Migrate option, see Launchpad bug #857828

For this reason, it is highly advised that users back up their PIM data before running KMail after upgrading. It also may be advisable for some to skip the migration process and recreate their accounts from scratch.

To back up your data, make copies of these files and folders:

With these saved folders, it will be possible to import the data into Kontact should the need arise.

These are the basic config files for the various Kontact applications.

More information on what you may want to back up can be found here, but with the folders listed above, you will be able to import things back into Kontact if necessary.

Failed Migration

If you have already attempted to run the migrator and it failed, you can re-run it manually by first deleting your ~/.kde4/share/config/kmail-migratorrc file and your ~/.kde4/share/config/kmail2rc file. Then you will need to run the migrator manually by hitting Alt-F2, and entering the following:

user $ kmail-migrator --interactive

The program will run, and all your accounts and mails will be moved over to the Akonadi system.

After Migrating

When KMail2 opens, you will notice a few things:

Importing Email Manually

If you choose to skip the migration and enter your account information manually, it is very easy to import your saved KMail folders.

Go to File → Import Messages. In the dialog that opens, select Import KMail Maildirs and Folder Structure, and browse to where you backed up your ~/.kde4/share/apps/kmail folder. Follow the prompts to finish the process. If you have mail folders in a different format than the standard Kmail Maildir, choose the appropriate option in the Import dialog.

If you need to import your calendar, you would go to Kontact's Calendar section, select File → Import → Import calendar, and browse to where you saved your ~/.kde4/share/apps/korganizer and select the std.ics file there, as well as any others you may have.

For contacts, the process is similar: go to Contacts, then File → Import → Import vcard , and browse to where you saved ~/.kde4/share/apps/kabc, and select std.vcf, as well as any other .vcf file you may have.

Troubleshooting

Downgrading to 4.4 again

Warning
In general, version downgrades are not supported (both by upstream KDE and by Gentoo) and can lead to arbitrary chaos. Here is a procedure that works, however, it just deletes all your local (mail, calendar, address book, ...) data. If you only use server-side (e.g. Google calendar, IMAP mail folders) data, that may be fine, but please be extra careful in any case.

If you have tried out KDEPIM-4.7 and decide that you'd rather go back to KDEPIM-4.4, well, here's what I (dilfridge) did. Basically you have to delete the entire KDEPIM configuration and application data and start from scratch.

user $ akonadicontrol stop
root # emerge -aC akonadiconsole akregator blogilo kabcclient kaddressbook kalarm kdepim-common-libs kdepim-icons kdepim-l10n kdepim-kresources kdepim-meta kdepim-strigi-analyzer kdepim-runtime kdepim-wizards kjots kleopatra kmail knode knotes konsolekalendar kontact korganizer ktimetracker
root # emerge -a kdepim-meta

Migrate to alternative Calendar/Addressbook

As an alternative, one can migrate to Thunderbird/Lightning for PIM needs. (Single app solution without the Akonadi/Nepomuk mess, modern and sufficiently robust)

(If you are already hosed, take your previously backed up .vcf file(s) and convert them to LDIFs using http://labs.brotherli.ch/vcfconvert/ ; install php and run the script locally).

Retrieved from "http://wiki.gentoo.org/wiki/KDEPIM-4.7_upgrade"
Personal tools
Namespaces
Variants
Actions
Gentoo Websites logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki new! Get Gentoo!
Navigation
Toolbox
Categories