Kontact Touch/Harmattan: Difference between revisions

Latest revision as of 19:03, 10 July 2012

Other languages:

Introduction

There are some packages of Kontact Touch for MeeGo 1.2 Harmattan. This is the operating system of the Nokia N9 (and N950) smartphones.

Installation

To install the packages you have to switch your phone into developer mode, since the packages are not yet available in the Application Store (reachable via Settings -> Security -> Developer Mode). This will also install an ssh server on your device which makes the rest of the installation much more comfortable.

Configure SSH

Note

This step is not really necessary since you can also do everything directly on the terminal of your device.

To connect to your ssh server you first have to set a password for the "user" account. To do that open the Terminal application and use devel-su to log in as root (default root password is rootme) and set the password for the user by calling passwd user. Now you are able to connect to your device as user and configure the OpenSSH server as usual.

Repositories

Kontact Touch packages need the nokia development repositories and the files.kolab.org repo (which contains the packages) so that all dependencies can be installed. To enable them (as root):

echo "deb http://harmattan-dev.nokia.com/ harmattan/sdk free non-free
deb https://files.kolab.org/local/maemo/dists/harmattan ./" >> /etc/apt/sources.list.d/community.list

Installation with apt-get

To install the most recent version of Kontact Touch you can then call:

curl https://ssl.intevation.de/Intevation-Distribution-Key.asc | apt-key add -
apt-get update
apt-get install kdepim-mobile

Note

When using a non-English version of apt, the continue question still needs a y as an answer to move on.

Note

If you get an error like:

https://downloads.maemo.nokia.com ./ libgmp3c2 2:4.3.2+dfsg-1+maemo5+0m6
The requested URL returned error: 404

You can get the the package here and install it manually with dpkg -i. The link to this package appears to be broken in the Nokia repository.

Use "MyDocs" as Cache

Warning

When syncing an significant amount of data and you are not absolutely sure it will fit in your home directory, you must move the cache off the home directory partition to MyDocs! Consider three times the size of your complete imap account contents. If you fill up the root partition an N9 defect might make your device unbootable and in need of reflashing.

You can symlink the akonadi directory (/home/user/.local/share/akonadi) to somewhere where you have enough space available. MyDocs usually has more space available, see the following steps:

make sure that akonadi is disabled (akonadictl stop / akonadictl status)

As root do (Please check after each step if it worked correctly and not copy/paste everything):

cp -r /home/user/.local/share/akonadi /home/user/MyDocs/akonadi

Now as user

rm -rf /home/user/.local/share/akonadi
ln -s /home/user/MyDocs/akonadi /home/user/.local/share/akonadi
echo -e "[Connection]\nSocketDirectory=/home/user" >> /home/user/.config/akonadi/akonadiserverrc

The configuration change of the socket directory is necessary because MyDocs is by default a vfat that does not support akonadi's way of symlinking it's socket in the .local directory.

When starting with an empty akonadi database, it is recommened to raise the threshold value which determines when an object will be saved as flat file. Therefore less files get saved to /home/user/.local/share/akonadi/file_db_data/. This avoids hitting the Mydocs-partition limitation on the number of 32764 files per directory too early. You can do this to add the following line to the "General" section of /home/user/.config/akonadi/akonadiserverrc with an editor. You can choose any value, the default is 4096. Make sure akonadi is stopped.

SizeThreshold=8192

Additional Notes

Make sure to check out the general Kontact Touch page, especially note the recommendation to use KWallet in the account setup section.

With some of the platform integration missing, you may get dialogs which are hard to use just with the touch screen because they are too small to hit with your fingers. Especially some of the settings are hard to reach. Consider using the VNC mode, which you can enable in the SDK setting of the N9. This way you can type and use a mouse from a desktop system.

Known problems (Version 20120522)

The Strigi daemon fails to start putting up an error message now and then and causing address completion and full text search not to work.

The icons might be just some strange red squares until you restart.

Command line use of GnuPG

You need to execute

export LD_LIBRARY_PATH=/opt/libgpg-error/lib:/opt/libgcrypt/lib

Before you can use gnupg (or use gnupg as crypto backend in kmail / kleopatra)

@@ Line 4: / Line 4: @@
 <!--T:2-->
 There are some packages of [[Special:myLanguage/Kontact_Touch|Kontact Touch]] for MeeGo 1.2 Harmattan. This is the operating system of the Nokia N9 (and N950) smartphones.
 == Installation == <!--T:3-->
@@ Line 22: / Line 22: @@
 <!--T:9-->
