Akonadi and AddressBook: Difference between revisions

    From KDE UserBase Wiki
    No edit summary
    (typography edit)
    Line 4: Line 4:


    <!--T:1-->
    <!--T:1-->
    ''This information was provided by Tobias Koenig, KDE-PIM developer.''
    ''This information was provided by Tobias Koenig, '''KDE-PIM''' developer.''


    <!--T:2-->
    <!--T:2-->
    Line 10: Line 10:


    <!--T:3-->
    <!--T:3-->
    By 'real data' we mean the data, like the contacts or events. These data are stored either on a groupware server or in local files. Where exactly depends on the resource you are using. E.g. the 'Personal Contacts' resource stores its data under $HOME/.local/share/contacts while the 'VCard File' resource (which is not recommended to use anyway [[Image:Face-smile.png]]) stores its data under $HOME/.kde/share/apps/kabc/std.vcf.
    By "real data" we mean the data, like the contacts or events. These data are stored either on a groupware server or in local files. Where exactly depends on the resource you are using. E.g. the '''Personal Contacts''' resource stores its data under $HOME/.local/share/contacts while the '''VCard File''' resource (which is not recommended to use anyway [[Image:Face-smile.png]]) stores its data under $HOME/.kde/share/apps/kabc/std.vcf.


    <!--T:4-->
    <!--T:4-->
    The 'cached data' are copies of the 'real data' that are kept in the database for faster access and offline caching. The database also keeps the 'meta data' which are management data needed by Akonadi to work correctly.
    The '''cached data''' are copies of the '''real data''' that are kept in the database for faster access and offline caching. The database also keeps the '''meta data''' which are management data needed by '''Akonadi''' to work correctly.


    <!--T:5-->
    <!--T:5-->
    The 'configuration data' are the data that configure the Akonadi server and the individual resources. The configuration data for the server can be found under $HOME/.config/akonadi, the configuration for the resources are mostly stored under $HOME/.kde/share/config/akonadi_xyz_resourcerc# (xyz is name of resource and # its instance number).
    The '''configuration data''' are the data that configure the '''Akonadi''' server and the individual resources. The configuration data for the server can be found under $HOME/.config/akonadi, the configuration for the resources are mostly stored under $HOME/.kde/share/config/akonadi_xyz_resourcerc# (xyz is name of resource and # its instance number).


    <!--T:6-->
    <!--T:6-->
    Line 22: Line 22:


    <!--T:7-->
    <!--T:7-->
    So now we need to decide what to back up.  If you want to backup the 'real data', then it depends on the resources you have configured... if you use a groupware server, then the backup should be done there. For contacts, the files under $HOME/.local/share/contacts will normally be what you need.
    So now we need to decide what to back up.  If you want to backup the "real data", then it depends on the resources you have configured... if you use a groupware server, then the backup should be done there. For contacts, the files under $HOME/.local/share/contacts will normally be what you need.


    <!--T:8-->
    <!--T:8-->
    The Akonadi tray icon offers you a backup and restore function.  That backs up the 'cache data' which might not include all of your data!  It can be helpfull if you want to clone a system 1:1, then you can copy the cached data together with the real data and the configuration, so you don't have to load the data again from the sources (e.g. groupware server).
    The '''Akonadi''' tray icon offers you a backup and restore function.  That backs up the "cache data" which might not include all of your data!  It can be helpful if you want to clone a system 1:1, then you can copy the cached data together with the real data and the configuration, so you don't have to load the data again from the sources (e.g. groupware server).


    <!--T:9-->
    <!--T:9-->
    Line 31: Line 31:


    <!--T:10-->
    <!--T:10-->
    KRunner offers you Akonadi Resource Configuration, or you can access this through the Akonadi tray icon > Configure.  You may find several resources set up.  You may find one labelled
    '''KRunner''' offers you '''Akonadi Resource Configuration''', or you can access this through the '''Akonadi tray icon -> Configure'''.  You may find several resources set up.  You may find one labelled


    <!--T:11-->
    <!--T:11-->
    Address Book - No KDE address book plugin configured yet.
    '''Address Book''' - No KDE address book plugin configured yet.


    <!--T:12-->
    <!--T:12-->
    Line 41: Line 41:


    <!--T:13-->
    <!--T:13-->
    std.vcf - Ready
    '''std.vcf''' - Ready


    <!--T:14-->
    <!--T:14-->
    This is the 'VCard File Resource' which points to $HOME/.kde/share/apps/kabc/std.vcf per default.  It is not recommended that you use that one, as it doesn't share the benefit of Akonadi.
    This is the '''VCard File Resource''' which points to $HOME/.kde/share/apps/kabc/std.vcf per default.  It is not recommended that you use that one, as it doesn't share the benefit of '''Akonadi'''.


    <!--T:15-->
    <!--T:15-->
    Personal Contacts - Offline
    '''Personal Contacts''' - Offline


    <!--T:16-->
    <!--T:16-->
    Line 54: Line 54:


    <!--T:17-->
    <!--T:17-->
    Note that this may say 'Offline' when in fact you are using it.  This is a display bug, and can safely be ignored.
    Note that this may say "Offline" when in fact you are using it.  This is a display bug, and can safely be ignored.


    <!--T:18-->
    <!--T:18-->
    ==And when more components use Akonadi?==
    ==And when more components use '''Akonadi'''?==


    <!--T:19-->
    <!--T:19-->
    When the rest of the components move to Akonadi, will all the data be under ~/.local/share?  That should make backup easy.  Well, contacts and mails are stored there now, I don't know what the plan for events/todos is, but it would make sense to store them there as well. We'll keep it in mind when discussion pops up!
    When the rest of the components move to '''Akonadi''', will all the data be under ~/.local/share?  That should make backup easy.  Well, contacts and mails are stored there now, I don't know what the plan for events/todos is, but it would make sense to store them there as well. We'll keep it in mind when discussion pops up!


    <!--T:20-->
    <!--T:20-->
    [[Category:System]]
    [[Category:System]]
    </translate>
    </translate>

    Revision as of 17:56, 18 June 2010

    Template:I18n/Language Navigation Bar

    This information was provided by Tobias Koenig, KDE-PIM developer.

    Some Definitions

    By "real data" we mean the data, like the contacts or events. These data are stored either on a groupware server or in local files. Where exactly depends on the resource you are using. E.g. the Personal Contacts resource stores its data under $HOME/.local/share/contacts while the VCard File resource (which is not recommended to use anyway ) stores its data under $HOME/.kde/share/apps/kabc/std.vcf.

    The cached data are copies of the real data that are kept in the database for faster access and offline caching. The database also keeps the meta data which are management data needed by Akonadi to work correctly.

    The configuration data are the data that configure the Akonadi server and the individual resources. The configuration data for the server can be found under $HOME/.config/akonadi, the configuration for the resources are mostly stored under $HOME/.kde/share/config/akonadi_xyz_resourcerc# (xyz is name of resource and # its instance number).

    Organising Backups

    So now we need to decide what to back up. If you want to backup the "real data", then it depends on the resources you have configured... if you use a groupware server, then the backup should be done there. For contacts, the files under $HOME/.local/share/contacts will normally be what you need.

    The Akonadi tray icon offers you a backup and restore function. That backs up the "cache data" which might not include all of your data! It can be helpful if you want to clone a system 1:1, then you can copy the cached data together with the real data and the configuration, so you don't have to load the data again from the sources (e.g. groupware server).

    Examining your Resources

    KRunner offers you Akonadi Resource Configuration, or you can access this through the Akonadi tray icon -> Configure. You may find several resources set up. You may find one labelled

    Address Book - No KDE address book plugin configured yet.

    That's the old compatibility bridge (possibly created by the migrator tool). You should remove this one!

    std.vcf - Ready

    This is the VCard File Resource which points to $HOME/.kde/share/apps/kabc/std.vcf per default. It is not recommended that you use that one, as it doesn't share the benefit of Akonadi.

    Personal Contacts - Offline

    That's the preferred resource for your local contacts which points to

     $HOME/.local/share/contacts
    

    Note that this may say "Offline" when in fact you are using it. This is a display bug, and can safely be ignored.

    And when more components use Akonadi?

    When the rest of the components move to Akonadi, will all the data be under ~/.local/share? That should make backup easy. Well, contacts and mails are stored there now, I don't know what the plan for events/todos is, but it would make sense to store them there as well. We'll keep it in mind when discussion pops up!