Установка из консоли (командной строки) — различия между версиями

Материал из Umicms
Перейти к:навигация, поиск
 
(не показано 20 промежуточных версий 4 участников)
Строка 1: Строка 1:
Для установки потребуется:
+
'''Актуально для версии 21'''
  
0) Соответствие сервера системным требованиям UMI.CMS:
+
== Задача ==
 +
Выполнить установку UMI.CMS, используя средства командной строки сервера.
  
Ознакомиться с ними можно по ссылке:
+
== Решение ==
http://www.umi-cms.ru/support/umi_cms_system_requirements/
 
  
Консольный инсталлятор проверяет соответствие системным требованиям при установке. Если вы используете отдельно консольный php и отдельно модуль apache - обратите внимание, что требования должны соблюдаться для обоих из них (иногда они используют разные конфигурационные файлы).
+
1) Проверка соответствия сервера [http://www.umi-cms.ru/support/umi_cms_system_requirements/ системным требованиям UMI.CMS]
  
 +
Консольный инсталлятор проверяет соответствие системным требованиям при установке.
 +
Если вы используете отдельно консольный php и отдельно модуль apache - обратите внимание, что требования должны соблюдаться для обоих из них (иногда они используют разные конфигурационные файлы).
  
1) Консольный инсталлятор:
+
2) Загрузка консольного инсталлятора:
  
Скачать его можно по ссылке:
+
[[Файл:Installer.zip]]
http://www.umi-cms.ru/install/files/hosters/installer.php
 
  
 
Файл installer.php должен быть помещён в корневую директорию сайта, на который производится установка UMI.CMS. Рекомендуется, чтобы эта директория была пустой. Необходимо чтобы она имела права на чтение и запись из php (если затрудняетесь выбрать - ставьте 777).
 
Файл installer.php должен быть помещён в корневую директорию сайта, на который производится установка UMI.CMS. Рекомендуется, чтобы эта директория была пустой. Необходимо чтобы она имела права на чтение и запись из php (если затрудняетесь выбрать - ставьте 777).
 
 
Права на сам файл installer.php должны быть такими, чтобы php мог его переписать.
 
Права на сам файл installer.php должны быть такими, чтобы php мог его переписать.
 
 
Инсталлятор обращается к внешним ресурсам для скачивания необходимых файлов и проверки аутентификационных данных. На хостинге для консольного php должны быть разрешены исходящие соединения.
 
Инсталлятор обращается к внешним ресурсам для скачивания необходимых файлов и проверки аутентификационных данных. На хостинге для консольного php должны быть разрешены исходящие соединения.
  
 +
3) Загрузка и подготовка файла install.ini с настройками для установки:
  
2) Файл install.ini с настройками для установки конкретного сайта:
+
[[Файл:install.zip]]
 
 
Скачать пример этого файла можно по ссылке:
 
http://www.umi-cms.ru/install/files/hosters/install.ini
 
 
 
Права на файл install.ini должны быть такими, чтобы php мог его переписать. Файл install.ini должен быть помещён в ту же директорию, где находится installer.php, до начала установки. После установки его рекомендуется удалять.
 
  
 +
Права на файл install.ini должны быть такими, чтобы php мог его переписать. Файл install.ini должен быть помещён в ту же директорию, где находится installer.php, до начала установки.
 
В файле указаны доступы к базе данных. Перед началом установки она уже должна существовать. Рекомендуется, чтобы она была пустая.
 
В файле указаны доступы к базе данных. Перед началом установки она уже должна существовать. Рекомендуется, чтобы она была пустая.
  
Если вы уже пользовались консольным установщиком UMI.CMS, то многие параметры менять не потребуется. Просто проверьте их корректность и правильный синтаксис. Подробная инструкция - ниже.
+
Файл должен быть сохранен в кодировке utf-8. Значения параметров, содержащие не латинские символы, а также спецсимволы необходимо брать в двойные кавычки ""; (например, пароль)
  
Важно: процесс установки с дефолтными значениями специально замедлен для слабых хостингов, поэтому с ними система может ставиться долго. Используйте следующие параметры для более быстрой установки или (наоборот) для экономии ресурсов сервера:
+
Пример файла:
 +
<source lang="ini">
 +
;=======================================================
 +
;= Инструкции для инсталлятора UMI.CMS в режиме CLI
 +
;= Обязательные секции и их опции отмечены *
 +
;=======================================================
  
[SETUP]
+
[SERVER]
sleep=1 ; Пауза между запросами в миллисекундах, чем меньше - тем быстрее.
+
; phppath="php7.3" ;необходимо указать, если версия php в консоли по умолчанию < 7.0
download_by=1024 ; Размер запрашиваемого пакета с сервера обновлений. Указывается в килобайтах, чем больше - тем быстрее.
 
  
 +
