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

Материал из Umicms
Перейти к:навигация, поиск
 
(не показана 1 промежуточная версия этого же участника)
Строка 1: Строка 1:
'''Актуально для версии 21.'''
+
'''Актуально для версии 21'''
  
Для установки потребуется:
+
== Задача ==
 +
Выполнить установку UMI.CMS, используя средства командной строки сервера.
  
0) Соответствие сервера [http://www.umi-cms.ru/support/umi_cms_system_requirements/ системным требованиям UMI.CMS]
+
== Решение ==
 +
 
 +
1) Проверка соответствия сервера [http://www.umi-cms.ru/support/umi_cms_system_requirements/ системным требованиям UMI.CMS]
  
 
Консольный инсталлятор проверяет соответствие системным требованиям при установке.
 
Консольный инсталлятор проверяет соответствие системным требованиям при установке.
 
Если вы используете отдельно консольный php и отдельно модуль apache - обратите внимание, что требования должны соблюдаться для обоих из них (иногда они используют разные конфигурационные файлы).
 
Если вы используете отдельно консольный php и отдельно модуль apache - обратите внимание, что требования должны соблюдаться для обоих из них (иногда они используют разные конфигурационные файлы).
  
1) Консольный инсталлятор:
+
2) Загрузка консольного инсталлятора:
  
 
[[Файл:Installer.zip]]
 
[[Файл:Installer.zip]]
Строка 16: Строка 19:
 
Инсталлятор обращается к внешним ресурсам для скачивания необходимых файлов и проверки аутентификационных данных. На хостинге для консольного php должны быть разрешены исходящие соединения.
 
Инсталлятор обращается к внешним ресурсам для скачивания необходимых файлов и проверки аутентификационных данных. На хостинге для консольного php должны быть разрешены исходящие соединения.
  
2) Файл install.ini с настройками для установки конкретного сайта:
+
3) Загрузка и подготовка файла install.ini с настройками для установки:
  
 
[[Файл:install.zip]]
 
[[Файл:install.zip]]
Строка 82: Строка 85:
 
</source>
 
</source>
  
3) Выбор соответствующего демо-сайта для установки:
+
4) Выбор соответствующего демо-сайта для установки:
  
 
Консольный установщик может устанавливать любой из демо-сайтов UMI.CMS, с учётом ограничений, описанных далее. Примеры этих сайтов можно увидеть в [http://demo.umi-cms.ru/ демо-центре].
 
Консольный установщик может устанавливать любой из демо-сайтов UMI.CMS, с учётом ограничений, описанных далее. Примеры этих сайтов можно увидеть в [http://demo.umi-cms.ru/ демо-центре].
 
Клиент вправе выбирать любой демо-сайт для любой редакции UMI.CMS. Однако следует учесть, что некоторые демосайты (например интернет-магазины) неразумно использовать для младших редакций, в которых нет соответствующих модулей (например модуля "Интернет-магазин"). Но с другой стороны, если клиент докупил необходимые модули, то он сможет получить соответствующий демо-сайт (набор модулей определяется по лицензионному ключу). В силу этих причин установщик может выдать [http://errors.umi-cms.ru/14022/ ошибку], если данный демосайт не подходит.
 
Клиент вправе выбирать любой демо-сайт для любой редакции UMI.CMS. Однако следует учесть, что некоторые демосайты (например интернет-магазины) неразумно использовать для младших редакций, в которых нет соответствующих модулей (например модуля "Интернет-магазин"). Но с другой стороны, если клиент докупил необходимые модули, то он сможет получить соответствующий демо-сайт (набор модулей определяется по лицензионному ключу). В силу этих причин установщик может выдать [http://errors.umi-cms.ru/14022/ ошибку], если данный демосайт не подходит.
  
Варианты демо-шаблонов:
+
Варианты демо-шаблонов:<br>
- "demomarket" - [https://demo.umi-cms.ru/category:all:commerce Адаптивный интернет-магазин]
+
- "demomarket" - [https://demo.umi-cms.ru/category:all:commerce Адаптивный интернет-магазин]<br>
 
- "_blank" - без демо-шаблона
 
- "_blank" - без демо-шаблона
  
4) Персональный гейт для выдачи лицензионных ключей UMI.CMS:
+
5) Установка UMI.CMS:
 
 
Со стороны компании "Юмисофт" существует специальный гейт, выдающий лицензионные ключи необходимого типа (Commerce Trial). При регистрации хостера на гейте ему выдаётся уникальный идентификатор (ID), а также инструкции, куда отсылать запросы на получение лицензионных ключей.
 
Если вы уже пользуетесь таким гейтом, то в 99% случаев вам не нужно ничего менять.
 
Если вы НЕ регистрировались на этом гейте и НЕ получали свой уникальный ID, обратитесь на partner@umisoft.ru за ним. Полученный ID нужно будет использовать в запросе лицензионных ключей UMI.CMS (см. ниже).
 
 
 
5) Инструкция по консольной установке UMI.CMS:
 
  
 
* Загрузите файл installer.php в корень сервера (DOCUMENT_ROOT)  
 
* Загрузите файл installer.php в корень сервера (DOCUMENT_ROOT)  
Строка 114: Строка 111:
 
</source>
 
</source>
  
Если консольный инсталлятор потребляет слишком много ресурсов сервера (процессор, память и т.д.) - обратитесь к специальным настройкам install.ini, позволяющих умерить их потребление.  
+
Если консольный инсталлятор потребляет слишком много ресурсов сервера (процессор, память и т.д.) - обратитесь к специальным настройкам install.ini, позволяющих умерить их потребление.
  
6) Коды ошибок:
+
5) Коды ошибок:
  
 
Практически все коды доступны по ссылке вида errors.umi-cms.ru/15000
 
Практически все коды доступны по ссылке вида errors.umi-cms.ru/15000
 
где 15000 - числовой код ошибки.
 
где 15000 - числовой код ошибки.
 +
 +
6) Персональный гейт для выдачи лицензионных ключей UMI.CMS:
 +
 +
Со стороны компании "Юмисофт" существует специальный гейт, выдающий лицензионные ключи необходимого типа (Commerce Trial). При регистрации хостера на гейте ему выдаётся уникальный идентификатор (ID), а также инструкции, куда отсылать запросы на получение лицензионных ключей.
 +
Если вы уже пользуетесь таким гейтом, то в 99% случаев вам не нужно ничего менять.
 +
Если вы НЕ регистрировались на этом гейте и НЕ получали свой уникальный ID, обратитесь на partner@umisoft.ru за ним. Полученный ID нужно будет использовать в запросе лицензионных ключей UMI.CMS (см. ниже).
  
 
--------------------------------------------------------------------------------------------------------------------------------------------------
 
--------------------------------------------------------------------------------------------------------------------------------------------------

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