MajorDoMo инфо - Вклад [ru]

Установка на Linux

2020-05-01T13:28:55Z

Mab: /* Устанавливаем PHP */

[[Category:Установка]]

==Альтернативные варианты==
[[installmd|Скрипт installmd, установка почти на все виды плат и полноценный Linux]]

[https://mjdm.ru/forum/viewtopic.php?f=3&p=92843#p92843 Скрипт установки на Ubuntu 16 или 18]

== Внимание!!! ==

''Инструкция была написана под операционную систему Ubuntu 18.10 и тестировалась только на ней!
В случае если у Вас установлена другая операционная система Linux то возможно, на каком-то из шагов, у Вас возникнут ошибки. В данном случае, рекомендуется сообщить об этих ошибках в чат в [https://t.me/MajorDoMoRu Telegram] или же на [https://majordomo.smartliving.ru/forum/ форум].''

'''<big>Перед началом работы необходимо убедиться что в системе установлен пакет sudo.</big>'''

Для этого нужно выполнить команду:

<pre>sudo</pre>

В случае если в ответ будет отображено сообщение подобного плана:

<pre>bash: sudo: command not found</pre>

Это будет обозначать, что пакет sudo по умолчанию не установлен в Вашей ОС. Потому его необходимо установить.

Для это необходимо выполнить следующие команды:

<pre>su -</pre>

Будет запрошен пароль пользователя от которого выполняется команда.

'''Важно!!!''' При вводе пароля символы не будут отображены на экране!

После успешного ввода пароля, в случае если вид консоли изменился и принял подобный вид:

<pre>root@localhost:~#</pre>

Производится установка sudo командой:

<pre>apt install sudo</pre>

После успешной установки пакета, необходимо добавить пользователя, от которого будет производиться установка, в группу sudo. Это делается командой:

<pre>usermod -aG sudo USERNAME</pre>

Где:
USERNAME - это имя пользователя. Для Raspberry PI это обычно пользователь: pi.
По завершении этих действий, необходимо выйти в окружение обычного пользователя. Это выполняется командой:

<pre>exit</pre>

Приглашающее сообщение в консоли, должно принять подобный вид:

<pre>pi@localhost:~$</pre>

==Обновление кеша пакетов и обновление установленных пакетов (в случае если для них есть обновления)==
<pre>sudo apt-get update
sudo apt-get upgrade</pre>
Установим ещё пару приложений которые будем использовать в процессе установки

<pre>sudo apt-get install nano wget unzip -y</pre>

==Устанавливаем SSH==

<pre>sudo apt-get install openssh-server openssh-client -y</pre>

==Устанавливаем MySQL==

<pre>sudo apt-get install mysql-server mysql-client -y</pre>

Когда запросит установить пароль для root – укажите любой пароль, который Вы запомните. Этот пароль понадобится в дальнейшем.

'''Важно!!!''' Если установщик не запросил пароль, то выполните в консоли команду:

<pre>sudo mysql_secure_installation</pre>

И пройдите по всем шагам. И в этих шагах укажите пароль пользователя root.

'''В Debian 10''' в качестве альтернативы MySQL по умолчанию используется форк проекта, MariaDB, который поддерживается сообществом.

<pre>sudo apt-get install mariadb-server -y</pre>

'''---'''

==Создание пользователя и БД MySQL:==

Для начала создадим БД командой:

<pre>sudo mysql -uroot -p -e "CREATE DATABASE db_terminal;"</pre>

После выполнения этой команды, и далее по параграфу, MySQL будет просить ввести пароль пользователя root, который мы указывали выше. Вводим его где будет необходимо и нажимаем Enter. 
'''Важно!!!''' При вводе пароля символы не будут отображены на экране. 

Далее создаём пользователя для работы с этой БД:

<pre>sudo mysql -uroot -p -e "CREATE USER 'majordomo'@'%' IDENTIFIED BY 'password';"</pre>

password - необходимо заменить на ваш пароль, который тоже необходимо запомнить. Этот пароль будет использоваться для работы MajorDoMo с БД, а так же для входа в phpMyAdmin ниже по инструкции. 
'''Важно!!!''' Рекомендуется использовать сложный пароль, так как в случае если будет открыт доступ к MajorDoMo и phpMyAdmin извне, то есть вероятность того, что простой пароль будет взломан и тот, кто это сделает, сможет получить доступ к важным данным в Вашей MajorDoMo. 

Для предоставления только что созданному пользователю привилегий, необходимо выполнить команду:

<pre>sudo mysql -uroot -p -e "GRANT ALL PRIVILEGES ON *.* TO 'majordomo'@'%';"</pre>

И в завершение, необходимо обновить привилегии:

<pre>sudo mysql -uroot -p -e "FLUSH PRIVILEGES;"</pre>

==Установка WEB сервера==

В качестве web сервера можно установить разные пакеты. В данном случае рассматривается вариант установки Apache.

<pre>sudo apt-get install apache2 apache2-utils -y</pre>

Правим конфиг Апача

<pre>sudo nano /etc/apache2/sites-available/default</pre>

Если такого файла нет, он может называться по-другому. Например:

<pre>000-default.conf</pre>

В этом файле находим раздел:

<pre><Directory /></pre>

И заменяем во всех совпадениях

<pre>AllowOverride None</pre>

на

<pre>AllowOverride All</pre>

Сохраняемся и выходим: Ctrl-O Ctrl-X

В более новых версиях Apache конфигурационный файл может не содержать директив "AllowOverride". В таком случае необходимо вручную привести файл к виду:
<pre>
<VirtualHost *:80>
DocumentRoot /var/www/html
<Directory />
Options FollowSymLinks
AllowOverride All
</Directory>
<Directory /var/www/html>
Options Indexes FollowSymLinks MultiViews
AllowOverride All
Order allow,deny
allow from all
</Directory>

ScriptAlias /cgi-bin/ /usr/lib/cgi-bin/
<Directory "/usr/lib/cgi-bin">
AllowOverride None
Options +ExecCGI -MultiViews +SymLinksIfOwnerMatch
Order allow,deny
Allow from all
</Directory>

ErrorLog ${APACHE_LOG_DIR}/error.log
CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost></pre>

Удаляем стандартный index.html файл командой:

<pre>sudo rm -f /var/www/html/index.html</pre>

И перезапускаем Апач:

<pre>sudo apache2ctl restart</pre>

Если при перезапуске выдаст примерно такой ответ:

<pre>apache2: Could not reliably determine the server's fully qualified domain name, using 127.0.1.1. Set the 'ServerName' directive globally to suppress this message</pre>

То необходимо поправить apache2.conf

<pre>sudo nano /etc/apache2/apache2.conf</pre>

Вставив в него такую строку:

<pre>ServerName localhost</pre>

Сохраняемся и выходим: Ctrl-O Ctrl-X

Перезапускаем Апач

<pre>sudo apache2ctl restart</pre>

Если ваша версия Apache отличается от рассматриваемой, то пути к файлам конфигурации могут быть такими:

<pre>sudo nano /etc/apache2/sites-available/default.conf
sudo nano /etc/apache2/httpd.conf</pre>

==Устанавливаем PHP==

<pre>sudo apt-get install php php-cgi php-cli php-pear php-mysql php-mbstring php-xml -y</pre>

curl и его библиотеки:

<pre>sudo apt-get install curl libcurl3 libcurl3-dev php-curl -y</pre>

'''В Debian 10'''

<pre>sudo apt-get install curl libcurl4 libcurl3-dev php-curl -y</pre>

'''---'''

*Для apache

<pre>sudo apt-get install libapache2-mod-php -y</pre>

*Для последних версий Апача необходимо включить работу с коротким тегом <? /?> для этого откройте файл php.ini командой:

<pre>sudo nano /etc/php/7.3/apache2/php.ini</pre>

Необходимо заменить или вставить строку:

<pre>short_open_tag = On</pre>

==Устанавливаем PHPMYADMIN==

<pre>sudo apt-get install phpmyadmin -y</pre>

Установщик изначально спросит о том, к какой версии web сервера необходимо произвести настройку. Необходимо выбрать версию apache2 путём нажатия пробела и Enter.

Установщик спросит необходимость конфигурирования баз данных при помощи "dbconfig-common". Отвечаем утвердительно путём нажатия Enter.

Далее установщик спрашивает пароль MySQL сервера. Этот пароль задавался в разделе "Устанавливаем MySQL" данного руководства. Вводим указанный пароль и подтверждаем его ещё раз.

==Включаем mod_rewrite==

<pre>sudo a2enmod rewrite</pre>

Перезапускаем Апач

<pre>sudo apache2ctl restart</pre>

'''В Debian 10'''

PhpMyAdmin не включен в репозиторий программного обеспечения Debian 10, поэтому мы должны загрузить его с phpmyadmin.net

Установим необходимые компоненты:
<pre>sudo apt install php-mbstring php-zip php-gd wget -y</pre>

<pre>cd /tmp
wget https://files.phpmyadmin.net/phpMyAdmin/5.0.2/phpMyAdmin-5.0.2-all-languages.zip</pre>

или вставляем ссылку на последнюю версию с сайта https://www.phpmyadmin.net/downloads/

Распаковываем, копируем в /usr/share/phpmyadmin и назначаем права:
<pre>
unzip phpMyAdmin-5.0.2-all-languages.zip
sudo mv phpMyAdmin-5.0.2-all-languages/ /usr/share/phpmyadmin
sudo chown -R www-data:www-data /usr/share/phpmyadmin</pre>

Теперь нам нужно войти в консоль MariaDB и создать базу данных и пользователя для phpMyAdmin.
<pre>
sudo mysql -u root
CREATE DATABASE phpmyadmin DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
GRANT ALL ON *.* TO 'admin'@'localhost' IDENTIFIED BY 'your_preferred_password';
grant all privileges on *.* to admin@localhost with grant option;
FLUSH PRIVILEGES;
EXIT;
</pre>

Затем перезапустите Apache:
<pre>sudo systemctl restart apache2</pre>

Создайте файл phpmyadmin.conf:
<pre>sudo nano /etc/apache2/conf-available/phpmyadmin.conf</pre>

Вставьте следующий текст в файл phpmyadmin.conf:
<pre>
# phpMyAdmin default Apache configuration

Alias /phpmyadmin /usr/share/phpmyadmin

<Directory /usr/share/phpmyadmin>
Options SymLinksIfOwnerMatch
DirectoryIndex index.php

<IfModule mod_php5.c>
<IfModule mod_mime.c>
AddType application/x-httpd-php .php
</IfModule>
<FilesMatch ".+\.php$">
SetHandler application/x-httpd-php
</FilesMatch>

php_value include_path .
php_admin_value upload_tmp_dir /var/lib/phpmyadmin/tmp
php_admin_value open_basedir /usr/share/phpmyadmin/:/etc/phpmyadmin/:/var/lib/phpmyadmin/:/usr/share/php/php-gettext/:/usr/share/php/php-php-gettext/:/usr/share/javascript/:/usr/share/php/tcpdf/:/usr/share/doc/phpmyadmin/:/usr/share/php/phpseclib/
php_admin_value mbstring.func_overload 0
</IfModule>
<IfModule mod_php.c>
<IfModule mod_mime.c>
AddType application/x-httpd-php .php
</IfModule>
<FilesMatch ".+\.php$">
SetHandler application/x-httpd-php
</FilesMatch>

php_value include_path .
php_admin_value upload_tmp_dir /var/lib/phpmyadmin/tmp
php_admin_value open_basedir /usr/share/phpmyadmin/:/etc/phpmyadmin/:/var/lib/phpmyadmin/:/usr/share/php/php-gettext/:/usr/share/php/php-php-gettext/:/usr/share/javascript/:/usr/share/php/tcpdf/:/usr/share/doc/phpmyadmin/:/usr/share/php/phpseclib/
php_admin_value mbstring.func_overload 0
</IfModule>

</Directory>

# Disallow web access to directories that don't need it
<Directory /usr/share/phpmyadmin/templates>
Require all denied
</Directory>
<Directory /usr/share/phpmyadmin/libraries>
Require all denied
</Directory>
<Directory /usr/share/phpmyadmin/setup/lib>
Require all denied
</Directory>
</pre>

Включим этот фрагмент конфигурации:
<pre>sudo a2enconf phpmyadmin.conf</pre>

Создаем временную папку:

<pre>sudo mkdir -p /var/lib/phpmyadmin/tmp
sudo chown www-data:www-data /var/lib/phpmyadmin/tmp</pre>

Перезагрузите Apache, чтобы изменения вступили в силу:

<pre>sudo systemctl reload apache2</pre>

Создаём файл config.inc.php из примера:
<pre>sudo cp /usr/share/phpmyadmin/config.sample.inc.php /usr/share/phpmyadmin/config.inc.php</pre>

Необходимо задать парольную фразу, открываем файл config.inc.php и задаём какую-нибудь парольную фразу длиннее 32-х символов, например,
<pre>$cfg['blowfish_secret'] = '12345678901234567890123456789012'; /* YOU MUST FILL IN THIS FOR COOKIE AUTH! */</pre>

Теперь вы можете получить доступ к веб-интерфейсу phpMyAdmin по адресу, введя имя 'admin' и пароль 'your_preferred_password', которые задали на шаге при создании базы данных и пользователя для phpMyAdmin:
<pre>http://ip_адрес/phpmyadmin</pre>

Теперь в панели управления phpMyAdmin вы можете увидеть предупреждающее сообщение.
<pre>Хранилище конфигурации phpMyAdmin не полностью настроено, некоторые расширенные функции были отключены. Узнайте причину.
Или перейдите на вкладку 'Операции' любой базы данных, чтобы настроить хранилище в ней.</pre>

Переходим по ссылке "Узнайте причину".
Видим сообщение:
<pre>Создать базу данных с именем 'phpmyadmin' и настроить там хранение конфигурации phpMyAdmin.</pre>

Переходим по ссылке "Создать".

'''---'''

==Настройка PHP==

В обоих конфигурационных файлах для web сервера:

<pre>sudo nano /etc/php/7.3/apache2/php.ini</pre>

И файл запуска php скриптов из командной строки:

<pre>sudo nano /etc/php/7.3/cli/php.ini</pre>

Строку error_reporting привести к виду:

<pre>error_reporting = E_ALL & ~E_NOTICE</pre>

А так же строки:
<pre>max_execution_time - С 30 меняем на 90
max_input_time - С 60 на 180
post_max_size - С 8M на 200M
upload_max_filesize - С 2M на 50M
max_file_uploads - С 20 на 150</pre>

Для применения изменений, необходимо перезапустить Apache:

<pre>sudo /etc/init.d/apache2 restart</pre>

==Устанавливаем MajorDoMo==

Скачиваем дистрибутив Majordomo, разархивируем и копируем содержимое majordomo-master в директорию /var/www/html:

<pre>mkdir ~/majordomo
cd ~/majordomo
wget https://github.com/sergejey/majordomo/archive/master.zip
unzip master.zip
sudo cp -rp ~/majordomo/majordomo-master/* /var/www/html
sudo cp -rp ~/majordomo/majordomo-master/.htaccess /var/www/html
rm -rf ~/majordomo</pre>

Настройка прав на файлы и директории

Установка рекомендуемых прав выполняется следующими командами:

Для файлов:

<pre>sudo find /var/www/html/ -type f -exec chmod 0644 {} \;</pre>

Для директорий:

<pre>sudo find /var/www/html/ -type d -exec chmod 0755 {} \;</pre>

Проверяем права командой:

<pre>ls -lh /var/www/html</pre>

Права будут выглядеть подобно:

Для директорий:

<pre>drwxr-xr-x</pre>

Для файлов:

<pre>-rw-r--r--</pre>

<big>Установка собственника и группы на файлы и директории</big>

Majordomo (а именно сервисы: apache и php) работает от пользователя www-data. Права доступа к каталогу /var/www/html, где лежат файлы Majordomo по умолчанию принадлежат root. Изменим владельца директории /var/www/html на www-data.

<pre>sudo chown -R www-data:www-data /var/www/html</pre>

Проверяем:

<pre>ls -lh /var/www/html</pre>

Вывод должен быть подобный:

<pre>-rw-r--r-- 1 www-data www-data 12K May 26 22:19 cycle.php</pre>

Теперь необходимо предоставить доступ пользователю www-data к медиа устройствам. Для этого его необходимо добавить в группу audio.

Это делается командой usermod:

<pre>sudo usermod -a -G audio www-data</pre>

Проверяем, что он появился в группе:

<pre>cat /etc/group | grep audio</pre>

Если всё в порядке, то вывод будет подобный:

<pre>audio:x:29:www-data</pre>

''Дальнейшие команды в этом разделе нужно использовать только в случае если у Вас по какой-то причине система не работает совсем или не работает частично.''

<big>В большинстве случаев на моменте начального конфигурирования, проблемы с системой возникают из-за неправильно установленных прав.</big>

Меняем права доступа к файлам по принципу: всем-всё.

<pre>sudo find /var/www/html/ -type f -exec chmod 0666 {} \;</pre>

И директориям

<pre>sudo find /var/www/html/ -type d -exec chmod 0777 {} \;</pre>

Проверяем права командой:

<pre>ls -lh /var/www/html</pre>

Права будут выглядеть подобно:

Для директорий:

<pre>drwxrwxrwx</pre>

Для файлов:

<pre>-rw-rw-rw-</pre>

В случае если права по какой-то причине не установились, то можно сделать вариант в котором устанавливаются полные права для всех рекурсивно по директориям и файлам.

Команда выглядит так:

<pre>sudo chmod -R 777 /var/www/html</pre>

Необходимо заметить, что данный способ, не самый безопасный, но самый простой.

==Импорт базы данных==

Заходим по адресу:

<pre>http://localhost/phpmyadmin</pre>

Или:

<pre>http://localhost/phpmyadmin4</pre>

При входе будет запрошен логин, его необходимо указать как: majordomo, и пароль который который был задан на шаге: "Создание пользователя и БД MySQL".

В созданную ранее БД необходимо импортировать файл db_terminal.sql из директории с дистрибутивом. Скачать его можно по ссылке: [https://raw.githubusercontent.com/sergejey/majordomo/master/db_terminal.sql db_termina.sql]. Для скачивания нажмите правой кнопкой мыши на ссылку и выберите: "Сохранить ссылку как...".

Далее выполняем последовательность действий в phpMyAdmin для импорта sql файла.

* В левой части окна выбрать БД db_terminal, путём нажатия один раз на её название.
* В верхней части окна найти кнопку "Импорт".
* В загрузившейся странице, в разделе "Импортируемый файл" нажать "Выберите файл" или "Обзор".
* В открывшемся окне, выбрать ранее сохраненный файл "db_terminal.sql".
* В нижней части окна нажать "Вперёд".

После успешного импорта должна отобразится зелёная строка с подобным текстом:

<pre>Импорт успешно завершён, выполнено 171 запросов. (db_terminal.sql)</pre>

В случае если возникли проблемы с импортом БД используя phpMyAdmin, есть возможность импортировать дамп БД используя командную строку. Для этого скачайте дамп файл командой:

<pre>sudo wget -O /tmp/db_terminal.sql https://raw.githubusercontent.com/sergejey/majordomo/master/db_terminal.sql</pre>

И импортируйте его:

<pre>sudo mysql -umajordomo -p db_terminal < /tmp/db_terminal.sql</pre>

Будет запрошен пароль пользователя majordomo, который был задан на шаге: "[[Установка_на_Linux#Создание пользователя и БД MySQL:|Создание пользователя и БД MySQL]]".

==Правим основной конфиг==

Изначально копируем пример конфига в рабочий конфиг:

<pre>sudo cp /var/www/html/config.php.sample /var/www/html/config.php</pre>

Установим собственника и группу для конфига:

<pre>sudo chown www-data: /var/www/html/config.php</pre>

И открываем конфиг для редактирования:

<pre>sudo nano /var/www/html/config.php</pre>

Прописываем имя пользователя и пароль пользователя БД. Для этого нужно исправить строки:

<pre>Define('DB_USER', 'majordomo');
Define('DB_PASSWORD', '');</pre>

Где:
* '''DB_USER''' - пользователь majordomo который был создан на шаге: "Создание пользователя и БД MySQL".
* '''DB_PASSWORD''' - пароль от этого пользователя, который был задан на том же шаге.

Сохраняем файл, и выходим из редактора.

Все, теперь можно зайти на веб интерфейс Majordomo.

http://localhost/

Или:

http://sever_ip/

Если установка выполняется не на локальную машину.

При первом входе должна быть отображена страница: "Hello, world! :)" на которой необходимо выбрать тайм зону, язык системы и цветовую тему. По завершении нажать кнопку "Continue".

В случае если такая страница не отобразилась, открыть её можно по ссылке:

<pre>http://localhost/popup/first_start.html</pre>

==Основной цикл Вариант 1. Systemd unit. Предпочтительный==

Код юнита:

<pre>
[Unit]
Description=Majordomo cycles service
Requires=network.target mysql.service apache2.service
After=mysql.service apache2.service

[Service]
Type=simple
User=www-data
Group=www-data
ExecStart=/usr/bin/php /var/www/html/cycle.php
ExecStop=/usr/bin/pkill -f cycle_*

KillSignal=SIGKILL
KillMode=control-group
RestartSec=1min
Restart=on-failure

[Install]
WantedBy=multi-user.target</pre>

Данный код необходимо скопировать в файл: /etc/systemd/system/majordomo.service Для этого открываем файл:

<pre>sudo nano /etc/systemd/system/majordomo.service</pre>

И вставляем в него код, который представлен выше.

Для автозапуска MajorDoMo при старте системы, необходимо выполнить команду:

<pre>sudo systemctl enable majordomo</pre>

И для запуска MajorDoMo необходимо выполнить:

<pre>sudo systemctl start majordomo</pre>

==Основной цикл Вариант 2. Если не сработал первый вариант==

Запуск основного цикла добавляем в Cron, для пользователя www-data, так как файлы МД принадлежат этому пользователю.

<pre>sudo crontab -e -u www-data</pre>

В открывшемся окне добавляем строку:

<pre>@reboot /usr/bin/php /var/www/html/cycle.php</pre>

'''И обязательно!''' ставим Enter для того чтобы в конце открытого файла был перенос строки.

Сохраняем и перезапускаем компьютер:

<pre>sudo reboot</pre>

После запуска циклов можно открыть MajorDoMo по адресу:

<pre>http://localhost/</pre>

В случае если MajorDoMo устанавливалась на локальный компьютер.

Или:

<pre>http://IP_ADDRESS/</pre>

Если MajorDoMo устанавливалась на удалённый сервер.

Если не выполняются onNewMinute и onNewHour

Нужно проверить настройку BASE_URL в config.php. Если Вы используете домен, а не IP, тогда добавьте в файл /etc/hosts строку вида:

<pre>127.0.0.1 domain.com</pre>

Где domain.com - это Ваш домен который Вы используете. Комментарий Сергея с форума: Дело в том, что эти методы вызываются через внутреннюю функцию raseEvent, которая обращается к серверу через HTTP-запрос используя BASE_URL. Если он неправильный, то метод не вызовется.

На этом статья об установке MajorDoMo на Linux Ubuntu закончена.

==Полезные темы на форуме==

Для быстрой установки необходимых атрибутов можно воспользоваться [http://smartliving.ru/forum/viewtopic.php?f=3&t=2&start=10#p84 данным скриптом].

[http://smartliving.ru/forum/viewtopic.php?f=3&t=298 Установка на Ubuntu]

[http://smartliving.ru/forum/viewtopic.php?f=3&t=573 Установка Системы Majordomo на Raspberry pi]

[http://smartliving.ru/forum/viewtopic.php?f=3&t=371 Установка на FreeBSD]

[http://smartliving.ru/forum/viewtopic.php?f=3&t=630 (РЕШЕНО) Проблема с установкой и настройкой на Ubuntu 13.04]

[http://smartliving.ru/forum/viewtopic.php?f=3&t=424 Установка на Debian подробная инструкция]

[http://smartliving.ru/forum/viewtopic.php?f=3&t=740 CubieBoard - попытка №1]

Yandex Home модуль

2020-05-01T13:38:31Z

Mab: /* Требования */

[[Category:Модули]]

автор: skysilver

==Описание==
'''Модуль Yandex Home'''

==Установка модуля==
Установка осуществляется через '''Маркет дополнений'''

==Общие сведения==

Модуль '''Yandex Home''' предназначен для поддержки '''личных''' (приватных) навыков для платформы умного дома '''Яндекс'''.

Платформа умного дома '''Яндекс''' имеет открытое [https://tech.yandex.ru/dialogs/alice/doc/smart-home/start-docpage/ '''API'''] и позволяет интегрировать '''Яндекс Алису''' с оборудованием сторонних производителей и системами умного дома. Модуль реализует '''авторизационный сервис''' на основе стандарта '''OAuth 2.0''' и '''Provider Adapter API''' - промежуточный API, который принимает на вход запросы в формате платформы умного дома Яндекс и преобразует их в запросы к API '''MajorDoMo'''.

Особенностью платформы умного дома '''Яндекс''' является '''новая''' специальная '''категория''' навыков '''Алисы''', которая предназначена для голосового управления домашними устройствами и не требует предварительного запуска навыка по его имени. Теперь устройствами можно управлять прямыми командами вида ''"Алиса, включи свет в гостиной"'', ''"Алиса, сделай в спальне похолоднее"'' и т. п. При этом следует понимать, что в отличие от классических навыков, '''Яндекс''' не передает в '''MajorDoMo''' распознанный текст команды пользователя, а передается непосредственно управляющая команда для устройства, которая интерпретируется модулем и записывается в привязанное свойство объекта.

Модуль реализует классическую концепцию '''MajorDoMo''' для взаимодействия с пользователем через '''метрики''' и привязанные к ним '''свойства объекта'''. К метрикам привязываются уже существующие объекты и свойства, через которые реализовано управление устройствами.

Обсуждение модуля на [https://mjdm.ru/forum/viewtopic.php?f=5&t=6498 '''Форуме'''].

Исходный код модуля на [https://github.com/skysilver-lab/majordomo-yandexhome '''Github'''].

Модуль в [https://connect.smartliving.ru/tasks/482.html '''Connect'''].

[[Файл:Module yandexhome.png|800px|мини|центр|Module yandexhome]]

Для успешного функционирования модуля и управления устройствами, подключенными к '''MajorDoMo''', через ассистента '''Яндекс Алиса''' требуется, в первую очередь, '''опубликовать обработчики запросов''' (конечные точки, вебхуки) в сеть Интернет и обеспечить тем самым их доступность со стороны облака '''Яндекс''' по доменному имени ('''DNS''') и протоколу '''HTTPS'''. Во вторую очередь, необходимо в консоли разработчика платформы Яндекс Диалогов создать, настроить и опубликовать '''приватный навык''' специальной категории '''Умный дом'''.

В модуле '''Yandex Home''' все обработчики запросов реализованы в виде отдельных файлов: ''authorize.php'', '''token.php''' и '''smarthome.php''', и размещаются в директории ''/modules/yandexhome''.

<table>

<tr>
<th>Назначение вебхука</th>
<th>URL вебхука</th>
<th>Пример опубликованной ссылки</th>
</tr>

<tr>
<td>URL авторизации</td>
<td>/modules/yandexhome/authorize.php</td>
<td><code>https://majordomo.keenetic.pro/modules/yandexhome/authorize.php</code></td>
</tr>
<tr>
<td>URL для получения и обновления токена</td>
<td>/modules/yandexhome/token.php</td>
<td><code>https://majordomo.keenetic.pro/modules/yandexhome/token.php</code></td>
</tr>
<tr>
<td>URL обработчика навыка</td>
<td>/modules/yandexhome/smarthome.php</td>
<td><code>https://majordomo.keenetic.pro/modules/yandexhome/smarthome.php</code></td>
</tr>
</table>

В конечном итоге '''запуск модуля''' сводится к такой последовательности шагов:

1. Установка модуля из маркета дополнений.

2. Настройка модуля.

3. Публикация обработчиков запросов.

4. Регистрация приватного навыка.

5. Объединение аккаунтов в приложении Яндекс.

6. Добавление и управление устройствами в модуле

==Поддерживаемые умения==

<table>

<tr>
<th>#</th>
<th>Метрика (умение)</th>
<th>Описание</th>
<th>Значения в модуле</th>
<th>Значения от Яндекс</th>
</tr>

<tr>
<td>1</td>
<td>on</td>
<td>Включить/выключить (1 - включено, 0 выключено).</td>
<td>1 и 0</td>
<td>true и false</td>
</tr>
<tr>
<td>2</td>
<td>volume</td>
<td>Громкость (проценты).</td>
<td>1 - 100 (*)</td>
<td>1 - 100, либо +1/-1</td>
</tr>
<tr>
<td>3</td>
<td>channel</td>
<td>ТВ-канал.</td>
<td>№ канала (*)</td>
<td>№ канала, либо +1/-1</td>
</tr>
<tr>
<td>4</td>
<td>temperature</td>
<td>Температура (градусы цельсия).</td>
<td>1 - 100 (*)</td>
<td>°C</td>
</tr>
<tr>
<td>5</td>
<td>temperature_k</td>
<td>Температура цвета (кельвины).</td>
<td>2700 - 9000</td>
<td>2700 - 9000</td>
</tr>
<tr>
<td>6</td>
<td>thermostat</td>
<td>Температурный режим.</td>
<td>auto, heat, cool, eco, dry, fan_only</td>
<td>auto, heat, cool, eco, dry, fan_only</td>
</tr>
<tr>
<td>7</td>
<td>mute</td>
<td>Режим без звука (1 - включено, 0 выключено).</td>
<td>1 и 0</td>
<td>true и false</td>
</tr>
<tr>
<td>8</td>
<td>fan_speed</td>
<td>Скорость вентиляции.</td>
<td>auto, low, medium, high</td>
<td>auto, low, medium, high</td>
</tr>
<tr>
<td>9</td>
<td>rgb</td>
<td>Цвет в формате RGB (hex).</td>
<td>000000 - FFFFFF</td>
<td>0 - 16777215</td>
</tr>
<tr>
<td>10</td>
<td>brightness</td>
<td>Яркость (проценты).</td>
<td>1 - 100 (*)</td>
<td>1 - 100</td>
</tr>

</table>

* Имеется возможность переопределить диапазон значений и шаг изменения.

==Требования==

1. '''Публичный''' (глобальный, белый) '''IP-адрес''', выдаваемый интернет-провайдером.

2. '''Доменное имя''' (DNS), привязанное к публичному IP-адресу.

3. Валидный '''SSL-сертификат''' на DNS-имя.

4. '''Опубликованные''' в Интернет '''обработчики''' запросов (без требования ввода логина и пароля).

5. Зарегистрированный и '''опубликованный''' приватный '''навык''' категории '''''Умный дом'''''.

6. Активное PHP-расширение '''pdo_mysql'''.

Примечание:
Не забывайте в файле config.php исправить/добавить следующие строки для доступа Яндекса к нашим вебхукам:
<pre>// Доступ к этим файлам без пароля
if (!(preg_match('/\/authorize\.php/is', $_SERVER['REQUEST_URI']) ||
preg_match('/\/token\.php/is', $_SERVER['REQUEST_URI']) ||
preg_match('/\/smarthome\.php/is', $_SERVER['REQUEST_URI'])))
{
Define('HOME_NETWORK', '192.168.0.*'); // домашняя сетка (доступ без пароля)
Define('EXT_ACCESS_USERNAME', 'admin'); // имя
Define('EXT_ACCESS_PASSWORD', 'password'); // пароль
}</pre>

==Установка модуля==

Чтобы установить модуль, нужно в '''Панели управления MajorDoMo''' перейти в раздел '''Система''' и открыть '''Маркет дополнений'''. Модуль находится в категории '''Взаимодействие'''. Открываем эту вкладку и ищем в списке строку с модулем. Для установки нажимаем кнопку '''Добавить'''.

[[Файл:68747470733a2f2f636f6e6e6563742e736d6172746c6976696e672e72752f636d732f646174615f696d616765732f3737355f696d6167652e706e67.png|800px|мини|центр|рис 1]]

Процесс установки отобразится в виде лога. После успешной установки система перенаправит обратно на страницу '''Маркета дополнений''', а в разделе '''Устройства''' Панели управления появится новый пункт с модулем '''Yandex Home'''.

[[Файл:68747470733a2f2f636f6e6e6563742e736d6172746c6976696e672e72752f636d732f646174615f696d616765732f3737365f696d6167652e706e67.png|800px|мини|центр|Установка]]

==Настройка модуля==

Настройка модуля заключается в генерации значений '''OAuth2 ID''' и '''OAuth2 KEY''' с помощью соответствующей кнопки, а также ввод произвольных '''логина''' и '''пароля''' пользователя, которые впоследствии будут запрошены в ходе объединения аккаунтов в '''приложении Яндекс'''.

[[Файл:68747470733a2f2f636f6e6e6563742e736d6172746c6976696e672e72752f636d732f646174615f696d616765732f3737375f696d6167652e706e67.png|800px|мини|центр|Настройка]]

На ранних этапах использования модуля '''рекомендуется включить''' ведение '''логов''' событий - '''Отладка DebMes'''.

При необходимости можно указать, какой использовать '''стиль отображения''' списка устройств на главной странице модуля.

==Публикация обработчиков запросов==

Механизм взаимодействия '''платформы умного дома Яндекс''' со сторонними системами (провайдерами) реализуется посредством '''вебхуков''' (webhook). Облако '''Яндекс''' для запроса состояния устройств и управления ими посылает '''POST'''- и '''GET'''- запросы на '''конечные точки''' (''endpoint'') вебхуков и получает ответы от них. Таким образом, для корректной работы этого механизма необходимо обеспечить постоянную доступность вебхуков из сети Интернет со стороны облака '''Яндекс'''.

Согласно '''API платформы''' умного дома '''Яндекс''' требуется реализовать '''три типа''' конечных точек:

1. '''URL авторизации''' (''authorization endpoint'') - страница, на которой авторизуется пользователь, чтобы разрешить навыку доступ к своему аккаунту.

2. '''URL для получения и обновления токена''' (''token endpoint'') - адрес, на который отправляются запросы с авторизационным кодом, чтобы получить '''''OAuth-токен''''' доступа, и запросы для обновления ранее полученного токена.

3. '''URL обработчика навыка''' (''smarthome endpoint'') - основной вебхук, который отвечает непосредственно за работу с устройствами.

В модуле '''Yandex Home''' все три типа конечных точек реализованы в виде отдельных файлов: ''authorize.php'', ''token.php'' и ''smarthome.php'', размещаемых в директории ''/modules/yandexhome''.

'''# Назначение вебхука''' '''URL вебхука'''

1 URL авторизации /modules/yandexhome/authorize.php

2 URL для получения и обновления токена /modules/yandexhome/token.php

3 URL обработчика навыка /modules/yandexhome/smarthome.php

Чтобы '''опубликовать''' эти три вебхука в сеть '''Интернет''' и обеспечить тем самым их доступность со стороны '''облака Яндекс''', необходимо выполнить ряд условий.

'''Условие №1'''. Публичный (глобальный, белый) IP-адрес, выдаваемый интернет-провадером.

Белый IP-адрес при этом может быть как ''статическим'', так и ''динамическим''. В случаях, когда невозможно получить белый адрес у интернет-провайдера, возможны варианты использования сторонних сервисов. Например, некоторые производители роутеров предоставляют их владельцам сервис по доступу к ресурсам домашней локальной сети (KeenDNS от Keenetic и др). Либо использовать VPN-сервисы на подобие vpnki.ru или собственный VPN-сервер, развернутый на VPS.

'''Условие №2'''. Доменное имя (DNS), привязанное к публичному IP-адресу.

Это требование в большинстве случаев закрывается классическими сервисами '''динамических DNS''', которых представлено в сети в большом ассортименте, как платных, так и бесплатных. Большинство современных роутеров уже имеют встроенную поддержку сервисов '''''Dynamic DNS'''''. При использовании сервисов удаленного доступа типа ''KeenDNS'' или ''VPNKI'' это условие выполняется автоматически - доменное имя выбирается и присвается в ходе регистрации и подключения услуги.

'''Условие №3'''. Валидный SSL-сертификат на DNS-имя.

По требованиям платформы умного дома '''Яндекс''' весь обмен трафиком между их облаком и '''MajorDoMo''' должен идти в зашифрованном виде по протоколу '''HTTPS''', что обеспечивается либо установкой '''''SSL-сертификата''''' на веб-сервер с '''MajorDoMo''', либо услугами сервисов удаленного доступа (см. выше). Бесплатный SSL-сертификат можно получить у удостоверяющего центра [https://letsencrypt.org/ Let’s Encrypt] сроком на 3 месяца, затем его нужно будет регулярно обновлять. Сертификат устанавливается либо на тот же ''виртуальный сервер'' '''Apache''', который обслуживает '''MajorDoMo''', либо на отдельный ''виртуальный сервер'' ('''Apache''' или '''Nginx'''), выступающий в роли обратного прокси (reverse proxy) для '''MajorDoMo'''.

Корректность установки сертификата и доступность вашего сервера из сети Интернет по HTTPS можно проверить с помощью специализированных сервисов, например:

https://ssllabs.com/ssltest/analyze.html
https://www.geocerts.com/ssl-checker
https://www.digicert.com/help/
https://www.sslshopper.com/ssl-checker.html

==Регистрация приватного навыка==

'''Навыки умного дома''' - специальная категория навыков '''Алисы''', предназначенных для голосового управления домашними устройствами. Навыки создаются в [https://dialogs.yandex.ru/developer/ ''консоли разработчика''] платформы Яндекс Диалогов.

Основные '''шаги''' по созданию навыка это:

1. Настройка связки аккаунтов OAuth 2.0.

2. Добавление навыка и выбор его типа.

3. Заполнение информационных полей.

4. Модерация навыка.

5. Публикация навыка.

Чтобы создать новый '''приватный навык''', открываем [https://dialogs.yandex.ru/developer/ '''консоль разработчика'''] и авторизуемся под нужной учетной записью.

[[Файл:68747470733a2f2f636f6e6e6563742e736d6172746c6976696e672e72752f636d732f646174615f696d616765732f3734395f696d6167652e706e67.png|800px|мини|без|Яндекс диалоги]]

В личном кабинете разработчика нажимаем шестеренку и переходим в раздел '''Настройки''', где открываем вкладку '''''Связки аккаунтов'''''.

[[Файл:68747470733a2f2f636f6e6e6563742e736d6172746c6976696e672e72752f636d732f646174615f696d616765732f3735315f696d6167652e706e67.png|800px|мини|центр|Связка аккаунтов]]

После чего добавляем новую связку и заполняем ее поля (детальное описание [https://tech.yandex.ru/dialogs/alice/doc/auth/account-linking-docpage/ здесь]).

- '''Название''' - понятное вам название связки.

- '''Идентификатор приложения''' - значение '''OAuth2 ID''' из настроек модуля '''Yandex Home'''.

- '''Секрет приложения''' - значение '''OAuth2 KEY''' из настроек модуля '''Yandex Home'''.

- '''URL авторизации''' - адрес вебхука авторизации (см. предыдущую статью), например, - https://majordomo.keenetic.pro:8443/modules/yandexhome/authorize.php

- '''URL для получения токена''' - адрес вебхука получения токена (см. предыдущую статью), например, https://majordomo.keenetic.pro:8443/modules/yandexhome/token.php

- '''URL для обновления токена''' - тот же самый, что и пунктом выше, например, https://majordomo.keenetic.pro:8443/modules/yandexhome/token.php

- '''Идентификатор группы действий''' - оставляем пустым.

- '''Идентификатор OAuth приложения''' - оставляем пустым.

[[Файл:68747470733a2f2f636f6e6e6563742e736d6172746c6976696e672e72752f636d732f646174615f696d616765732f3735305f696d6167652e706e67.png|800px|мини|центр|Связка аккаунтов]]

Сохраняем связку и возвращаемся на главную страницу консоли разработчика, на которой создаем новый навык, кликнув по кнопке '''''Создать диалог'''''.

[[Файл:68747470733a2f2f636f6e6e6563742e736d6172746c6976696e672e72752f636d732f646174615f696d616765732f3735325f696d6167652e706e67.png|800px|мини|центр|Создать диалог]]

Тип навыка выбираем '''Умный дом'''.

[[Файл:68747470733a2f2f636f6e6e6563742e736d6172746c6976696e672e72752f636d732f646174615f696d616765732f3735335f696d6167652e706e67 (1).png|800px|мини|центр|Тип диалога]]

Последовательно заполняем поля (детальное описание [https://tech.yandex.ru/dialogs/alice/doc/smart-home/start-docpage/ здесь]).

- '''Название''' - указываем название навыка.

- '''Endpoint URL''' - адрес вебхука обработчика навыка (см. предыдущую статью),

например, https://majordomo.keenetic.pro:8443/modules/yandexhome/smarthome.php.

[[Файл:68747470733a2f2f636f6e6e6563742e736d6172746c6976696e672e72752f636d732f646174615f696d616765732f3735355f696d6167652e706e67.png|800px|мини|центр|Основные настройки]]

- '''Приватность''' - обязательно ставим галочку '''''Не показывать в каталоге'''''.

- '''Подзаголовок''' - пишем краткое описание навыка.

- '''Имя разработчика''' - фамилия, имя.

- '''E-mail разработчика''' - пишем аккаунт Яндекс.Почты.

- '''Сайт для верификации прав использования бренда''' - оставляем пустым.

- '''Описание''' - произвольное описание нашего навыка.

- '''Заметки для модератора''' - оставляем пустым.

- '''Иконка''' - логотип навыка в формате PNG или JPG.

[[Файл:68747470733a2f2f636f6e6e6563742e736d6172746c6976696e672e72752f636d732f646174615f696d616765732f3735365f696d6167652e706e67.png|800px|мини|центр|Связка аккаунтов]]

- '''Связка аккаунтов''' - в выпадающем списке выбрать ранее созданную связку.

[[Файл:68747470733a2f2f636f6e6e6563742e736d6172746c6976696e672e72752f636d732f646174615f696d616765732f3735375f696d6167652e706e67.png|800px|мини|центр|Связка аккаунтов]]

Сохраняем изменения, после чего становится активной кнопка '''''На модерацию'''''. Кликаем на нее и отправляем наш навык на модерацию. На сегодняшний день модерация автоматическая и происходит мгновенно.

[[Файл:68747470733a2f2f636f6e6e6563742e736d6172746c6976696e672e72752f636d732f646174615f696d616765732f3735385f696d6167652e706e67.png|800px|мини|центр|Черновик]]

После модерации остается завершающий этап - '''публикация''' навыка. Нажимаем кнопку '''Опубликовать'''''Курсивное начертание'' и на главной странице консоли разработчика видим, что навык сменил статус и переместился в раздел '''Опубликованные'''.

[[Файл:68747470733a2f2f636f6e6e6563742e736d6172746c6976696e672e72752f636d732f646174615f696d616765732f3735395f696d6167652e706e67.png|800px|мини|центр|Публикация]]

Опубликованный приватный навык появится в списке навыков умного дома в '''приложении Яндекс''' (или в его веб-версии [https://quasar.yandex.ru/skills/iot/ '''quasar''']).

[[Файл:68747470733a2f2f636f6e6e6563742e736d6172746c6976696e672e72752f636d732f646174615f696d616765732f3736305f696d6167652e706e67.png|800px|мини|центр|Первые шаги]]

На следующем шаге можно приступать к объединению аккаунтов.

==Объединение аккаунтов в приложении Яндекс==

Следующим этапом после регистрации и публикации приватного навыка является '''объединение аккаунтов''' в приложении умного дома '''Яндекс'''. Это - '''завершающий этап по интеграции сторонних систем (и MajorDoMo в частности) с платформой умного дома Яндекс, после которого становится доступным управление устройствами с помощью голосового ассистента Яндекс Алиса'''.

Чтобы объединить аккаунты, с главной страницы приложения ([https://play.google.com/store/apps/details?id=ru.yandex.searchplugin Google Play] или [https://itunes.apple.com/ru/app/id1050704155 App Store]) необходимо зайти в раздел '''''Умный дом''''', а затем тапнуть кнопку '''Добавить устройство''', после чего откроется раздел '''''Популярные производители'''''.

[[Файл:68747470733a2f2f636f6e6e6563742e736d6172746c6976696e672e72752f636d732f646174615f696d616765732f3736315f696d6167652e706e67.png|800px|мини|центр|Следующий шаг]]

В списке производителей выбираем наш приватный навык и тапаем кнопку '''Объединить аккаунты'''. Приложение переадресует на страницу авторизации навыка, на которой нужно ввести '''''логин пользователя и пароль пользователя''''', указанные ранее в настройках модуля '''Yandex Home'''. После успешной авторизации подтверждаем сопряжение кнопкой '''Предоставить'''.

[[Файл:68747470733a2f2f636f6e6e6563742e736d6172746c6976696e672e72752f636d732f646174615f696d616765732f3736325f696d6167652e706e67.png|800px|мини|центр|Следующий шаг]]

Приложение переадресует обратно на страницу свойств навыка, а кнопка '''Объединить аккаунты''' изменится на '''Обновить список устройств'''. Тапаем на нее и после успешной синхронизации будет предложено перейти на страницу со списком устройств. Если в этот момент в модуле '''Yandex Home''' уже были добавлены устройства, то они отобразятся в приложении. В дальнейшем при добавлении устройств в модуле или изменении их свойств необходимо каждый раз выполнять такую синхронизацию для обновления списка устройств в '''приложении Яндекс'''.

[[Файл:68747470733a2f2f636f6e6e6563742e736d6172746c6976696e672e72752f636d732f646174615f696d616765732f3736335f696d6167652e706e67.png|800px|мини|центр|Следующий шаг]]

==Добавление и управление устройствами в модуле==

Модуль реализует классическую концепцию '''MajorDoMo''' для взаимодействия с пользователем через '''метрики''' и '''привязанные''' к ним '''свойства объекта'''. К метрикам (умениям) привязываются уже существующие объекты и свойства, через которые '''реализовано управление''' устройствами. К каждому умению устройства можно привязать свое свойство объекта.

Добавление нового устройства выполняется с помощью кнопки '''Добавить устройство''' на главной странице модуля. После чего указываются название, тип и местоположение устройства.

[[Файл:68747470733a2f2f636f6e6e6563742e736d6172746c6976696e672e72752f636d732f646174615f696d616765732f3737385f696d6167652e706e67.png|800px|мини|центр|Настройка]]

Дальнейшее конфигурирование выполняется на странице редактирования (настройки) устройства.

[[Файл:68747470733a2f2f636f6e6e6563742e736d6172746c6976696e672e72752f636d732f646174615f696d616765732f3737395f696d6167652e706e67.png|800px|мини|центр|Конфигурирование]]

[[Файл:68747470733a2f2f636f6e6e6563742e736d6172746c6976696e672e72752f636d732f646174615f696d616765732f3738305f696d6167652e706e67.png|800px|мини|центр|Настройка устройств]]

'''Обязательные''' для заполнения '''поля''' устройства:

1. Название.

2. Тип.

3. Местоположение.

4. Умения.

У каждого устройства '''должно быть''' указано '''минимум одно''' умение.

'''Не обязательные''' для заполнения '''поля''' устройства:

1. Описание.

2. Производитель.

3. Модель.

4. Версия программного обеспечения (ПО).

5. Версия аппаратного обеспечения (АО).

[[Файл:68747470733a2f2f636f6e6e6563742e736d6172746c6976696e672e72752f636d732f646174615f696d616765732f3738315f696d6167652e706e67.png|800px|мини|центр|Описание полей]]

'''Набор умений''' представлен в виде выпадающего списка.

[[Файл:68747470733a2f2f636f6e6e6563742e736d6172746c6976696e672e72752f636d732f646174615f696d616765732f3738325f696d6167652e706e67.png|800px|мини|центр|Набор умений]]

'''Привязка свойства''' объекта к конкретному '''умению''' выполняется также с помощью выпадающих списков.

[[Файл:68747470733a2f2f636f6e6e6563742e736d6172746c6976696e672e72752f636d732f646174615f696d616765732f3738335f696d6167652e706e67.png|800px|мини|центр|Привязка свойств]]

При добавлении устройств в модуле или изменении их свойств для обновления списка устройств в '''приложении Яндекс''' необходимо каждый раз выполнять синхронизацию с помощью кнопки '''Обновить список устройств''' в окне свойств навыка. Удаляются устройства из '''приложения Яндекс''' вручную, либо через '''отвязывание аккаунта''' и последующее повторное объединение аккаунтов.

==Документация по модулю==

1. [https://connect.smartliving.ru/profile/461/blog/majordomo-i-yandeks-alisa-obschie-svedeniya.html MajorDoMo и Яндекс Алиса. Общие сведения.]

2. [https://connect.smartliving.ru/profile/461/blog/majordomo-i-yandeks-alisa-publikaciya-vebhukov.html MajorDoMo и Яндекс Алиса. Публикация вебхуков.]

3. [https://connect.smartliving.ru/profile/461/blog/majordomo-i-yandeks-alisa-registraciya-privatnogo-navyka.html MajorDoMo и Яндекс Алиса. Регистрация приватного навыка.]

4. [https://connect.smartliving.ru/profile/461/blog/majordomo-i-yandeks-alisa-obyedinenie-akkauntov.html MajorDoMo и Яндекс Алиса. Объединение аккаунтов.]

5. [https://connect.smartliving.ru/profile/461/blog/majordomo-i-yandeks-alisa-modul-yandex-home.html MajorDoMo и Яндекс Алиса. Модуль Yandex Home.]

6. [https://connect.smartliving.ru/profile/461/blog/majordomo-i-yandeks-alisa-alisa-vklyuchi-svet-na-kuhne.html MajorDoMo и Яндекс Алиса. Алиса, включи свет на кухне.]

7. [https://connect.smartliving.ru/profile/461/blog/majordomo-i-yandeks-alisa-alisa-uvelich-yarkost-nastolnoy-lampy.html MajorDoMo и Яндекс Алиса. Алиса, сделай ярче настольную лампу.]

8. [https://connect.smartliving.ru/profile/461/blog/majordomo-i-yandeks-alisa-alisa-izmeni-cvet-bra-na-krasnyy.html MajorDoMo и Яндекс Алиса. Алиса, измени цвет бра на красный.]

9. [https://connect.smartliving.ru/profile/461/blog/majordomo-i-yandeks-alisa-alisa-vklyuchi-kanal-karusel.html MajorDoMo и Яндекс Алиса. Алиса, включи канал Карусель.]

Установка на Linux

2020-04-08T18:17:16Z

Mab: /* Устанавливаем PHP */

[[Category:Установка]]

==Альтернативные варианты==
[[installmd|Скрипт installmd, установка почти на все виды плат и полноценный Linux]]

[https://mjdm.ru/forum/viewtopic.php?f=3&p=92843#p92843 Скрипт установки на Ubuntu 16 или 18]

== Внимание!!! ==

''Инструкция была написана под операционную систему Ubuntu 18.10 и тестировалась только на ней!
В случае если у Вас установлена другая операционная система Linux то возможно, на каком-то из шагов, у Вас возникнут ошибки. В данном случае, рекомендуется сообщить об этих ошибках в чат в [https://t.me/MajorDoMoRu Telegram] или же на [https://majordomo.smartliving.ru/forum/ форум].''

'''<big>Перед началом работы необходимо убедиться что в системе установлен пакет sudo.</big>'''

Для этого нужно выполнить команду:

<pre>sudo</pre>

В случае если в ответ будет отображено сообщение подобного плана:

<pre>bash: sudo: command not found</pre>

Это будет обозначать, что пакет sudo по умолчанию не установлен в Вашей ОС. Потому его необходимо установить.

Для это необходимо выполнить следующие команды:

<pre>su -</pre>

Будет запрошен пароль пользователя от которого выполняется команда.

'''Важно!!!''' При вводе пароля символы не будут отображены на экране!

После успешного ввода пароля, в случае если вид консоли изменился и принял подобный вид:

<pre>root@localhost:~#</pre>

Производится установка sudo командой:

<pre>apt install sudo</pre>

После успешной установки пакета, необходимо добавить пользователя, от которого будет производиться установка, в группу sudo. Это делается командой:

<pre>usermod -aG sudo USERNAME</pre>

Где:
USERNAME - это имя пользователя. Для Raspberry PI это обычно пользователь: pi.
По завершении этих действий, необходимо выйти в окружение обычного пользователя. Это выполняется командой:

<pre>exit</pre>

Приглашающее сообщение в консоли, должно принять подобный вид:

<pre>pi@localhost:~$</pre>

==Обновление кеша пакетов и обновление установленных пакетов (в случае если для них есть обновления)==
<pre>sudo apt-get update
sudo apt-get upgrade</pre>
Установим ещё пару приложений которые будем использовать в процессе установки

<pre>sudo apt-get install nano wget unzip -y</pre>

==Устанавливаем SSH==

<pre>sudo apt-get install openssh-server openssh-client -y</pre>

==Устанавливаем MySQL==

<pre>sudo apt-get install mysql-server mysql-client -y</pre>

Когда запросит установить пароль для root – укажите любой пароль, который Вы запомните. Этот пароль понадобится в дальнейшем.

'''Важно!!!''' Если установщик не запросил пароль, то выполните в консоли команду:

<pre>sudo mysql_secure_installation</pre>

И пройдите по всем шагам. И в этих шагах укажите пароль пользователя root.

'''В Debian 10''' в качестве альтернативы MySQL по умолчанию используется форк проекта, MariaDB, который поддерживается сообществом.

<pre>sudo apt-get install mariadb-server -y</pre>

'''---'''

==Создание пользователя и БД MySQL:==

Для начала создадим БД командой:

<pre>sudo mysql -uroot -p -e "CREATE DATABASE db_terminal;"</pre>

После выполнения этой команды, и далее по параграфу, MySQL будет просить ввести пароль пользователя root, который мы указывали выше. Вводим его где будет необходимо и нажимаем Enter. 
'''Важно!!!''' При вводе пароля символы не будут отображены на экране. 

Далее создаём пользователя для работы с этой БД:

<pre>sudo mysql -uroot -p -e "CREATE USER 'majordomo'@'%' IDENTIFIED BY 'password';"</pre>

password - необходимо заменить на ваш пароль, который тоже необходимо запомнить. Этот пароль будет использоваться для работы MajorDoMo с БД, а так же для входа в phpMyAdmin ниже по инструкции. 
'''Важно!!!''' Рекомендуется использовать сложный пароль, так как в случае если будет открыт доступ к MajorDoMo и phpMyAdmin извне, то есть вероятность того, что простой пароль будет взломан и тот, кто это сделает, сможет получить доступ к важным данным в Вашей MajorDoMo. 

Для предоставления только что созданному пользователю привилегий, необходимо выполнить команду:

<pre>sudo mysql -uroot -p -e "GRANT ALL PRIVILEGES ON *.* TO 'majordomo'@'%';"</pre>

И в завершение, необходимо обновить привилегии:

<pre>sudo mysql -uroot -p -e "FLUSH PRIVILEGES;"</pre>

==Установка WEB сервера==

В качестве web сервера можно установить разные пакеты. В данном случае рассматривается вариант установки Apache.

<pre>sudo apt-get install apache2 apache2-utils -y</pre>

Правим конфиг Апача

<pre>sudo nano /etc/apache2/sites-available/default</pre>

Если такого файла нет, он может называться по-другому. Например:

<pre>000-default.conf</pre>

В этом файле находим раздел:

<pre><Directory /></pre>

И заменяем во всех совпадениях

<pre>AllowOverride None</pre>

на

<pre>AllowOverride All</pre>

Сохраняемся и выходим: Ctrl-O Ctrl-X

В более новых версиях Apache конфигурационный файл может не содержать директив "AllowOverride". В таком случае необходимо вручную привести файл к виду:
<pre>
<VirtualHost *:80>
DocumentRoot /var/www/html
<Directory />
Options FollowSymLinks
AllowOverride All
</Directory>
<Directory /var/www/html>
Options Indexes FollowSymLinks MultiViews
AllowOverride All
Order allow,deny
allow from all
</Directory>

ScriptAlias /cgi-bin/ /usr/lib/cgi-bin/
<Directory "/usr/lib/cgi-bin">
AllowOverride None
Options +ExecCGI -MultiViews +SymLinksIfOwnerMatch
Order allow,deny
Allow from all
</Directory>

ErrorLog ${APACHE_LOG_DIR}/error.log
CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost></pre>

Удаляем стандартный index.html файл командой:

<pre>sudo rm -f /var/www/html/index.html</pre>

И перезапускаем Апач:

<pre>sudo apache2ctl restart</pre>

Если при перезапуске выдаст примерно такой ответ:

<pre>apache2: Could not reliably determine the server's fully qualified domain name, using 127.0.1.1. Set the 'ServerName' directive globally to suppress this message</pre>

То необходимо поправить apache2.conf

<pre>sudo nano /etc/apache2/apache2.conf</pre>

Вставив в него такую строку:

<pre>ServerName localhost</pre>

Сохраняемся и выходим: Ctrl-O Ctrl-X

Перезапускаем Апач

<pre>sudo apache2ctl restart</pre>

Если ваша версия Apache отличается от рассматриваемой, то пути к файлам конфигурации могут быть такими:

<pre>sudo nano /etc/apache2/sites-available/default.conf
sudo nano /etc/apache2/httpd.conf</pre>

==Устанавливаем PHP==

<pre>sudo apt-get install php php-cgi php-cli php-pear php-mysql php-mbstring php-xml -y</pre>

curl и его библиотеки:

<pre>sudo apt-get install curl libcurl3 libcurl3-dev php-curl -y</pre>

'''В Debian 10'''

<pre>sudo apt-get install curl libcurl4 libcurl3-dev php-curl -y</pre>

'''---'''

*Для apache

<pre>sudo apt-get install libapache2-mod-php -y</pre>

*Для последних версий Апача необходимо включить работу с коротким тегом <? /?> для этого откройте файл php.ini командой:

<pre>sudo nano /etc/php/7.0/apache2/php.ini</pre>

Необходимо заменить или вставить строку:

<pre>short_open_tag = On</pre>

==Устанавливаем PHPMYADMIN==

<pre>sudo apt-get install phpmyadmin -y</pre>

Установщик изначально спросит о том, к какой версии web сервера необходимо произвести настройку. Необходимо выбрать версию apache2 путём нажатия пробела и Enter.

Установщик спросит необходимость конфигурирования баз данных при помощи "dbconfig-common". Отвечаем утвердительно путём нажатия Enter.

Далее установщик спрашивает пароль MySQL сервера. Этот пароль задавался в разделе "Устанавливаем MySQL" данного руководства. Вводим указанный пароль и подтверждаем его ещё раз.

==Включаем mod_rewrite==

<pre>sudo a2enmod rewrite</pre>

Перезапускаем Апач

<pre>sudo apache2ctl restart</pre>

'''В Debian 10'''

PhpMyAdmin не включен в репозиторий программного обеспечения Debian 10, поэтому мы должны загрузить его с phpmyadmin.net

Установим необходимые компоненты:
<pre>sudo apt install php-mbstring php-zip php-gd wget -y</pre>

<pre>cd /tmp
wget https://files.phpmyadmin.net/phpMyAdmin/5.0.2/phpMyAdmin-5.0.2-all-languages.zip</pre>

или вставляем ссылку на последнюю версию с сайта https://www.phpmyadmin.net/downloads/

Распаковываем, копируем в /usr/share/phpmyadmin и назначаем права:
<pre>
uzip phpMyAdmin-5.0.2-all-languages.zip
sudo mv phpMyAdmin-5.0.2-all-languages/ /usr/share/phpmyadmin
sudo chown -R www-data:www-data /usr/share/phpmyadmin</pre>

Теперь нам нужно войти в консоль MariaDB и создать базу данных и пользователя для phpMyAdmin.
<pre>
sudo mysql -u root
CREATE DATABASE phpmyadmin DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
GRANT ALL ON *.* TO 'admin'@'localhost' IDENTIFIED BY 'your_preferred_password';
grant all privileges on *.* to admin@localhost with grant option;
FLUSH PRIVILEGES;
EXIT;
</pre>

Затем перезапустите Apache:
<pre>sudo systemctl restart apache2</pre>

Создайте файл phpmyadmin.conf:
<pre>sudo nano /etc/apache2/conf-available/phpmyadmin.conf</pre>

Вставьте следующий текст в файл phpmyadmin.conf:
<pre>
# phpMyAdmin default Apache configuration

Alias /phpmyadmin /usr/share/phpmyadmin

<Directory /usr/share/phpmyadmin>
Options SymLinksIfOwnerMatch
DirectoryIndex index.php

<IfModule mod_php5.c>
<IfModule mod_mime.c>
AddType application/x-httpd-php .php
</IfModule>
<FilesMatch ".+\.php$">
SetHandler application/x-httpd-php
</FilesMatch>

php_value include_path .
php_admin_value upload_tmp_dir /var/lib/phpmyadmin/tmp
php_admin_value open_basedir /usr/share/phpmyadmin/:/etc/phpmyadmin/:/var/lib/phpmyadmin/:/usr/share/php/php-gettext/:/usr/share/php/php-php-gettext/:/usr/share/javascript/:/usr/share/php/tcpdf/:/usr/share/doc/phpmyadmin/:/usr/share/php/phpseclib/
php_admin_value mbstring.func_overload 0
</IfModule>
<IfModule mod_php.c>
<IfModule mod_mime.c>
AddType application/x-httpd-php .php
</IfModule>
<FilesMatch ".+\.php$">
SetHandler application/x-httpd-php
</FilesMatch>

php_value include_path .
php_admin_value upload_tmp_dir /var/lib/phpmyadmin/tmp
php_admin_value open_basedir /usr/share/phpmyadmin/:/etc/phpmyadmin/:/var/lib/phpmyadmin/:/usr/share/php/php-gettext/:/usr/share/php/php-php-gettext/:/usr/share/javascript/:/usr/share/php/tcpdf/:/usr/share/doc/phpmyadmin/:/usr/share/php/phpseclib/
php_admin_value mbstring.func_overload 0
</IfModule>

</Directory>

# Disallow web access to directories that don't need it
<Directory /usr/share/phpmyadmin/templates>
Require all denied
</Directory>
<Directory /usr/share/phpmyadmin/libraries>
Require all denied
</Directory>
<Directory /usr/share/phpmyadmin/setup/lib>
Require all denied
</Directory>
</pre>

Включим этот фрагмент конфигурации:
<pre>sudo a2enconf phpmyadmin.conf</pre>

Создаем временную папку:

<pre>sudo mkdir -p /var/lib/phpmyadmin/tmp
sudo chown www-data:www-data /var/lib/phpmyadmin/tmp</pre>

Перезагрузите Apache, чтобы изменения вступили в силу:

<pre>sudo systemctl reload apache2</pre>

Создаём файл config.inc.php из примера:
<pre>sudo cp /usr/share/phpmyadmin/config.sample.inc.php /usr/share/phpmyadmin/config.inc.php</pre>

Необходимо задать парольную фразу, открываем файл config.inc.php и задаём какую-нибудь парольную фразу длиннее 32-х символов, например,
<pre>$cfg['blowfish_secret'] = '12345678901234567890123456789012'; /* YOU MUST FILL IN THIS FOR COOKIE AUTH! */</pre>

Теперь вы можете получить доступ к веб-интерфейсу phpMyAdmin по адресу, введя имя 'admin' и пароль 'your_preferred_password', которые задали на шаге при создании базы данных и пользователя для phpMyAdmin:
<pre>http://ip_адрес/phpmyadmin</pre>

Теперь в панели управления phpMyAdmin вы можете увидеть предупреждающее сообщение.
<pre>Хранилище конфигурации phpMyAdmin не полностью настроено, некоторые расширенные функции были отключены. Узнайте причину.
Или перейдите на вкладку 'Операции' любой базы данных, чтобы настроить хранилище в ней.</pre>

Переходим по ссылке "Узнайте причину".
Видим сообщение:
<pre>Создать базу данных с именем 'phpmyadmin' и настроить там хранение конфигурации phpMyAdmin.</pre>

Переходим по ссылке "Создать".

'''---'''

==Настройка PHP==

В обоих конфигурационных файлах для web сервера:

<pre>sudo nano /etc/php/7.0/apache2/php.ini</pre>

И файл запуска php скриптов из командной строки:

<pre>sudo nano /etc/php/7.0/cli/php.ini</pre>

Строку error_reporting привести к виду:

<pre>error_reporting = E_ALL & ~E_NOTICE</pre>

А так же строки:
<pre>max_execution_time - С 30 меняем на 90
max_input_time - С 60 на 180
post_max_size - С 8M на 200M
upload_max_filesize - С 2M на 50M
max_file_uploads - С 20 на 150</pre>

Для применения изменений, необходимо перезапустить Apache:

<pre>sudo /etc/init.d/apache2 restart</pre>

==Устанавливаем MajorDoMo==

Скачиваем дистрибутив Majordomo, разархивируем и копируем содержимое majordomo-master в директорию /var/www/html:

<pre>mkdir ~/majordomo
cd ~/majordomo
wget https://github.com/sergejey/majordomo/archive/master.zip
unzip master.zip
sudo cp -rp ~/majordomo/majordomo-master/* /var/www/html
sudo cp -rp ~/majordomo/majordomo-master/.htaccess /var/www/html
rm -rf ~/majordomo</pre>

Настройка прав на файлы и директории

Установка рекомендуемых прав выполняется следующими командами:

Для файлов:

<pre>sudo find /var/www/html/ -type f -exec chmod 0644 {} \;</pre>

Для директорий:

<pre>sudo find /var/www/html/ -type d -exec chmod 0755 {} \;</pre>

Проверяем права командой:

<pre>ls -lh /var/www/html</pre>

Права будут выглядеть подобно:

Для директорий:

<pre>drwxr-xr-x</pre>

Для файлов:

<pre>-rw-r--r--</pre>

<big>Установка собственника и группы на файлы и директории</big>

Majordomo (а именно сервисы: apache и php) работает от пользователя www-data. Права доступа к каталогу /var/www/html, где лежат файлы Majordomo по умолчанию принадлежат root. Изменим владельца директории /var/www/html на www-data.

<pre>sudo chown -R www-data:www-data /var/www/html</pre>

Проверяем:

<pre>ls -lh /var/www/html</pre>

Вывод должен быть подобный:

<pre>-rw-r--r-- 1 www-data www-data 12K May 26 22:19 cycle.php</pre>

Теперь необходимо предоставить доступ пользователю www-data к медиа устройствам. Для этого его необходимо добавить в группу audio.

Это делается командой usermod:

<pre>sudo usermod -a -G audio www-data</pre>

Проверяем, что он появился в группе:

<pre>cat /etc/group | grep audio</pre>

Если всё в порядке, то вывод будет подобный:

<pre>audio:x:29:www-data</pre>

''Дальнейшие команды в этом разделе нужно использовать только в случае если у Вас по какой-то причине система не работает совсем или не работает частично.''

<big>В большинстве случаев на моменте начального конфигурирования, проблемы с системой возникают из-за неправильно установленных прав.</big>

Меняем права доступа к файлам по принципу: всем-всё.

<pre>sudo find /var/www/html/ -type f -exec chmod 0666 {} \;</pre>

И директориям

<pre>sudo find /var/www/html/ -type d -exec chmod 0777 {} \;</pre>

Проверяем права командой:

<pre>ls -lh /var/www/html</pre>

Права будут выглядеть подобно:

Для директорий:

<pre>drwxrwxrwx</pre>

Для файлов:

<pre>-rw-rw-rw-</pre>

В случае если права по какой-то причине не установились, то можно сделать вариант в котором устанавливаются полные права для всех рекурсивно по директориям и файлам.

Команда выглядит так:

<pre>sudo chmod -R 777 /var/www/html</pre>

Необходимо заметить, что данный способ, не самый безопасный, но самый простой.

==Импорт базы данных==

Заходим по адресу:

<pre>http://localhost/phpmyadmin</pre>

Или:

<pre>http://localhost/phpmyadmin4</pre>

При входе будет запрошен логин, его необходимо указать как: majordomo, и пароль который который был задан на шаге: "Создание пользователя и БД MySQL".

В созданную ранее БД необходимо импортировать файл db_terminal.sql из директории с дистрибутивом. Скачать его можно по ссылке: [https://raw.githubusercontent.com/sergejey/majordomo/master/db_terminal.sql db_termina.sql]. Для скачивания нажмите правой кнопкой мыши на ссылку и выберите: "Сохранить ссылку как...".

Далее выполняем последовательность действий в phpMyAdmin для импорта sql файла.

* В левой части окна выбрать БД db_terminal, путём нажатия один раз на её название.
* В верхней части окна найти кнопку "Импорт".
* В загрузившейся странице, в разделе "Импортируемый файл" нажать "Выберите файл" или "Обзор".
* В открывшемся окне, выбрать ранее сохраненный файл "db_terminal.sql".
* В нижней части окна нажать "Вперёд".

После успешного импорта должна отобразится зелёная строка с подобным текстом:

<pre>Импорт успешно завершён, выполнено 171 запросов. (db_terminal.sql)</pre>

В случае если возникли проблемы с импортом БД используя phpMyAdmin, есть возможность импортировать дамп БД используя командную строку. Для этого скачайте дамп файл командой:

<pre>sudo wget -O /tmp/db_terminal.sql https://raw.githubusercontent.com/sergejey/majordomo/master/db_terminal.sql</pre>

И импортируйте его:

<pre>sudo mysql -umajordomo -p db_terminal < /tmp/db_terminal.sql</pre>

Будет запрошен пароль пользователя majordomo, который был задан на шаге: "[[Установка_на_Linux#Создание пользователя и БД MySQL:|Создание пользователя и БД MySQL]]".

==Правим основной конфиг==

Изначально копируем пример конфига в рабочий конфиг:

<pre>sudo cp /var/www/html/config.php.sample /var/www/html/config.php</pre>

Установим собственника и группу для конфига:

<pre>sudo chown www-data: /var/www/html/config.php</pre>

И открываем конфиг для редактирования:

<pre>sudo nano /var/www/html/config.php</pre>

Прописываем имя пользователя и пароль пользователя БД. Для этого нужно исправить строки:

<pre>Define('DB_USER', 'majordomo');
Define('DB_PASSWORD', '');</pre>

Где:
* '''DB_USER''' - пользователь majordomo который был создан на шаге: "Создание пользователя и БД MySQL".
* '''DB_PASSWORD''' - пароль от этого пользователя, который был задан на том же шаге.

Сохраняем файл, и выходим из редактора.

Все, теперь можно зайти на веб интерфейс Majordomo.

http://localhost/

Или:

http://sever_ip/

Если установка выполняется не на локальную машину.

При первом входе должна быть отображена страница: "Hello, world! :)" на которой необходимо выбрать тайм зону, язык системы и цветовую тему. По завершении нажать кнопку "Continue".

В случае если такая страница не отобразилась, открыть её можно по ссылке:

<pre>http://localhost/popup/first_start.html</pre>

==Основной цикл Вариант 1. Systemd unit. Предпочтительный==

Код юнита:

<pre>
[Unit]
Description=Majordomo cycles service
Requires=network.target mysql.service apache2.service
After=mysql.service apache2.service

[Service]
Type=simple
User=www-data
Group=www-data
ExecStart=/usr/bin/php /var/www/html/cycle.php
ExecStop=/usr/bin/pkill -f cycle_*

KillSignal=SIGKILL
KillMode=control-group
RestartSec=1min
Restart=on-failure

[Install]
WantedBy=multi-user.target</pre>

Данный код необходимо скопировать в файл: /etc/systemd/system/majordomo.service Для этого открываем файл:

<pre>sudo nano /etc/systemd/system/majordomo.service</pre>

И вставляем в него код, который представлен выше.

Для автозапуска MajorDoMo при старте системы, необходимо выполнить команду:

<pre>sudo systemctl enable majordomo</pre>

И для запуска MajorDoMo необходимо выполнить:

<pre>sudo systemctl start majordomo</pre>

==Основной цикл Вариант 2. Если не сработал первый вариант==

Запуск основного цикла добавляем в Cron, для пользователя www-data, так как файлы МД принадлежат этому пользователю.

<pre>sudo crontab -e -u www-data</pre>

В открывшемся окне добавляем строку:

<pre>@reboot /usr/bin/php /var/www/html/cycle.php</pre>

'''И обязательно!''' ставим Enter для того чтобы в конце открытого файла был перенос строки.

Сохраняем и перезапускаем компьютер:

<pre>sudo reboot</pre>

После запуска циклов можно открыть MajorDoMo по адресу:

<pre>http://localhost/</pre>

В случае если MajorDoMo устанавливалась на локальный компьютер.

Или:

<pre>http://IP_ADDRESS/</pre>

Если MajorDoMo устанавливалась на удалённый сервер.

Если не выполняются onNewMinute и onNewHour

Нужно проверить настройку BASE_URL в config.php. Если Вы используете домен, а не IP, тогда добавьте в файл /etc/hosts строку вида:

<pre>127.0.0.1 domain.com</pre>

Где domain.com - это Ваш домен который Вы используете. Комментарий Сергея с форума: Дело в том, что эти методы вызываются через внутреннюю функцию raseEvent, которая обращается к серверу через HTTP-запрос используя BASE_URL. Если он неправильный, то метод не вызовется.

На этом статья об установке MajorDoMo на Linux Ubuntu закончена.

==Полезные темы на форуме==

Для быстрой установки необходимых атрибутов можно воспользоваться [http://smartliving.ru/forum/viewtopic.php?f=3&t=2&start=10#p84 данным скриптом].

[http://smartliving.ru/forum/viewtopic.php?f=3&t=298 Установка на Ubuntu]

[http://smartliving.ru/forum/viewtopic.php?f=3&t=573 Установка Системы Majordomo на Raspberry pi]

[http://smartliving.ru/forum/viewtopic.php?f=3&t=371 Установка на FreeBSD]

[http://smartliving.ru/forum/viewtopic.php?f=3&t=630 (РЕШЕНО) Проблема с установкой и настройкой на Ubuntu 13.04]

[http://smartliving.ru/forum/viewtopic.php?f=3&t=424 Установка на Debian подробная инструкция]

[http://smartliving.ru/forum/viewtopic.php?f=3&t=740 CubieBoard - попытка №1]

Установка на Linux

2020-03-25T17:02:31Z

Mab: /* Устанавливаем PHP */

[[Category:Установка]]

==Альтернативные варианты==
[[installmd|Скрипт installmd, установка почти на все виды плат и полноценный Linux]]

[https://mjdm.ru/forum/viewtopic.php?f=3&p=92843#p92843 Скрипт установки на Ubuntu 16 или 18]

== Внимание!!! ==

''Инструкция была написана под операционную систему Ubuntu 18.10 и тестировалась только на ней!
В случае если у Вас установлена другая операционная система Linux то возможно, на каком-то из шагов, у Вас возникнут ошибки. В данном случае, рекомендуется сообщить об этих ошибках в чат в [https://t.me/MajorDoMoRu Telegram] или же на [https://majordomo.smartliving.ru/forum/ форум].''

'''<big>Перед началом работы необходимо убедиться что в системе установлен пакет sudo.</big>'''

Для этого нужно выполнить команду:

<pre>sudo</pre>

В случае если в ответ будет отображено сообщение подобного плана:

<pre>bash: sudo: command not found</pre>

Это будет обозначать, что пакет sudo по умолчанию не установлен в Вашей ОС. Потому его необходимо установить.

Для это необходимо выполнить следующие команды:

<pre>su -</pre>

Будет запрошен пароль пользователя от которого выполняется команда.

'''Важно!!!''' При вводе пароля символы не будут отображены на экране!

После успешного ввода пароля, в случае если вид консоли изменился и принял подобный вид:

<pre>root@localhost:~#</pre>

Производится установка sudo командой:

<pre>apt install sudo</pre>

После успешной установки пакета, необходимо добавить пользователя, от которого будет производиться установка, в группу sudo. Это делается командой:

<pre>usermod -aG sudo USERNAME</pre>

Где:
USERNAME - это имя пользователя. Для Raspberry PI это обычно пользователь: pi.
По завершении этих действий, необходимо выйти в окружение обычного пользователя. Это выполняется командой:

<pre>exit</pre>

Приглашающее сообщение в консоли, должно принять подобный вид:

<pre>pi@localhost:~$</pre>

==Обновление кеша пакетов и обновление установленных пакетов (в случае если для них есть обновления)==
<pre>sudo apt-get update
sudo apt-get upgrade</pre>
Установим ещё пару приложений которые будем использовать в процессе установки

<pre>sudo apt-get install nano wget unzip -y</pre>

==Устанавливаем SSH==

<pre>sudo apt-get install openssh-server openssh-client -y</pre>

==Устанавливаем MySQL==

<pre>sudo apt-get install mysql-server mysql-client -y</pre>

Когда запросит установить пароль для root – укажите любой пароль, который Вы запомните. Этот пароль понадобится в дальнейшем.

'''Важно!!!''' Если установщик не запросил пароль, то выполните в консоли команду:

<pre>sudo mysql_secure_installation</pre>

И пройдите по всем шагам. И в этих шагах укажите пароль пользователя root.

'''В Debian 10''' в качестве альтернативы MySQL по умолчанию используется форк проекта, MariaDB, который поддерживается сообществом.

<pre>sudo apt-get install mariadb-server -y</pre>

==Создание пользователя и БД MySQL:==

Для начала создадим БД командой:

<pre>sudo mysql -uroot -p -e "CREATE DATABASE db_terminal;"</pre>

После выполнения этой команды, и далее по параграфу, MySQL будет просить ввести пароль пользователя root, который мы указывали выше. Вводим его где будет необходимо и нажимаем Enter. 
'''Важно!!!''' При вводе пароля символы не будут отображены на экране. 

Далее создаём пользователя для работы с этой БД:

<pre>sudo mysql -uroot -p -e "CREATE USER 'majordomo'@'%' IDENTIFIED BY 'password';"</pre>

password - необходимо заменить на ваш пароль, который тоже необходимо запомнить. Этот пароль будет использоваться для работы MajorDoMo с БД, а так же для входа в phpMyAdmin ниже по инструкции. 
'''Важно!!!''' Рекомендуется использовать сложный пароль, так как в случае если будет открыт доступ к MajorDoMo и phpMyAdmin извне, то есть вероятность того, что простой пароль будет взломан и тот, кто это сделает, сможет получить доступ к важным данным в Вашей MajorDoMo. 

Для предоставления только что созданному пользователю привилегий, необходимо выполнить команду:

<pre>sudo mysql -uroot -p -e "GRANT ALL PRIVILEGES ON *.* TO 'majordomo'@'%';"</pre>

И в завершение, необходимо обновить привилегии:

<pre>sudo mysql -uroot -p -e "FLUSH PRIVILEGES;"</pre>

==Установка WEB сервера==

В качестве web сервера можно установить разные пакеты. В данном случае рассматривается вариант установки Apache.

<pre>sudo apt-get install apache2 apache2-utils -y</pre>

Правим конфиг Апача

<pre>sudo nano /etc/apache2/sites-available/default</pre>

Если такого файла нет, он может называться по-другому. Например:

<pre>000-default.conf</pre>

В этом файле находим раздел:

<pre><Directory /></pre>

И заменяем во всех совпадениях

<pre>AllowOverride None</pre>

на

<pre>AllowOverride All</pre>

Сохраняемся и выходим: Ctrl-O Ctrl-X

В более новых версиях Apache конфигурационный файл может не содержать директив "AllowOverride". В таком случае необходимо вручную привести файл к виду:
<pre>
<VirtualHost *:80>
DocumentRoot /var/www/html
<Directory />
Options FollowSymLinks
AllowOverride All
</Directory>
<Directory /var/www/html>
Options Indexes FollowSymLinks MultiViews
AllowOverride All
Order allow,deny
allow from all
</Directory>

ScriptAlias /cgi-bin/ /usr/lib/cgi-bin/
<Directory "/usr/lib/cgi-bin">
AllowOverride None
Options +ExecCGI -MultiViews +SymLinksIfOwnerMatch
Order allow,deny
Allow from all
</Directory>

ErrorLog ${APACHE_LOG_DIR}/error.log
CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost></pre>

Удаляем стандартный index.html файл командой:

<pre>sudo rm -f /var/www/html/index.html</pre>

И перезапускаем Апач:

<pre>sudo apache2ctl restart</pre>

Если при перезапуске выдаст примерно такой ответ:

<pre>apache2: Could not reliably determine the server's fully qualified domain name, using 127.0.1.1. Set the 'ServerName' directive globally to suppress this message</pre>

То необходимо поправить apache2.conf

<pre>sudo nano /etc/apache2/apache2.conf</pre>

Вставив в него такую строку:

<pre>ServerName localhost</pre>

Сохраняемся и выходим: Ctrl-O Ctrl-X

Перезапускаем Апач

<pre>sudo apache2ctl restart</pre>

Если ваша версия Apache отличается от рассматриваемой, то пути к файлам конфигурации могут быть такими:

<pre>sudo nano /etc/apache2/sites-available/default.conf
sudo nano /etc/apache2/httpd.conf</pre>

==Устанавливаем PHP==

<pre>sudo apt-get install php php-cgi php-cli php-pear php-mysql php-mbstring php-xml -y</pre>

curl и его библиотеки:

<pre>sudo apt-get install curl libcurl3 libcurl3-dev php-curl -y</pre>

'''В Debian 10'''

<pre>sudo apt-get install curl libcurl4 libcurl3-dev php-curl -y</pre>

*Для apache

<pre>sudo apt-get install libapache2-mod-php -y</pre>

*Для последних версий Апача необходимо включить работу с коротким тегом <? /?> для этого откройте файл php.ini командой:

<pre>sudo nano /etc/php/7.0/apache2/php.ini</pre>

Необходимо заменить или вставить строку:

<pre>short_open_tag = On</pre>

==Устанавливаем PHPMYADMIN==

<pre>sudo apt-get install phpmyadmin -y</pre>

Установщик изначально спросит о том, к какой версии web сервера необходимо произвести настройку. Необходимо выбрать версию apache2 путём нажатия пробела и Enter.

Установщик спросит необходимость конфигурирования баз данных при помощи "dbconfig-common". Отвечаем утвердительно путём нажатия Enter.

Далее установщик спрашивает пароль MySQL сервера. Этот пароль задавался в разделе "Устанавливаем MySQL" данного руководства. Вводим указанный пароль и подтверждаем его ещё раз.

==Включаем mod_rewrite==

<pre>sudo a2enmod rewrite</pre>

Перезапускаем Апач

<pre>sudo apache2ctl restart</pre>

'''В Debian 10'''

PhpMyAdmin не включен в репозиторий программного обеспечения Debian 10, поэтому мы должны загрузить его с phpmyadmin.net

Установим необходимые компоненты:
<pre>sudo apt install php-mbstring php-zip php-gd wget -y</pre>

<pre>cd /tmp
wget https://files.phpmyadmin.net/phpMyAdmin/5.0.2/phpMyAdmin-5.0.2-all-languages.zip</pre>

или вставляем ссылку на последнюю версию с сайта https://www.phpmyadmin.net/downloads/

Распаковываем, копируем в /usr/share/phpmyadmin и назначаем права:
<pre>
uzip phpMyAdmin-5.0.2-all-languages.zip
sudo mv phpMyAdmin-5.0.2-all-languages/ /usr/share/phpmyadmin
sudo chown -R www-data:www-data /usr/share/phpmyadmin</pre>

Теперь нам нужно войти в консоль MariaDB и создать базу данных и пользователя для phpMyAdmin.
<pre>
sudo mysql -u root
CREATE DATABASE phpmyadmin DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
GRANT ALL ON *.* TO 'admin'@'localhost' IDENTIFIED BY 'your_preferred_password';
grant all privileges on *.* to admin@localhost with grant option;
FLUSH PRIVILEGES;
EXIT;
</pre>

Затем перезапустите Apache:
<pre>sudo systemctl restart apache2</pre>

Создайте файл phpmyadmin.conf:
<pre>sudo nano /etc/apache2/conf-available/phpmyadmin.conf</pre>

Вставьте следующий текст в файл phpmyadmin.conf:
<pre>
# phpMyAdmin default Apache configuration

Alias /phpmyadmin /usr/share/phpmyadmin

<Directory /usr/share/phpmyadmin>
Options SymLinksIfOwnerMatch
DirectoryIndex index.php

<IfModule mod_php5.c>
<IfModule mod_mime.c>
AddType application/x-httpd-php .php
</IfModule>
<FilesMatch ".+\.php$">
SetHandler application/x-httpd-php
</FilesMatch>

php_value include_path .
php_admin_value upload_tmp_dir /var/lib/phpmyadmin/tmp
php_admin_value open_basedir /usr/share/phpmyadmin/:/etc/phpmyadmin/:/var/lib/phpmyadmin/:/usr/share/php/php-gettext/:/usr/share/php/php-php-gettext/:/usr/share/javascript/:/usr/share/php/tcpdf/:/usr/share/doc/phpmyadmin/:/usr/share/php/phpseclib/
php_admin_value mbstring.func_overload 0
</IfModule>
<IfModule mod_php.c>
<IfModule mod_mime.c>
AddType application/x-httpd-php .php
</IfModule>
<FilesMatch ".+\.php$">
SetHandler application/x-httpd-php
</FilesMatch>

php_value include_path .
php_admin_value upload_tmp_dir /var/lib/phpmyadmin/tmp
php_admin_value open_basedir /usr/share/phpmyadmin/:/etc/phpmyadmin/:/var/lib/phpmyadmin/:/usr/share/php/php-gettext/:/usr/share/php/php-php-gettext/:/usr/share/javascript/:/usr/share/php/tcpdf/:/usr/share/doc/phpmyadmin/:/usr/share/php/phpseclib/
php_admin_value mbstring.func_overload 0
</IfModule>

</Directory>

# Disallow web access to directories that don't need it
<Directory /usr/share/phpmyadmin/templates>
Require all denied
</Directory>
<Directory /usr/share/phpmyadmin/libraries>
Require all denied
</Directory>
<Directory /usr/share/phpmyadmin/setup/lib>
Require all denied
</Directory>
</pre>

Включим этот фрагмент конфигурации:
<pre>sudo a2enconf phpmyadmin.conf</pre>

Создаем временную папку:

<pre>sudo mkdir -p /var/lib/phpmyadmin/tmp
sudo chown www-data:www-data /var/lib/phpmyadmin/tmp</pre>

Перезагрузите Apache, чтобы изменения вступили в силу:

<pre>sudo systemctl reload apache2</pre>

Создаём файл config.inc.php из примера:
<pre>sudo cp /usr/share/phpmyadmin/config.sample.inc.php /usr/share/phpmyadmin/config.inc.php</pre>

Необходимо задать парольную фразу, открываем файл config.inc.php и задаём какую-нибудь парольную фразу длиннее 32-х символов, например,
<pre>$cfg['blowfish_secret'] = '12345678901234567890123456789012'; /* YOU MUST FILL IN THIS FOR COOKIE AUTH! */</pre>

Теперь вы можете получить доступ к веб-интерфейсу phpMyAdmin по адресу, введя имя 'admin' и пароль 'your_preferred_password', которые задали на шаге при создании базы данных и пользователя для phpMyAdmin:
<pre>http://ip_адрес/phpmyadmin</pre>

Теперь в панели управления phpMyAdmin вы можете увидеть предупреждающее сообщение.
<pre>Хранилище конфигурации phpMyAdmin не полностью настроено, некоторые расширенные функции были отключены. Узнайте причину.
Или перейдите на вкладку 'Операции' любой базы данных, чтобы настроить хранилище в ней.</pre>

Переходим по ссылке "Узнайте причину".
Видим сообщение:
<pre>Создать базу данных с именем 'phpmyadmin' и настроить там хранение конфигурации phpMyAdmin.</pre>

Переходим по ссылке "Создать".

==Настройка PHP==

В обоих конфигурационных файлах для web сервера:

<pre>sudo nano /etc/php/7.0/apache2/php.ini</pre>

И файл запуска php скриптов из командной строки:

<pre>sudo nano /etc/php/7.0/cli/php.ini</pre>

Строку error_reporting привести к виду:

<pre>error_reporting = E_ALL & ~E_NOTICE</pre>

А так же строки:
<pre>max_execution_time - С 30 меняем на 90
max_input_time - С 60 на 180
post_max_size - С 8M на 200M
upload_max_filesize - С 2M на 50M
max_file_uploads - С 20 на 150</pre>

Для применения изменений, необходимо перезапустить Apache:

<pre>sudo /etc/init.d/apache2 restart</pre>

==Устанавливаем MajorDoMo==

Скачиваем дистрибутив Majordomo, разархивируем и копируем содержимое majordomo-master в директорию /var/www/html:

<pre>mkdir ~/majordomo
cd ~/majordomo
wget https://github.com/sergejey/majordomo/archive/master.zip
unzip master.zip
sudo cp -rp ~/majordomo/majordomo-master/* /var/www/html
sudo cp -rp ~/majordomo/majordomo-master/.htaccess /var/www/html
rm -rf ~/majordomo</pre>

Настройка прав на файлы и директории

Установка рекомендуемых прав выполняется следующими командами:

Для файлов:

<pre>sudo find /var/www/html/ -type f -exec chmod 0644 {} \;</pre>

Для директорий:

<pre>sudo find /var/www/html/ -type d -exec chmod 0755 {} \;</pre>

Проверяем права командой:

<pre>ls -lh /var/www/html</pre>

Права будут выглядеть подобно:

Для директорий:

<pre>drwxr-xr-x</pre>

Для файлов:

<pre>-rw-r--r--</pre>

<big>Установка собственника и группы на файлы и директории</big>

Majordomo (а именно сервисы: apache и php) работает от пользователя www-data. Права доступа к каталогу /var/www/html, где лежат файлы Majordomo по умолчанию принадлежат root. Изменим владельца директории /var/www/html на www-data.

<pre>sudo chown -R www-data:www-data /var/www/html</pre>

Проверяем:

<pre>ls -lh /var/www/html</pre>

Вывод должен быть подобный:

<pre>-rw-r--r-- 1 www-data www-data 12K May 26 22:19 cycle.php</pre>

Теперь необходимо предоставить доступ пользователю www-data к медиа устройствам. Для этого его необходимо добавить в группу audio.

Это делается командой usermod:

<pre>sudo usermod -a -G audio www-data</pre>

Проверяем, что он появился в группе:

<pre>cat /etc/group | grep audio</pre>

Если всё в порядке, то вывод будет подобный:

<pre>audio:x:29:www-data</pre>

''Дальнейшие команды в этом разделе нужно использовать только в случае если у Вас по какой-то причине система не работает совсем или не работает частично.''

<big>В большинстве случаев на моменте начального конфигурирования, проблемы с системой возникают из-за неправильно установленных прав.</big>

Меняем права доступа к файлам по принципу: всем-всё.

<pre>sudo find /var/www/html/ -type f -exec chmod 0666 {} \;</pre>

И директориям

<pre>sudo find /var/www/html/ -type d -exec chmod 0777 {} \;</pre>

Проверяем права командой:

<pre>ls -lh /var/www/html</pre>

Права будут выглядеть подобно:

Для директорий:

<pre>drwxrwxrwx</pre>

Для файлов:

<pre>-rw-rw-rw-</pre>

В случае если права по какой-то причине не установились, то можно сделать вариант в котором устанавливаются полные права для всех рекурсивно по директориям и файлам.

Команда выглядит так:

<pre>sudo chmod -R 777 /var/www/html</pre>

Необходимо заметить, что данный способ, не самый безопасный, но самый простой.

==Импорт базы данных==

Заходим по адресу:

<pre>http://localhost/phpmyadmin</pre>

Или:

<pre>http://localhost/phpmyadmin4</pre>

При входе будет запрошен логин, его необходимо указать как: majordomo, и пароль который который был задан на шаге: "Создание пользователя и БД MySQL".

В созданную ранее БД необходимо импортировать файл db_terminal.sql из директории с дистрибутивом. Скачать его можно по ссылке: [https://raw.githubusercontent.com/sergejey/majordomo/master/db_terminal.sql db_termina.sql]. Для скачивания нажмите правой кнопкой мыши на ссылку и выберите: "Сохранить ссылку как...".

Далее выполняем последовательность действий в phpMyAdmin для импорта sql файла.

* В левой части окна выбрать БД db_terminal, путём нажатия один раз на её название.
* В верхней части окна найти кнопку "Импорт".
* В загрузившейся странице, в разделе "Импортируемый файл" нажать "Выберите файл" или "Обзор".
* В открывшемся окне, выбрать ранее сохраненный файл "db_terminal.sql".
* В нижней части окна нажать "Вперёд".

После успешного импорта должна отобразится зелёная строка с подобным текстом:

<pre>Импорт успешно завершён, выполнено 171 запросов. (db_terminal.sql)</pre>

В случае если возникли проблемы с импортом БД используя phpMyAdmin, есть возможность импортировать дамп БД используя командную строку. Для этого скачайте дамп файл командой:

<pre>sudo wget -O /tmp/db_terminal.sql https://raw.githubusercontent.com/sergejey/majordomo/master/db_terminal.sql</pre>

И импортируйте его:

<pre>sudo mysql -umajordomo -p db_terminal < /tmp/db_terminal.sql</pre>

Будет запрошен пароль пользователя majordomo, который был задан на шаге: "[[Установка_на_Linux#Создание пользователя и БД MySQL:|Создание пользователя и БД MySQL]]".

==Правим основной конфиг==

Изначально копируем пример конфига в рабочий конфиг:

<pre>sudo cp /var/www/html/config.php.sample /var/www/html/config.php</pre>

Установим собственника и группу для конфига:

<pre>sudo chown www-data: /var/www/html/config.php</pre>

И открываем конфиг для редактирования:

<pre>sudo nano /var/www/html/config.php</pre>

Прописываем имя пользователя и пароль пользователя БД. Для этого нужно исправить строки:

<pre>Define('DB_USER', 'majordomo');
Define('DB_PASSWORD', '');</pre>

Где:
* '''DB_USER''' - пользователь majordomo который был создан на шаге: "Создание пользователя и БД MySQL".
* '''DB_PASSWORD''' - пароль от этого пользователя, который был задан на том же шаге.

Сохраняем файл, и выходим из редактора.

Все, теперь можно зайти на веб интерфейс Majordomo.

http://localhost/

Или:

http://sever_ip/

Если установка выполняется не на локальную машину.

При первом входе должна быть отображена страница: "Hello, world! :)" на которой необходимо выбрать тайм зону, язык системы и цветовую тему. По завершении нажать кнопку "Continue".

В случае если такая страница не отобразилась, открыть её можно по ссылке:

<pre>http://localhost/popup/first_start.html</pre>

==Основной цикл Вариант 1. Systemd unit. Предпочтительный==

Код юнита:

<pre>
[Unit]
Description=Majordomo cycles service
Requires=network.target mysql.service apache2.service
After=mysql.service apache2.service

[Service]
Type=simple
User=www-data
Group=www-data
ExecStart=/usr/bin/php /var/www/html/cycle.php
ExecStop=/usr/bin/pkill -f cycle_*

KillSignal=SIGKILL
KillMode=control-group
RestartSec=1min
Restart=on-failure

[Install]
WantedBy=multi-user.target</pre>

Данный код необходимо скопировать в файл: /etc/systemd/system/majordomo.service Для этого открываем файл:

<pre>sudo nano /etc/systemd/system/majordomo.service</pre>

И вставляем в него код, который представлен выше.

Для автозапуска MajorDoMo при старте системы, необходимо выполнить команду:

<pre>sudo systemctl enable majordomo</pre>

И для запуска MajorDoMo необходимо выполнить:

<pre>sudo systemctl start majordomo</pre>

==Основной цикл Вариант 2. Если не сработал первый вариант==

Запуск основного цикла добавляем в Cron, для пользователя www-data, так как файлы МД принадлежат этому пользователю.

<pre>sudo crontab -e -u www-data</pre>

В открывшемся окне добавляем строку:

<pre>@reboot /usr/bin/php /var/www/html/cycle.php</pre>

'''И обязательно!''' ставим Enter для того чтобы в конце открытого файла был перенос строки.

Сохраняем и перезапускаем компьютер:

<pre>sudo reboot</pre>

После запуска циклов можно открыть MajorDoMo по адресу:

<pre>http://localhost/</pre>

В случае если MajorDoMo устанавливалась на локальный компьютер.

Или:

<pre>http://IP_ADDRESS/</pre>

Если MajorDoMo устанавливалась на удалённый сервер.

Если не выполняются onNewMinute и onNewHour

Нужно проверить настройку BASE_URL в config.php. Если Вы используете домен, а не IP, тогда добавьте в файл /etc/hosts строку вида:

<pre>127.0.0.1 domain.com</pre>

Где domain.com - это Ваш домен который Вы используете. Комментарий Сергея с форума: Дело в том, что эти методы вызываются через внутреннюю функцию raseEvent, которая обращается к серверу через HTTP-запрос используя BASE_URL. Если он неправильный, то метод не вызовется.

На этом статья об установке MajorDoMo на Linux Ubuntu закончена.

==Полезные темы на форуме==

Для быстрой установки необходимых атрибутов можно воспользоваться [http://smartliving.ru/forum/viewtopic.php?f=3&t=2&start=10#p84 данным скриптом].

[http://smartliving.ru/forum/viewtopic.php?f=3&t=298 Установка на Ubuntu]

[http://smartliving.ru/forum/viewtopic.php?f=3&t=573 Установка Системы Majordomo на Raspberry pi]

[http://smartliving.ru/forum/viewtopic.php?f=3&t=371 Установка на FreeBSD]

[http://smartliving.ru/forum/viewtopic.php?f=3&t=630 (РЕШЕНО) Проблема с установкой и настройкой на Ubuntu 13.04]

[http://smartliving.ru/forum/viewtopic.php?f=3&t=424 Установка на Debian подробная инструкция]

[http://smartliving.ru/forum/viewtopic.php?f=3&t=740 CubieBoard - попытка №1]

Установка на Linux

2020-03-14T10:03:50Z

Mab: /* Устанавливаем MySQL */

[[Category:Установка]]

==Альтернативные варианты==
[[installmd|Скрипт installmd, установка почти на все виды плат и полноценный Linux]]

[https://mjdm.ru/forum/viewtopic.php?f=3&p=92843#p92843 Скрипт установки на Ubuntu 16 или 18]

== Внимание!!! ==

''Инструкция была написана под операционную систему Ubuntu 18.10 и тестировалась только на ней!
В случае если у Вас установлена другая операционная система Linux то возможно, на каком-то из шагов, у Вас возникнут ошибки. В данном случае, рекомендуется сообщить об этих ошибках в чат в [https://t.me/MajorDoMoRu Telegram] или же на [https://majordomo.smartliving.ru/forum/ форум].''

'''<big>Перед началом работы необходимо убедиться что в системе установлен пакет sudo.</big>'''

Для этого нужно выполнить команду:

<pre>sudo</pre>

В случае если в ответ будет отображено сообщение подобного плана:

<pre>bash: sudo: command not found</pre>

Это будет обозначать, что пакет sudo по умолчанию не установлен в Вашей ОС. Потому его необходимо установить.

Для это необходимо выполнить следующие команды:

<pre>su -</pre>

Будет запрошен пароль пользователя от которого выполняется команда.

'''Важно!!!''' При вводе пароля символы не будут отображены на экране!

После успешного ввода пароля, в случае если вид консоли изменился и принял подобный вид:

<pre>root@localhost:~#</pre>

Производится установка sudo командой:

<pre>apt install sudo</pre>

После успешной установки пакета, необходимо добавить пользователя, от которого будет производиться установка, в группу sudo. Это делается командой:

<pre>usermod -aG sudo USERNAME</pre>

Где:
USERNAME - это имя пользователя. Для Raspberry PI это обычно пользователь: pi.
По завершении этих действий, необходимо выйти в окружение обычного пользователя. Это выполняется командой:

<pre>exit</pre>

Приглашающее сообщение в консоли, должно принять подобный вид:

<pre>pi@localhost:~$</pre>

==Обновление кеша пакетов и обновление установленных пакетов (в случае если для них есть обновления)==
<pre>sudo apt-get update
sudo apt-get upgrade</pre>
Установим ещё пару приложений которые будем использовать в процессе установки

<pre>sudo apt-get install nano wget unzip -y</pre>

==Устанавливаем SSH==

<pre>sudo apt-get install openssh-server openssh-client -y</pre>

==Устанавливаем MySQL==

<pre>sudo apt-get install mysql-server mysql-client -y</pre>

Когда запросит установить пароль для root – укажите любой пароль, который Вы запомните. Этот пароль понадобится в дальнейшем.

'''Важно!!!''' Если установщик не запросил пароль, то выполните в консоли команду:

<pre>sudo mysql_secure_installation</pre>

И пройдите по всем шагам. И в этих шагах укажите пароль пользователя root.

=== В Debian 10 ===
в качестве альтернативы MySQL по умолчанию используется форк проекта, MariaDB, который поддерживается сообществом.

<pre>sudo apt-get install mariadb-server -y</pre>

==Создание пользователя и БД MySQL:==

Для начала создадим БД командой:

<pre>sudo mysql -uroot -p -e "CREATE DATABASE db_terminal;"</pre>

После выполнения этой команды, и далее по параграфу, MySQL будет просить ввести пароль пользователя root, который мы указывали выше. Вводим его где будет необходимо и нажимаем Enter. 
'''Важно!!!''' При вводе пароля символы не будут отображены на экране. 

Далее создаём пользователя для работы с этой БД:

<pre>sudo mysql -uroot -p -e "CREATE USER 'majordomo'@'%' IDENTIFIED BY 'password';"</pre>

password - необходимо заменить на ваш пароль, который тоже необходимо запомнить. Этот пароль будет использоваться для работы MajorDoMo с БД, а так же для входа в phpMyAdmin ниже по инструкции. 
'''Важно!!!''' Рекомендуется использовать сложный пароль, так как в случае если будет открыт доступ к MajorDoMo и phpMyAdmin извне, то есть вероятность того, что простой пароль будет взломан и тот, кто это сделает, сможет получить доступ к важным данным в Вашей MajorDoMo. 

Для предоставления только что созданному пользователю привилегий, необходимо выполнить команду:

<pre>sudo mysql -uroot -p -e "GRANT ALL PRIVILEGES ON *.* TO 'majordomo'@'%';"</pre>

И в завершение, необходимо обновить привилегии:

<pre>sudo mysql -uroot -p -e "FLUSH PRIVILEGES;"</pre>

==Установка WEB сервера==

В качестве web сервера можно установить разные пакеты. В данном случае рассматривается вариант установки Apache.

<pre>sudo apt-get install apache2 apache2-utils -y</pre>

Правим конфиг Апача

<pre>sudo nano /etc/apache2/sites-available/default</pre>

Если такого файла нет, он может называться по-другому. Например:

<pre>000-default.conf</pre>

В этом файле находим раздел:

<pre><Directory /></pre>

И заменяем во всех совпадениях

<pre>AllowOverride None</pre>

на

<pre>AllowOverride All</pre>

Сохраняемся и выходим: Ctrl-O Ctrl-X

В более новых версиях Apache конфигурационный файл может не содержать директив "AllowOverride". В таком случае необходимо вручную привести файл к виду:
<pre>
<VirtualHost *:80>
DocumentRoot /var/www/html
<Directory />
Options FollowSymLinks
AllowOverride All
</Directory>
<Directory /var/www/html>
Options Indexes FollowSymLinks MultiViews
AllowOverride All
Order allow,deny
allow from all
</Directory>

ScriptAlias /cgi-bin/ /usr/lib/cgi-bin/
<Directory "/usr/lib/cgi-bin">
AllowOverride None
Options +ExecCGI -MultiViews +SymLinksIfOwnerMatch
Order allow,deny
Allow from all
</Directory>

ErrorLog ${APACHE_LOG_DIR}/error.log
CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost></pre>

Удаляем стандартный index.html файл командой:

<pre>sudo rm -f /var/www/html/index.html</pre>

И перезапускаем Апач:

<pre>sudo apache2ctl restart</pre>

Если при перезапуске выдаст примерно такой ответ:

<pre>apache2: Could not reliably determine the server's fully qualified domain name, using 127.0.1.1. Set the 'ServerName' directive globally to suppress this message</pre>

То необходимо поправить apache2.conf

<pre>sudo nano /etc/apache2/apache2.conf</pre>

Вставив в него такую строку:

<pre>ServerName localhost</pre>

Сохраняемся и выходим: Ctrl-O Ctrl-X

Перезапускаем Апач

<pre>sudo apache2ctl restart</pre>

Если ваша версия Apache отличается от рассматриваемой, то пути к файлам конфигурации могут быть такими:

<pre>sudo nano /etc/apache2/sites-available/default.conf
sudo nano /etc/apache2/httpd.conf</pre>

==Устанавливаем PHP==

<pre>sudo apt-get install php php-cgi php-cli php-pear php-mysql php-mbstring php-xml -y</pre>

curl и его библиотеки:

<pre>sudo apt-get install curl libcurl3 libcurl3-dev php-curl -y</pre>

*Для apache

<pre>sudo apt-get install libapache2-mod-php -y</pre>

*Для последних версий Апача необходимо включить работу с коротким тегом <? /?> для этого откройте файл php.ini командой:

<pre>sudo nano /etc/php/7.0/apache2/php.ini</pre>

Необходимо заменить или вставить строку:

<pre>short_open_tag = On</pre>

==Устанавливаем PHPMYADMIN==

<pre>sudo apt-get install phpmyadmin -y</pre>

Установщик изначально спросит о том, к какой версии web сервера необходимо произвести настройку. Необходимо выбрать версию apache2 путём нажатия пробела и Enter.

Установщик спросит необходимость конфигурирования баз данных при помощи "dbconfig-common". Отвечаем утвердительно путём нажатия Enter.

Далее установщик спрашивает пароль MySQL сервера. Этот пароль задавался в разделе "Устанавливаем MySQL" данного руководства. Вводим указанный пароль и подтверждаем его ещё раз.

==Включаем mod_rewrite==

<pre>sudo a2enmod rewrite</pre>

Перезапускаем Апач

<pre>sudo apache2ctl restart</pre>

==Настройка PHP==

В обоих конфигурационных файлах для web сервера:

<pre>sudo nano /etc/php/7.0/apache2/php.ini</pre>

И файл запуска php скриптов из командной строки:

<pre>sudo nano /etc/php/7.0/cli/php.ini</pre>

Строку error_reporting привести к виду:

<pre>error_reporting = E_ALL & ~E_NOTICE</pre>

А так же строки:
<pre>max_execution_time - С 30 меняем на 90
max_input_time - С 60 на 180
post_max_size - С 8M на 200M
upload_max_filesize - С 2M на 50M
max_file_uploads - С 20 на 150</pre>

Для применения изменений, необходимо перезапустить Apache:

<pre>sudo /etc/init.d/apache2 restart</pre>

==Устанавливаем MajorDoMo==

Скачиваем дистрибутив Majordomo, разархивируем и копируем содержимое majordomo-master в директорию /var/www/html:

<pre>mkdir ~/majordomo
cd ~/majordomo
wget https://github.com/sergejey/majordomo/archive/master.zip
unzip master.zip
sudo cp -rp ~/majordomo/majordomo-master/* /var/www/html
sudo cp -rp ~/majordomo/majordomo-master/.htaccess /var/www/html
rm -rf ~/majordomo</pre>

Настройка прав на файлы и директории

Установка рекомендуемых прав выполняется следующими командами:

Для файлов:

<pre>sudo find /var/www/html/ -type f -exec chmod 0644 {} \;</pre>

Для директорий:

<pre>sudo find /var/www/html/ -type d -exec chmod 0755 {} \;</pre>

Проверяем права командой:

<pre>ls -lh /var/www/html</pre>

Права будут выглядеть подобно:

Для директорий:

<pre>drwxr-xr-x</pre>

Для файлов:

<pre>-rw-r--r--</pre>

<big>Установка собственника и группы на файлы и директории</big>

Majordomo (а именно сервисы: apache и php) работает от пользователя www-data. Права доступа к каталогу /var/www/html, где лежат файлы Majordomo по умолчанию принадлежат root. Изменим владельца директории /var/www/html на www-data.

<pre>sudo chown -R www-data:www-data /var/www/html</pre>

Проверяем:

<pre>ls -lh /var/www/html</pre>

Вывод должен быть подобный:

<pre>-rw-r--r-- 1 www-data www-data 12K May 26 22:19 cycle.php</pre>

Теперь необходимо предоставить доступ пользователю www-data к медиа устройствам. Для этого его необходимо добавить в группу audio.

Это делается командой usermod:

<pre>sudo usermod -a -G audio www-data</pre>

Проверяем, что он появился в группе:

<pre>cat /etc/group | grep audio</pre>

Если всё в порядке, то вывод будет подобный:

<pre>audio:x:29:www-data</pre>

''Дальнейшие команды в этом разделе нужно использовать только в случае если у Вас по какой-то причине система не работает совсем или не работает частично.''

<big>В большинстве случаев на моменте начального конфигурирования, проблемы с системой возникают из-за неправильно установленных прав.</big>

Меняем права доступа к файлам по принципу: всем-всё.

<pre>sudo find /var/www/html/ -type f -exec chmod 0666 {} \;</pre>

И директориям

<pre>sudo find /var/www/html/ -type d -exec chmod 0777 {} \;</pre>

Проверяем права командой:

<pre>ls -lh /var/www/html</pre>

Права будут выглядеть подобно:

Для директорий:

<pre>drwxrwxrwx</pre>

Для файлов:

<pre>-rw-rw-rw-</pre>

В случае если права по какой-то причине не установились, то можно сделать вариант в котором устанавливаются полные права для всех рекурсивно по директориям и файлам.

Команда выглядит так:

<pre>sudo chmod -R 777 /var/www/html</pre>

Необходимо заметить, что данный способ, не самый безопасный, но самый простой.

==Импорт базы данных==

Заходим по адресу:

<pre>http://localhost/phpmyadmin</pre>

Или:

<pre>http://localhost/phpmyadmin4</pre>

При входе будет запрошен логин, его необходимо указать как: majordomo, и пароль который который был задан на шаге: "Создание пользователя и БД MySQL".

В созданную ранее БД необходимо импортировать файл db_terminal.sql из директории с дистрибутивом. Скачать его можно по ссылке: [https://raw.githubusercontent.com/sergejey/majordomo/master/db_terminal.sql db_termina.sql]. Для скачивания нажмите правой кнопкой мыши на ссылку и выберите: "Сохранить ссылку как...".

Далее выполняем последовательность действий в phpMyAdmin для импорта sql файла.

* В левой части окна выбрать БД db_terminal, путём нажатия один раз на её название.
* В верхней части окна найти кнопку "Импорт".
* В загрузившейся странице, в разделе "Импортируемый файл" нажать "Выберите файл" или "Обзор".
* В открывшемся окне, выбрать ранее сохраненный файл "db_terminal.sql".
* В нижней части окна нажать "Вперёд".

После успешного импорта должна отобразится зелёная строка с подобным текстом:

<pre>Импорт успешно завершён, выполнено 171 запросов. (db_terminal.sql)</pre>

В случае если возникли проблемы с импортом БД используя phpMyAdmin, есть возможность импортировать дамп БД используя командную строку. Для этого скачайте дамп файл командой:

<pre>sudo wget -O /tmp/db_terminal.sql https://raw.githubusercontent.com/sergejey/majordomo/master/db_terminal.sql</pre>

И импортируйте его:

<pre>sudo mysql -umajordomo -p db_terminal < /tmp/db_terminal.sql</pre>

Будет запрошен пароль пользователя majordomo, который был задан на шаге: "[[Установка_на_Linux#Создание пользователя и БД MySQL:|Создание пользователя и БД MySQL]]".

==Правим основной конфиг==

Изначально копируем пример конфига в рабочий конфиг:

<pre>sudo cp /var/www/html/config.php.sample /var/www/html/config.php</pre>

Установим собственника и группу для конфига:

<pre>sudo chown www-data: /var/www/html/config.php</pre>

И открываем конфиг для редактирования:

<pre>sudo nano /var/www/html/config.php</pre>

Прописываем имя пользователя и пароль пользователя БД. Для этого нужно исправить строки:

<pre>Define('DB_USER', 'majordomo');
Define('DB_PASSWORD', '');</pre>

Где:
* '''DB_USER''' - пользователь majordomo который был создан на шаге: "Создание пользователя и БД MySQL".
* '''DB_PASSWORD''' - пароль от этого пользователя, который был задан на том же шаге.

Сохраняем файл, и выходим из редактора.

Все, теперь можно зайти на веб интерфейс Majordomo.

http://localhost/

Или:

http://sever_ip/

Если установка выполняется не на локальную машину.

При первом входе должна быть отображена страница: "Hello, world! :)" на которой необходимо выбрать тайм зону, язык системы и цветовую тему. По завершении нажать кнопку "Continue".

В случае если такая страница не отобразилась, открыть её можно по ссылке:

<pre>http://localhost/popup/first_start.html</pre>

==Основной цикл Вариант 1. Systemd unit. Предпочтительный==

Код юнита:

<pre>
[Unit]
Description=Majordomo cycles service
Requires=network.target mysql.service apache2.service
After=mysql.service apache2.service

[Service]
Type=simple
User=www-data
Group=www-data
ExecStart=/usr/bin/php /var/www/html/cycle.php
ExecStop=/usr/bin/pkill -f cycle_*

KillSignal=SIGKILL
KillMode=control-group
RestartSec=1min
Restart=on-failure

[Install]
WantedBy=multi-user.target</pre>

Данный код необходимо скопировать в файл: /etc/systemd/system/majordomo.service Для этого открываем файл:

<pre>sudo nano /etc/systemd/system/majordomo.service</pre>

И вставляем в него код, который представлен выше.

Для автозапуска MajorDoMo при старте системы, необходимо выполнить команду:

<pre>sudo systemctl enable majordomo</pre>

И для запуска MajorDoMo необходимо выполнить:

<pre>sudo systemctl start majordomo</pre>

==Основной цикл Вариант 2. Если не сработал первый вариант==

Запуск основного цикла добавляем в Cron, для пользователя www-data, так как файлы МД принадлежат этому пользователю.

<pre>sudo crontab -e -u www-data</pre>

В открывшемся окне добавляем строку:

<pre>@reboot /usr/bin/php /var/www/html/cycle.php</pre>

'''И обязательно!''' ставим Enter для того чтобы в конце открытого файла был перенос строки.

Сохраняем и перезапускаем компьютер:

<pre>sudo reboot</pre>

После запуска циклов можно открыть MajorDoMo по адресу:

<pre>http://localhost/</pre>

В случае если MajorDoMo устанавливалась на локальный компьютер.

Или:

<pre>http://IP_ADDRESS/</pre>

Если MajorDoMo устанавливалась на удалённый сервер.

Если не выполняются onNewMinute и onNewHour

Нужно проверить настройку BASE_URL в config.php. Если Вы используете домен, а не IP, тогда добавьте в файл /etc/hosts строку вида:

<pre>127.0.0.1 domain.com</pre>

Где domain.com - это Ваш домен который Вы используете. Комментарий Сергея с форума: Дело в том, что эти методы вызываются через внутреннюю функцию raseEvent, которая обращается к серверу через HTTP-запрос используя BASE_URL. Если он неправильный, то метод не вызовется.

На этом статья об установке MajorDoMo на Linux Ubuntu закончена.

==Полезные темы на форуме==

Для быстрой установки необходимых атрибутов можно воспользоваться [http://smartliving.ru/forum/viewtopic.php?f=3&t=2&start=10#p84 данным скриптом].

[http://smartliving.ru/forum/viewtopic.php?f=3&t=298 Установка на Ubuntu]

[http://smartliving.ru/forum/viewtopic.php?f=3&t=573 Установка Системы Majordomo на Raspberry pi]

[http://smartliving.ru/forum/viewtopic.php?f=3&t=371 Установка на FreeBSD]

[http://smartliving.ru/forum/viewtopic.php?f=3&t=630 (РЕШЕНО) Проблема с установкой и настройкой на Ubuntu 13.04]

[http://smartliving.ru/forum/viewtopic.php?f=3&t=424 Установка на Debian подробная инструкция]

[http://smartliving.ru/forum/viewtopic.php?f=3&t=740 CubieBoard - попытка №1]