Akonadi and AddressBook/id: Difference between revisions

From KDE Wiki Sandbox
(Created page with '==Beberapa Definisi==')
(Updating to match new version of source page)
 
(26 intermediate revisions by 2 users not shown)
Line 1: Line 1:
<languages />
<languages />
{{Note|This article also apply to other applications that are using [[Special:myLanguage/Akonadi|Akonadi]] for example KMail and KOrganizer.}}


''Informasi ini diberikan oleh Tobias Koenig, pengembang software '''KDE-PIM'''.''
''Informasi ini diberikan oleh Tobias Koenig, pengembang software '''KDE-PIM'''.''
Line 5: Line 7:
==Beberapa Definisi==
==Beberapa Definisi==


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|16px]]) stores its data under $HOME/.kde/share/apps/kabc/std.vcf.
Yang dimaksud dengan ''real data'' adalah data seperti yang ada dalam kontak atau peristiwa. Data ini disimpan di server groupware atau dalam file lokal. Di mana data tersebut benar-benar tersimpan tergantung kepada sumber daya/resource yang Anda gunakan. Misalnya, "Personal Contacts" menyimpan datanya di $HOME/.local/share/contacts sedangkan "VCard File" (harap jangan digunakan [[Image:Face-smile.png|16px]]) menyimpan datanya di $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.
"Cache data" adalah copy dari data yang sesungguhnya yang disimpan di database agar mudah akses dan di-cache secara offline. Database ini juga menyimpan "meta data" yaitu data manajemen yang diperlukan oleh '''Akonadi''' agar mampu berkerja dengan baik.


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).
"Data konfigurasi" adalah data yang melakukan konfigurasi terhadap server '''Akonadi''' dan resource individual. Data konfigurasi untuk server ada di $HOME/.config/akonadi, sedangkan data konfigurasi untuk resource biasanya disimpan di $HOME/.kde/share/config/akonadi_xyz_resourcerc# ('''''xyz''''' adalah nama dari resource tersebut dan '''''#''''' adalah contoh nomornya).


==Organising Backups==
The '''Akonadi''' server configuration is a couple of files in ''$HOME/.config/akonadi'' - this can be changed through environment variables, $XDG_DATA_HOME and $XDG_CONFIG_HOME, defaulting to ''$HOME/.local/share'' and ''$HOME/.config'' respectively if not set.  It contains which data sources and helper programs are active and will be started and watched (so they can be restarted on crashes) by one of '''Akonadi's''' server processes '''(akonadi_control)'''.  KDE's local base directory can be changed using $KDEHOME environment variable, defaulting to $HOME/.kde when not set (or to $HOME/.kde4 if the distributor changed the default by patching the code).
See {{Input|1=kde4-config --path data}}


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.
Each data source handler (called resources) or helper program (called agents)
can have its own configuration although some agents or resources don't require configuration. The general rule is that for every entry in $HOME/.config/akonadi/agentsrc there is a corresponding configuration file in $HOME/.kde/share/config.  For example, if the [Instances] section in agentrc contains an entry for akonadi_ical_resource_2, there is also a config file called akonadi_ical_resource_2rc in the KDE config directory.


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).
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.


==Examining your Resources==
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).


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


''Address Book'' - No KDE address book plugin configured yet.
Kita harus memutuskan apa yang ingin kita backup. Jika kita ingin membackup "real data" maka tergantung kepada resource yang sudah dikonfigurasi...jika Anda menggunakan server groupware, maka backup akan dilakukan di server tersebut. Dalam hal kontak, maka file yang akan menarik perhatian Anda adalah $HOME/.local/share/contacts.


That's the old compatibility bridge (possibly created by the migrator tool).
Icon '''Akonadi''' di system tray memberikan kita fungsi backup dan restore yang kita butuhkan. Backup ini hanya akan terdiri dari "cache data" yang mungkin tidak mencakup keseluruhan dari data Anda! Jika Anda benar-benar ingin membackup sebuah sistem secara 1:1, Anda harus mengcopy data cache beserta "real data" dan konfigurasinya, sehingga dengan demikian Anda tidak perlu memuat data dari sumbernya lagi (mislanya dari server groupware).
You should remove this one!
<span id="Examining your Resources"></span>
==Memeriksa Resource==
 
'''KRunner''' offers you '''Akonadi Resource Configuration''', or you can access this through the <menuchoice>Akonadi tray icon -> Configure</menuchoice>.  From KDE 4.6 you will find it in <menuchoice>System Settings -> Personal Information</menuchoice>  You may find several resources set up.  You may find one labelled
 
''Buku Alamat'' - Belum ada plugin buku alamat KDE yang dikonfigurasi.
 
Ini adalah sekedar fitur penyambung kompatibilitas (yang dibuat oleh alat bantu migrasi). Anda harus menghapusnya!


