Инструкция по установке, запуску и использованию программы «IDV CMS»

1. Общие положения

Настоящий документ содержит порядок установки экземпляра программы для ЭВМ «IDV CMS» версии 1.0.0, предоставленного для проведения экспертной проверки. Инструкция рассчитана на то, что эксперт развернёт экземпляр самостоятельно, без помощи автора.

«IDV CMS» является веб-приложением с серверной частью: системой управления содержимым сайтов (CMS). Программа написана на языке PHP и хранит данные в PostgreSQL. Веб-сервер nginx с php-fpm, PHP и PostgreSQL берутся из репозитория операционной системы и в поставку не входят. Сторонних библиотек, шрифтов и сценариев в составе программы нет. Docker и виртуальные машины не требуются.

Установка и работа программы не требуют доступа к сети Интернет. Единственное исходящее соединение, которое программа может установить, это отправка почты через SMTP-сервер, указанный администратором в настройках.

2. Требования к проверочной среде

Что Требование
Операционная система Linux. Программа предназначена для Astra Linux Special Edition 1.8, РЕД ОС 8, ALT; также работает на Debian 12 и Ubuntu.
PHP версия 8.2 или новее (php-cli и php-fpm) с расширениями pdo_pgsql и mbstring; желательно расширение gd (нужно для создания уменьшенных копий изображений)
СУБД PostgreSQL версии 13 или новее (сервер и клиент psql) на этом же сервере либо на другом, если база создана заранее
Веб-сервер nginx; допускается другой веб-сервер с поддержкой FastCGI, тогда он настраивается вручную по образцу /etc/idv-cms/nginx-site.conf.example
Права доступ администратора (sudo) на сервере проверки
Порт 80 для проверки по умолчанию (можно задать другой параметром --port)
Планировщик cron (или таймер systemd, если cron не установлен): задания выполняются каждые 5 минут
Доступ к сети Интернет не требуется для установки и работы программы; нужен только для установки пакетов окружения из репозитория ОС, если локальной копии репозитория нет

3. Состав поставки и получение экземпляра

Экземпляр для экспертной проверки предоставляется в трёх видах, содержимое которых одинаково:

Файл Назначение
idv-cms_1.0.0_all.deb пакет для Astra Linux, Debian, Ubuntu
idv-cms-1.0.0-1.noarch.rpm пакет для РЕД ОС, ALT
idv-cms-1.0.0.tar.gz архив для сервера без менеджера пакетов и для хостинга
SHA256SUMS контрольные суммы SHA-256 перечисленных файлов

Файлы размещены на странице правообладателя https://itdevlink.ru/products/idv-cms и передаются эксперту вместе с заявкой. Перед установкой проверьте контрольные суммы (файлы и SHA256SUMS должны лежать в одном каталоге):

sha256sum -c SHA256SUMS

Ожидаемый результат: у каждого найденного файла строка «OK».

4. Подготовка окружения

Окружение устанавливается из репозитория операционной системы. Для Astra Linux, Debian и Ubuntu:

sudo apt install php-cli php-fpm php-pgsql php-mbstring php-gd nginx postgresql cron

Для РЕД ОС и ALT устанавливаются пакеты с теми же назначениями: php-cli, php-fpm, php-pgsql, php-mbstring, php-gd, nginx, postgresql-server (в РЕД ОС менеджер пакетов dnf, в ALT apt-get). Точные имена пакетов в репозитории конкретной версии ОС можно найти поиском (dnf search php-pgsql или apt-cache search php-pgsql). В ALT имена пакетов PHP могут содержать номер версии.

Если версия PHP в репозитории ОС ниже 8.2, программа не установится: мастер настройки сообщит об этом. В этом случае необходимо использовать версию ОС или репозиторий с подходящей версией PHP.

Проверка версий:

php -v
psql --version
nginx -v

5. Установка программы

5.1. Пакет deb (Astra Linux, Debian, Ubuntu)

sudo dpkg -i idv-cms_1.0.0_all.deb

5.2. Пакет rpm (РЕД ОС, ALT)

sudo rpm -i idv-cms-1.0.0-1.noarch.rpm

5.3. Архив tar.gz (сервер без менеджера пакетов)

tar xzf idv-cms-1.0.0.tar.gz
cd idv-cms-1.0.0
sudo ./install.sh

Любой из способов копирует программу в каталог /opt/idv-cms (владелец root, только чтение), создаёт каталоги /etc/idv-cms (настройки) и /var/lib/idv-cms (данные), а также команды idv-cms и idv-cms-setup. Базу данных, администратора и настройки веб-сервера на этом шаге пакет не создаёт: это выполняет первичная настройка.

6. Первичная настройка одной командой

