View source for Kontact Touch/Maemo5

<languages />
<translate>
== Installation and Update == <!--T:1--> 

=== Maemo 5 (e.g. Nokia N900) === <!--T:2--> 

==== Installation ==== <!--T:3--> 

<!--T:4-->
The [http://files.kolab.org/local/maemo/install/kdepim-testing.install repository installation file] will add the extras-devel and Kontact-Touch-testing repositories . Simply click that link on your N900 browser to add the necessary repositories.
{{Warning|To use the Kontact-Touch repository you will have to enable the http://wiki.maemo.org/Extras-devel repository. (The above link will do that.) Like all other beta software that has dependencies on extras-devel, we would like to remind you to not blindly update from -devel and recommend disabling extras-devel again after installing or updating Kontact Touch}}

<!--T:5-->
To verify the downloaded packages in this apt repository you should import the Intevation File Distribution Key into apt:
{{Input|1=gpg --keyserver hkp://keys.gnupg.net --recv-keys EC70B1B8
gpg --export EC70B1B8 {{!}} apt-key add -
}}

<!--T:6-->
The recommended way to install Kontact Touch on N900 is to open a terminal and run
{{Input|1=
root
apt-get update
apt-get install kdepim-mobile
}}
after adding the [http://files.kolab.org/local/maemo/install/kdepim-testing.install testing repository] (be sure you have good and affordable internet access when doing so).

<!--T:7-->
To get root access on your device see [http://wiki.maemo.org/Root_access]

<!--T:8-->
You can find some additional instructions on how to install different Kontact Touch repositories on the N900 in [http://files.kolab.org/local/maemo/README.html this README]

<!--T:9-->
For testing purposes you should always use the TESTING section. Do not use the other sections. We try to update the testing section about once a week.

==== Update ==== <!--T:10--> 

<!--T:11-->
Use the command line to update. (At the moment the update does not work via the N900 program manager, we believe it has some subtle problems.)

<!--T:12-->
Make sure to have the package '''rootsh''' installed, to be able to get administrator rights. Use the application '''X Terminal''' or a remote shell connection and enter the following to do the update

<!--T:13-->
{{Input|1=root
apt-get update
apt-get install kdepim-mobile
apt-get upgrade
}}

<!--T:14-->
(Technical background: 'apt-get upgrade' would not install new packages that kdepim-mobile might need. Only doing 'install kdepim-mobile' used to fail with some package sets because the dependencies were not tight enough. So it is better to do both 'install kdepim-mobile' and 'upgrade'.)

<!--T:15-->
Note that you have to reboot the N900 or manually restart several services like akonadiserver in order to profit from changes in these underlying services.
If you are testing, rebooting the phone before your next tests is strongly recommended.

==== Stop all Kontact Touch related processes ==== <!--T:16--> 

<!--T:17-->
We have included a small script that stops and shuts down all processes that might cost you resources even after you quit any KDE mobile application. Just open a console and, to be sure there are no resource eaters running, run

<!--T:18-->
{{Input|1=kdepim-shutdown
}}

<!--T:19-->
Alternatively you can restart your phone.

==== Deinstallation ==== <!--T:20--> 

<!--T:21-->
If installation happened only using the hildon application manager, you should be able to uninstall the same way. 

<!--T:22-->
When apt-get was used manually, you might have selected some additional packages for which you need apt-get to remove them again. Typically this will need

<!--T:23-->
{{Input|1=apt-get remove kdepim-mobile}}

<!--T:24-->
You could find the following helpful to remove all the KDE related stuff.

<!--T:25-->
{{Input|1=apt-get remove libkdecore5 kdelibs5-data kdebase-runtime-data
apt-get autoremove
}}

<!--T:26-->
Check what is installed by using {{Input|1=dpkg -l <nowiki>|</nowiki> grep kde}}. Everything that has an "ii" in the beginning of the line still is installed. Another attempt to see what is already installed from a KDE SC 4.x is {{Input|1=dpkg -l <nowiki>|</nowiki> grep -e "^.i.*4:4"}}.<br />
(Pay attention that other installations might use the KDE components, like libkok is used by freoffice.)

==== Clear the configuration ==== <!--T:27--> 

<!--T:28-->
If you want to start over or remove the configuration of the KDE components
completely, you need to deal with three places. ''First make sure that no kdepim related application is running anymore!'' Here are a number of commands to move the old files into a new backup directory 'dot.kde-20100728'. 

<!--T:29-->
{{Input|1=cd
d=dot.kde-20100728
mkdir $d $d/dot.config 
mv .config/akonadi $d/dot.config
mkdir -p $d/dot.local/share
mv .local/share/akonadi $d/dot.local/share
mv .kde $d
}}

<!--T:30-->
Also, some resources (like unsent mails) can be found at ~/.local/share/local-mail, ~/.local/share/contacts, ~/.local/share/notes and ~/.local/share/.local-mail.directory .

<!--T:31-->
There is one step that you might have to do after moving away (or deleting) the .kde directory. Some packages create a preset kdewallet.kwl file for the 'user', which you need to recreate. The script doing so usually can be rightfully called so by the user:

<!--T:32-->
{{Input|1=/var/lib/dpkg/info/kdebase-runtime.postinst
}}
It basically does:
{{Output|1=mkdir -p /home/user/.kde/share/apps/kwallet
cp /usr/share/kde4/apps/kwallet/kdewallet.kwl /home/user/.kde/share/apps/kwallet
}}

==== Language ==== <!--T:33--> 

<!--T:34-->
If you want to test a localized version, issue

<!--T:35-->
{{Input|1=root
apt-get update
apt-get install kde-l10n-de
apt-get upgrade
}}

<!--T:36-->
The above snippet will install the German (-de) translation.  Remove the "-de" for English, and substitute a language code for any other language.

== Get encryption working == <!--T:37--> 

<!--T:38-->
There is a touch version of '''kleopatra''', if the package is not installed by the dependencies,
install it. You can use it to import your certificates or you just use Gnupg like you would 
on other GNU systems on the command line.

<!--T:39-->
You might need to check the permissions and the owner on the .gnupg folder, it seems
that there are some conditions where this folder belongs to root. For crypto to work
as a user, the user will need to be able to write the files in the folder.

<!--T:40-->
Alternatively: Assuming you have all your keys together on your computer, you can find them most likely in ~/.gnupg. Please copy this folder to your N900, by simply connecting it via USB with your computer and copying the folder (Note: you might need to change some settings to be able to see hidden files. In '''Dolphin''' this would be <keycap>Alt + . </keycap>). Now disconnect your N900.

<!--T:41-->
If you already have a .gnupg folder on your phone, consider making a backup or deleting it before you do next steps. 

<!--T:42-->
Close all '''Kontact''' mobile applications. Open '''X Terminal''' on the N900. If you copied the .gnupg to the root folder of your MemoryCard on your N900 (Default Name: 'MyDocs') the following commands in X Terminal will do the job for you:

<!--T:43-->
{{Input|1=mv MyDocs/.gnupg ~/.gnupg
chmod 700 ~/.gnupg
}}

<!--T:44-->
Now you should be able to read and write signed and encrypted messages.

</translate><span id="General Hints"></span><translate>

== General Hints == <!--T:45--> 

<!--T:46-->
* If an application hangs you can press <keycap>ctl(sym) + backspace (upper left and upper right button)</keycap> simultaneously to get back to the application overview.
* To enter special symbols like < > or | you can push the arrow symbol in the upper left corner and then the ctl(sym) to get a symbol table.
* To make a screenshot, press <keycap>Ctrl + Shift + P</keycap>. The screenshot(s) will be saved in /home/user/MyDocs/.images .
* If you like to start the applications from the command line, you need to use the wrapper scripts, as long as qt-experimental is used, to set the right LD_LIBRARY_PATH, e.g. kmail-mobile.sh, korganiser-mobile.sh, kaddressbook-mobile.sh.

<!--T:47-->
[[Category:Internet]]
</translate>