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

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

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

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

Ознакомиться с ними можно по ссылке: http://www.umi-cms.ru/support/umi_cms_system_requirements/

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

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

Скачать его можно по ссылке: Файл:Installer.zip

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

Права на сам файл installer.php должны быть такими, чтобы php мог его переписать.

Инсталлятор обращается к внешним ресурсам для скачивания необходимых файлов и проверки аутентификационных данных. На хостинге для консольного php должны быть разрешены исходящие соединения.

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

Скачать пример этого файла можно по ссылке: http://www.umi-cms.ru/install/files/hosters/install.ini

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

В файле указаны доступы к базе данных. Перед началом установки она уже должна существовать. Рекомендуется, чтобы она была пустая.

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

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

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

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

; информация о PHP 
[SERVER]
; phppath=/usr/local/bin/php - больше не используется.
; phpini=/etc/php5/cli/php.ini - больше не используется.
 
;Информация о лицензии *
;-------------------------------------------------------
;Информация о лицензии *
[LICENSE]
domain=example.com		; доменное имя *
ip=127.0.1.7			; ip - адрес *
key=*-*-*			; лицензионный ключ *
 
;Доступ к базе данных. *
;База данных должна быть создана
;-------------------------------------------------------
[DB]
host=localhost			; имя хоста *
user=root			; логин *
password=";\pass;"		; пароль *
dbname=installer		; имя базы *

;Информация о супервайзере *
;-------------------------------------------------------
[SUPERVISOR]
login=sv			; логин для входа в админку *
password="1"			; пароль *
lname=Installer			; фамилия
fname=cli			; имя
mname=Vasilievich		; отчество

[BRAND]
;Ссылка "Купить UMI.CMS"
buy-lbl="Купить UMI.CMS"	; Текст ссылки
buy-link="http://www.umi-cms.ru/purchase/how-to-buy/" ; Ru URL
en-buy-lbl="Buy UMI.CMS"	; Link text
en-buy-link="http://www.umi-cms.ru/purchase/how-to-buy/" ; En URL

[BACKUP]
mode = "none" ; all или none

[DEMOSITE]
name="_blank"		; Имя предустановленного демо-сайта (demomarket,demodizzy,demohunt,demoold,demooldschool,_blank)

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

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

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

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

Консольный установщик может устанавливать любой из демо-сайтов UMI.CMS, с учётом ограничений, описанных далее. Примеры этих сайтов можно увидеть по ссылке: http://demo.umi-cms.ru/ . Демо-сайт государственной организации (Gov) в настоящее время автоматически не устанавливается.

Клиент вправе выбирать любой демо-сайт для любой редакции UMI.CMS. Однако следует учесть, что некоторые демосайты (например интернет-магазины) неразумно использовать для младших редакций, в которых нет соответствующих модулей (например модуля магазина). Но с другой стороны, если клиент докупил необходимые модули, то он сможет получить соответствующий демо-сайт (набор модулей определяется по лицензионному ключу). В силу этих причин установщик может выдать ошибку http://errors.umi-cms.ru/14022/ , если данный демосайт не подходит.

Если хостер не предоставляет клиентам выбор демо-сайта (как в большинстве случаев, когда он предлагает только Commerce Trial), то рекомендуется использовать следующие:

Для редакции Commerce Trial: [DEMOSITE] name="demomarket"

Либо сайт без шаблонов (не рекомендуется): [DEMOSITE] name="_blank"

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

Со стороны компании "Юмисофт" существует специальный гейт, выдающий лицензионные ключи необходимого типа (Commerce Trial). При регистрации хостера на гейте ему выдаётся уникальный идентификатор (ID), а также инструкции, куда отсылать запросы на получение лицензионных ключей.

Если вы уже пользуетесь таким гейтом, то в 99% случаев вам не нужно ничего менять.

Если вы НЕ регистрировались на этом гейте и НЕ получали свой уникальный ID, обратитесь на partner@umisoft.ru за ним. Полученный ID нужно будет использовать в запросе лицензионных ключей UMI.CMS (см. ниже).

5) Инструкция:

• Загрузите файл 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) Коды ошибок:

Практически все коды доступны по ссылке вида http://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. После этого запустить инсталлятор.