-Kontact Touch packages need three repositories so that all dependencies can be installed. To enable them (as root):
+Kontact Touch packages need the nokia development repositories and the files.kolab.org repo (which contains the packages) so that all dependencies can be installed. To enable them (as root):
 <!--T:10-->
 {{Input|1=<nowiki>
-echo "deb http://repo.pub.meego.com/home:/rzr:/harmattan/MeeGo_1.2_Harmattan_Maemo.org_MeeGo_1.2_Harmattan_standard/ ./
+echo "deb http://harmattan-dev.nokia.com/ harmattan/sdk free non-free
-deb http://harmattan-dev.nokia.com/ harmattan/sdk free non-free
 deb https://files.kolab.org/local/maemo/dists/harmattan ./" >> /etc/apt/sources.list.d/community.list</nowiki>}}
@@ Line 37: / Line 36: @@
 <!--T:13-->
 {{Input|1=<nowiki>
+curl https://ssl.intevation.de/Intevation-Distribution-Key.asc | apt-key add -
 apt-get update
 apt-get install kdepim-mobile</nowiki>}}
+<!--T:30-->
+{{Note|1=When using a non-English version of apt, the continue question still needs a <code>y</code> as an answer to move on.}}
 <!--T:14-->
@@ Line 46: / Line 49: @@
 You can get the the package [http://harmattan-dev.nokia.com/pool/harmattan-beta/free/g/gmp/ here] and install it manually with <code>dpkg -i</code>. The link to this package appears to be broken in the Nokia repository.}}
-<!--T:15-->
+=== Use "MyDocs" as Cache === <!--T:36-->
-''Note:'' With the Harmattan Beta 2 image you might also get conflicts with packages having more recent versions in the community repository then on the platform. This can cause conflicts with the mp-harmattan package. To avoid those you can pin down the community repo by creating the file /etc/apt/preferences with the content:
-        Explanation: Dont update platform packages
+<!--T:25-->
-        Package: *
+{{Warning|When syncing an significant amount of data and you are not absolutely sure it will fit in your home directory, you must move the cache off the home directory partition to MyDocs! Consider three times the size of your complete imap account contents. If you fill up the root partition an N9 defect might make your device unbootable and in need of reflashing.}}
-        Pin: origin repo.pub.meego.com
-        Pin-Priority: 99
+<!--T:28-->
+You can symlink the akonadi directory (<tt>/home/user/.local/share/akonadi</tt>) to somewhere where you have enough space available. MyDocs usually has more space available, see the following
+steps:
+<!--T:26-->
+make sure that akonadi is disabled (<code>akonadictl stop</code> / <code>akonadictl status</code>)
+<!--T:27-->
+As root do (Please check after each step if it worked correctly and not copy/paste everything):
+<!--T:29-->
+{{Input|1=<nowiki>
+cp -r /home/user/.local/share/akonadi /home/user/MyDocs/akonadi
+</nowiki>}}
+Now as user
+{{Input|1=<nowiki>
+rm -rf /home/user/.local/share/akonadi
+ln -s /home/user/MyDocs/akonadi /home/user/.local/share/akonadi
+echo -e "[Connection]\nSocketDirectory=/home/user" >> /home/user/.config/akonadi/akonadiserverrc
+</nowiki>}}
+<!--T:31-->
+The configuration change of the socket directory is necessary because MyDocs is by default a vfat that does
+not support akonadi's way of symlinking it's socket in the .local directory.
-=== Known problems (Version 20111120) === <!--T:16-->
+<!--T:37-->
+When starting with an empty akonadi database, it is recommened to raise the threshold value
+which determines when an object will be saved as flat file. Therefore less files get saved to <tt>/home/user/.local/share/akonadi/file_db_data/</tt>. This avoids hitting the Mydocs-partition limitation on the number of 32764 files per directory too early. You can do this to add the following line to the "General" section of <tt>/home/user/.config/akonadi/akonadiserverrc</tt> with an editor. You can choose any value, the default is 4096. Make sure akonadi is stopped.
+{{Input|1=<nowiki>
+SizeThreshold=8192
+</nowiki>}}
-<!--T:17-->
+=== Additional Notes === <!--T:20-->
-Installation with the community repository is problematic as the kontact touch packages were
-built with a newer libgpgme then the one that is available from Nokia which causes conflicts
+<!--T:21-->
-with the mp-harmattan-pr package. To resolve those you have to uninstall the mp-harmattan-pr meta
+Make sure to check out the [[Special:myLanguage/Kontact Touch|general Kontact Touch page]], especially note the recommendation to use [[Special:myLanguage/KDE_Wallet_Manager|KWallet]] in the account setup section.
-package (do not do an apt-get autormove afterwards!)
+<!--T:38-->
+With some of the platform integration missing, you may get dialogs which are hard to use just with
+the touch screen because they are too small to hit with your fingers. Especially some of the settings are hard to reach. Consider using the VNC mode, which you can enable in the SDK setting of the N9. This way you can type and use a mouse from a desktop system.
+=== Known problems (Version 20120522) === <!--T:16-->
 <!--T:18-->
-The Strigi deamon fails to start putting up an error message now and then and causing
+The Strigi daemon fails to start putting up an error message now and then and causing
 address completion and full text search not to work.
@@ Line 68: / Line 104: @@
 The icons might be just some strange red squares until you restart.
-=== Additional Notes === <!--T:20-->
+==== Command line use of GnuPG ==== <!--T:32-->
+<!--T:33-->
+You need to execute
+<!--T:34-->
+{{Input|1=<nowiki>
+export LD_LIBRARY_PATH=/opt/libgpg-error/lib:/opt/libgcrypt/lib</nowiki>}}
+<!--T:35-->
+Before you can use gnupg (or use gnupg as crypto backend in kmail / kleopatra)
-<!--T:21-->
-Make sure to check out the [[Special:myLanguage/Kontact Touch|general Kontact Touch page]], especially note the recommendation to use [[Special:myLanguage/KDE_Wallet_Manager|KWallet]] in the account setup section.
 <!--T:22-->