Merge remote-tracking branch 'origin/master'

README.md

@@ -1,17 +1,17 @@
 Linux Deploy
 ============
 
-Copyright (C) 2012-2016  Anton Skshidlevsky, [GPLv3](http://opensource.org/licenses/gpl-3.0.html)
+Copyright (C) 2012-2017  Anton Skshidlevsky, [GPLv3](http://opensource.org/licenses/gpl-3.0.html)
 
 This application is open source software for quick and easy installation of the operating system (OS) GNU/Linux on your Android device.
 
 The application creates a disk image on a flash card, mounts it and installs an OS distribution. Applications of the new system are run in a chroot environment and working together with the Android platform. All changes made on the device are reversible, i.e. the application and components can be removed completely. Installation of a distribution is done by downloading files from official mirrors online over the internet. The application requires superuser rights (ROOT).
 
 The program supports multi language interface. You can manage the process of installing the OS, and after installation, you can start and stop services of the new system (there is support for running your scripts) through the UI. The installation process is reported as text in the main application window. During the installation, the program will adjust the environment, which includes the base system, SSH server, VNC server and desktop environment. The program interface can also manage SSH and VNC settings.
 
-Installing a new operating system takes about 30 minutes. The recommended minimum size of a disk image is 1024 MB (with LXDE), and without a GUI - 512 MB. When you install Linux on the flash card with the FAT32 file system, the image size should not exceed 4095 MB! After the initial setup the default password for SSH and VNC is changeme. The password can be changed through standard OS tools.
+Installing a new operating system takes about 30 minutes. The recommended minimum size of a disk image is 1024 MB (with LXDE), and without a GUI - 512 MB. When you install Linux on the flash card with the FAT32 file system, the image size should not exceed 4095 MB! After the initial setup the password for SSH and VNC generated automatically. The password can be changed through "Properties -> User password" or standard OS tools (passwd, vncpasswd).
 
-#### Features: ####
+#### Features:
 * Supported distributions: Debian, Ubuntu, Kali Linux, Arch Linux, Fedora, CentOS, Gentoo, openSUSE, Slackware, RootFS (tgz, tbz2, txz)
 * Installation type: image file, directory, disk partition, RAM
 * Supported file systems: ext2, ext3, ext4
@@ -20,12 +20,25 @@ Installing a new operating system takes about 30 minutes. The recommended minimu
 * Desktop environment: XTerm, LXDE, Xfce, MATE, other (manual configuration)
 * Supported languages: multilingual interface
 
-#### Install ####
+#### Install
 You can install the app from:
 * GitHub: <https://github.com/meefik/linuxdeploy/releases>
 * Google Play: <https://play.google.com/store/apps/details?id=ru.meefik.linuxdeploy>
 
-#### Performance ####
+#### FAQ
+> Do not work update operating environment or errors appear in debug mode: "Permission denied", "Socket operation on non-socket" or other.
+
+Install compatible [BusyBox](https://github.com/meefik/busybox/releases) in /system/xbin, add path /system/xbin in "Settings -> PATH variable", update the operating environment "Settings -> Update ENV". Before upgrading the environment, it is desirable restart the device. After that, the container options must be selected "Properties -> File system -> Auto" and "Propetries -> Image size (MB) -> 2000", because "busybox mke2fs" is not supperted an option "-t" to specify type of file system and not supperted image greater 2 GB. Now you can start a new installation "Menu -> Install".
+
+> Making an image on sdcard return an error "Read-only file system".
+
+If you are using SuperSU utility you need to uncheck "mount namespace separation" in SuperSU settings. See [documentation](https://su.chainfire.eu/#how-mount).
+
+> Installing an application on Google Play fails with the message "Unknown error code during application installation: -24".
+
+You need to remove the application directory: /data/data/ru.meefik.linuxdeploy
+
+#### Performance
 SD card read / write speed (10 class) on Android (Samsung Galaxy S II) for file systems vfat, ext2, ext4:
 * **vfat**: read speed 14.1 MB/s; write speed 12.0 MB/s
 * **ext2**: read speed 14.9 MB/s; write speed 3.9 MB/s
@@ -41,8 +54,8 @@ Installation time and use space on disk (Debian wheezy/armhf on Samsung Galaxy S
 * **GNOME** ~ 0:55 / 1.3 GB
 * **KDE** ~ 1:20 / 1.3 GB
 
-#### Source code ####
+#### Source code
 Source code: <https://github.com/meefik/linuxdeploy>. The project is written using Android Studio.
 
-#### Donations ####
+#### Donations
 <http://meefik.github.io/donate>

README.ru.md

@@ -1,11 +1,11 @@
 Linux Deploy
 ============
 
-Copyright (C) 2012-2016  Антон Скшидлевский, [GPLv3](http://opensource.org/licenses/gpl-3.0.html)
+Copyright (C) 2012-2017  Антон Скшидлевский, [GPLv3](http://opensource.org/licenses/gpl-3.0.html)
 
-Это приложение с открытым исходным кодом, предназначенное для автоматизации процесса установки, конфигурирования и запуска GNU/Linux дистрибутивов на платформе Android внутри контейнера chroot. Приложение создает образ диска на карте памяти или ином носителе, монтирует его и устанавливает туда выбранный Linux-дистрибутив. Поддерживается установка в файл, прямо на раздел карты памяти, в директорию с файловой системой ext2/ext3/ext4 и в оперативную память. Приложения из Linux-дистрибутива запускаются в chroot окружении, работают параллельно с основной системой и сопоставимы с ней по скорости. Все вносимые изменения на устройстве обратимы, т.е. приложение и созданные им компоненты можно полностью удалить. Установка Linux-дистрибутива осуществляется по сети с официальных зеркал в интернете. Поскольку работа Linux Deploy базируется на системном вызове ядра Linux, то в роли "гостевых" систем могут выступать только дистрибутивы Linux. Через интерфейс программы можно управлять процессом установки Linux-дистрибутива, а после установки можно запускать и останавливать сервисы установленной системы (есть поддержка запуска собственных сценариев). Процесс установки отображается в виде текстовых отчетов в главном окне приложения. Во время установки программа сама настраивает рабочее окружение, которое включает в себя базовую систему, сервер SSH, сервер VNC и графическую среду на выбор. Также через интерфейс программы можно управлять параметрами серверов SSH и VNC. Установка Linux-дистрибутива занимает около 30 минут. Рекомендованный минимальный размер образа диска без графического интерфейса - 512 МБ, а с графическим интерфейсом - 1024 МБ (для LXDE). После начальной установки пароль для доступа по SSH и VNC назначается как "changeme", который можно сменить стандартными средствами дистрибутива, либо через параметры приложения.
+Это приложение с открытым исходным кодом, предназначенное для автоматизации процесса установки, конфигурирования и запуска GNU/Linux дистрибутивов на платформе Android внутри контейнера chroot. Приложение создает образ диска на карте памяти или ином носителе, монтирует его и устанавливает туда выбранный Linux-дистрибутив. Поддерживается установка в файл, прямо на раздел карты памяти, в директорию с файловой системой ext2/ext3/ext4 и в оперативную память. Приложения из Linux-дистрибутива запускаются в chroot окружении, работают параллельно с основной системой и сопоставимы с ней по скорости. Все вносимые изменения на устройстве обратимы, т.е. приложение и созданные им компоненты можно полностью удалить. Установка Linux-дистрибутива осуществляется по сети с официальных зеркал в интернете. Поскольку работа Linux Deploy базируется на системном вызове ядра Linux, то в роли "гостевых" систем могут выступать только дистрибутивы Linux. Через интерфейс программы можно управлять процессом установки Linux-дистрибутива, а после установки можно запускать и останавливать сервисы установленной системы (есть поддержка запуска собственных сценариев). Процесс установки отображается в виде текстовых отчетов в главном окне приложения. Во время установки программа сама настраивает рабочее окружение, которое включает в себя базовую систему, сервер SSH, сервер VNC и графическую среду на выбор. Также через интерфейс программы можно управлять параметрами серверов SSH и VNC. Установка Linux-дистрибутива занимает около 30 минут. Рекомендованный минимальный размер образа диска без графического интерфейса - 512 МБ, а с графическим интерфейсом - 1024 МБ (для LXDE). После начальной установки пароль для доступа по SSH и VNC пароль генерируется автоматически, который можно сменить через параметры приложения, либо стандартными средствами дистрибутива.
 
-#### Характеристики: ####
+#### Характеристики:
 * Поддерживаемые дистрибутивы: Debian, Ubuntu, Kali Linux, Arch Linux, Fedora, CentOS, Gentoo, openSUSE, Slackware, RootFS (tgz, tbz2, txz)
 * Тип установки: файл образа, директория, раздел диска, оперативная память
 * Поддерживаемые файловые системы: ext2, ext3, ext4
@@ -14,12 +14,25 @@ Copyright (C) 2012-2016  Антон Скшидлевский, [GPLv3](http://ope
 * Окружение рабочего стола: XTerm, LXDE, Xfce, MATE, другое (ручная настройка)
 * Поддерживаемые языки: мультиязычный интерфейс
 
-#### Установка ####
+#### Установка
 Вы можете установить это приложение из:
 * GitHub: <https://github.com/meefik/linuxdeploy/releases>
 * Google Play: <https://play.google.com/store/apps/details?id=ru.meefik.linuxdeploy>
 
-#### Производительность ####
+#### Известные проблемы и их решение
+> Не запускается обновление окружения или установка, в режиме отладки появляются ошибки "Permission denied", "Socket operation on non-socket" или другие.
+
+Установить совместимый [BusyBox](https://github.com/meefik/busybox/releases) в /system/xbin, добавить в "Настройки -> PATH" ("Settings -> PATH variable") путь /system/xbin, выполнить обновление окружения "Настройки -> Обновить окружение" ("Settings -> Update ENV"). Перед обновлением окружения желательно перезагрузить устройство. Затем в параметрах контейнера выбрать "Параметры -> Файловая система -> Автоопределение" ("Properties -> File system -> Auto") и "Параметры -> Размер образа (МБ) -> 2000" ("Propetries -> Image size (MB) -> 2000"), т.к. busybox mke2fs не поддерживает параметр "-t" для указания типа файловой системы и не поддерживает образы больше 2 ГБ. После этого можно запускать новую установку "Меню - Установить" ("Menu -> Install").
+
+> Не видит карту памяти, при установке в режиме отладки появляется ошибка "Read-only file system", создание образа на карте памяти заканчивается ошибкой.
+
+Такое может случиться, если в системе используется разделение пространства имен утилитой SuperSU. В этом случае карта памяти смонтирована под каким-то пользователем, а при переходе в root смонтированные устройства уже не видны. В утилите SuperSU есть опция, которая может помочь решить данную проблему. Для этого нужно снять флаг "SuperSU -> Настройки -> Создать поименное разделение пространств".
+
+> Ошибка при установке приложения через Google Play: "Неизвестный код ошибки во время установки приложения 24".
+
+Нужно удалить с устройства остаточные файлы приложения, если оно уже было до этого установлено. Для этого нужно удалить каталог: /data/data/ru.meefik.linuxdeploy
+
+#### Производительность
 Скорость чтения/записи SD карты (10 класс) на Android (Samsung Galaxy S II) для файловых систем vfat, ext2, ext4:
 * **vfat**: скорость чтения 14.1 МБ/с; скорость записи 12.0 МБ/с
 * **ext2**: скорость чтения 14.9 МБ/с; скорость записи 3.9 МБ/с
@@ -35,8 +48,8 @@ Copyright (C) 2012-2016  Антон Скшидлевский, [GPLv3](http://ope
 * **GNOME** ~ 0:55 / 1.3 ГБ
 * **KDE** ~ 1:20 / 1.3 ГБ
 
-#### Исходный код ####
+#### Исходный код
 Исходный код доступен по адресу: <https://github.com/meefik/linuxdeploy>. Проект создан в Android Studio.
 
-#### Поддержать проект ####
+#### Поддержать проект
 <http://meefik.github.io/donate>