Данная заметка будет дополняться по мере возникновения таковых и будет содержать особенности, которые мало где описаны и не всегда очевидны.
Отключения плагинов при загрузке
Часто при обновлении, продукты atlassian’a не запускаются с руганью на какой-то из плагинов. Иногда ругань явная, иногда – нет. Плагины можно отключить 2-мя способами: задать опции при старте или принудительно через запрос в базу. Мы рассмотрим только первый вариант, так как он наиболее гибкий и носит временный характер.
- через опции к стартовому скрипту:
./start-confluence.sh --disable-all-addons ./start-confluence.sh --disable-addons=com.atlassian.test.plugin
- через файл setenv.sh
комментируем строку
CATALINA_OPTS="${START_CONFLUENCE_JAVA_OPTS} ${CATALINA_OPTS}"
добавляем такую
CATALINA_OPTS="-Datlassian.plugins.startup.options='--disable-all-addons' ${CATALINA_OPTS}"
Если нужно отключить несколько плагинов, нужно использовать разделитель двоеточие (“:”), regex/wildcard не работают
-Datlassian.plugins.startup.options="--disable-addons=com.atlassian.test.plugin:com.atlassian.another.test.plugin"
Работа через proxy (на примере nginx’a).
В логах будет видно предупреждение:
You may be ubing a proxy server that prevents WebSocket connections
или ошибки:
Could not ping the synchrony-proxy [http://127.0.0.1:8090/sync
hrony-proxy/healthcheck]: The target server failed to respond
Something went wrong after loading the editor.
Решение – добавить в nginx такой location:
location /synchrony { proxy_set_header X-Forwarded-Host $host; proxy_set_header X-Forwarded-Server $host; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_pass http://127.0.0.1:8091/synchrony; proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection "Upgrade"; }
Принудительное обновление схемы
Если upgrade с первого раза не прошёл успешно, и обновилась только часть данных в базе, то часто бывает, что сам update’r не в состоянии сделать или rollback или дообновить то, что ещё не обновил. На помощь приходит параметр
-Datlassian.forceSchemaUpdate=true
Нехватка прав в базу
Если видите ошибку
You do not have the SUPER privilege
то не спешите давать SUPER права, достаточно выставить параметр log_bin_trust_function_creators=1 (изменения возможны налету, при условии, что включён binlog, иначе нужен будет restart mysql’я)
Downgrade
Сообщения в логеCaesium-1-2 INFO [c.a.j.upgrade.util.BuildNumberDao] Setting current version to 8.13.11
Caesium-1-2 INFO [c.a.j.upgrade.util.BuildNumberDao] Setting downgrade version to 7.1.2
Означают, что текущая версия 8.13.11, а откатится мы можем вплоть до 7.1.2. Что бы откатиться, нужно выставить параметр -Djira.downgrade.allowed=true в setenv.sh и перезапустить jir’y
Something went wrong after loading the editor. Copy your unsaved changes and refresh the page to keep editing.
Скорее всего у вас включён в confluence режим “коллаборации”, то есть совместного редактирования. Тут вам выбирать: либо отказаться от совместного редактирования, либо получать такие сообщения об ошибке. Отключается так: Settings -> General configuration -> Collaborative editing.
Mysql
Даже тогда, когда уже давно существует версия 8.0, продукты atlassian’a не поддерживают её практически (хотя на сайте заявлена полная совместимость с mysql 8.0). Всему виной database charset, а точнее отсутствие чистого utf8 в mysql 8.0. Вместо него предлагается uft8mb4, который не поддерживается, как минимум в последних LTS-версиях bitbucket. Если быть точнее, то нельзя будет сделать backup/restore через bitbucket-backup-client. Даже, если вы попробуете использовать mysql-connect-java-driver версии 8.х всё равно будет ругань на неизвестный charset.