Kontact Touch/Harmattan: Difference between revisions

From KDE UserBase Wiki
(Add a first rough installation guide for harmattan)
 
m (formatting changes)
 
(44 intermediate revisions by 5 users not shown)
Line 1: Line 1:
== Introduction ==
<languages/>
There are some packages of [[Special:myLanguage/Kontact_Touch|Kontact Touch]] for ''MeeGoi 1.2
<translate>
Harmattan''. This is the operating system of the Nokia N9 (and N950) Smartphones.
== Introduction == <!--T:1-->


== Installation ==
<!--T:2-->
To install the packages you have to switch your phone into developer mode, since the
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.
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 ===
== Installation == <!--T:3-->
'''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.
<!--T:4-->
To do that open the Terminal application and use ''devel-su'' to log in as root
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.
(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 ===
=== Configure SSH === <!--T:5-->
Kontact Touch packages need three repositories so that all dependencies can be
 
installed. To enable them (as root):
<!--T:6-->
{{Note|1=This step is not really necessary since you can also do everything directly on the terminal of your device.}}
 
<!--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.
 
=== 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>
{{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>}}
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:
To install the most recent version of Kontact Touch you can then call:
<!--T:13-->
{{Input|1=<nowiki>
{{Input|1=<nowiki>
curl https://ssl.intevation.de/Intevation-Distribution-Key.asc | apt-key add -
apt-get update
apt-get update
apt-get install kdepim-mobile</nowiki>}}
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/
<!--T:14-->
and install it manually with dpkg -i
{{Note|1=If you get an error like:
The link to this package appears to be broken in the nokia repository.
{{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-->
 
<!--T:25-->
{{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>)


''Note:'' With the Harmattan Beta 2 image you might also get conflicts with packages having more
<!--T:27-->
recent versions in the community repository then on the platform. This can cause conflicts
As root do (Please check after each step if it worked correctly and not copy/paste everything):
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:29-->
        Explanation: Dont update platform packages
{{Input|1=<nowiki>
        Package: *
cp -r /home/user/.local/share/akonadi /home/user/MyDocs/akonadi
        Pin: origin repo.pub.meego.com
</nowiki>}}
        Pin-Priority: 99
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>}}


=== Known problems ===
<!--T:31-->
The packages are not well adopted (most not at all) to the harmattan security model.
The configuration change of the socket directory is necessary because MyDocs is by default a vfat that does
The configuration of kdebase-runtime and strigi fails because
not support akonadi's way of symlinking it's socket in the .local directory.
it tries to create the home directories for strigi and kde
to work around this create (as user) a symlink from MyDocs.


<!--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>
{{Input|1=<nowiki>
mkdir /home/MyDocs/.kde
SizeThreshold=8192
mkdir /home/MyDocs/.strigi
</nowiki>}}
ln -s /home/MyDocs/.strigi /home/user/.strigi
ln -s /home/MyDocs/.kde /home/user/.kde</nowiki>}}


Some more configuration steps might fail. Most (chgrp / chown)
=== Additional Notes === <!--T:20-->
can be ignored when you just run the configuration again.


There is also a bad patch in the kdelibs package 4.7+20111016.674ebb6964fa48afb45d8e401e4699bbaa87e6be-1maemo6.7
<!--T:21-->
changing the font sizes to monospace.
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.


To wokaround that put this in your kdeglobals:
<!--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.


        [General]
=== Known problems (Version 20120522) === <!--T:16-->
        fixed=Monospace,16,-1,5,50,0,0,0,0,0
        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: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.
The icons might be just some strange red squares until you restart.


=== Additional Notes ===  
==== Command line use of GnuPG ==== <!--T:32-->
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: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:22-->
[[Category:Internet]]
[[Category:Office]]
</translate>

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)