From 178be39704ed0a101c19a4064bdde4ac9f59c60a Mon Sep 17 00:00:00 2001 From: Ivan Alejandro Date: Fri, 30 Oct 2015 14:40:44 -0300 Subject: Update known issues text to be more clear/friendly --- pages/docs/client/known-issues.md | 124 +++++++++++++++++++------------------- 1 file changed, 62 insertions(+), 62 deletions(-) (limited to 'pages/docs/client') diff --git a/pages/docs/client/known-issues.md b/pages/docs/client/known-issues.md index b5f6edc..3e86b97 100644 --- a/pages/docs/client/known-issues.md +++ b/pages/docs/client/known-issues.md @@ -6,97 +6,97 @@ Here you can find documentation about known issues and potential work-arounds in the current Bitmask release. -No polkit agent available -------------------------- -To run Bitmask and the services correctly you need to have a running polkit -agent. If you don't have one you will get an error and won't be able to start -Bitmask. +Connection Errors +----------------- -The currently recognized polkit agents are: +You may get the error: “Unable to connect: Problem with provider”. This can +result from a problem with your network not the the provider. We are tracking +this issue here https://leap.se/code/issues/4023 and plan to have more specific +error notifications in the future. -| process name | Who uses it? | -|---------------------------------------|-----------------------------------| -| `polkit-gnome-authentication-agent-1` | Gnome | -| `polkit-kde-authentication-agent-1` | KDE | -| `polkit-mate-authentication-agent-1` | Mate | -| `lxpolkit` or `lxsession` | LXDE | -| `xfce-polkit` | XFCE | -| `gnome-shell` | Gnome shell | -| `fingerprint-polkit-agent` | the `fingerprint-gui` package | +Mail issues +----------- -If you have a different polkit agent running that it's not in that list, -please report a bug so we can include in our checks. +* If you have received a large amount of mails (testing with more than 400), +Thunderbird may not respond. This problem wont happen if you already had the +client open and Thunderbird loading mails at the same time. -You can get the list of running processes that match polkit with the following -command: `ps aux | grep -i polkit`. -Here is an example on my KDE desktop: +* Opening the same account from more than one computer at the same time might +possibly break your account. - ➜ ps aux | grep polkit - root 1392 0.0 0.0 298972 6120 ? Sl Sep22 0:02 /usr/lib/policykit-1/polkitd --no-debug - user 1702 0.0 0.0 12972 920 pts/16 S+ 16:42 0:00 grep polkit - user 3259 0.0 0.4 559764 38464 ? Sl Sep22 0:05 /usr/lib/kde4/libexec/polkit-kde-authentication-agent-1 +* You may get an error on Thunderbird about not being able to reach the IMAP +server. This happens during long syncs. +* If you have a big amount of emails and email traffic the syncs are +sometimes very slow. We are working on this. -Note that `polkitd` is not a valid agent, is just the daemon, you still need an -agent running. -Other Issues ------------- +Key generation too slow? +------------------------ -- You may get the error: "Unable to connect: Problem with provider" in - situations when the problem is the network instead of the provider. - See: https://leap.se/code/issues/4023 +When you create a new mail account, the key generation may take a while. It can +take up to 5mins, but be aware, on virtual machines it sometimes takes a very +long time. As long as a 40min!. The below tricks can reduce the time for +testers using virtual machines. -Mail issues -=========== +If you are just testing mail accounts and **are not worried about security** +you can use some tricks to generate the extra entropy needed to speed up the +process. -Note that email is not stable yet so this list may not be accurate. +1. Manually generate entropy by moving the mouse, type stuff, browse the internet and local files, etc. -- If you have received a big amount of mails (tested with more than 400), you - may experience that Thunderbird won't respond. +1. Use haveged -That problem does not happen if you have the client open and Thunderbird -loading mails while are reaching your inbox. + Install the haveged package, most likely is available through your distro's + package manager. + See: http://www.issihosts.com/haveged/ -- Opening the same account from more than one box at the same time will - possibly break your account. +1. Generate IO (may not work on SSDs) -- You may get an error on Thunderbird about not being able to reach the IMAP - server. This happens during long syncs. + find / -type f -print0 2>&1 | xargs -0 cat &> /dev/null -- If you have a big amount of emails and email traffic the syncs may be very - slow and your account will be most of the time syncing. +If you want more information you can take a look at: +https://leap.se/code/issues/4656 -Key generation too slow? ------------------------- +"No polkit agent available" Error +--------------------------------- -When you create a new mail account, the key generation may take a while. While -it is normal that takes approx. 5mins, on virtual machines sometimes takes a -very long time. As long as a 40min!. -Using one of this tricks/hacks that time can be reduced to <5min. +(For people using minimal distros/desktops like awesome/i3) -If you are just testing mail accounts and **do not worry about security** you can -use some tricks to generate the extra entropy needed to speed up the process. +To run Bitmask and the services correctly you need to have a running polkit +agent. If you don’t have one you will get an error and won’t be able to start +Bitmask. -1. Manually generate entropy +The currently recognized polkit agents are: - Move the mouse, type stuff, browse the internet and local files, etc. +| process name | Who uses it? | +|---------------------------------------|-----------------------------------| +| `polkit-gnome-authentication-agent-1` | Gnome | +| `polkit-kde-authentication-agent-1` | KDE | +| `polkit-mate-authentication-agent-1` | Mate | +| `lxpolkit` or `lxsession` | LXDE | +| `xfce-polkit` | XFCE | +| `gnome-shell` | Gnome shell | +| `fingerprint-polkit-agent` | the `fingerprint-gui` package | -1. Use haveged - Install the haveged package, most likely is available through your distro's - package manager. +If you have a different polkit agent running that it's not in that list, +please report a bug so we can include in our checks. - See: http://www.issihosts.com/haveged/ +You can get the list of running processes that match polkit with the following +command: `ps aux | grep -i polkit`. +Here is an example on my KDE desktop: -1. Generate IO (may not work on SSDs) + ➜ ps aux | grep polkit + root 1392 0.0 0.0 298972 6120 ? Sl Sep22 0:02 /usr/lib/policykit-1/polkitd --no-debug + user 1702 0.0 0.0 12972 920 pts/16 S+ 16:42 0:00 grep polkit + user 3259 0.0 0.4 559764 38464 ? Sl Sep22 0:05 /usr/lib/kde4/libexec/polkit-kde-authentication-agent-1 - find / -type f -print0 2>&1 | xargs -0 cat &> /dev/null -If you want more information you can take a look at: -https://leap.se/code/issues/4656 +Note that `polkitd` is not a valid agent, is just the daemon, you still need an +agent running. -- cgit v1.2.3