sudo idv-cms-setup

Мастер задаёт два вопроса: логин администратора (по умолчанию admin) и пароль (не короче 10 символов, буквы и цифры, вводится дважды). Остальное выполняется автоматически:

  • создаются роль и база данных PostgreSQL на этом сервере (имя idv_cms, пароль роли случайный, записывается только в файл настроек /etc/idv-cms/config.php);
  • создаётся структура базы данных и учётная запись администратора;
  • создаются пул php-fpm и сайт nginx; стандартная страница nginx отключается, если сайт должен отвечать на любое имя сервера;
  • включается задание планировщика (каждые 5 минут);
  • запускается самопроверка idv-cms check.

Настройка без вопросов (пароль передаётся переменной окружения, чтобы не попасть в историю команд и список процессов):

sudo env CMS_ADMIN_PASSWORD='ПарольПроверки2026' idv-cms-setup --non-interactive \
    --admin-login=admin --site-name='Проверочный сайт' --site-url=http://адрес-сервера

Если в режиме без вопросов пароль не передан, программа создаст случайный пароль и один раз покажет его на экране в конце работы. В журнал настройки пароль не записывается.

Основные параметры (полный список: idv-cms-setup --help):

Параметр Назначение
--site-url=АДРЕС адрес сайта (по умолчанию http:// и имя сервера)
--server-name=ИМЯ имя сервера для nginx; без параметра сайт отвечает на любое имя
--site-name=НАЗВАНИЕ название сайта
--port=80 порт nginx
--pack=НАБОР отраслевой набор разделов: culture, edu, gov, org
--admin-login=ЛОГИН логин администратора (по умолчанию admin)
--admin-password-file=ФАЙЛ пароль администратора из первой строки файла
--db-host, --db-port, --db-name, --db-user, --db-password использовать уже существующую базу данных (на другом сервере или созданную заранее); без них база создаётся на этом сервере
--no-nginx не изменять настройки nginx и php-fpm
--non-interactive ничего не спрашивать

Журнал настройки без паролей: /var/log/idv-cms-setup.log.

7. Проверка установки

Самопроверка выполняется автоматически в конце первичной настройки. Повторить её можно от имени пользователя веб-сервера (его имя мастер выводит на экран и записывает в /etc/idv-cms/setup.state):

sudo -u "$(sed -n 's/^web_user=//p' /etc/idv-cms/setup.state)" idv-cms check

Самопроверка работает без сети и не изменяет данные сайта (проверки в базе выполняются в отменяемой транзакции). Ожидаемый результат: строки, начинающиеся с «OK», и итоговая строка вида «Самопроверка: N из N. Сбоев нет.»; код выхода 0. В начале вывода:

OK    Версия PHP не ниже 8.2 (установлена 8.2.x)
OK    Расширения PHP: pdo_pgsql, mbstring
OK    Очистка разметки удаляет сценарии и опасные ссылки
...
OK    Подключение к PostgreSQL версии не ниже 13
OK    Структура базы данных актуальна
...
Самопроверка: 27 из 27. Сбоев нет.

Число проверок зависит от действующей редакции и включённых модулей: без лицензионного ключа в примере 27 из 27, с ключом редакции «Корпорация» 36 из 36. Каждый модуль добавляет собственные проверки. Строка «СБОЙ» с пояснением означает, что соответствующая функция не работает; код выхода в этом случае 1.

Проверка ответа сайта (если порт и имя сервера не менялись):

curl -s -o /dev/null -w '%{http_code}\n' http://127.0.0.1/
curl -s -o /dev/null -w '%{http_code}\n' http://127.0.0.1/admin/login

Ожидаемый результат: код 200 для обеих команд. Версию программы показывает команда:

idv-cms version

Ожидаемый ответ: «IDV CMS 1.0.0 от 2026-11-13».

8. Установка лицензионного ключа (редакции «Бизнес» и «Корпорация»)

Редакция «Старт» работает без ключа. Редакции «Бизнес» и «Корпорация» включаются лицензионным ключом: файлом или текстом, который выдаёт правообладатель. Эксперту передаётся файл expert-license.key (редакция «Корпорация», пробная, по 31.12.2027, без привязки к сайту). Установка ключа (файл лежит в текущем каталоге):

sudo -u "$(sed -n 's/^web_user=//p' /etc/idv-cms/setup.state)" idv-cms license:install expert-license.key

Ожидаемый результат: строки «Редакция: Корпорация», «Состояние: ...», «Лицензиат: ...» и срок действия, код выхода 0. Повторная самопроверка (команда из раздела 7) после установки ключа:

Самопроверка: 36 из 36. Сбоев нет.

До установки ключа самопроверка даёт 27 из 27: проверяются возможности редакции «Старт». Текущую редакцию показывает команда idv-cms license; удаляет ключ idv-cms license:remove (сайт возвращается к редакции «Старт»). Ключ можно также вставить в панели управления, раздел «Редакция и лицензия».

Ключ проверяется на сервере локально электронной подписью, без обращения к сети, и нигде не передаётся. Для проверки подписи нужно расширение PHP sodium; если его нет, программа сообщает об этом, и нужно установить пакет php-sodium из репозитория ОС. Если срок ключа истёк или ключ выдан для другого сайта, сайт продолжает работать в редакции «Старт».

9. Вход в панель управления и учётные данные

Панель управления открывается по адресу сайта с добавлением /admin, например http://адрес-сервера/admin. Для входа используются логин и пароль администратора, заданные при первичной настройке (либо логин admin и пароль, показанный на экране при настройке без вопросов). Готовых учётных записей и паролей в программе нет: учётная запись создаётся при установке.

Если пароль утерян, новый задаёт администратор сервера командой (от имени пользователя веб-сервера):

sudo -u "$(sed -n 's/^web_user=//p' /etc/idv-cms/setup.state)" idv-cms user:password --login=admin --password='НовыйПароль2026'

Вход в панель можно проверить по шагам: открыть /admin, ввести логин и пароль, убедиться, что открылась «Сводка» с меню слева (разделы «Содержимое», «Обращения», «Настройка», «Администрирование»).

10. Установка без прав администратора (хостинг)

Для виртуального хостинга и сервера без прав администратора используется архив tar.gz: после распаковки выполняется ./install.sh без sudo, программа копируется в каталог ~/idv-cms, корень сайта указывается как ~/idv-cms/public. Затем открывается адрес сайта в браузере и заполняется форма установки (база данных PostgreSQL должна быть создана заранее; данные подключения, логин и пароль администратора вводятся в форме). Задание планировщика (php ~/idv-cms/bin/idv-cms cron каждые 5 минут) настраивается средствами хостинга.

11. Обновление

Обновление выполняется администратором вручную: программа не обновляется автоматически и не обращается к серверам правообладателя. Новая версия устанавливается тем же способом (dpkg -i, rpm -U либо ./install.sh из нового архива). Настройки, данные и база не затрагиваются; структура базы данных обновляется автоматически, при необходимости её можно обновить вручную командой idv-cms migrate.

12. Удаление экземпляра

Удаление программы с сохранением настроек, данных и базы (повторная установка подхватит их):

sudo dpkg -r idv-cms        # Astra Linux, Debian, Ubuntu
sudo rpm -e idv-cms           # РЕД ОС, ALT

Полное удаление настроек (deb):

sudo dpkg -P idv-cms

Данные сайта и базу данных пакет не удаляет, чтобы не потерять информацию. Если они больше не нужны, их удаляют вручную:

sudo rm -rf /var/lib/idv-cms
sudo -u postgres dropdb idv_cms
sudo -u postgres psql -c 'DROP ROLE idv_cms'

13. Типовые ошибки при установке

Сообщение или признак Причина Что сделать
нужен PHP 8.2 или новее в репозитории ОС старая версия PHP использовать ОС или репозиторий с PHP 8.2 и новее
нет расширения PHP pdo_pgsql (или mbstring) не установлен пакет расширения установить php-pgsql и php-mbstring, повторить команду
не найден php, nginx или psql окружение не установлено выполнить раздел 4
пароль администратора: не короче 10 символов, буквы и цифры пароль не подходит под требования задать пароль длиннее, с буквами и цифрами
база уже существует и не пуста база с именем idv_cms занята указать другое имя: --db-name=ИМЯ
вход по паролю с адреса 127.0.0.1 не проходит в pg_hba.conf для 127.0.0.1 не включён метод scram-sha-256 или md5 включить метод, перечитать настройки PostgreSQL, повторить настройку
Программа уже установлена: найден файл настроек первичная настройка уже выполнялась для новой установки удалить настройки (раздел 12) или использовать другой сервер
сайт отвечает 502 не запущен php-fpm или не создан сокет проверить службу php-fpm, журнал /var/log/idv-cms-setup.log, выполнить повторную настройку
предупреждение: нет расширения PHP gd не установлен php-gd работа возможна; для уменьшенных копий изображений установить php-gd
СБОЙ: каталог данных недоступен для записи idv-cms check запущен не от пользователя веб-сервера запустить команду из раздела 7

14. Сведения для связи

Правообладатель: ООО «АЙТИ ДЕВ ЛИНК». Электронная почта: info@itdevlink.ru. Страница программы: https://itdevlink.ru/products/idv-cms.