;Информация о лицензии *
 +
;-------------------------------------------------------
 +
[LICENSE]
 +
domain = ""; Домен *
 +
ip = ""; ip Адрес *
 +
key = ""; Лицензионный ключ *
  
3) Выбор соответствующего демо-сайта для установки:
+
;Доступ к базе данных. *
 +
;База данных должна быть создана
 +
;-------------------------------------------------------
 +
[DB]
 +
host = ""; Хост *
 +
port= ""; Порт
 +
user = ""; Логин *
 +
password = ""; Пароль *
 +
dbname = ""; Имя базы данных *
  
Консольный установщик может устанавливать любой из демо-сайтов UMI.CMS, с учётом ограничений, описанных далее. Примеры этих сайтов можно увидеть по ссылке: http://demo.umi-cms.ru/ . Демо-сайт государственной организации (Gov) в настоящее время автоматически не устанавливается.
 
 
Клиент вправе выбирать любой демо-сайт для любой редакции UMI.CMS. Однако следует учесть, что некоторые демосайты (например интернет-магазины) неразумно использовать для младших редакций, в которых нет соответствующих модулей (например модуля магазина). Но с другой стороны, если клиент докупил необходимые модули, то он сможет получить соответствующий демо-сайт (набор модулей определяется по лицензионному ключу). В силу этих причин установщик может выдать ошибку http://errors.umi-cms.ru/14022/ , если данный демосайт не подходит.
 
 
Если хостер не предоставляет клиентам выбор демо-сайта (как в большинстве случаев, когда он предлагает только Start и Commerce Trial), то рекомендуется использовать следующие:
 
 
Для редакции Start:
 
 
[DEMOSITE]
 
[DEMOSITE]
name="demooldschool"
+
name = "_blank"; Имя устанавливаемого решения
  
Для редакции Commerce Trial:
+
;Информация о супервайзере *
[DEMOSITE]
+
;-------------------------------------------------------
name="demodizzy"
+
[SUPERVISOR]
 +
login = "sv"; Логин *
 +
password = "1"; Пароль *
 +
lname = ""; Фамилия
 +
fname = ""; Имя
 +
mname = ""; Отчество
 +
email = ""; Почтовый ящик
  
Либо сайт без шаблонов (не рекомендуется):
+
[SETUP]
[DEMOSITE]
+
sleep=0 ; Время простоя для снижения нагрузки на сервер. Указывается в миллисекундах. Одна миллисекунда - одна тясячная одной секунды (500 = полсекунды)
name="_blank"
+
download_by=4096 ; Размер запрашиваемого пакета с сервера обновлений. Указывается в килобайтах.
 +
split_block_size=100000
  
 +
[UPDATES]
 +
update-database-by-parts = "0"
 +
keep-installer = "0"
 +
</source>
  
4) Персональный гейт для выдачи лицензионных ключей UMI.CMS:
+
'''Важно:''' процесс установки с дефолтными значениями специально замедлен для слабых хостингов, поэтому с ними система может ставиться долго. Используйте следующие параметры для более быстрой установки или (наоборот) для экономии ресурсов сервера:
 +
<source lang="ini">
 +
[SETUP]
 +
sleep=1 ; Пауза между запросами в миллисекундах, чем меньше - тем быстрее.
 +
download_by=4096 ; Размер запрашиваемого пакета с сервера обновлений. Указывается в килобайтах, чем больше - тем быстрее.
 +
</source>
  
Со стороны компании "Юмисофт" существует специальный гейт, выдающий лицензионные ключи необходимых типов (Start и Commerce Trial). При регистрации хостера на гейте ему выдаётся уникальный идентификатор (ID), а так же инструкции куда отсылать запросы на получение лицензионных ключей.
+
4) Выбор соответствующего демо-сайта для установки:
  
