Common Problems¶
First off, make sure:
- You have eAccelerator disabled during install. eAccelerator can cause problems when doing the heavy lifting during the install process.
- You followed all the directions on the Upgrading MODX page.
- You’ve uploaded all the necessary files for upgrade, making sure to merge directories and not replace them.
- Clear your browser cache after upgrading. This will clear up a lot of common JS and CSS related errors.
- Clear the Site Cache after upgrading. Sometimes this doesn’t occur for whatever reason during setup/ because of your environment.
Help! The only option I can choose is «New Installation», but this is an upgrade!¶
This occurs when you erase the core/config/config.inc.php file. You’ll need to restore it. If you made a backup before upgrading (as is strongly recommended), just copy the file from there to your new core/config/ directory and make it writable.
If you didn’t backup, you can try creating a new core/config/config.inc.php from the template in core/docs/config.inc.tpl, by replacing all the placeholders surrounded by {}, and then making the file writable.
Setup went well, but my manager isn’t fully working¶
Make sure to clear your browser cache. Browsers cache the JS and CSS in the manager to have it load faster, and this often causes issues when upgrading, as the browser persists in using the old files. (Note: this is less of an issue post-2.0.2, as JS files are now prefixed with the version to make them non-cacheable after upgrades.)
Some manager pages are blank due to 400 Bad Request from manager/min/¶
If you’ve never had problems with min before and you happen to have installed the ACE Extra, make sure the files it refers to in manager/components/ace/ exist.
Still Problems?¶
Get help on the forum or from a MODX Professional.
See Also¶
- Troubleshooting Installation
- Additional Troubleshooting
Open COllective
Support the team building MODX with a monthly donation.
The budget raised through OpenCollective is transparent, including payouts, and any contributor can apply to be paid for their work on MODX.
Backers
Budget
$407 per month—let’s make that $500!
Learn more
Обновить MODX Revolution до актуальной версии не сложно, но многие пренебрегают этим. В новые версии движка включают исправления ошибок и устранение уязвимостей, поэтому откладывать обновление в долгий ящик не стоит.
В первую очередь перед обновлением сделайте резервную копию всех файлов сайта и базы данных. Это требуется чтобы в случае неудачного обновления сделать откат.
Скачайте актуальную версию MODX Revolution (Traditional). Распакуйте архив и закачайте его содержимое на хостинг, перезаписывая старые файлы движка. Затем начинаем установку.
http://YouSite.ru/setup/
В параметрах установки ставим галочку «Обновление существующей установки» и нажимаем «Далее». По идее, всё должно нормально обновиться. На практике иногда встречаются проблемы.
Ошибки при обновлении MODX
В самом начале обновления MODX может появится ошибка:
FATAL ERROR: MODX Setup cannot continue.
To use PHP 5.3.0+, you must set the date.timezone setting in your php.ini.
Please do set it to a proper timezone before proceeding. A list can be found here.
Нас просят прописать в файле конфигурации php.ini временную зону:
date.timezone=»Europe/Moscow»
И действительно, при первичной инсталляции MODX Revolution после этого установка шла дальше, а вот при обновлении почему-то проблема не решилась. Причину я так и не нашел, возможно, требуется прописать timezone где-то ещё.
Самый простой вариант обойти эту ошибку — в начале файла установщика MODX (/setup/index.php) прописать код:
@ ini_set(‘date.timezone’, ‘Moscow/Europe’);
После решения этой проблемы на следующем шаге обновления MODX Revolution я столкнулся с ещё одной ошибкой:
Ошибка обновления таблицы для класса modTemplateVar
Array
(
[0] => 42S21
[1] => 1060
[2] => Duplicate column name ‘input_properties’
)
Решилась проблема так, из каталога «/core/packages/» удаляем папку core и пробуем ещё раз пройти этот пункт установки/обновления MODX. Мне помогло.
Данное решение так же помогает при следующей ошибке:
Не удалось установить MODX, поскольку MODX не смог распаковать пакет «/core/packages/core.transport.zip».
Проверьте, что файл «/core/packages/core.transport.zip» существует, доступен для записи, и возможна запись в каталог «/core/packages/».
Возможно также возникновение ошибок, связанных с правами на каталоги, но на них я заострять внимание не буду, они быстро решаются установкой нужных прав (через терминал, FTP или SSH клиент).
После обновления MODX Revolution не забудьте удалить с хостинга каталог setup.
Предупреждение «Каталог ядра в открытом доступе»
В новых версиях движка в панели администрирования часто появляется сообщение «Каталог ядра в открытом доступе». Многие знают, что этим каталогом «/core/» и его файлы не должны быть доступны из вне. Для того чтобы ограничить доступ к ним, требуется в корне каталога создать файл .htaccess с содержимым:
<ifModule mod_authz_core.c>
Require all denied
</ifModule>
<ifModule !mod_authz_core.c>
deny from all
Satisfy All
</ifModule>
Несмотря на это, предупреждение об открытом каталоге ядра часто не пропадает. Это происходит из-за того что MODX осуществляет проверку с помощью доступности файла «/core/docs/changelog.txt», но есть проблема. На многих хостингах за отдачу изображений и текстовых файлов отвечает не apach, для которого созданы правила в htaccess, а nginx. Соответственно, текстовый файл будет доступен несмотря на запрет. В этом нет ничего страшного. Следует проверить доступность других важных файлов, например «/core/cache/logs/error.log», а файл «changelog.txt» просто переименовать или удалить.
После обновления ресурсы отдают 500 ошибку
Если после обновления MODX до версии 2.5.1 в панели администрирования невозможно отктыть ресурсы, то попробуйте удалить визуальный редактор TinyMCE.
Сделать это можно в разделе управления пакетами. В качестве замены рекомендуется использовать TinyMCE RTE или вовсе отказаться от редактора и использовать Ace с подсветкой html синтаксиса.
Способ 3. Ручное обновление
Само название предполагает, что мы перенесем новые файлы не скриптом, а руками. Для этого можно использовать файловый менеджер хостинга или программу для передачи файлов по FTP. Данный способ можно использовать в случае если по каким-то причинам невозможно воспользоваться предыдущими методами. Например, при входе в админ-панель возникает 500я ошибка.
Итак, идем на официальный сайт модэкса и качаем версию, которая нам нужна. Я чаще пользуюсь версией Traditional.
Полученный архив мы можем сразу закинуть на хостинг через файловый менеджер и разархивировать с заменой имеющихся файлов.
Так мы разместили новые файлы на хостинге.
Обращаю Ваше внимание на то, что архив распакуется в свою папку
В случае если у вас нет доступа к самому хостингу, а есть только к FTP, можно воспользоваться им. Для примера я буду использовать программу Filezilla, но вы можете пользоваться той, которая вам удобнее. Разархивируем, заходим в файлзиллу, соединяемся и загружаем с заменой на хостинг все папки и файлы.
Установка обновления
После загрузки файлов в браузерной строке вбиваем следующую конструкцию: *ваш адрес сайта*/setup
Появится интерфейс установки/обновления модэкса. Нажимаем кнопки «далее» (на каждом шаге они называются по-своему, но суть от этого не меняется), смотрим чтобы все уведомления были позитивными (зелёного цвета) и не требовали нашего вмешательства. Что это значит. По сути процесс обновления это та же самая установка движка, просто все данные уже внесены и нам нужно просто пройти все этапы процесса. Если при обновлении на каком-то шаге возникла ошибка, то модэкс не даст нам перейти на другой шаг пока не исправим ошибку. Тогда мы читаем текст красного цвета (это информация об ошибке) и исправляем её.
Обновление закаленного MODX
До этого я говорил о «традиционной» версии модэкса. Она стандартно устанавливается большинством скриптов от хостингов. Однако, у модэкса есть такая вещь как «закалка». Она характеризуется тем, что переименована папка с ядром (или все каталоги) или ядро вынесено на уровень выше. Это увеличивает безопасность сайта, но при этом немного меняется процесс обновления. На сайте модэкса мы скачиваем версию Modx advansed. В ней 2 папки: core и setup. setup заливаем в корень сайта. А папку core переименовываем также как она называется у вас и заливаем с заменой, и запускаем установку также, как было показано выше.
На первом же шаге вы увидите ошибку Your MODX_CORE_PATH is invalid (ваш MODX_CORE_PATH недействителен; укажите правильный путь в поле выше) меняем путь на правильный (пишем адрес переименованной папки core) и далее следуем по шагам.
Ошибки установки Modx
Чаще всего они возникают по причине нехватки прав на изменение файлов или из-за оставшегося кеша файлов. В другой статье я подробно опишу типичные ошибки при обновлении Modx revolution.
Сейчас стоит версия 2.6.1 нужно обновиться. После обновления админка открывается и там все хорошо, а сайт нет — белый экран. и неважно на какую версию перехожу…2.6.2 или 2.7.0. В логах ошибка одна и таже как до обновления, так и после (как во время работоспособности сайта, так и нет). Вот что пишет в логах
[2019-03-18 16:18:57] (ERROR @ /hosting2/saunax/electro-nagrev.by/core/xpdo/om/xpdoquery.class.php : 766) Encountered empty IN condition with key id
[2019-03-18 16:18:57] (ERROR @ /hosting2/saunax/electro-nagrev.by/core/xpdo/om/xpdoobject.class.php : 240) Error 42000 executing statement:
Array
(
[0] => 42000
[1] => 1064
[2] => You have an error in your SQL syntax; check the manual that corresponds to your MariaDB server version for the right syntax to use near ') AND `modResource`.`published` = 1 AND `modResource`.`deleted` = 0 )' at line 1
)Подскажите, где что нужно смотреть… Ошибка эта всегда, но сайт не открывается именно после обновления… Кэш чистила, все с папки удаляла…
There are a few other things you might want to try first.
Check the network tab and console tab in Chrome Dev tools (Ctrl-shift-i) while trying to use that Manager.
If there’s no clue there, see if you can go directly to a specific manager page after logging in, like
http://yoursite.com/manager/?a=resource/update&id=1
If that works, your problem is with the MODX dashboard. You can remove widgets from dashboards in the modx_dashboard_widget_placement table in the DB. Just delete any record there that’s on the default dashboard (usually 1). The two «feed» widgets (widgets 1 and 2) are often a problem. You could also delete all the records in that table. That doesn’t delete the widgets, it just takes them off any dashboard. If that fixes things, you can put the widgets back one by one in the Manager until you find the culprit.
If that doesn’t work, another thing to try would be to disable all plugins in the modx_site_plugins table in the DB.
As far as backing out, no one has yet tried this, but if UpgradeMODX will run, you can set the settings_version system setting back to 2.8.3-pl in the modx_system_settings table in the DB. Then you can «upgrade» to MODX 2.8.4 in UGM. You’ll have a bunch of extra MODX 3 files left over but the Manager may work again. I wouldn’t try this unless you’re planning to trash the site and go to a backup. In that case you have nothing to lose. If you do try it, let us know if it worked.