Установка из консоли (командной строки)

Актуально для версии 21.

Для установки потребуется:

0) Соответствие сервера системным требованиям UMI.CMS

Консольный инсталлятор проверяет соответствие системным требованиям при установке. Если вы используете отдельно консольный php и отдельно модуль apache - обратите внимание, что требования должны соблюдаться для обоих из них (иногда они используют разные конфигурационные файлы).

1) Консольный инсталлятор:

Файл installer.php должен быть помещён в корневую директорию сайта, на который производится установка UMI.CMS. Рекомендуется, чтобы эта директория была пустой. Необходимо чтобы она имела права на чтение и запись из php (если затрудняетесь выбрать - ставьте 777). Права на сам файл installer.php должны быть такими, чтобы php мог его переписать. Инсталлятор обращается к внешним ресурсам для скачивания необходимых файлов и проверки аутентификационных данных. На хостинге для консольного php должны быть разрешены исходящие соединения.

2) Файл install.ini с настройками для установки конкретного сайта:

Права на файл install.ini должны быть такими, чтобы php мог его переписать. Файл install.ini должен быть помещён в ту же директорию, где находится installer.php, до начала установки. В файле указаны доступы к базе данных. Перед началом установки она уже должна существовать. Рекомендуется, чтобы она была пустая.

Файл должен быть сохранен в кодировке utf-8. Значения параметров, содержащие не латинские символы, а также спецсимволы необходимо брать в двойные кавычки ""; (например, пароль)

Пример файла:

;=======================================================
;= Инструкции для инсталлятора UMI.CMS в режиме CLI
;= Обязательные секции и их опции отмечены *
;=======================================================

[SERVER]
; phppath="php7.3" ;необходимо указать, если версия php в консоли по умолчанию < 7.0

;Информация о лицензии *
;-------------------------------------------------------
[LICENSE]
domain = ""; Домен *
ip = ""; ip Адрес *
key = ""; Лицензионный ключ *

;Доступ к базе данных. *
;База данных должна быть создана
;-------------------------------------------------------
[DB]
host = ""; Хост *
port= ""; Порт
user = ""; Логин *
password = ""; Пароль *
dbname = ""; Имя базы данных *

[DEMOSITE]
name = "_blank"; Имя устанавливаемого решения

;Информация о супервайзере *
;-------------------------------------------------------
[SUPERVISOR]
login = "sv"; Логин *
password = "1"; Пароль *
lname = ""; Фамилия
fname = ""; Имя
mname = ""; Отчество
email = ""; Почтовый ящик

[SETUP]
sleep=0 ; Время простоя для снижения нагрузки на сервер. Указывается в миллисекундах. Одна миллисекунда - одна тясячная одной секунды (500 = полсекунды)
download_by=4096 ; Размер запрашиваемого пакета с сервера обновлений. Указывается в килобайтах.
split_block_size=100000

[UPDATES]
update-database-by-parts = "0"
keep-installer = "0"

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

[SETUP]
sleep=1 ; Пауза между запросами в миллисекундах, чем меньше - тем быстрее.
download_by=4096 ; Размер запрашиваемого пакета с сервера обновлений. Указывается в килобайтах, чем больше - тем быстрее.

3) Выбор соответствующего демо-сайта для установки:

Консольный установщик может устанавливать любой из демо-сайтов UMI.CMS, с учётом ограничений, описанных далее. Примеры этих сайтов можно увидеть в демо-центре. Клиент вправе выбирать любой демо-сайт для любой редакции UMI.CMS. Однако следует учесть, что некоторые демосайты (например интернет-магазины) неразумно использовать для младших редакций, в которых нет соответствующих модулей (например модуля "Интернет-магазин"). Но с другой стороны, если клиент докупил необходимые модули, то он сможет получить соответствующий демо-сайт (набор модулей определяется по лицензионному ключу). В силу этих причин установщик может выдать ошибку, если данный демосайт не подходит.

Варианты демо-шаблонов: - "demomarket" - Адаптивный интернет-магазин - "_blank" - без демо-шаблона

4) Персональный гейт для выдачи лицензионных ключей UMI.CMS:

Со стороны компании "Юмисофт" существует специальный гейт, выдающий лицензионные ключи необходимого типа (Commerce Trial). При регистрации хостера на гейте ему выдаётся уникальный идентификатор (ID), а также инструкции, куда отсылать запросы на получение лицензионных ключей. Если вы уже пользуетесь таким гейтом, то в 99% случаев вам не нужно ничего менять. Если вы НЕ регистрировались на этом гейте и НЕ получали свой уникальный ID, обратитесь на partner@umisoft.ru за ним. Полученный ID нужно будет использовать в запросе лицензионных ключей UMI.CMS (см. ниже).

5) Инструкция по консольной установке UMI.CMS:

• Загрузите файл installer.php в корень сервера (DOCUMENT_ROOT)
• Создайте файл install.ini в (DOCUMENT_ROOT), укажите в нем все необходимые данные. Кодировка файла utf-8
• Зайдите на сервер по ssh.

ssh example.com -llogin

• Сделайте корневую директорию сервера (DOCUMENT_ROOT) текущей.

cd /home/www/example.com/htdocs

• Запустите инсталлятор

php -f installer.php

Если консольный инсталлятор потребляет слишком много ресурсов сервера (процессор, память и т.д.) - обратитесь к специальным настройкам install.ini, позволяющих умерить их потребление.

6) Коды ошибок:

Практически все коды доступны по ссылке вида errors.umi-cms.ru/15000 где 15000 - числовой код ошибки.

---

Справочная информация:

Описание гейта для выдачи ключей: Хостер должен получать очередной ключ на каждый очередной экземпляр системы, устанавливаемой клиенту. Для получения ключа нужно обращаться по URL: для редакции Commerce Trial: http://updateserver.umihost.ru/udata/custom/generateLicenseGate/SFNUFTDJYFT/client@email.ru/FirstName/LastName/client.domain.ru/client.ip.address/trial

SFNUFTDJYFT - пример уникального ID вашего хостинга (см. выше про выдачу ключа персонального гейта) следующие параметры по порядку: e-mail клиента имя клиента фамилия клиента домен клиента IP-адрес, на котором расположен сайт с этим доменом

В результате выполнения этого запроса вы получаете XML-данные. Из них вам нужно извлечь значение параметра "domain-keycode" - это доменный ключ, который нужно записать в файл install.ini для инсталлятора UMI.CMS. После этого запустить инсталлятор.