Инсталлятор: различия между версиями

Материал из WiKi - UserSide
Нет описания правки
 
(не показано 12 промежуточных версий 4 участников)
Строка 1: Строка 1:
'''ВНИМАНИЕ: Инсталлятор используется для версий ERP "UserSide" 3.11 и выше. Для версии ниже 3.11 - используйте отдельную инструкцию по [[Установка системы|установке]].
[[Installer|en]] | [[Інсталятор|uk]] | '''ru'''


[[Файл:20170702_4.PNG|thumb|800px|center]]
'''ВНИМАНИЕ: Инсталлятор используется для версий ERP "UserSide" 3.21 и выше. Для версии 3.11-3.20 - используйте отдельную инструкцию по [[Установка для версий 3.11 - 3.20|установке]]. Для версии ниже 3.11 - используйте инструкцию по [[Установка для версии 3.10 и более ранних|установке более ранних версий]].'''


Инсталлятор доступен в личном кабинете клиента по адресу http://my.userside.eu
== Загрузка инсталлятора ==


Он представляет собой консольную утилиту, которая '''запускается на сервере в каталоге, где установлена/будет установлена ERP "UserSide"''', и даёт возможность [[Установка (инсталлятор)|установить актуальную версию]] ERP "UserSide" или [[Обновление (инсталлятор)|обновить текущую версию]] до актуальной.
Создайте каталог, в котором планируете установить ERP USERSIDE, перейдите в него и загрузите инсталлятор:


В процессе работы инсталлятора потребуется ввести свой лицензионный ключ, который также виден в личном кабинете. Дополнительная авторизация осуществляется по IP-адресу сервера, где запускается инсталлятор.
<pre>
<span id="mode"></span>
curl -fsSL https://my.userside.eu/install.sh | sudo -u www-data bash
== Конфигурация инсталлятора (расширенный режим) ==
</pre>


При помощи режима конфигурирования можно настроить уровень стабильности получаемых обновлений. Для этого запустите инсталлятор с командой '''config''' и опцией --stability=''уровень'':
== Установка ERP USERSIDE ==


php userside_install.phar config --stability=stable
Всегда запускайте инсталлятор от имени web-пользователя (например, www-data) чтобы гаранировать доступ к файлам как инсталлятору так и nginx и php-fpm.


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


Вы можете выбрать один из следующих уровней стабильности:
<pre>
sudo -u www-data ./installer install
</pre>


* '''stable''' - вы будете получать только стабильные версии
Следуйте инструкциям. Инсталлятор проверит соответствие окружения, попытается проверить подключение ко всем необходимым службам и корректность их настройки, затем загрузит выбранную Вами версию ERP USERSIDE и установит ее.
* '''rc''' - вы будете получать стабильные версии и релиз-кандидаты
 
* '''beta''' - вы будете получать стабильные версии, релиз-кандидаты и бета-версии
== Расширенное использование инсталлятора ==
* '''alpha''' - вы будете получать версии с любым уровнем стабильности
 
<pre>
sudo -u www-data ./installer [global flags] <command> [command flags]
</pre>
 
=== Глобальные флаги ===
 
* <code>--quiet</code> <code>-q</code> — "тихий" режим: подавить все сообщения на стандартный вывод, кроме ошибок. В этом режиме не доступна интерактивность инсталлятора. При необходимости пользовательского ввода инсталлятор завершится с ошибкой.
* <code>--verbose</code> <code>-v</code> — "детальный" режим: инсталлятор выводит больше информации во время работы.
* <code>--level <stable|rc|beta|alpha></code> — уровень стабильности сборки ERP USERSIDE. Не сохраняется в конфигурации и требуется вседа указывать явно, еслис нужна отличная от "stable" стабильность сборки.
 
=== Команды ===
 
* <code>install</code> — режим установки или обновления ERP USERSIDE.
* <code>repair</code> — режим восстановления текущей версии или неудачно установленной версии ERP USERSIDE.
* <code>update-check</code> — проверка наличия обновлений ERP USERSIDE (используйте флаг <code>--level</code> для указания уровня стабильности сборки).
* <code>self-update</code> — самообновление инсталлятора. Также проверка новой версии и самообновление выполняется каждый раз при запуске команд "install" и "repair".
* <code>crc-check</code> — проверка контрольных сумм файлов ERP USERSIDE.
* <code>config</code> — изменение некоторой конфигурации системы. Конкретные изменяемые параметры задаются дополнительными флагами:
 
==== Флаги для команды config ====
* <code>--url <URL></code> — изменить URL системы. Будет проверена настройка web-сервера на указанный URL и внесены все необходимые изменения в конфигурацию системы.
* <code>--maintenance-disable</code> — принудительное отключение режима обслуживания (использовать с осторожностью). Если после обновления система не вышла из режима обслуживания самостоятельно, лучше обратиться в техническую поддержку за помощью.
* <code>--flush-cache</code> — полный сброс кеша. Не выполняйте это без рекомендации службы поддержки. Разогрев кеша может занять много времени, что скажется на деградации производительности системы.
* <code>--2fa <enable|disable></code> — включение и выключение режима двухфакторной аутентификации.

Текущая версия от 07:47, 19 мая 2026

en | uk | ru

ВНИМАНИЕ: Инсталлятор используется для версий ERP "UserSide" 3.21 и выше. Для версии 3.11-3.20 - используйте отдельную инструкцию по установке. Для версии ниже 3.11 - используйте инструкцию по установке более ранних версий.

Загрузка инсталлятора

Создайте каталог, в котором планируете установить ERP USERSIDE, перейдите в него и загрузите инсталлятор:

curl -fsSL https://my.userside.eu/install.sh | sudo -u www-data bash

Установка ERP USERSIDE

Всегда запускайте инсталлятор от имени web-пользователя (например, www-data) чтобы гаранировать доступ к файлам как инсталлятору так и nginx и php-fpm.

Для установки достаточно запустить инсталлятор с параметром install:

sudo -u www-data ./installer install

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

Расширенное использование инсталлятора

sudo -u www-data ./installer [global flags] <command> [command flags]

Глобальные флаги

  • --quiet -q — "тихий" режим: подавить все сообщения на стандартный вывод, кроме ошибок. В этом режиме не доступна интерактивность инсталлятора. При необходимости пользовательского ввода инсталлятор завершится с ошибкой.
  • --verbose -v — "детальный" режим: инсталлятор выводит больше информации во время работы.
  • --level <stable|rc|beta|alpha> — уровень стабильности сборки ERP USERSIDE. Не сохраняется в конфигурации и требуется вседа указывать явно, еслис нужна отличная от "stable" стабильность сборки.

Команды

  • install — режим установки или обновления ERP USERSIDE.
  • repair — режим восстановления текущей версии или неудачно установленной версии ERP USERSIDE.
  • update-check — проверка наличия обновлений ERP USERSIDE (используйте флаг --level для указания уровня стабильности сборки).
  • self-update — самообновление инсталлятора. Также проверка новой версии и самообновление выполняется каждый раз при запуске команд "install" и "repair".
  • crc-check — проверка контрольных сумм файлов ERP USERSIDE.
  • config — изменение некоторой конфигурации системы. Конкретные изменяемые параметры задаются дополнительными флагами:

Флаги для команды config

  • --url <URL> — изменить URL системы. Будет проверена настройка web-сервера на указанный URL и внесены все необходимые изменения в конфигурацию системы.
  • --maintenance-disable — принудительное отключение режима обслуживания (использовать с осторожностью). Если после обновления система не вышла из режима обслуживания самостоятельно, лучше обратиться в техническую поддержку за помощью.
  • --flush-cache — полный сброс кеша. Не выполняйте это без рекомендации службы поддержки. Разогрев кеша может занять много времени, что скажется на деградации производительности системы.
  • --2fa <enable|disable> — включение и выключение режима двухфакторной аутентификации.