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

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

Задача

Выполнить установку UMI.CMS, используя средства командной строки сервера.

Решение

1) Проверка соответствия сервера системным требованиям UMI.CMS

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

2) Загрузка консольного инсталлятора:

Файл:Installer.zip

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

3) Загрузка и подготовка файла install.ini с настройками для установки:

Файл:Install.zip

Права на файл 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 ; Размер запрашиваемого пакета с сервера обновлений. Указывается в килобайтах, чем больше - тем быстрее.

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

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

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

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, позволяющих умерить их потребление.

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

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

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

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

---

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

Описание гейта для выдачи ключей: Хостер должен получать очередной ключ на каждый очередной экземпляр системы, устанавливаемой клиенту. Для получения ключа нужно обращаться по 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. После этого запустить инсталлятор.