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 1: / Line 1: @@
 <languages/>
 <translate>
-== Introduction ==
+== Introduction == <!--T:1-->
-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.
+<!--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 ==
+== Installation == <!--T:3-->
-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 <menuchoice>Settings -> Security -> Developer Mode</menuchoice>) This will also install an ssh server on your device which makes the rest of the installation much more comfortable.
+<!--T:4-->
+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 <menuchoice>Settings -> Security -> Developer Mode</menuchoice>). This will also install an ssh server on your device which makes the rest of the installation much more comfortable.
-=== Configure SSH ===
+=== Configure SSH === <!--T:5-->
-'''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.
+<!--T:6-->
+{{Note|1=This step is not really necessary since you can also do everything directly on the terminal of your device.}}
-=== Repositories ===
+<!--T:7-->
+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 <code>devel-su</code> to log in as root (default root password is rootme) and set the password for the user by calling <code>passwd user</code>. Now you are able to connect to your device as user and configure the OpenSSH server as usual.
-Kontact Touch packages need three repositories so that all dependencies can be installed. To enable them (as root):
+=== Repositories === <!--T:8-->
+<!--T:9-->
+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>}}
-=== Installation with apt-get ===
+=== Installation with apt-get === <!--T:11-->
+<!--T:12-->
 To install the most recent version of Kontact Touch you can then call:
+<!--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>}}
-''Note:'' If you get an error like:
+<!--T:30-->
-https://downloads.maemo.nokia.com ./ libgmp3c2 2:4.3.2+dfsg-1+maemo5+0m6   The requested URL returned error: 404
+{{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.}}
-You can get the the package from: http://harmattan-dev.nokia.com/pool/harmattan-beta/free/g/gmp/
-and install it manually with <code>dpkg -i</code>. The link to this package appears to be broken in the Nokia repository.
+<!--T:14-->
+{{Note|1=If you get an error like:
+{{Output|1=<nowiki>https://downloads.maemo.nokia.com ./ libgmp3c2 2:4.3.2+dfsg-1+maemo5+0m6
+The requested URL returned error: 404</nowiki>}}
+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.}}
+=== 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:
+<!--T:25-->
-        Explanation: Dont update platform packages
+{{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.}}
-        Package: *
-        Pin: origin repo.pub.meego.com
-        Pin-Priority: 99
-=== Known problems ===
+<!--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:
-The packages are not well adopted (most not at all) to the harmattan security model. The configuration of kdebase-runtime and strigi fails because it tries to create the home directories for strigi and kde to work around this create (as user) a symlink from MyDocs.
+<!--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>
-mkdir /home/MyDocs/.kde
+cp -r /home/user/.local/share/akonadi /home/user/MyDocs/akonadi
-mkdir /home/MyDocs/.strigi
+</nowiki>}}
-ln -s /home/MyDocs/.strigi /home/user/.strigi
+Now as user
-ln -s /home/MyDocs/.kde /home/user/.kde</nowiki>}}
+{{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>}}
-Some more configuration steps might fail. Most (chgrp / chown) can be ignored when you just run the configuration again.
+<!--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.
-There is also a bad patch in the kdelibs package 4.7+20111016.674ebb6964fa48afb45d8e401e4699bbaa87e6be-1maemo6.7
+<!--T:37-->
-changing the font sizes to monospace.
+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>}}
-To workaround that put this in your kdeglobals:
+=== Additional Notes === <!--T:20-->
-        [General]
+<!--T:21-->
-        fixed=Monospace,16,-1,5,50,0,0,0,0,0
+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.
-        font=Sans Serif,16,-1,5,50,0,0,0,0,0
-        menuFont=Sans Serif,16,-1,5,50,0,0,0,0,0
-        taskbarFont=Sans Serif,16,-1,5,50,0,0,0,0,0
-        toolBarFont=Sans Serif,16,-1,5,50,0,0,0,0,0
-        smallestReadableFont=Sans Serif,16,-1,5,50,0,0,0,0,0
+<!--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 daemon fails to start putting up an error message now and then and causing
+address completion and full text search not to work.
+<!--T:19-->
 The icons might be just some strange red squares until you restart.
-=== Additional Notes ===
+==== 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)
-Make sure to check out the [[Special:myLanguage/Kontact Touch|general Kontact Touch page]], especially note the recommendation to use '''KWallet''' in the account setup section.
+<!--T:22-->
 [[Category:Internet]]
 [[Category:Office]]
 </translate>