Akonadi e AddressBook

From KDE UserBase Wiki
Revision as of 23:33, 9 June 2011 by MarcusGama (talk | contribs) (Created page with "Cada controlador de fontes de dados (chamadas de recursos) ou programas auxiliares (chamados agentes) pode ter sua própria configuração, embora alguns agentes ou recursos não...")

Esta informação foi fornecida por Tobias Koenig, desenvolvedor do KDE-PIM.

Algumas definições

Por dados reais entende-se os dados, como os contatos ou eventos. Estes dados são armazenados ou em um servidor groupware ou em arquivos locais. Onde exatamente depende do recurso que você está usando. Por exemplo, o recurso Contatos pessoais armazena os seus dados em $HOME/.local/share/contacts enquanto o recurso Arquivo VCard (cujo uso não se recomenda ) armazena os seus dados em $HOME/.kde/share/apps/kabc/std.vcf.

Os dados armazenados em cache são cópias dos dados reais que estão armazenados no banco de dados para um acesso mais rápido e uso sem conexão. O banco de dados também mantém os metadados que são informações de gerenciamento, necessários para que o Akonadi funcione corretamente.

Os dados de configuração são aqueles que configuram o servidor Akonadi e os recursos individuais. Os dados de configuração para o servidor podem ser encontrados em $HOME/.config/akonadi, e as configurações dos recursos são normalmente armazenados em $HOME/.kde/share/config/akonadi_xyz_resourcerc# (xyz é o nome do recurso e # seu número de instância).

As configurações do servidor Akonadi são alguns arquivos armazenados em $HOME/.config/akonadi - isto pode ser alterado através das variáveis, $XDG_DATA_HOME e $XDG_CONFIG_HOME, sendo seus valores predefinidos $HOME/.local/share e $HOME/.config respectivamente, se outros não forem definidos. Os arquivos contêm as fontes de dados e os programas de assistência ativos, que serão iniciados e monitorados (para que possam ser reiniciados em caso de um erro grave) por um dos processos do servidor Akonadi (akonadi_control). A pasta base local do KDE pode ser alterada com o uso da variável de ambiente $KDEHOME, sendo seu valor padrão $HOME/.kde (ou $HOME/.kde4 se o distribuidor alterou o valor padrão alterando o código).

Verifique com:

kde4-config --path data

Cada controlador de fontes de dados (chamadas de recursos) ou programas auxiliares (chamados agentes) pode ter sua própria configuração, embora alguns agentes ou recursos não necessitem de configuração. A regra geral é que para cada entrada no $HOME/.config/akonadi/agentsrc existe um arquivo de configuração correspondente em $HOME/.kde/share/config. Por exemplo, se a seção [Instances] no agentrc contiver uma entrada para o akonadi_ical_resource_2, existirá também um arquivo de configuração chamado akonadi_ical_resource_2rc no diretório de configuração do KDE.

Depending on the type of data, such config files for resources will have filenames or directory names of where the data is stored. Common locations are KDE's legacy default files, e.g. $HOME/.kde/share/apps/korganizer/std.ics. New default locations are files and directories in $HOME/.local/share, e.g. $HOME/.local/share/contacts.

For now (as in actually released versions) the database is merely used for caching and keeping structural information (e.g. which addressbook a contact belongs to). This will change when Akonadi is being used for email, since state information like read/unread is also stored there (unless the backend is also capable of doing this, e.g. IMAP).

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. From KDE 4.6 you will find it in System Settings -> Personal Information 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!

Troubleshooting

Problem: You update to 4.6 and your addressbook is suddenly completely blank

Solution: This is new behaviour in 4.6 - you can choose whether to display specific addressbooks or all of them. In front of each addressbook name there is a checkbox. Use that to enable the addressbooks you want to use.

Related pages

Akonadi
Akonadi Troubleshooting
KAddressBook