Планировщик задач
Настройка заданий cron на сервере
Планировщик задач запускает внутренние процессы iEXExchanger по установленному расписанию. Для этого системная служба CRON каждую минуту вызывает Laravel Scheduler, а система определяет, какие задачи должны быть выполнены в этот момент.
В штатной установке на чистом сервере используются три компонента:
cron.service
Проверяет расписание каждую минуту
enabled и active
/etc/cron.d/iexexchanger-scheduler
Содержит единственную команду запуска
Одна активная строка
iex-scheduler.service
Выполняет безопасный проверочный запуск
inactive и Result=success
Планировщик запускается от отдельного пользователя приложения. Запуск от root запрещён: он может изменить владельцев файлов и нарушить работу сайта, обновлений и фоновых процессов.
Какой способ восстановления выбрать
Сначала определите, завершилась ли первоначальная установка продукта.
Если Installer остановился на настройке или проверке планировщика, не создавайте системные файлы вручную. Продолжите тот же запуск с теми же файлами и конфигурацией.
Проверьте состояние установки:
cd /home/installer
sudo ./iex-installer statusЕсли последний запуск не завершён или имеет статус ошибки, выполните:
cd /home/installer
sudo ./iex-installer \
--config /home/installer/install.yaml \
--non-interactive \
--yes \
resumeПосле завершения запустите проверку:
sudo /home/installer/iex-installer \
--config /home/installer/install.yaml \
verifyИспользуйте ту же сборку Installer и тот же файл install.yaml, с которыми была начата установка. Не распаковывайте поверх каталога /home/installer другую версию Installer.
Если установка имеет успешный статус, сайт и административная панель работают, но планировщик отсутствует или выдаёт ошибку, сначала выполните диагностику:
sudo /home/installer/iex-installer \
--config /home/installer/install.yaml \
verify
systemctl is-enabled cron.service
systemctl is-active cron.service
cat /etc/cron.d/iexexchanger-scheduler
systemctl show iex-scheduler.service \
--property=LoadState,ActiveState,Result,ExecMainStatus,User,Group,SupplementaryGroupsЕсли полная проверка показывает другие неисправности сервера, сначала устраните их. Ручная настройка планировщика не исправляет повреждённый релиз, базу данных, PHP-FPM, Redis или PostgreSQL.
Готовый промпт для ИИ-агента
Для восстановления планировщика агенту не нужны домены, архивы продукта или ключ лицензии. Достаточно SSH-доступа к серверу. Все остальные значения должны быть получены из защищённого состояния установленной системы.
Подготовка к ручной настройке
Ручная настройка допускается, если первоначальная установка уже завершена, активный релиз существует, а неисправность относится только к планировщику.
Для выполнения инструкции необходим SSH-доступ с правами root.
Не продолжайте настройку во время установки, обновления или отката. Во время таких операций планировщик приостанавливается специально, чтобы не запускать новые задачи одновременно с изменением приложения.
Не удаляйте вручную файлы maintenance. Сначала проверьте состояние Installer или Updater и завершите соответствующую операцию.
Ручная настройка через терминал
Выполняйте все команды последовательно в одной SSH-сессии. Переменные, определённые на первых этапах, используются в последующих командах.
Подключение к серверу по SSHПроверьте состояние установленной системы
Убедитесь, что существует защищённое состояние установки и работает основной фоновый процесс приложения:
В результате iex-horizon.service должен иметь состояние active. В выводе Updater параметр Maintenance должен быть выключен, а последний запуск обновления или отката не должен находиться в процессе выполнения.
Если отображается активный maintenance или незавершённая операция, остановитесь и завершите её штатной командой.
Восстановите управляемые каталоги
Планировщику разрешена запись только в определённые runtime-каталоги. Восстановите их режимы и владельцев из штатной конфигурации:
Не используйте chmod 777 и не меняйте владельца каталога releases. Код активного релиза должен оставаться защищённым от записи приложением.
Проверка планировщика
Проверьте файлы и расписание
Сформируйте ожидаемую строку и сравните её с созданным файлом:
Проверьте, что других периодических запусков нет:
В результате должна отображаться только строка из /etc/cron.d/iexexchanger-scheduler.
Проверьте системные службы
Правильный результат:
В свойствах User и Group должен отображаться пользователь приложения, а в SupplementaryGroups — его группа с окончанием -web.
Проверьте зарегистрированные задачи
Получите список задач, которые зарегистрированы в текущем Backend:
Команда должна завершиться без PHP-ошибок и показать зарегистрированные задачи с их расписанием.
Запустите полную проверку Installer
Если исходный каталог Installer сохранён, завершите настройку полной проверкой:
После успешной полной проверки сохраните резервную копию из $BACKUP_DIR до ближайшей подтверждённой проверки работы сайта и административной панели. Затем её можно удалить вручную.
Решение проблем
iex-horizon.service не найден
Основные системные службы приложения не были установлены. Не создавайте только планировщик поверх незавершённой установки.
Проверьте Installer и продолжите исходную операцию:
Отображается Maintenance: ВКЛЮЧЁН
Планировщик приостановлен из-за установки, обновления, отката или восстановления. Не удаляйте /run/iexexchanger/maintenance и storage/framework/down вручную.
Проверьте состояние операций:
Сначала завершите или восстановите соответствующую операцию.
Scheduler завершается с Result=exit-code
Посмотрите журнал последнего запуска:
Повторите команду от пользователя приложения, а не от root:
Исправляйте конкретную ошибку, показанную командой. Не скрывайте её перенаправлением в /dev/null.
Не найден файл artisan
Проверьте активный релиз:
Если current отсутствует, повреждён или не указывает на релиз, не создавайте другой путь вручную. Используйте resume Installer либо штатное восстановление незавершённого обновления.
Отображается Permission denied
Восстановите управляемые каталоги:
Не применяйте chmod 777 и не выполняйте рекурсивный chown для /var/www/iexexchanger. Такие команды нарушают разграничение между защищённым кодом релиза и изменяемыми данными.
cron.service не запускается
Переустановите только пакет CRON и повторите запуск:
Последние сообщения службы:
Планировщик исправен, но отдельная функция не выполняется
Успешный запуск Scheduler подтверждает только выполнение зарегистрированного расписания. Он не включает автоматически настройки обменного пункта, источники курсов, мерчанты, автовыплаты или внешние интеграции.
Сначала выполните:
Если Scheduler завершён успешно, проверяйте настройки и журналы конкретной функции отдельно.
Последнее обновление