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

Материал из Umicms
Перейти к:навигация, поиск
 
(не показано 12 промежуточных версий 3 участников)
Строка 1: Строка 1:
'''Актуально для версии 18.'''
+
'''Актуально для версии 21'''
  
Для установки потребуется:
+
== Задача ==
 +
Выполнить установку UMI.CMS, используя средства командной строки сервера.
  
0) Соответствие сервера системным требованиям UMI.CMS:
+
== Решение ==
  
Ознакомиться с ними можно по ссылке:
+
1) Проверка соответствия сервера [http://www.umi-cms.ru/support/umi_cms_system_requirements/ системным требованиям UMI.CMS]
http://www.umi-cms.ru/support/umi_cms_system_requirements/
 
  
Консольный инсталлятор проверяет соответствие системным требованиям при установке. Если вы используете отдельно консольный php и отдельно модуль apache - обратите внимание, что требования должны соблюдаться для обоих из них (иногда они используют разные конфигурационные файлы).
+
Консольный инсталлятор проверяет соответствие системным требованиям при установке.
 +
Если вы используете отдельно консольный php и отдельно модуль apache - обратите внимание, что требования должны соблюдаться для обоих из них (иногда они используют разные конфигурационные файлы).
  
 +
2) Загрузка консольного инсталлятора:
  
1) Консольный инсталлятор:
 
 
Скачать его можно по ссылке:
 
 
[[Файл:Installer.zip]]
 
[[Файл:Installer.zip]]
  
 
Файл 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. Значения параметров, содержащие не латинские символы, а также спецсимволы необходимо брать в двойные кавычки ""; (например, пароль)
 
 
Файл должен быть сохранен в кодировке utf-8! Значения параметров, содержащие не латинские символы, а так же спецсимволы необходимо брать в двойные кавычки ""; (например пароль)
 
  
 
Пример файла:
 
Пример файла:
 
<source lang="ini">
 
<source lang="ini">
 
;=======================================================
 
;=======================================================
;= инструкции для инсталлятора umi.cms в режиме CLI
+
;= Инструкции для инсталлятора UMI.CMS в режиме CLI
 
;= Обязательные секции и их опции отмечены *
 
;= Обязательные секции и их опции отмечены *
 
;=======================================================
 
;=======================================================
  
; информация о PHP
 
 
[SERVER]
 
[SERVER]
; phppath=/usr/local/bin/php - больше не используется.
+
; phppath="php7.3" ;необходимо указать, если версия php в консоли по умолчанию < 7.0
; phpini=/etc/php5/cli/php.ini - больше не используется.
+
 
 
 
;Информация о лицензии *
 
;Информация о лицензии *
 
;-------------------------------------------------------
 
;-------------------------------------------------------
;Информация о лицензии *
 
 
[LICENSE]
 
[LICENSE]
domain=example.com ; доменное имя *
+
domain = ""; Домен *
ip=127.0.1.7 ; ip - адрес *
+
ip = ""; ip Адрес *
key=*-*-* ; лицензионный ключ *
+
key = ""; Лицензионный ключ *
+
 
 
;Доступ к базе данных. *
 
;Доступ к базе данных. *
 
;База данных должна быть создана
 
;База данных должна быть создана
 
;-------------------------------------------------------
 
;-------------------------------------------------------
 
[DB]
 
[DB]
host=localhost ; имя хоста *
+
host = ""; Хост *
user=root ; логин *
+
port= ""; Порт
password=";\pass;" ; пароль *
+
user = ""; Логин *
dbname=installer ; имя базы *
+
password = ""; Пароль *
 +
dbname = ""; Имя базы данных *
 +
 
 +
[DEMOSITE]
 +
name = "_blank"; Имя устанавливаемого решения
  
 
;Информация о супервайзере *
 
;Информация о супервайзере *
 
;-------------------------------------------------------
 
;-------------------------------------------------------
 
[SUPERVISOR]
 
[SUPERVISOR]
login=sv ; логин для входа в админку *
+
login = "sv"; Логин *
password="1" ; пароль *
+
password = "1"; Пароль *
lname=Installer ; фамилия
+
lname = ""; Фамилия
fname=cli ; имя
+
fname = ""; Имя
mname=Vasilievich ; отчество
+
mname = ""; Отчество
 
+
email = ""; Почтовый ящик
[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" ; Имя предустановленного демо-сайта (demodizzy,demohunt,demoold,demooldschool,_blank)
 
  
 
[SETUP]
 
[SETUP]
sleep=500 ; Время простоя для снижения нагрузки на сервер. Указывается в миллисекундах. Одна миллисекунда - одна тясячная одной секунды (500 = полсекунды)
+
sleep=0 ; Время простоя для снижения нагрузки на сервер. Указывается в миллисекундах. Одна миллисекунда - одна тясячная одной секунды (500 = полсекунды)
download_by=1024 ; Размер запрашиваемого пакета с сервера обновлений. Указывается в килобайтах.
+
download_by=4096 ; Размер запрашиваемого пакета с сервера обновлений. Указывается в килобайтах.
 
+
split_block_size=100000
  
 +
[UPDATES]
 +
update-database-by-parts = "0"
 +
keep-installer = "0"
 
</source>
 
</source>
  
Важно: процесс установки с дефолтными значениями специально замедлен для слабых хостингов, поэтому с ними система может ставиться долго. Используйте следующие параметры для более быстрой установки или (наоборот) для экономии ресурсов сервера:
+
'''Важно:''' процесс установки с дефолтными значениями специально замедлен для слабых хостингов, поэтому с ними система может ставиться долго. Используйте следующие параметры для более быстрой установки или (наоборот) для экономии ресурсов сервера:
 
+
<source lang="ini">
 
[SETUP]
 
[SETUP]
 
sleep=1 ; Пауза между запросами в миллисекундах, чем меньше - тем быстрее.
 
sleep=1 ; Пауза между запросами в миллисекундах, чем меньше - тем быстрее.
download_by=1024 ; Размер запрашиваемого пакета с сервера обновлений. Указывается в килобайтах, чем больше - тем быстрее.
+
download_by=4096 ; Размер запрашиваемого пакета с сервера обновлений. Указывается в килобайтах, чем больше - тем быстрее.
 
+
</source>
 
 
3) Выбор соответствующего демо-сайта для установки:
 
 
 