''std.vcf'' - Ready
''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'''.
Ini adalah ''VCard File Resource'' yang secara default merujuk ke  $HOME/.kde/share/apps/kabc/std.vcf. Harap Anda jangan menggunakan ini karena tidak memanfaatkan keunggulan '''Akonadi'''.


''Personal Contacts'' - Offline
''Personal Contacts'' - Offline


That's the preferred resource for your local contacts which points to
Ini adalah resource yang dianjurkan ketika menseting rujukan kontak lokal Anda.
::{{Output|1=$HOME/.local/share/contacts}}
{{Output|1=$HOME/.local/share/contacts}}


<!--T:17-->
<!--T:17-->
Note that this may say "Offline" when in fact you are using itThis is a display bug, and can safely be ignored.
Harap diperhatikan bahwa akan tampil status "offline" padahal Anda sedang menggunakannnya. Ini hanyalah sebuah 'bug' di tampilan dan aman bila diabaikan.
 
==Apabila resource lain menggunakan '''Akonadi'''?==
 
Apabila semua resource berimigrasi ke '''Akonadi''', apakah semua data akan disimpan di ~/.local/share? Kalau demikian, membackup akan menjadi sangat mudah. Kontak dan email sudah menyimpan datanya di folder tersebut tetapi saya tidak tahu bagaimana rencana selanjutnya untuk fitur events/todos tetapi akan sangat logis jika data juga disimpan di folder tersebut. Kami akan mengingat ini jika diskusi mengenai hal ini muncul kembali!
 
==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 themIn front of each addressbook name there is a checkbox.  Use that to enable the addressbooks you want to use.


==And when more components use '''Akonadi'''?==
== Related pages ==


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!
:[[Special:myLanguage/Akonadi|Akonadi]]<br />
:[[Special:myLanguage/KAddressBook/index|KAddressBook]]


[[Category:System]]
[[Category:Sistem/id]]

Latest revision as of 11:00, 19 January 2019

Note
This article also apply to other applications that are using Akonadi for example KMail and KOrganizer.


Informasi ini diberikan oleh Tobias Koenig, pengembang software KDE-PIM.

Beberapa Definisi

Yang dimaksud dengan real data adalah data seperti yang ada dalam kontak atau peristiwa. Data ini disimpan di server groupware atau dalam file lokal. Di mana data tersebut benar-benar tersimpan tergantung kepada sumber daya/resource yang Anda gunakan. Misalnya, "Personal Contacts" menyimpan datanya di $HOME/.local/share/contacts sedangkan "VCard File" (harap jangan digunakan ) menyimpan datanya di $HOME/.kde/share/apps/kabc/std.vcf.

"Cache data" adalah copy dari data yang sesungguhnya yang disimpan di database agar mudah akses dan di-cache secara offline. Database ini juga menyimpan "meta data" yaitu data manajemen yang diperlukan oleh Akonadi agar mampu berkerja dengan baik.

"Data konfigurasi" adalah data yang melakukan konfigurasi terhadap server Akonadi dan resource individual. Data konfigurasi untuk server ada di $HOME/.config/akonadi, sedangkan data konfigurasi untuk resource biasanya disimpan di $HOME/.kde/share/config/akonadi_xyz_resourcerc# (xyz adalah nama dari resource tersebut dan # adalah contoh nomornya).

The Akonadi server configuration is a couple of files in $HOME/.config/akonadi - this can be changed through environment variables, $XDG_DATA_HOME and $XDG_CONFIG_HOME, defaulting to $HOME/.local/share and $HOME/.config respectively if not set. It contains which data sources and helper programs are active and will be started and watched (so they can be restarted on crashes) by one of Akonadi's server processes (akonadi_control). KDE's local base directory can be changed using $KDEHOME environment variable, defaulting to $HOME/.kde when not set (or to $HOME/.kde4 if the distributor changed the default by patching the code).

See

kde4-config --path data

Each data source handler (called resources) or helper program (called agents) can have its own configuration although some agents or resources don't require configuration. The general rule is that for every entry in $HOME/.config/akonadi/agentsrc there is a corresponding configuration file in $HOME/.kde/share/config. For example, if the [Instances] section in agentrc contains an entry for akonadi_ical_resource_2, there is also a config file called akonadi_ical_resource_2rc in the KDE config directory.

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).

Mengatur Backup

Kita harus memutuskan apa yang ingin kita backup. Jika kita ingin membackup "real data" maka tergantung kepada resource yang sudah dikonfigurasi...jika Anda menggunakan server groupware, maka backup akan dilakukan di server tersebut. Dalam hal kontak, maka file yang akan menarik perhatian Anda adalah $HOME/.local/share/contacts.

Icon Akonadi di system tray memberikan kita fungsi backup dan restore yang kita butuhkan. Backup ini hanya akan terdiri dari "cache data" yang mungkin tidak mencakup keseluruhan dari data Anda! Jika Anda benar-benar ingin membackup sebuah sistem secara 1:1, Anda harus mengcopy data cache beserta "real data" dan konfigurasinya, sehingga dengan demikian Anda tidak perlu memuat data dari sumbernya lagi (mislanya dari server groupware).

Memeriksa Resource

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

Buku Alamat - Belum ada plugin buku alamat KDE yang dikonfigurasi.

Ini adalah sekedar fitur penyambung kompatibilitas (yang dibuat oleh alat bantu migrasi). Anda harus menghapusnya!

std.vcf - Ready

Ini adalah VCard File Resource yang secara default merujuk ke $HOME/.kde/share/apps/kabc/std.vcf. Harap Anda jangan menggunakan ini karena tidak memanfaatkan keunggulan Akonadi.

Personal Contacts - Offline

Ini adalah resource yang dianjurkan ketika menseting rujukan kontak lokal Anda.

$HOME/.local/share/contacts

Harap diperhatikan bahwa akan tampil status "offline" padahal Anda sedang menggunakannnya. Ini hanyalah sebuah 'bug' di tampilan dan aman bila diabaikan.

Apabila resource lain menggunakan Akonadi?

Apabila semua resource berimigrasi ke Akonadi, apakah semua data akan disimpan di ~/.local/share? Kalau demikian, membackup akan menjadi sangat mudah. Kontak dan email sudah menyimpan datanya di folder tersebut tetapi saya tidak tahu bagaimana rencana selanjutnya untuk fitur events/todos tetapi akan sangat logis jika data juga disimpan di folder tersebut. Kami akan mengingat ini jika diskusi mengenai hal ini muncul kembali!

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
KAddressBook