Kontact Touch/Harmattan/en: Difference between revisions

    From KDE UserBase Wiki
    (Updating to match new version of source page)
     
    (Updating to match new version of source page)
     
    (16 intermediate revisions by the same user not shown)
    Line 2: Line 2:
    == Introduction ==
    == Introduction ==


    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.  
    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 ==


    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.
    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 ===
    Line 12: Line 12:
    {{Note|1=This step is not really necessary since you can also do everything directly on the terminal of your device.}}
    {{Note|1=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.
    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 ===
    === Repositories ===


    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):


    {{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>}}


    Line 28: Line 27:


    {{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|1=When using a non-English version of apt, the continue question still needs a <code>y</code> as an answer to move on.}}


    {{Note|1=If you get an error like:
    {{Note|1=If you get an error like:
    Line 36: Line 38:
    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.}}
    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.}}


    ''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:
    === Use "MyDocs" as Cache ===
            Explanation: Dont update platform packages
     
            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
    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:


    === Known problems (Version 20111120) ===
    make sure that akonadi is disabled (<code>akonadictl stop</code> / <code>akonadictl status</code>)


    Installation with the community repository is problematic as the kontact touch packages were
    As root do (Please check after each step if it worked correctly and not copy/paste everything):
    built with a newer libgpgme then the one that is available from Nokia which causes conflicts
    with the mp-harmattan-pr package. To resolve those you have to uninstall the mp-harmattan-pr meta
    package (do not do an apt-get autormove afterwards!)


    The Strigi deamon fails to start putting up an error message now and then and causing
    {{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>}}
     
    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 <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 ===
     
    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.
     
    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.
    address completion and full text search not to work.


    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 ====
     
    You need to execute
     
    {{Input|1=<nowiki>
    export LD_LIBRARY_PATH=/opt/libgpg-error/lib:/opt/libgcrypt/lib</nowiki>}}
     
    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 [[Special:myLanguage/KDE_Wallet_Manager|KWallet]] in the account setup section.


    [[Category:Internet]]
    [[Category:Internet]]
    [[Category:Office]]
    [[Category:Office]]

    Latest revision as of 19:03, 10 July 2012

    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)