Если вы уже пользуетесь таким гейтом, то в 99% случаев вам не нужно ничего менять.
+
Консольный установщик может устанавливать любой из демо-сайтов UMI.CMS, с учётом ограничений, описанных далее. Примеры этих сайтов можно увидеть в [http://demo.umi-cms.ru/ демо-центре].
 +
Клиент вправе выбирать любой демо-сайт для любой редакции UMI.CMS. Однако следует учесть, что некоторые демосайты (например интернет-магазины) неразумно использовать для младших редакций, в которых нет соответствующих модулей (например модуля "Интернет-магазин"). Но с другой стороны, если клиент докупил необходимые модули, то он сможет получить соответствующий демо-сайт (набор модулей определяется по лицензионному ключу). В силу этих причин установщик может выдать [http://errors.umi-cms.ru/14022/ ошибку], если данный демосайт не подходит.
  
Если вы НЕ регистрировались на этом гейте и НЕ получали свой уникальный ID, обратитесь на partner@umisoft.ru за ним. Полученный ID нужно будет использовать в запросе лицензионных ключей UMI.CMS (см. ниже).
+
Варианты демо-шаблонов:<br>
 +
- "demomarket" - [https://demo.umi-cms.ru/category:all:commerce Адаптивный интернет-магазин]<br>
 +
- "_blank" - без демо-шаблона
  
 +
5) Установка UMI.CMS:
  
5) Запуск инсталлятора:
+
* Загрузите файл installer.php в корень сервера (DOCUMENT_ROOT)  
 +
* Создайте файл install.ini в (DOCUMENT_ROOT), укажите в нем все необходимые данные. Кодировка файла utf-8
 +
* Зайдите на сервер по ssh.
 +
<source lang="bash">
 +
ssh example.com -llogin
 +
</source>
 +
* Сделайте корневую директорию сервера (DOCUMENT_ROOT) текущей.
 +
<source lang="bash">
 +
cd /home/www/example.com/htdocs
 +
</source>
 +
* Запустите инсталлятор
 +
<source lang="bash">
 +
php -f installer.php
 +
</source>
  
Запуск осуществляется как запуск обычного php-скрипта, например
+
Если консольный инсталлятор потребляет слишком много ресурсов сервера (процессор, память и т.д.) - обратитесь к специальным настройкам install.ini, позволяющих умерить их потребление.
cd /full/path/to/site/htdocs/
 
/usr/local/bin/php ./installer.php
 
  
Если консольный инсталлятор потребляет слишком много ресурсов сервера (процессор, память и т.д.) - обратитесь к специальным настройкам install.ini, позволяющих умерить их потребление. Подробная инструкция - ниже.
+
5) Коды ошибок:
  
 +
Практически все коды доступны по ссылке вида errors.umi-cms.ru/15000
 +
где 15000 - числовой код ошибки.
  
6) Коды ошибок:
+
6) Персональный гейт для выдачи лицензионных ключей UMI.CMS:
 
 
Практически все коды доступны по ссылке вида http://errors.umi-cms.ru/15000/
 
где 15000 - числовой код ошибки.
 
  
 +
Со стороны компании "Юмисофт" существует специальный гейт, выдающий лицензионные ключи необходимого типа (Commerce Trial). При регистрации хостера на гейте ему выдаётся уникальный идентификатор (ID), а также инструкции, куда отсылать запросы на получение лицензионных ключей.
 +
Если вы уже пользуетесь таким гейтом, то в 99% случаев вам не нужно ничего менять.
 +
Если вы НЕ регистрировались на этом гейте и НЕ получали свой уникальный ID, обратитесь на partner@umisoft.ru за ним. Полученный ID нужно будет использовать в запросе лицензионных ключей UMI.CMS (см. ниже).
  
 
--------------------------------------------------------------------------------------------------------------------------------------------------
 
--------------------------------------------------------------------------------------------------------------------------------------------------
Строка 89: Строка 129:
  
 
Описание гейта для выдачи ключей:
 
Описание гейта для выдачи ключей:
 
 
Хостер должен получать очередной ключ на каждый очередной экземпляр системы, устанавливаемой клиенту. Для получения ключа нужно обращаться по URL:
 
Хостер должен получать очередной ключ на каждый очередной экземпляр системы, устанавливаемой клиенту. Для получения ключа нужно обращаться по URL:
 
для редакции Start:
 
http://updateserver.umihost.ru/udata/custom/generateLicenseGate/SFNUFTDJYFT/client@email.ru/FirstName/LastName/client.domain.ru/client.ip.address/
 
 
 
для редакции Commerce Trial:
 
для редакции Commerce Trial:
 
http://updateserver.umihost.ru/udata/custom/generateLicenseGate/SFNUFTDJYFT/client@email.ru/FirstName/LastName/client.domain.ru/client.ip.address/trial
 
http://updateserver.umihost.ru/udata/custom/generateLicenseGate/SFNUFTDJYFT/client@email.ru/FirstName/LastName/client.domain.ru/client.ip.address/trial
 
Второй запрос отличается от первого только добавлением "/trial" в конце.
 
  
 
SFNUFTDJYFT - пример уникального ID вашего хостинга (см. выше про выдачу ключа персонального гейта)
 
SFNUFTDJYFT - пример уникального ID вашего хостинга (см. выше про выдачу ключа персонального гейта)

Текущая версия на 14:05, 11 марта 2020

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