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 27: / Line 27: @@
 {{Input|1=<nowiki>
 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</nowiki>}}
+deb https://files.kolab.org/local/maemo/dists/harmattan ./" >> /etc/apt/sources.list.d/community.list</nowiki>}}
 === Installation with apt-get === <!--T:11-->
@@ Line 36: / 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 -o DPkg::Options::=--force-overwrite kdepim-mobile</nowiki>}}
+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 45: / 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.}}
-=== Known problems (Version 20120124) === <!--T:16-->
+=== Use "MyDocs" as Cache === <!--T:36-->
-<!--T:23-->
+<!--T:25-->
-The apt-get option -o DPkg::Options::=--force-overwrite is necessary to replace old versions of libgcrypt and libgpg-error on the phone. The packages can not be updated as they come from Nokia but they were not developed / optimized for mobile devices and Kontact also depends on functions that are not contained in those libraries. As the newer versions we provide are binary compatible the replace is harmless.
+{{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.}}
+<!--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.
+<!--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>}}
+=== Additional Notes === <!--T:20-->
+<!--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: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-->
@@ Line 57: / 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-->
-If you want to sync an account that is larger then your home directory for complete offline use you can symlink the akonadi directory ( /home/user/.local/share/akonadi ) to somewhere where you have enough space available.
+<!--T:33-->
+You need to execute
-As root do (Please check after each step if it worked correctly and not copy/paste everything):
+<!--T:34-->
 {{Input|1=<nowiki>
-cp -r /home/user/.local/share/akonadi /home/user/MyDocs/akonadi
+export LD_LIBRARY_PATH=/opt/libgpg-error/lib:/opt/libgcrypt/lib</nowiki>}}
-exit
-rm -rf /home/user/.local/share/akonadi
+<!--T:35-->
-ln -s /home/user/MyDocs/akonadi /home/user/.local/share/akonadi
+Before you can use gnupg (or use gnupg as crypto backend in kmail / kleopatra)
-</nowiki>}}
-<!--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-->