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

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

2023-05-23T08:52:31Z

Newz20: /* Альтернативные варианты */

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

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

[https://mjdm.ru/forum/viewtopic.php?f=3&p=92843#p92843 Скрипт установки на Ubuntu Server 18, 20, 22 и Mint 19, 20, 21]

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

''Инструкция была написана под операционную систему 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>sudo service systemd-logind restart</pre>

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

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

Если вы разворачиваете сервер на ноутбуке вам пригодится отключение режима засыпания при закрытии крышки.
для этого набираем

<pre>sudo nano /etc/systemd/logind.conf</pre>

Находим строчку ''#HandleLidSwitch=suspend'' и меняем её на

<pre>HandleLidSwitch=ignore</pre>

И опять же перелогиниться

<pre>sudo service systemd-logind restart</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 php7.3 php7.3-cgi php7.3-cli php7.3-pear php7.3-mysql php7.3-mbstring php7.3-xml -y</pre>

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

<pre>sudo apt-get install curl libcurl3 libcurl3-dev php7.3-curl -y</pre>

'''В Debian 10'''

<pre>sudo apt-get install curl libcurl4 libcurl3-dev php7.3-curl -y</pre>

'''---'''

*Для apache

<pre>sudo apt-get install libapache2-mod-php7.3 -y</pre>

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

<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 php7.3-mbstring php7.3-zip php7.3-gd wget -y</pre>

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

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

Распаковываем, копируем в /usr/share/phpmyadmin и назначаем права:
<pre>
unzip phpMyAdmin-5.1.1-all-languages.zip
sudo mv phpMyAdmin-5.1.1-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>
Где '''your_preferred_password''' будет пароль для входа в phpMyAdmin

Затем перезапустите 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>

Для сохранения нажмите CTRL+O ENTER для выхода CTRL+X

Включим этот фрагмент конфигурации:
<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

<pre>sudo nano /usr/share/phpmyadmin/config.inc.php</pre>

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

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

Теперь в панели управления phpMyAdmin вы можете увидеть предупреждающее сообщение.

[[Файл:PhpMyAdmin не полностью настроено.png|центр]]

Переходим по ссылке "Узнайте причину".
Видим сообщение:

[[Файл:Создать базу данных с именем.png|центр]]

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

'''---'''

==Настройка 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".
* В нижней части окна нажать "Вперёд".

[[Файл:Импорт db terminal успешно завершён.png|мини|слева]]
После успешного импорта должна отобразится зелёная строка с подобным текстом:

<pre>Импорт успешно завершён, выполнено 192 запроса. (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

2023-03-02T09:27:12Z

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

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

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

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

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

''Инструкция была написана под операционную систему 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>sudo service systemd-logind restart</pre>

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

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

Если вы разворачиваете сервер на ноутбуке вам пригодится отключение режима засыпания при закрытии крышки.
для этого набираем

<pre>sudo nano /etc/systemd/logind.conf</pre>

Находим строчку ''#HandleLidSwitch=suspend'' и меняем её на

<pre>HandleLidSwitch=ignore</pre>

И опять же перелогиниться

<pre>sudo service systemd-logind restart</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 php7.3 php7.3-cgi php7.3-cli php7.3-pear php7.3-mysql php7.3-mbstring php7.3-xml -y</pre>

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

<pre>sudo apt-get install curl libcurl3 libcurl3-dev php7.3-curl -y</pre>

'''В Debian 10'''

<pre>sudo apt-get install curl libcurl4 libcurl3-dev php7.3-curl -y</pre>

'''---'''

*Для apache

<pre>sudo apt-get install libapache2-mod-php7.3 -y</pre>

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

<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 php7.3-mbstring php7.3-zip php7.3-gd wget -y</pre>

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

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

Распаковываем, копируем в /usr/share/phpmyadmin и назначаем права:
<pre>
unzip phpMyAdmin-5.1.1-all-languages.zip
sudo mv phpMyAdmin-5.1.1-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>
Где '''your_preferred_password''' будет пароль для входа в phpMyAdmin

Затем перезапустите 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>

Для сохранения нажмите CTRL+O ENTER для выхода CTRL+X

Включим этот фрагмент конфигурации:
<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

<pre>sudo nano /usr/share/phpmyadmin/config.inc.php</pre>

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

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

Теперь в панели управления phpMyAdmin вы можете увидеть предупреждающее сообщение.

[[Файл:PhpMyAdmin не полностью настроено.png|центр]]

Переходим по ссылке "Узнайте причину".
Видим сообщение:

[[Файл:Создать базу данных с именем.png|центр]]

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

'''---'''

==Настройка 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".
* В нижней части окна нажать "Вперёд".

[[Файл:Импорт db terminal успешно завершён.png|мини|слева]]
После успешного импорта должна отобразится зелёная строка с подобным текстом:

<pre>Импорт успешно завершён, выполнено 192 запроса. (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]

Телеграм Отправка изображения с IP камеры .

2023-03-02T08:41:17Z

Newz20: Новая страница: «Category:Юзеркейсы ==Описание== Телеграмм. Отправка изображения с IP камеры. ==Код== <pre>exec('sudo ffmpeg -i rtsp://IP:port/user=admin_password=imfzZCJe_channel=0_stream=0.sdp?real_stream -y -f mjpeg -t 0.110 -s 1280x720 mnt/Backup/Video/out.jpg'); $jpg="/mnt/Backup/Video/out.jpg"; $this->sendImageToUser($chat_id,$jpg);</pre> '''rtsp://IP:port''' - адрес и порт камеры. '''mnt/Ba...»

[[Category:Юзеркейсы]]
==Описание==
Телеграмм. Отправка изображения с IP камеры.
==Код==
<pre>exec('sudo ffmpeg -i rtsp://IP:port/user=admin_password=imfzZCJe_channel=0_stream=0.sdp?real_stream -y -f mjpeg -t 0.110 -s 1280x720 mnt/Backup/Video/out.jpg');
$jpg="/mnt/Backup/Video/out.jpg";
$this->sendImageToUser($chat_id,$jpg);</pre>

'''rtsp://IP:port''' - адрес и порт камеры.

'''mnt/Backup/Video/out.jpg''' - путь куда сохранять снимок, у вас он может быть другой.

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

2023-03-02T08:34:44Z

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

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

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

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

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

''Инструкция была написана под операционную систему 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>sudo service systemd-logind restart</pre>

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

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

Если вы разворачиваете сервер на ноутбуке вам пригодится отключение режима засыпания при закрытии крышки.
для этого набираем

<pre>sudo nano /etc/systemd/logind.conf</pre>

Находим строчку ''#HandleLidSwitch=suspend'' и меняем её на

<pre>HandleLidSwitch=ignore</pre>

И опять же перелогиниться

<pre>sudo service systemd-logind restart</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 php7.3 php7.3-cgi php7.3-cli php7.3-pear php7.3-mysql php7.3-mbstring php7.3-xml -y</pre>

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

<pre>sudo apt-get install curl libcurl3 libcurl3-dev php7.3-curl -y</pre>

'''В Debian 10'''

<pre>sudo apt-get install curl libcurl4 libcurl3-dev php7.3-curl -y</pre>

'''---'''

*Для apache

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

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

<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 php7.3-mbstring php7.3-zip php7.3-gd wget -y</pre>

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

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

Распаковываем, копируем в /usr/share/phpmyadmin и назначаем права:
<pre>
unzip phpMyAdmin-5.1.1-all-languages.zip
sudo mv phpMyAdmin-5.1.1-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>
Где '''your_preferred_password''' будет пароль для входа в phpMyAdmin

Затем перезапустите 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>

Для сохранения нажмите CTRL+O ENTER для выхода CTRL+X

Включим этот фрагмент конфигурации:
<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

<pre>sudo nano /usr/share/phpmyadmin/config.inc.php</pre>

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

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

Теперь в панели управления phpMyAdmin вы можете увидеть предупреждающее сообщение.

[[Файл:PhpMyAdmin не полностью настроено.png|центр]]

Переходим по ссылке "Узнайте причину".
Видим сообщение:

[[Файл:Создать базу данных с именем.png|центр]]

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

'''---'''

==Настройка 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".
* В нижней части окна нажать "Вперёд".

[[Файл:Импорт db terminal успешно завершён.png|мини|слева]]
После успешного импорта должна отобразится зелёная строка с подобным текстом:

<pre>Импорт успешно завершён, выполнено 192 запроса. (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

2023-02-20T09:55:02Z

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

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

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

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

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

''Инструкция была написана под операционную систему 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>sudo service systemd-logind restart</pre>

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

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

Если вы разворачиваете сервер на ноутбуке вам пригодится отключение режима засыпания при закрытии крышки.
для этого набираем

<pre>sudo nano /etc/systemd/logind.conf</pre>

Находим строчку ''#HandleLidSwitch=suspend'' и меняем её на

<pre>HandleLidSwitch=ignore</pre>

И опять же перелогиниться

<pre>sudo service systemd-logind restart</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 php7.3 php7.3-cgi php7.3-cli php7.3-pear php7.3-mysql php7.3-mbstring php7.3-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 командой: (внимательно смотрите какая версия PHP установилась у вас, и поменяйте 7.3 на свои версии. здесь и далее по инструкции)

<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 php7.3-mbstring php7.3-zip php7.3-gd wget -y</pre>

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

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

Распаковываем, копируем в /usr/share/phpmyadmin и назначаем права:
<pre>
unzip phpMyAdmin-5.1.1-all-languages.zip
sudo mv phpMyAdmin-5.1.1-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>
Где '''your_preferred_password''' будет пароль для входа в phpMyAdmin

Затем перезапустите 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>

Для сохранения нажмите CTRL+O ENTER для выхода CTRL+X

Включим этот фрагмент конфигурации:
<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

<pre>sudo nano /usr/share/phpmyadmin/config.inc.php</pre>

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

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

Теперь в панели управления phpMyAdmin вы можете увидеть предупреждающее сообщение.

[[Файл:PhpMyAdmin не полностью настроено.png|центр]]

Переходим по ссылке "Узнайте причину".
Видим сообщение:

[[Файл:Создать базу данных с именем.png|центр]]

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

'''---'''

==Настройка 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".
* В нижней части окна нажать "Вперёд".

[[Файл:Импорт db terminal успешно завершён.png|мини|слева]]
После успешного импорта должна отобразится зелёная строка с подобным текстом:

<pre>Импорт успешно завершён, выполнено 192 запроса. (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

2023-02-20T09:54:17Z

Newz20: /* Включаем mod_rewrite */

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

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

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

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

''Инструкция была написана под операционную систему 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>sudo service systemd-logind restart</pre>

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

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

Если вы разворачиваете сервер на ноутбуке вам пригодится отключение режима засыпания при закрытии крышки.
для этого набираем

<pre>sudo nano /etc/systemd/logind.conf</pre>

Находим строчку ''#HandleLidSwitch=suspend'' и меняем её на

<pre>HandleLidSwitch=ignore</pre>

И опять же перелогиниться

<pre>sudo service systemd-logind restart</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 -y php7.3 php7.3-cgi php7.3-cli php-pear php7.3-mbstring php7.3-mysql php7.3-xml</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 командой: (внимательно смотрите какая версия PHP установилась у вас, и поменяйте 7.3 на свои версии. здесь и далее по инструкции)

<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 php7.3-mbstring php7.3-zip php7.3-gd wget -y</pre>

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

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

Распаковываем, копируем в /usr/share/phpmyadmin и назначаем права:
<pre>
unzip phpMyAdmin-5.1.1-all-languages.zip
sudo mv phpMyAdmin-5.1.1-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>
Где '''your_preferred_password''' будет пароль для входа в phpMyAdmin

Затем перезапустите 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>

Для сохранения нажмите CTRL+O ENTER для выхода CTRL+X

Включим этот фрагмент конфигурации:
<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

<pre>sudo nano /usr/share/phpmyadmin/config.inc.php</pre>

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

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

Теперь в панели управления phpMyAdmin вы можете увидеть предупреждающее сообщение.

[[Файл:PhpMyAdmin не полностью настроено.png|центр]]

Переходим по ссылке "Узнайте причину".
Видим сообщение:

[[Файл:Создать базу данных с именем.png|центр]]

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

'''---'''

==Настройка 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".
* В нижней части окна нажать "Вперёд".

[[Файл:Импорт db terminal успешно завершён.png|мини|слева]]
После успешного импорта должна отобразится зелёная строка с подобным текстом:

<pre>Импорт успешно завершён, выполнено 192 запроса. (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]

MQTT модуль

2021-06-04T06:59:15Z

Newz20:

[[Category:MQTT]]
[[Category:Модули]]
'''MQTT''' - (англ. message queuing telemetry transport) — упрощённый сетевой протокол, работающий поверх TCP/IP, ориентированный для обмена сообщениями между устройствами по принципу издатель-подписчик.

Модуль выступает клиентом и способен отправлять и принимать сообщения через сервер, модуль умеет не только прямые подписки на ветки от других клиентов(устройств), но и разбивать данные в формате JSON на ветки и свойства. Вы можете привязывать каждое полученное сообщение в ветке к нужному свойству, ветки не привязанные к свойствам никуда не пишут свои данные.

Для работы клиентов MQTT необходим сервер или еще его называют брокером (в предустановленном наборе и рекомендованный к использованию Mosquitto), данный сервер отвечает за пересылку сообщений от клиента к клиенту. Клиент MQTT может находится где угодно и для работы ему необходим только канал связи с сервером MQTT. Таким образом вы можете через интернет управлять устройствами поддерживающими MQTT протокол где угодно. Они в свою очередь сообщат вам о своем состоянии тем же образом. MajorDoMo может автоматизировать ваш гараж находясь у вас дома, для этого необходим только интернет канал и устройства с поддержкой MQTT.

[[Файл:2019-12-12 08-44-27.jpg|мини|слева|Настройки mqtt]] [[Файл:2019-12-12 08-42-40.jpg|мини|центр|настройка топика mqtt]]

Про retain.
Это "залипание" топика на MQTT брокере.

При подписывании нового клиента к топику он первым делом получает текущее, "залипшее" значение - независимо от того как давно оно произошло (ну, с учетом настроек брокера).

Логика простая: если в топике предполагается хранение текущего значения - лучше его сделать retained. Тогда он будет доступен всем клиентам в любой момент, им не нужно будет дожидаться повторной отправки значения источником.

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

Соответственно, retained топик потребляет больше ресурсов брокера, и использовать его нужно только тогда когда необходимо.

Для фиксации положения осветителей (включены или выключены) при отключении света её можно использовать. В этом случае тот же MD будет знать текущее состояние освещения даже сразу после перезагрузки сервера а не тогда когда кто-то щелкнет выключателем.

А, вот пример когда retained использовать точно не следует: например, в момент нажатия кнопки по MQTT отправляется топик (не важно, со значением или без значения). Просто для того чтобы оповестить подписчиков что произошло событие "нажатие кнопки". Так вот, если его сделать retained, то каждый новый клиент при подписывании на топик сразу получит оповещение "кнопка была нажата", даже если это произошло очень давно.

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

<youtube>gL3UM_HuXAM</youtube>
<youtube>EwH6jY_scUU</youtube>
<youtube>jFUPy1q3ze8</youtube>
<youtube>4O-2dJwRQtg</youtube>

==Примеры кода==
Отправка сообщения через модуль в топик
<pre>include_once(DIR_MODULES . 'mqtt/mqtt.class.php');
$mqtt = new mqtt();
$rezult = $mqtt->mqttPublish($topic, $value, 0, 0);</pre>

==Ошибки==
После перехода mosquitto на version 2.0.10 были по дефолту активировали секьюрити функции теперь запрещен доступ без пароля и запрещено подключение с любых систем не 127.0.0.1

Для начала проверим что версия новая стала

<pre>mosquitto -v</pre>

в консоли линя выведет вам версию, если она больше 2.0 то идем в конфиг

<pre>/etc/mosquitto/mosquitto.conf</pre>

правим файл, к тому что есть дописываем
<pre>listener 1883 0.0.0.0</pre> разрешает подключение к брокеру на любом интерфейсе.
<pre>allow_anonymous true</pre> разрешает подключение без паролей.

Восстановить пароль

2021-01-28T05:43:28Z

Newz20:

====Описание====
Чтобы восстановить пароль пользователя, нужен доступ к админ панели. Если доступа нет, то один из выходов - создать пользователя через базу данных.

Для этого в базе данных db_terminal (через PhpMyAdmin будет удобнее) в таблице users нужно добавить или изменить строку с пользователем.

При изменении своего пользователя достаточно изметить поле
PASSWORD:
<pre>
fb131bc57a477c8c9d068f1ee5622ac304195a77164ccc2d75d82dfe1a727ba8d674ed87f96143b2b416aacefb555e3045c356faa23e6d21de72b85822e39fdd
</pre>
И зайти под своим пользователем с паролем <pre>111</pre>

====Данные новой учетки====
вот настройка на логин '''111''' и пароль '''111'''
====настройка====
USERNAME: <pre>111</pre>
NAME: <pre>111</pre>
PASSWORD:
<pre>
fb131bc57a477c8c9d068f1ee5622ac304195a77164ccc2d75d82dfe1a727ba8d674ed87f96143b2b416aacefb555e3045c356faa23e6d21de72b85822e39fdd
</pre>
IS_ADMIN <pre>1</pre>

Или выполнить
====SQL запрос====
<pre>
INSERT INTO users (USERNAME,NAME,PASSWORD,IS_ADMIN) VALUES('111','111','fb131bc57a477c8c9d068f1ee5622ac304195a77164ccc2d75d82dfe1a727ba8d674ed87f96143b2b416aacefb555e3045c356faa23e6d21de72b85822e39fdd',1);
</pre>

После успешного входа не забудьте удалить пользователя 111 или сменить ему пароль

Восстановить пароль

2021-01-28T05:27:05Z

Newz20:

====Описание====
Чтобы восстановить пароль пользователя, нужен доступ к админ панели. Если доступа нет, то один из выходов - создать пользователя через базу данных.

Для этого в базе данных db_terminal (через PhpMyAdmin будет удобнее) в таблице users нужно добавить или изменить строку с пользователем.

При изменении своего пользователя достаточно изметить поле
PASSWORD:
<pre>
fb131bc57a477c8c9d068f1ee5622ac304195a77164ccc2d75d82dfe1a727ba8d674ed87f96143b2b416aacefb555e3045c356faa23e6d21de72b85822e39fdd
</pre>
И зайти под своим пользователем с паролем <pre>111</pre>

====Данные новой учетки====
вот настройка на логин '''111''' и пароль '''111'''
====настройка====
USERNAME: <pre>111</pre>
NAME: <pre>111</pre>
PASSWORD:
<pre>
fb131bc57a477c8c9d068f1ee5622ac304195a77164ccc2d75d82dfe1a727ba8d674ed87f96143b2b416aacefb555e3045c356faa23e6d21de72b85822e39fdd
</pre>
IS_ADMIN <pre>1</pre>

Или выполнить
====SQL запрос====
<pre>
INSERT INTO users (USERNAME,NAME,PASSWORD,IS_ADMIN) VALUES('111','111','fb131bc57a477c8c9d068f1ee5622ac304195a77164ccc2d75d82dfe1a727ba8d674ed87f96143b2b416aacefb555e3045c356faa23e6d21de72b85822e39fdd','1');
</pre>

После успешного входа не забудьте удалить пользователя 111 или сменить ему пароль

RemoveLinkedProperty

2021-01-24T15:21:18Z

Newz20: /* Альтернативные названия функции (сленг) */

[[Category:Встроенные функции]]
==Описание==
'''removeLinkedProperty'''($object, $property, $module); -- Summary of removeLinkedProperty
@param mixed $object Object
@param mixed $property Property
@param mixed $module Module
@return int
==Примеры запросов==

removeLinkedProperty(объект, свойство, zigbee2mqtt);

==Альтернативные названия функции (сленг)==

linked

RemoveLinkedProperty

2021-01-24T15:20:44Z

Newz20: /* Примеры запросов */

NEW VALUE и OLD VALUE

2020-12-17T10:39:49Z

Newz20:

[[Category:Примеры]]

<pre>if ($params['NEW_VALUE'] == $params['OLD_VALUE']) return;</pre> //код сравнивает новое значение со старым и выходит из метода если они совпадают.

срабатывание по фронту для 0/1 значений
<pre>if ($params['NEW_VALUE'] == 1 && $params['OLD_VALUE'] == 0) </pre> // из 0 в 1 - "началось"
<pre>if ($params['NEW_VALUE'] == 0 && $params['OLD_VALUE'] == 1) </pre> // из 1 в 0 - "кончилось"

Однако из топика MQTT приходит параметр не NEW_VALUE, а '''VALUE'''. При использовании привязки методов к топикам использовать его.

Так же можно использовать в различных условиях передаваемые данные (ниже пример вызова метода по изменению свойства класса)
<pre>
//{"PROPERTY":"temperatureDevices", "NEW_VALUE":"29.05", "OLD_VALUE":"29.05", "no_session":"1", "ORIGINAL_OBJECT_TITLE":"ZB_relay_03"}

if ($params['PROPERTY'] == "temperatureDevices") $temp=$params['NEW_VALUE'];
else $temp=$this->getProperty('temperatureDevices');

if ($params['ORIGINAL_OBJECT_TITLE'] == "ZB_relay_03") $ot=$params['ORIGINAL_OBJECT_TITLE'];

</pre>
==Поисковые запросы==
олдвалуе, ньювалуе, Алиса постоянно говорит значения которые изменились, в чате постоянно пишет, повтор сообщения, повторы, многократное срабатывание метода при одном и том же значении свойства, срабатывание метода только при изменении значения, срабатывание по фронту, препроцессинг и постпроцессинг значений свойств объектов

MQTT модуль

2020-10-11T16:38:43Z

Newz20: ретейн

GetGlobal

2020-10-07T05:27:21Z

Newz20: Примечание о ThisComputer

[[Category:Встроенные функции]]
==Описание==
'''getGlobal'''("Object.Value"); -- получение значения глобального свойства объекта, где (Object-объект, Value-свойство)

'''gg'''("Object.Value"); -- альтернативное имя getGlobal

'''Примечание:''' При отсутствии в запросе указанного объекта "Object" система самостоятельно дополнит его объектом "[[ThisComputer]]" и все данные прочтутся из этого объекта системы, при условии что в нем есть данное свойство.

==Примеры запросов==
Присвоить переменной $t значение времени в формате HH:MM из свойства timeNow объекта ThisComputer. Данный объект и свойство используются в дефолтной поставке МДМ.
<pre>$t = getGlobal("ThisComputer.timeNow");</pre>

Полностью равно предыдущей записи:
<pre>$t = gg("ThisComputer.timeNow");</pre>

==Альтернативные названия функции (сленг)==
гг, гетглобал, gg

==Просто для проверки появления разделов==

SetGlobal

2020-10-07T05:25:13Z

Newz20: /* Описание */

[[Category:Встроенные функции]]
==Описание==
'''SetGlobal'''("Object.Value", $value); -- установка значения глобального свойства объекта, где (Object-объект, Value-свойство), а $value устанавливаемое значение.

'''sg'''("Object.Value", $value); -- альтернативное имя setGlobal

'''Примечание:''' Конструкция запроса предусматривает возможность увеличения пути установки свойства до Класса. Класс.Объект.Свойство '''SetGlobal'''("Class.Object.Value", $value); , но данный метод в системе не приветствуется, так как одинаковые объекты могут причинить другие неудобства. В системе принято не создавать одинаковые объекты, а значит и указание класса в запросе не требуется.

'''Примечание 2:''' При отсутствии в запросе указанного объекта "Object" система самостоятельно дополнит его объектом "[[ThisComputer]]" и все данные запишутся в данный объект системы.

'''Примечание 3:''' Если в объекте отсутствует свойство "Value", то система самостоятельно создаст его на уровне объекта и запишет данные в него. Такой подход лишает нас истории свойства и остальных возможностей свойств созданных на уровне класса.

==Примеры запросов==
Присвоить свойству timeNow объекта ThisComputer значение 17:12. Данный объект и свойство используются в дефолтной поставке МДМ.
<pre>setGlobal("ThisComputer.timeNow", "17:12");</pre>

Полностью равно предыдущей записи:
<pre>sg("ThisComputer.timeNow", "17:12");</pre>

==Альтернативные названия функции (сленг)==
cг, cетглобал,

==Просто для проверки появления разделов==

ThisComputer

2020-10-07T05:23:03Z

Newz20: Новая страница: «Category:Структура ==Описание== '''ThisComputer''' -- Основной системный объект содержащий в себе мн...»

[[Category:Структура]]
==Описание==
'''ThisComputer''' -- Основной системный объект содержащий в себе множество свойств необходимых для работы системы, '''удаление может привести к неработоспособности всей системы'''. Объект находится в классе "Computer".

SetGlobal

2020-10-07T05:18:35Z

Newz20: Доп примечания

[[Category:Встроенные функции]]
==Описание==
'''SetGlobal'''("Object.Value", $value); -- установка значения глобального свойства объекта, где (Object-объект, Value-свойство), а $value устанавливаемое значение.

'''sg'''("Object.Value", $value); -- альтернативное имя setGlobal

'''Примечание:''' Конструкция запроса предусматривает возможность увеличения пути установки свойства до Класса. Класс.Объект.Свойство '''SetGlobal'''("Class.Object.Value", $value); , но данный метод в системе не приветствуется, так как одинаковые объекты могут причинить другие неудобства. В системе принято не создавать одинаковые объекты, а значит и указание класса в запросе не требуется.

'''Примечание 2:''' При отсутствии в запросе указанного объекта "Object" система самостоятельно дополнит его объектом "ThisComputer" и все данные запишутся в данный объект системы.

'''Примечание 3:''' Если в объекте отсутствует свойство "Value", то система самостоятельно создаст его на уровне объекта и запишет данные в него. Такой подход лишает нас истории свойства и остальных возможностей свойств созданных на уровне класса.

==Примеры запросов==
Присвоить свойству timeNow объекта ThisComputer значение 17:12. Данный объект и свойство используются в дефолтной поставке МДМ.
<pre>setGlobal("ThisComputer.timeNow", "17:12");</pre>

Полностью равно предыдущей записи:
<pre>sg("ThisComputer.timeNow", "17:12");</pre>

==Альтернативные названия функции (сленг)==
cг, cетглобал,

==Просто для проверки появления разделов==

SetGlobal

2020-10-07T04:55:20Z

Newz20: Примечание о Классе

NEW VALUE и OLD VALUE

2020-09-10T11:42:11Z

Newz20:

[[Category:Примеры]]

<pre>if ($params['NEW_VALUE'] == $params['OLD_VALUE']) return;</pre> //код сравнивает новое значение со старым и выходит из метода если они совпадают.

срабатывание по фронту для 0/1 значений
<pre>if ($params['NEW_VALUE'] == 1 && $params['OLD_VALUE'] == 0) </pre> // из 0 в 1 - "началось"
<pre>if ($params['NEW_VALUE'] == 0 && $params['OLD_VALUE'] == 1) </pre> // из 1 в 0 - "кончилось"

Однако из топика MQTT приходит параметр '''VALUE'''. При использовании привязки методов к топикам использовать его.

Так же можно использовать в различных условиях передаваемые данные (ниже пример вызова метода по изменению свойства класса)
<pre>
//{"PROPERTY":"temperatureDevices", "NEW_VALUE":"29.05", "OLD_VALUE":"29.05", "no_session":"1", "ORIGINAL_OBJECT_TITLE":"ZB_relay_03"}

if ($params['PROPERTY'] == "temperatureDevices") $temp=$params['NEW_VALUE'];
else $temp=$this->getProperty('temperatureDevices');

if ($params['ORIGINAL_OBJECT_TITLE'] == "ZB_relay_03") $ot=$params['ORIGINAL_OBJECT_TITLE'];

</pre>
==Поисковые запросы==
олдвалуе, ньювалуе, Алиса постоянно говорит значения которые изменились, в чате постоянно пишет, повтор сообщения, повторы, многократное срабатывание метода при одном и том же значении свойства, срабатывание метода только при изменении значения, срабатывание по фронту, препроцессинг и постпроцессинг значений свойств объектов

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

2020-08-28T10:47:11Z

Newz20:

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

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

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

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

''Инструкция была написана под операционную систему 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]

GetHistoryMin

2020-08-25T12:44:16Z

Newz20: /* Примеры запросов */

[[Category:Встроенные функции]]
==Описание==
'''getHistoryMin'''($varname, $start_time, $stop_time) -- Возвращает минимальное значение за период
работает от обратного [[GetHistoryMax]]

varname - "объект.свойство" (строка)

start_time - Время начало выборки, включительно (метка времени Unix)

stop_time - Время конца выборки, включительно (метка времени Unix) параметр может не указываться, в этом случае равен текущему времени

==Примеры запросов==
<pre>
$data = getHistoryMin("RainGauge1.value", -3*60*60);
echo print_r($data, true)." \n";

Если минимальная температура за день меньше 5 градусов, то пора сливать воду из системы полива.
if (getHistoryMin("tsrearyard.temp", strtotime("-1 day")) < 5)
say("Пора сливать воду из системы полива");
</pre>

Запрос данных за прошедшие сутки с ПУ счетчик
<pre>
getHistoryMin('Counter01.valueDay', strtotime(date("d.m.Y 00:00:00",strtotime("-1 day"))),strtotime(date("d.m.Y 23:59:59",strtotime("-1 day"))));
</pre>

==Альтернативные названия функции (сленг)==

==Просто для проверки появления разделов==

1064

2020-08-03T06:29:36Z

Newz20:

[[Category:Возникающие ошибки]]

==Описание==
1064 - ошибка возникает при неверном запросе sql.

==Поиск проблемы==
Если у вас такой случай

<pre>1064: You have an error in your SQL syntax; check the manual that corresponds to your MySQL server version for the right syntax to use near 'AND TITLE LIKE 'cycle%Run' ORDER BY TITLE' at line 1
SELECT properties.* FROM properties WHERE OBJECT_ID= AND TITLE LIKE 'cycle%Run' ORDER BY TITLE </pre>

Обычно проявляется на вкладке x-ray? то вероятно проблема в отсутствии класса ThisComputer.

[[Файл:Photo 2020-07-28 12-46-02.jpg|мини|центр|ThisComputer]]

==Решение проблемы==
Возможно вы перенесли класс в другое место, например ПУ. Поиском в МД найти ThisComputer. Если так то отвязать устройство ПУ и вернуть класс на место.

Если данный класс не найден

Импортировать Класс ThisComputer

[[Файл:Computer1.txt|мини|Класс для импорта скачать]]

Категория:Взаимодействие

2020-07-30T09:04:44Z

Newz20:

[[Category:root]]
В этой категории будут описаны протоколы взаимодействия
* [[:Category:Z-Wave]]
* [[:Category:ZigBee]]
* [[:Category:1Wire]]
* [[:Category:WiFi]]

Категория:Взаимодействие

2020-07-30T09:03:43Z

Newz20: Откат правок Newz20 (обсуждение) к версии Mixman

[[Category:root]]
В этой категории будут описаны протоколы взаимодействия
* [[Category:Z-Wave|Z-Wave]]
* [[Category:ZigBee|ZigBee]]
* [[Category:1Wire|1Wire]]
* [[Category:WiFi|WiFi]]

Категория:Взаимодействие

2020-07-30T09:02:34Z

Newz20:

Категория:Взаимодействие

2020-07-30T09:01:50Z

Newz20:

Категория:Взаимодействие

2020-07-30T08:59:57Z

Newz20:

Z-Wave общие сведения о технологии

2020-07-30T08:59:16Z

Newz20:

[[Category:Z-Wave]]

=== Общие сведения о протоколе ===
'''Z-Wave''' является запатентованным беспроводным протоколом связи, разработанным для домашней автоматизации, в частности для контроля и управления в жилых и коммерческих объектах.

'''''Sigma Designs''''', владелец технологии Z-Wave

'''''Z-Wave Альянс''''', открытый консорциум из более чем 700 производителей.
По состоянию на 2018, на рынке представлено более 2700 различных сертифицированных продуктов.

В отличие от Wi-Fi и других IEEE 802.11 стандартов передачи данных, предназначенных в основном для больших потоков информации, Z-Wave работает в диапазоне частот до 1 ГГц и оптимизирована для передачи простых управляющих команд с малыми задержками (например, включить/выключить, изменить громкость, яркость и т.д.).

В 2013 году Sigma Designs и Z-Wave Alliance представили расширение протокола Z-Wave, названное Z-Wave Plus.

Фактически, это обычный протокол Z-Wave, дополненный списком более строгих требований по сравнению с обычными требованиями сертификации Z-Wave. Z-Wave Plus полностью включает в себя все требования Z-Wave. Новые требования направлены на улучшение совместимости устройств на рынке.

Условие совместимости — одно из главных преимуществ технологии Z-Wave. Перед выходом в продажу все устройства проходят сертификацию Z-Wave в одном их трёх центров сертификации, где проверяют устройство на совместимость. Более 150 производителей по всем миру выбрали Z-Wave в качестве основного протокола для своих продуктов. И все они совместимы друг с другом в пределах одного региона (одного диапазона частот).

'''Внимание! Один контроллер может работать с другими устройствами только на одной частоте. Поэтому если планируете создавать сеть Z-Wave продумайте на какой частоте будете её строить. Если планируете расширять - перепроверьте на какой частоте работает Ваш контроллер.'''

=== Совместная работа оборудования Z-Wave и MajorDoMo ===
Платформа MajorDoMo поддерживает следующие подключение контроллеров: API Z-Wave.Me ('''USB стик Z-Wave.Me, Z-Stick Z-Way''' и '''Плата расширения Z-Wave.Me RaZberry'''); API VeraLite; Zippato; и возможна работа через windows шлюз mqtt от Aven.
При покупке оборудования контроллера, ознакомьтесь с документацией на оборудование.
'''Рекомендация: Перед интеграцией с системой MajorDoMo требуется установить оборудование в ОС, настроить сеть и установить необходимый модуль.
Для совместной работы используется [[Z-Wave модуль]].

'''
=== Возможности и термины сети Z-Way: ===
Первичный контроллер — координатор сети. Это единственный узел, способный включать в сеть новые узлы и исключать существующие. Он же хранит информацию о топологии сети и может обновлять списки соседей для всех остальных (вторичных) контроллеров и формировать маршруты во всех дочерних узлах. Первичный контроллер может быть только один в сети. Обычно первичным является тот контроллер, с которого началось построение сети. Однако в дальнейшем первичный контроллер может включить в сеть новый контроллер, передав ему свою роль.
Каждая Z-Wave сеть определяется уникальным идентификатором сети (Network ID) (генерируется при создании сети генератором случайных чисел с шумом от радиоприёмника в качестве источника случайных числе или назначается Sigma Designs для старых контроллеров). Network ID (он же Home ID) является общим идентификатором всех узлов, принадлежащих к одной логической Z-Wave сети. Network ID имеет длину 4 байта (32 бит) и присваивается каждому устройству через основной (primary) контроллер, когда устройство подключается к сети. На одной территории может сосуществовать несколько сетей Z-Wave с разными Home ID. При этом они не будут друг друга видеть и друг с другом взаимодействовать. и может включать до 232 узлов, определяемых идентификатором устройства (Node ID).

Узлы с различными идентификаторами сети не могут общаться друг с другом.

Z-Wave использует ячеистую топологию сети и можно создать сеть из одного управляемого и одного управляющего устройства. (Что мы и делаем на данный момент). Дополнительные устройства могут быть добавлены в любое время, так же как и несколько управляющих контроллеров.

Устройства должны быть «включены» в Z-Wave сеть, прежде чем ими можно будет управлять.

Включение происходит переводом контроллера в специальный режим Включения (Inclusion mode; обычно какой-то специальной кнопкой в или комбинацией клавиш), а включаемого устройства в режим Обучения (Learn mode; обычно одинарным или тройным нажатием на кнопку). При этом контроллер и включаемое устройство должны находиться в прямой видимости. Многие современные (версии протокола 4.5x или 6.x) постоянно питающиеся (не спящие) устройства первые 3-5 минут после включения в сеть электропитания самостоятельно переходят в специальный режим обучения (Network Wide Inclusion, NWI), если они ещё не включены в сеть. При этом условие нахождения в прямой видимости уже не требуется. Это позволяет достаточно легко включать в сеть новые устройства, не бегая по дому.

Исключение из сети происходит аналогично: контроллер переводится в режим Исключения (Exclusion mode), а дочерний узел в режим Обучения. После исключения Node ID и Home ID устройства сбросятся на 0 (для контроллеров NodeID сбросится на 1, а HomeID на заводское значение). Большинство устройств при исключении сбросит и все остальные пользовательские настройки на заводские значения.

Стоит отметить, что устройство уже прописанное в одной сети не включится в другую сеть. Но исключить из сети может любой первичный контроллер (даже устройство не из своей сети).

Этот процесс подключения повторяется для каждого устройства в системе. Контроллер запоминает мощность сигнала устройства во время процесса подключения, таким образом, архитектура предполагает, что устройства должны быть расположены в окончательном месте, прежде чем они будут добавлены в систему. Однако, Z-Wave предполагает реконфигурацию сети — запуск этой процедуры на контроллере позволяет перераспределить маршруты и улучшить связь между устройствами, расположенными далеко от контроллера.

=== Уровни модели OSI и основные характеристики Z-Wave. ===
==== Физический уровень====

Передача данных осуществляется на частоте 869.0 МГц (Россия), 868.42 МГц (Европа, страны CEPT, Китай, Сингапур, ОАЭ, ЮАР), 908.42 МГц (США, Мексика), 921.42 МГц (Австралия, Бразилия, Новая Зеландия), 919.8 МГц (Гонконг), 865.2 МГц (Индия), 868.2 МГц (Малайзия), Япония (951-956 и 922-926 МГц). Модуляция FSK (частотная манипуляция). Скорость передачи: 42 кбит/с, 100 кбит/с и 9.6 кбит/с (для совместимостью со старыми устройствами). Предельная мощность передачи 1 мВт.
==== Канальный уровень ====

Используются пакеты с контролем целостности данных (контрольная сумма) и адресацией получателя и отправителя. В качестве получателя может использоваться multicast адрес или broadcast (в этом случае пакет принимается всеми участниками сети с включенным радио-модулем).

==== Сетевой уровень ====

Протокол Z-Wave определяет алгоритм маршрутизации, позволяющий передавать данные между устройствами вне прямой видимости. Все постоянно работающие узлы сети (бывают ещё спящие и «часто слушающие» узлы) могу участвовать в пересылке пакетов между другими участниками сети. Z-Wave использует механизм Source Routing, т.е. маршрут следования определяется отправителем. Broadcast и multicast пакеты не маршрутизируются. При невозможности найти нужный узел по маршрутам, записанным в памяти, существует механизм поиска узла по всей сети путём посылки специального пакета Explorer Frame всем узлам сети. После успешного нахождения узла новый маршрут записывается отправителем в память для последующего использования.

==== Транспортный уровень ====

На данном уровне Z-Wave гарантирует подтверждение доставки и повторную отправку в случае, если пакет не был доставлен до получателя. Каждый узел, участвующий в пересылке, подтверждает факт получения сообщения. Для уменьшения загрузки эфира в Z-Wave используется механизм «молчаливых подтверждений»: узел (А), передавший пакет следующему узлу (Б) на пути следования пакета не ждёт подтверждения от него, а видит, что Б отправил пакет дальше узлу С и воспринимает это как факт подтверждения успешной пересылки пакета от А к Б. Получив пакет, конечный узел передаёт назад подтверждения доставки, которое путешествует назад тем же маршрутом до исходного отправителя. Таким образом отправитель всегда знает, дошёл ли пакет до точки назначения или нет.

==== Сеансовый уровень ====

Используется только при использовании шифрования, где определяются короткие сеансы с одноразовым ключом.

==== Прикладной уровень ====

Z-Wave также определяет алгоритм интерпретации получаемых на прикладном уровне команд. Данный уровень описан набором Классов Команд (Command Classes). Для некоторых Классов существует несколько вариантов интерпретации команд, которые зависят от Класса Устройства (Device Class), определяющего тип устройства.

С 2012 года физический и канальный уровни протокола Z-Wave вошли в стандарт ITU-T G.9959(рекомендации сектора стандартизации электросвязи Международного союза электросвязи).

Уровни от транспортного до канального реализованы в программном коде Sigma Designs и поставляются в прекомпилированном виде (в комплекте SDK). С одной стороны проприетарный код — это минус, но в закрытости данного протокола есть и свои плюсы: ни один производитель не может изменить нижние уровни протокола, что позволяет легче обеспечивать совместимость — все устройства основаны на одном хорошо отлаженном коде.

Все команды в Z-Wave компактно упакованы. Это нужно для уменьшения размера пакета, что положительно влияет на занимаемое в эфире время, а также на уменьшение потерь при передаче. Z-Wave предназначен для передачи коротких команд без открытия сессии, т.е. совсем не подходит для потоковой передачи потоковых данных. Максимальный полезный размер передаваемых данных составляет 46 байт (размер данных прикладного уровня без шифрования).

Z-Wave общие сведения о технологии

2020-07-30T08:55:38Z

Newz20:

[[Category:Z-Wave]]
[[Category:Взаимодействие]]

=== Общие сведения о протоколе ===
'''Z-Wave''' является запатентованным беспроводным протоколом связи, разработанным для домашней автоматизации, в частности для контроля и управления в жилых и коммерческих объектах.

'''''Sigma Designs''''', владелец технологии Z-Wave

'''''Z-Wave Альянс''''', открытый консорциум из более чем 700 производителей.
По состоянию на 2018, на рынке представлено более 2700 различных сертифицированных продуктов.

В отличие от Wi-Fi и других IEEE 802.11 стандартов передачи данных, предназначенных в основном для больших потоков информации, Z-Wave работает в диапазоне частот до 1 ГГц и оптимизирована для передачи простых управляющих команд с малыми задержками (например, включить/выключить, изменить громкость, яркость и т.д.).

В 2013 году Sigma Designs и Z-Wave Alliance представили расширение протокола Z-Wave, названное Z-Wave Plus.

Фактически, это обычный протокол Z-Wave, дополненный списком более строгих требований по сравнению с обычными требованиями сертификации Z-Wave. Z-Wave Plus полностью включает в себя все требования Z-Wave. Новые требования направлены на улучшение совместимости устройств на рынке.

Условие совместимости — одно из главных преимуществ технологии Z-Wave. Перед выходом в продажу все устройства проходят сертификацию Z-Wave в одном их трёх центров сертификации, где проверяют устройство на совместимость. Более 150 производителей по всем миру выбрали Z-Wave в качестве основного протокола для своих продуктов. И все они совместимы друг с другом в пределах одного региона (одного диапазона частот).

'''Внимание! Один контроллер может работать с другими устройствами только на одной частоте. Поэтому если планируете создавать сеть Z-Wave продумайте на какой частоте будете её строить. Если планируете расширять - перепроверьте на какой частоте работает Ваш контроллер.'''

=== Совместная работа оборудования Z-Wave и MajorDoMo ===
Платформа MajorDoMo поддерживает следующие подключение контроллеров: API Z-Wave.Me ('''USB стик Z-Wave.Me, Z-Stick Z-Way''' и '''Плата расширения Z-Wave.Me RaZberry'''); API VeraLite; Zippato; и возможна работа через windows шлюз mqtt от Aven.
При покупке оборудования контроллера, ознакомьтесь с документацией на оборудование.
'''Рекомендация: Перед интеграцией с системой MajorDoMo требуется установить оборудование в ОС, настроить сеть и установить необходимый модуль.
Для совместной работы используется [[Z-Wave модуль]].

'''
=== Возможности и термины сети Z-Way: ===
Первичный контроллер — координатор сети. Это единственный узел, способный включать в сеть новые узлы и исключать существующие. Он же хранит информацию о топологии сети и может обновлять списки соседей для всех остальных (вторичных) контроллеров и формировать маршруты во всех дочерних узлах. Первичный контроллер может быть только один в сети. Обычно первичным является тот контроллер, с которого началось построение сети. Однако в дальнейшем первичный контроллер может включить в сеть новый контроллер, передав ему свою роль.
Каждая Z-Wave сеть определяется уникальным идентификатором сети (Network ID) (генерируется при создании сети генератором случайных чисел с шумом от радиоприёмника в качестве источника случайных числе или назначается Sigma Designs для старых контроллеров). Network ID (он же Home ID) является общим идентификатором всех узлов, принадлежащих к одной логической Z-Wave сети. Network ID имеет длину 4 байта (32 бит) и присваивается каждому устройству через основной (primary) контроллер, когда устройство подключается к сети. На одной территории может сосуществовать несколько сетей Z-Wave с разными Home ID. При этом они не будут друг друга видеть и друг с другом взаимодействовать. и может включать до 232 узлов, определяемых идентификатором устройства (Node ID).

Узлы с различными идентификаторами сети не могут общаться друг с другом.

Z-Wave использует ячеистую топологию сети и можно создать сеть из одного управляемого и одного управляющего устройства. (Что мы и делаем на данный момент). Дополнительные устройства могут быть добавлены в любое время, так же как и несколько управляющих контроллеров.

Устройства должны быть «включены» в Z-Wave сеть, прежде чем ими можно будет управлять.

Включение происходит переводом контроллера в специальный режим Включения (Inclusion mode; обычно какой-то специальной кнопкой в или комбинацией клавиш), а включаемого устройства в режим Обучения (Learn mode; обычно одинарным или тройным нажатием на кнопку). При этом контроллер и включаемое устройство должны находиться в прямой видимости. Многие современные (версии протокола 4.5x или 6.x) постоянно питающиеся (не спящие) устройства первые 3-5 минут после включения в сеть электропитания самостоятельно переходят в специальный режим обучения (Network Wide Inclusion, NWI), если они ещё не включены в сеть. При этом условие нахождения в прямой видимости уже не требуется. Это позволяет достаточно легко включать в сеть новые устройства, не бегая по дому.

Исключение из сети происходит аналогично: контроллер переводится в режим Исключения (Exclusion mode), а дочерний узел в режим Обучения. После исключения Node ID и Home ID устройства сбросятся на 0 (для контроллеров NodeID сбросится на 1, а HomeID на заводское значение). Большинство устройств при исключении сбросит и все остальные пользовательские настройки на заводские значения.

Стоит отметить, что устройство уже прописанное в одной сети не включится в другую сеть. Но исключить из сети может любой первичный контроллер (даже устройство не из своей сети).

Этот процесс подключения повторяется для каждого устройства в системе. Контроллер запоминает мощность сигнала устройства во время процесса подключения, таким образом, архитектура предполагает, что устройства должны быть расположены в окончательном месте, прежде чем они будут добавлены в систему. Однако, Z-Wave предполагает реконфигурацию сети — запуск этой процедуры на контроллере позволяет перераспределить маршруты и улучшить связь между устройствами, расположенными далеко от контроллера.

=== Уровни модели OSI и основные характеристики Z-Wave. ===
==== Физический уровень====

Передача данных осуществляется на частоте 869.0 МГц (Россия), 868.42 МГц (Европа, страны CEPT, Китай, Сингапур, ОАЭ, ЮАР), 908.42 МГц (США, Мексика), 921.42 МГц (Австралия, Бразилия, Новая Зеландия), 919.8 МГц (Гонконг), 865.2 МГц (Индия), 868.2 МГц (Малайзия), Япония (951-956 и 922-926 МГц). Модуляция FSK (частотная манипуляция). Скорость передачи: 42 кбит/с, 100 кбит/с и 9.6 кбит/с (для совместимостью со старыми устройствами). Предельная мощность передачи 1 мВт.
==== Канальный уровень ====

Используются пакеты с контролем целостности данных (контрольная сумма) и адресацией получателя и отправителя. В качестве получателя может использоваться multicast адрес или broadcast (в этом случае пакет принимается всеми участниками сети с включенным радио-модулем).

==== Сетевой уровень ====

Протокол Z-Wave определяет алгоритм маршрутизации, позволяющий передавать данные между устройствами вне прямой видимости. Все постоянно работающие узлы сети (бывают ещё спящие и «часто слушающие» узлы) могу участвовать в пересылке пакетов между другими участниками сети. Z-Wave использует механизм Source Routing, т.е. маршрут следования определяется отправителем. Broadcast и multicast пакеты не маршрутизируются. При невозможности найти нужный узел по маршрутам, записанным в памяти, существует механизм поиска узла по всей сети путём посылки специального пакета Explorer Frame всем узлам сети. После успешного нахождения узла новый маршрут записывается отправителем в память для последующего использования.

==== Транспортный уровень ====

На данном уровне Z-Wave гарантирует подтверждение доставки и повторную отправку в случае, если пакет не был доставлен до получателя. Каждый узел, участвующий в пересылке, подтверждает факт получения сообщения. Для уменьшения загрузки эфира в Z-Wave используется механизм «молчаливых подтверждений»: узел (А), передавший пакет следующему узлу (Б) на пути следования пакета не ждёт подтверждения от него, а видит, что Б отправил пакет дальше узлу С и воспринимает это как факт подтверждения успешной пересылки пакета от А к Б. Получив пакет, конечный узел передаёт назад подтверждения доставки, которое путешествует назад тем же маршрутом до исходного отправителя. Таким образом отправитель всегда знает, дошёл ли пакет до точки назначения или нет.

==== Сеансовый уровень ====

Используется только при использовании шифрования, где определяются короткие сеансы с одноразовым ключом.

==== Прикладной уровень ====

Z-Wave также определяет алгоритм интерпретации получаемых на прикладном уровне команд. Данный уровень описан набором Классов Команд (Command Classes). Для некоторых Классов существует несколько вариантов интерпретации команд, которые зависят от Класса Устройства (Device Class), определяющего тип устройства.

С 2012 года физический и канальный уровни протокола Z-Wave вошли в стандарт ITU-T G.9959(рекомендации сектора стандартизации электросвязи Международного союза электросвязи).

Уровни от транспортного до канального реализованы в программном коде Sigma Designs и поставляются в прекомпилированном виде (в комплекте SDK). С одной стороны проприетарный код — это минус, но в закрытости данного протокола есть и свои плюсы: ни один производитель не может изменить нижние уровни протокола, что позволяет легче обеспечивать совместимость — все устройства основаны на одном хорошо отлаженном коде.

Все команды в Z-Wave компактно упакованы. Это нужно для уменьшения размера пакета, что положительно влияет на занимаемое в эфире время, а также на уменьшение потерь при передаче. Z-Wave предназначен для передачи коротких команд без открытия сессии, т.е. совсем не подходит для потоковой передачи потоковых данных. Максимальный полезный размер передаваемых данных составляет 46 байт (размер данных прикладного уровня без шифрования).

Z-Wave общие сведения о технологии

2020-07-30T08:54:29Z

Newz20:

[[Category:Взаимодействие]]
[[Category:Z-Wave]]
=== Общие сведения о протоколе ===
'''Z-Wave''' является запатентованным беспроводным протоколом связи, разработанным для домашней автоматизации, в частности для контроля и управления в жилых и коммерческих объектах.

'''''Sigma Designs''''', владелец технологии Z-Wave

'''''Z-Wave Альянс''''', открытый консорциум из более чем 700 производителей.
По состоянию на 2018, на рынке представлено более 2700 различных сертифицированных продуктов.

В отличие от Wi-Fi и других IEEE 802.11 стандартов передачи данных, предназначенных в основном для больших потоков информации, Z-Wave работает в диапазоне частот до 1 ГГц и оптимизирована для передачи простых управляющих команд с малыми задержками (например, включить/выключить, изменить громкость, яркость и т.д.).

В 2013 году Sigma Designs и Z-Wave Alliance представили расширение протокола Z-Wave, названное Z-Wave Plus.

Фактически, это обычный протокол Z-Wave, дополненный списком более строгих требований по сравнению с обычными требованиями сертификации Z-Wave. Z-Wave Plus полностью включает в себя все требования Z-Wave. Новые требования направлены на улучшение совместимости устройств на рынке.

Условие совместимости — одно из главных преимуществ технологии Z-Wave. Перед выходом в продажу все устройства проходят сертификацию Z-Wave в одном их трёх центров сертификации, где проверяют устройство на совместимость. Более 150 производителей по всем миру выбрали Z-Wave в качестве основного протокола для своих продуктов. И все они совместимы друг с другом в пределах одного региона (одного диапазона частот).

'''Внимание! Один контроллер может работать с другими устройствами только на одной частоте. Поэтому если планируете создавать сеть Z-Wave продумайте на какой частоте будете её строить. Если планируете расширять - перепроверьте на какой частоте работает Ваш контроллер.'''

=== Совместная работа оборудования Z-Wave и MajorDoMo ===
Платформа MajorDoMo поддерживает следующие подключение контроллеров: API Z-Wave.Me ('''USB стик Z-Wave.Me, Z-Stick Z-Way''' и '''Плата расширения Z-Wave.Me RaZberry'''); API VeraLite; Zippato; и возможна работа через windows шлюз mqtt от Aven.
При покупке оборудования контроллера, ознакомьтесь с документацией на оборудование.
'''Рекомендация: Перед интеграцией с системой MajorDoMo требуется установить оборудование в ОС, настроить сеть и установить необходимый модуль.
Для совместной работы используется [[Z-Wave модуль]].

'''
=== Возможности и термины сети Z-Way: ===
Первичный контроллер — координатор сети. Это единственный узел, способный включать в сеть новые узлы и исключать существующие. Он же хранит информацию о топологии сети и может обновлять списки соседей для всех остальных (вторичных) контроллеров и формировать маршруты во всех дочерних узлах. Первичный контроллер может быть только один в сети. Обычно первичным является тот контроллер, с которого началось построение сети. Однако в дальнейшем первичный контроллер может включить в сеть новый контроллер, передав ему свою роль.
Каждая Z-Wave сеть определяется уникальным идентификатором сети (Network ID) (генерируется при создании сети генератором случайных чисел с шумом от радиоприёмника в качестве источника случайных числе или назначается Sigma Designs для старых контроллеров). Network ID (он же Home ID) является общим идентификатором всех узлов, принадлежащих к одной логической Z-Wave сети. Network ID имеет длину 4 байта (32 бит) и присваивается каждому устройству через основной (primary) контроллер, когда устройство подключается к сети. На одной территории может сосуществовать несколько сетей Z-Wave с разными Home ID. При этом они не будут друг друга видеть и друг с другом взаимодействовать. и может включать до 232 узлов, определяемых идентификатором устройства (Node ID).

Узлы с различными идентификаторами сети не могут общаться друг с другом.

Z-Wave использует ячеистую топологию сети и можно создать сеть из одного управляемого и одного управляющего устройства. (Что мы и делаем на данный момент). Дополнительные устройства могут быть добавлены в любое время, так же как и несколько управляющих контроллеров.

Устройства должны быть «включены» в Z-Wave сеть, прежде чем ими можно будет управлять.

Включение происходит переводом контроллера в специальный режим Включения (Inclusion mode; обычно какой-то специальной кнопкой в или комбинацией клавиш), а включаемого устройства в режим Обучения (Learn mode; обычно одинарным или тройным нажатием на кнопку). При этом контроллер и включаемое устройство должны находиться в прямой видимости. Многие современные (версии протокола 4.5x или 6.x) постоянно питающиеся (не спящие) устройства первые 3-5 минут после включения в сеть электропитания самостоятельно переходят в специальный режим обучения (Network Wide Inclusion, NWI), если они ещё не включены в сеть. При этом условие нахождения в прямой видимости уже не требуется. Это позволяет достаточно легко включать в сеть новые устройства, не бегая по дому.

Исключение из сети происходит аналогично: контроллер переводится в режим Исключения (Exclusion mode), а дочерний узел в режим Обучения. После исключения Node ID и Home ID устройства сбросятся на 0 (для контроллеров NodeID сбросится на 1, а HomeID на заводское значение). Большинство устройств при исключении сбросит и все остальные пользовательские настройки на заводские значения.

Стоит отметить, что устройство уже прописанное в одной сети не включится в другую сеть. Но исключить из сети может любой первичный контроллер (даже устройство не из своей сети).

Этот процесс подключения повторяется для каждого устройства в системе. Контроллер запоминает мощность сигнала устройства во время процесса подключения, таким образом, архитектура предполагает, что устройства должны быть расположены в окончательном месте, прежде чем они будут добавлены в систему. Однако, Z-Wave предполагает реконфигурацию сети — запуск этой процедуры на контроллере позволяет перераспределить маршруты и улучшить связь между устройствами, расположенными далеко от контроллера.

=== Уровни модели OSI и основные характеристики Z-Wave. ===
==== Физический уровень====

Передача данных осуществляется на частоте 869.0 МГц (Россия), 868.42 МГц (Европа, страны CEPT, Китай, Сингапур, ОАЭ, ЮАР), 908.42 МГц (США, Мексика), 921.42 МГц (Австралия, Бразилия, Новая Зеландия), 919.8 МГц (Гонконг), 865.2 МГц (Индия), 868.2 МГц (Малайзия), Япония (951-956 и 922-926 МГц). Модуляция FSK (частотная манипуляция). Скорость передачи: 42 кбит/с, 100 кбит/с и 9.6 кбит/с (для совместимостью со старыми устройствами). Предельная мощность передачи 1 мВт.
==== Канальный уровень ====

Используются пакеты с контролем целостности данных (контрольная сумма) и адресацией получателя и отправителя. В качестве получателя может использоваться multicast адрес или broadcast (в этом случае пакет принимается всеми участниками сети с включенным радио-модулем).

==== Сетевой уровень ====

Протокол Z-Wave определяет алгоритм маршрутизации, позволяющий передавать данные между устройствами вне прямой видимости. Все постоянно работающие узлы сети (бывают ещё спящие и «часто слушающие» узлы) могу участвовать в пересылке пакетов между другими участниками сети. Z-Wave использует механизм Source Routing, т.е. маршрут следования определяется отправителем. Broadcast и multicast пакеты не маршрутизируются. При невозможности найти нужный узел по маршрутам, записанным в памяти, существует механизм поиска узла по всей сети путём посылки специального пакета Explorer Frame всем узлам сети. После успешного нахождения узла новый маршрут записывается отправителем в память для последующего использования.

==== Транспортный уровень ====

На данном уровне Z-Wave гарантирует подтверждение доставки и повторную отправку в случае, если пакет не был доставлен до получателя. Каждый узел, участвующий в пересылке, подтверждает факт получения сообщения. Для уменьшения загрузки эфира в Z-Wave используется механизм «молчаливых подтверждений»: узел (А), передавший пакет следующему узлу (Б) на пути следования пакета не ждёт подтверждения от него, а видит, что Б отправил пакет дальше узлу С и воспринимает это как факт подтверждения успешной пересылки пакета от А к Б. Получив пакет, конечный узел передаёт назад подтверждения доставки, которое путешествует назад тем же маршрутом до исходного отправителя. Таким образом отправитель всегда знает, дошёл ли пакет до точки назначения или нет.

==== Сеансовый уровень ====

Используется только при использовании шифрования, где определяются короткие сеансы с одноразовым ключом.

==== Прикладной уровень ====

Z-Wave также определяет алгоритм интерпретации получаемых на прикладном уровне команд. Данный уровень описан набором Классов Команд (Command Classes). Для некоторых Классов существует несколько вариантов интерпретации команд, которые зависят от Класса Устройства (Device Class), определяющего тип устройства.

С 2012 года физический и канальный уровни протокола Z-Wave вошли в стандарт ITU-T G.9959(рекомендации сектора стандартизации электросвязи Международного союза электросвязи).

Уровни от транспортного до канального реализованы в программном коде Sigma Designs и поставляются в прекомпилированном виде (в комплекте SDK). С одной стороны проприетарный код — это минус, но в закрытости данного протокола есть и свои плюсы: ни один производитель не может изменить нижние уровни протокола, что позволяет легче обеспечивать совместимость — все устройства основаны на одном хорошо отлаженном коде.

Все команды в Z-Wave компактно упакованы. Это нужно для уменьшения размера пакета, что положительно влияет на занимаемое в эфире время, а также на уменьшение потерь при передаче. Z-Wave предназначен для передачи коротких команд без открытия сессии, т.е. совсем не подходит для потоковой передачи потоковых данных. Максимальный полезный размер передаваемых данных составляет 46 байт (размер данных прикладного уровня без шифрования).

Категория:Возникающие ошибки

2020-07-29T11:09:41Z

Newz20: Полностью удалено содержимое страницы

MySQL 551

2020-07-29T11:07:54Z

Newz20: Новая страница: «Category:Возникающие ошибки ==Описание== Warning in ./libraries/plugin_interface.lib.php#551 Ошибка возникает при...»

[[Category:Возникающие ошибки]]

==Описание==
Warning in ./libraries/plugin_interface.lib.php#551

Ошибка возникает при использовании импорта и экспорта базы данных в phpMyAdmin.

[[Файл:Warning 551.png|мини|phpMyAdmin Warning 551]]

==Решение проблемы==

Для начала обезопасим себя, проведем резервное копирование файла ''plugin_interface.lib.php'' командой

<pre>sudo cp /usr/share/phpmyadmin/libraries/plugin_interface.lib.php /usr/share/phpmyadmin/libraries/plugin_interface.lib.php.bak </pre>

После этого без опасений его можно редактировать и в случае чего восстановить.

Приступим к редактированию командой

<pre>sudo nano /usr/share/phpmyadmin/libraries/plugin_interface.lib.php </pre>

Нажмите CTRL + W и найдите <pre>if (! is_null($options) && count($options) > 0) {</pre>

Если не найдено, попробуйте выполнить поиск <pre>if ($options != null && count($options) > 0)</pre>

Замените на <pre>if (! is_null($options) && count((array)$options) > 0) {</pre>

Сохраните файл (Нажмите CTRL + O) и выйдите, (Нажмите CTRL + X , нажмите Y а затем нажмите ENTER )

После этих манипуляций перезапустить сервис '''apache''' командой

<pre>sudo service apache2 restart</pre>

1064

2020-07-29T08:55:26Z

Newz20:

[[Category:Возникающие ошибки]]

==Описание==
1064 - ошибка возникает при неверном запросе sql.

==Поиск проблемы==
Если у вас такой случай

<pre>1064: You have an error in your SQL syntax; check the manual that corresponds to your MySQL server version for the right syntax to use near 'AND TITLE LIKE 'cycle%Run' ORDER BY TITLE' at line 1
SELECT properties.* FROM properties WHERE OBJECT_ID= AND TITLE LIKE 'cycle%Run' ORDER BY TITLE </pre>

Обычно проявляется на вкладке x-ray? то вероятно проблема в отсутствии класса ThisComputer.

[[Файл:Photo 2020-07-28 12-46-02.jpg|мини|центр|ThisComputer]]

==Решение проблемы==
Импортировать Класс ThisComputer

[[Файл:Computer1.txt|мини|Класс для импорта скачать]]

Файл:Computer1.txt

2020-07-29T08:54:36Z

Newz20:

Класс для импорта

1064

2020-07-29T06:09:07Z

Newz20:

1064

2020-07-29T06:06:45Z

Newz20: Новая страница: «Category:Возникающие ошибки ==Описание== 1064 - ошибка возникает при неверном запросе sql. ==П...»

[[Category:Возникающие ошибки]]

==Описание==
1064 - ошибка возникает при неверном запросе sql.

==Поиск проблемы==
Если у вас такой случай

<pre>1064: You have an error in your SQL syntax; check the manual that corresponds to your MySQL server version for the right syntax to use near 'AND TITLE LIKE 'cycle%Run' ORDER BY TITLE' at line 1
SELECT properties.* FROM properties WHERE OBJECT_ID= AND TITLE LIKE 'cycle%Run' ORDER BY TITLE </pre>

Обычно проявляется на вкладке x-ray? то проблема в отсутствии записи о нужном цикле или нескольких в Классе ThisComputer.

[[Файл:Photo 2020-07-28 12-46-02.jpg|мини|центр|ThisComputer]]

==Решение проблемы==
Импортировать Класс ThisComputer

Файл:Photo 2020-07-28 12-46-02.jpg

2020-07-28T09:56:49Z

Newz20:

ThisComputer

Cannot redeclare

2020-07-24T06:00:46Z

Newz20:

[[Category:Возникающие ошибки]]

==Описание==
Cannot redeclare - ошибка объявления функции.

Если Вы видите ошибку PHP Fatal error: Cannot redeclare function это значит, что есть проблема в Вашем коде (он пытается объявить одну функцию несколько раз).

Эта ошибка говорит о том, что Ваша функция уже определена. Это может означать:

У Вас есть такая же функция, определенная в двух файлах.

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

Файл, в котором определена Ваша функция, включается два раза (так, кажется, функция определена два раза)

Чтобы помочь с третьим пунктом, решением было бы использовать include_once вместо include при включении Вашего файла functions.php, поэтому его нельзя включать более одного раза.

==Поиск проблемы==
Необходимо найти функцию по названию в файлах МДМ

в Windows умеет поиск по файлам Notepad++

в Linux <pre>grep -rl 'НАЗВАНИЕ ФУНКЦИИ' /var/www</pre>

==Решение проблемы==
Далее определиться где она лишняя (чаще всего это файл личных функций) и удалить ее там.

Перезапуск системы.

Cannot redeclare

2020-07-24T05:48:30Z

Newz20: Новая страница: «Category:Возникающие ошибки ==Описание== Cannot redeclare - ошибка объявления функции. Если Вы види...»

[[Category:Возникающие ошибки]]

==Описание==
Cannot redeclare - ошибка объявления функции.
Если Вы видите ошибку PHP Fatal error: Cannot redeclare function это значит, что есть проблема в Вашем коде (он пытается объявить одну функцию несколько раз).

Эта ошибка говорит о том, что Ваша функция уже определена. Это может означать:

У Вас есть такая же функция, определенная в двух файлах.

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

Файл, в котором определена Ваша функция, включается два раза (так, кажется, функция определена два раза)

Чтобы помочь с третьим пунктом, решением было бы использовать include_once вместо include при включении Вашего файла functions.php, поэтому его нельзя включать более одного раза.

==Поиск проблемы==
Необходимо найти функцию по названию в файлах МДМ

в Windows умеет поиск по файлам Notepad++

в Linux <pre>grep -rl 'НАЗВАНИЕ ФУНКЦИИ' /var/www</pre>

==Решение проблемы==
Далее определиться где она лишняя (чаще всего это файл личных функций) и удалить ее там.

Перезапуск системы.

Modules

2020-06-17T07:56:43Z

Newz20:

[[Category:Папки и файлы]]

[[Папки и файлы|Вернуться на директорию выше]]
===== Папки директории modules =====

[[actions_log]] - пока без описания

[[app_mediabrowser]] - пока без описания

[[app_player]] - пока без описания

[[blockly_code]] - пока без описания

[[classes]] - пока без описания

[[commands]] - пока без описания

[[connect]] - пока без описания

[[control_access]] - пока без описания

[[control_modules]] - пока без описания

[[dashboard]] - пока без описания

[[dateselect]] - пока без описания

[[devices]] - пока без описания

[[Modules/events|events]] - пока без описания корректная ссылка

[[events]] - пока без описания Кривая ссылка

[[history]] - пока без описания

[[jobs]] - пока без описания

[[layouts]] - пока без описания

[[linkedobject]] - пока без описания

[[locations]] - пока без описания

[[market]] - пока без описания

[[master]] - пока без описания

[[methods]] - пока без описания

[[myblocks]] - пока без описания

[[objects]] - пока без описания

[[patterns]] - пока без описания

[[pinghosts]] - пока без описания

[[plans]] - пока без описания

[[properties]] - пока без описания

[[pvalues]] - пока без описания

[[saverestore]] - пока без описания

[[scenes]] - пока без описания

[[scripts]] - пока без описания

[[security_rules]] - пока без описания

[[settings]] - пока без описания

[[shoutbox]] - пока без описания

[[shoutrooms]] - пока без описания

[[soundfiles]] - пока без описания

[[system_errors]] - пока без описания

[[terminals]] - пока без описания

[[textfiles]] - пока без описания

[[thumb]] - пока без описания

[[users]] - пока без описания

[[xray]] - пока без описания

===== Файлы директории modules =====

application.class.php - пока без описания

apps.php - пока без описания

first_start.php - пока без описания

inc_panel_ajax.php - пока без описания

panel.class.php - пока без описания

Templates/events

2020-06-17T07:32:53Z

Newz20: Новая страница: «страница»

страница

Папки и файлы

2020-06-17T06:59:59Z

Newz20:

[[Category:Папки и файлы|Папки и файлы]]
[[Category:Структура]]
====Папки====
[[3rdparty]] - пока без описания

[[backup]] - Папка в данный момент перенесена в директорию [[saverestore]] /cms/saverestore

[[cms]] - пока без описания

[[css]] - пока без описания

[[img]] - картинки иконки изображения используемые в интерфейсе

[[js]] - пока без описания

[[languages]] - папка с файлами локализации

[[lib]] - в этой папке хранятся системные функции, так же можно создать и хранить свои "пользовательские" функции.

[[modules]] - Папка с установленными модулями

[[objects]] - Папка содержащая в себе сценарий проекта обработчика объекта (или как-то так)

[[pChart]] - Графики

[[rc]] - пока нет описания

[[scripts]] - в этой папке содержатся циклы системы MajorDoMo

[[templates]] - в этой папке содержится набор шаблонов для интерфейса

[[templates_alt]] - Альтернатива папки templates для измененных файлов своего дизайна (чтобы при обновлении не слетали собственные правки)

====Файлы====

admin.php

api.php

backup.php

btraced.php

command.php

[[Конфигурационный файл|config.php.sample]] - Заготовка, шаблон основного конфигурационного файла. В рабочей системе переименовывается в
[[Конфигурационный файл|config.php]], предварительно откорректировав. Подробнее про [[Конфигурационный файл]]

cycle.php

db_terminal.sql

diagnostic.php

favicon.ico - иконка логотипа MajorDoMo

index.php

install-linux.sh

load_settings.php

nf.php

obj.bat

print_all.php

robots.txt

rss.php

trackme.php

verimage.php

write_error.php

Редактор

2020-06-09T16:24:57Z

Newz20: /* Горячие клавиши */

[[Category:Первые шаги]]
== Горячие клавиши ==
Некоторые функции доступны только в альфе (на дату 09.06.2020)

Для работы большинства функций требуется настроить их в общих настройках -> Codeeditor

"F11" - развернуть окно редактора на весь экран

"Ctrl-S" - сохранить изменения

"Ctrl-O" - Принудительное автосохранение (в тесте)

"Ctrl-E" - Проверка на ошибки без сохранения и перезагрузки страницы

"Ctrl-D" - Делает дубликат строки на которой стоит курсор

"Ctrl-F" - поиск

"Ctrl + Shift + F" - поиск с заменой

"Esc" - выход из полного экрана

"Ctrl-Space" - автодопонение набираемой функции

"Ctrl-Q" - Сворачивает и разворачивает блоки функций

Редактор

2020-06-09T16:18:50Z

Newz20: перенос строки

[[Category:Первые шаги]]
== Горячие клавиши ==
Некоторые функции доступны только в альфе (на дату 09.06.2020)

"F11" - развернуть окно редактора на весь экран

"Ctrl-S" - сохранить изменения

"Ctrl-O" - Принудительное автосохранение (в тесте)

"Ctrl-E" - Проверка на ошибки без сохранения и перезагрузки страницы

"Ctrl-D" - Делает дубликат строки на которой стоит курсор

"Ctrl-F" - поиск

"Ctrl + Shift + F" - поиск с заменой

"Esc" - выход из полного экрана

"Ctrl-Space" - автодопонение набираемой функции

"Ctrl-Q" - Сворачивает и разворачивает блоки функций

Редактор

2020-06-09T16:17:52Z

Newz20: Правка

[[Category:Первые шаги]]
== Горячие клавиши ==
Некоторые функции доступны только в альфе (на дату 09.06.2020)
"F11" - развернуть окно редактора на весь экран

"Ctrl-S" - сохранить изменения

"Ctrl-O" - Принудительное автосохранение (в тесте)

"Ctrl-E" - Проверка на ошибки без сохранения и перезагрузки страницы

"Ctrl-D" - Делает дубликат строки на которой стоит курсор

"Ctrl-F" - поиск

"Ctrl + Shift + F" - поиск с заменой

"Esc" - выход из полного экрана

"Ctrl-Space" - автодопонение набираемой функции

"Ctrl-Q" - Сворачивает и разворачивает блоки функций

Редактор

2020-06-09T14:48:59Z

Newz20: Новая страница: «Category:Первые шаги == Горячие клавиши == Некоторые функции доступны только в альфе (на дат...»

[[Category:Первые шаги]]
== Горячие клавиши ==
Некоторые функции доступны только в альфе (на дату 09.06.2020)
"F11" - развернуть окно редактора на весь экран

"Ctrl-S" - сохранить изменения

"Ctrl-E" - включает и отключает автосохранение

"Ctrl-D" - Делает дубликат строки на которой стоит курсор

"Ctrl-F" - поиск

"Ctrl + Shift + F" - поиск с заменой

"Esc" - выход из полного экрана

"Ctrl-Space" - автодопонение набираемой функции

"Ctrl-Q": function(cm){ cm.foldCode(cm.getCursor()); }
}

Обсуждение:SetTimeOut

2020-06-05T10:16:21Z

Newz20: Полностью удалено содержимое страницы

Обсуждение:SetTimeOut

2020-06-05T09:08:51Z

Newz20: /* Подскажите где применяется */ новая тема

Подскажите как использовать

== Подскажите где применяется ==

тест

Обсуждение:SetTimeOut

2020-06-05T09:07:45Z

Newz20: Новая страница: «Подскажите как использовать»

Подскажите как использовать

SetTimeOut

2020-06-05T09:04:11Z

Newz20: /* Альтернативные названия функции (сленг) */

[[Category:Встроенные функции]]
==Описание==
'''SetTimeOut'''('title','commands', $timeout); //-- $timeout в секундах (аналог AddScheduledJob('title','commands',time()+$timeout));

'''timeOutExists'''('title'); //-- возвращает идентификатор запланированной задачи (или 0, в случае отсутствия)

'''ClearTimeOut'''("title"); // аналог ClearScheduledJob("title"); - удаляет таймер выше

==Примеры запросов==
<pre>
// motionDetected() method example
// включаем свет (команда вымышленная)
If ($lightIsOff) {
turnonlight();

}
// сбрасываем таймер выключения
//ps. При установке одноименного таймера ClearTimeOut можно не делать
ClearTimeOut("TurnOffTheLight");
// ставим новый таймер
SetTimeOut("TurnOffTheLight","turnofflight();",60);
</pre>

==Альтернативные названия функции (сленг)==
Сеттаймаут, таймер, отложенный запуск

==Просто для проверки появления разделов==