Консольный установщик может устанавливать любой из демо-сайтов UMI.CMS, с учётом ограничений, описанных далее. Примеры этих сайтов можно увидеть по ссылке: http://demo.umi-cms.ru/ . Демо-сайт государственной организации (Gov) в настоящее время автоматически не устанавливается.
 
 
 
Клиент вправе выбирать любой демо-сайт для любой редакции UMI.CMS. Однако следует учесть, что некоторые демосайты (например интернет-магазины) неразумно использовать для младших редакций, в которых нет соответствующих модулей (например модуля магазина). Но с другой стороны, если клиент докупил необходимые модули, то он сможет получить соответствующий демо-сайт (набор модулей определяется по лицензионному ключу). В силу этих причин установщик может выдать ошибку http://errors.umi-cms.ru/14022/ , если данный демосайт не подходит.
 
 
 
Если хостер не предоставляет клиентам выбор демо-сайта (как в большинстве случаев, когда он предлагает только Commerce Trial), то рекомендуется использовать следующие:
 
 
 
Для редакции Commerce Trial:
 
[DEMOSITE]
 
name="demodizzy"
 
 
 
Либо сайт без шаблонов (не рекомендуется):
 
[DEMOSITE]
 
name="_blank"
 
 
 
 
 
4) Персональный гейт для выдачи лицензионных ключей UMI.CMS:
 
  
Со стороны компании "Юмисофт" существует специальный гейт, выдающий лицензионные ключи необходимого типа (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.
* Загрузите файл installer.php в корень сервера ([[DOCUMENT_ROOT]])  
 
* Создайте файл install.ini в ([[DOCUMENT_ROOT]]), укажите в нем все необходимые данные. Кодировка файла utf-8
 
* Зайдите на сервер по [[ssh]]
 
 
<source lang="bash">
 
<source lang="bash">
ssh example.com -llogin
+
ssh example.com -llogin
 
</source>
 
</source>
* Сделайте корневую директорию сервера ([[DOCUMENT_ROOT]]) текущей.
+
* Сделайте корневую директорию сервера (DOCUMENT_ROOT) текущей.
 
<source lang="bash">
 
<source lang="bash">
cd /home/www/example.com/htdocs
+
cd /home/www/example.com/htdocs
 
</source>
 
</source>
 
* Запустите инсталлятор
 
* Запустите инсталлятор
 
<source lang="bash">
 
<source lang="bash">
php -f installer.php
+
php -f installer.php
 
</source>
 
</source>
  
Если консольный инсталлятор потребляет слишком много ресурсов сервера (процессор, память и т.д.) - обратитесь к специальным настройкам install.ini, позволяющих умерить их потребление.  
+
Если консольный инсталлятор потребляет слишком много ресурсов сервера (процессор, память и т.д.) - обратитесь к специальным настройкам install.ini, позволяющих умерить их потребление.
  
 +
5) Коды ошибок:
  
6) Коды ошибок:
+
Практически все коды доступны по ссылке вида errors.umi-cms.ru/15000
 +
где 15000 - числовой код ошибки.
  
Практически все коды доступны по ссылке вида http://errors.umi-cms.ru/15000/
+
6) Персональный гейт для выдачи лицензионных ключей UMI.CMS:
где 15000 - числовой код ошибки.
 
  
 +
Со стороны компании "Юмисофт" существует специальный гейт, выдающий лицензионные ключи необходимого типа (Commerce Trial). При регистрации хостера на гейте ему выдаётся уникальный идентификатор (ID), а также инструкции, куда отсылать запросы на получение лицензионных ключей.
 +
Если вы уже пользуетесь таким гейтом, то в 99% случаев вам не нужно ничего менять.
 +
Если вы НЕ регистрировались на этом гейте и НЕ получали свой уникальный ID, обратитесь на partner@umisoft.ru за ним. Полученный ID нужно будет использовать в запросе лицензионных ключей UMI.CMS (см. ниже).
  
 
--------------------------------------------------------------------------------------------------------------------------------------------------
 
--------------------------------------------------------------------------------------------------------------------------------------------------
Строка 159: Строка 129:
  
 
Описание гейта для выдачи ключей:
 
Описание гейта для выдачи ключей:
 
 
Хостер должен получать очередной ключ на каждый очередной экземпляр системы, устанавливаемой клиенту. Для получения ключа нужно обращаться по URL:
 
Хостер должен получать очередной ключ на каждый очередной экземпляр системы, устанавливаемой клиенту. Для получения ключа нужно обращаться по URL:
 
 
для редакции 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

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