| 1 | = Инструкции по обновлению (для Trac 0.11) = |
| 2 | [[TracGuideToc]] |
| 3 | [[TranslatedPages(revision=0)]] |
| 4 | |
| 5 | [TracEnvironment окружение Trac] должно быть обновлено перед использованием с Trac 0.11. Этот документ описывает шаги необходимые для обновления окружения. |
| 6 | |
| 7 | Обновления окружения не обязательны для младших версий релизов, если обратное не оговорено отдельно. |
| 8 | |
| 9 | |
| 10 | == Инструкции == |
| 11 | |
| 12 | Обычно, обновление до новой версии Trac включает в себя четыре шага: |
| 13 | |
| 14 | === Обновление кода Trac === |
| 15 | |
| 16 | Получите новую версию так, как это описано в TracInstall, или специфичной для вашей операционной системы процедуре. |
| 17 | |
| 18 | Если вы делаете обновление вручную (не специфичное только для вашей операционной системы), вы можете потом удалить существующий код Trac путем удаления директории `trac` из директории `lib/site-packages` Python'а. |
| 19 | |
| 20 | Размещение директории site-packages зависит от операционной системы, и места, куда был установлен Python. Часто встречаются следующие расположения: |
| 21 | * Если вы используете Linux: /usr/lib/python2.X/site-packages |
| 22 | * Если вы используете Windows: C:\Python2.X\lib\site-packages |
| 23 | * Если вы используете MacOSX: /Library/Python2.X/site-packages |
| 24 | |
| 25 | Вы также можете захотеть удалить `cgi-bin`, `htdocs`, `templates` и `wiki-default` директории Trac, которые часто находятся в директории с названеим `share/trac` (точное расположение зависит от вашей платформы). |
| 26 | |
| 27 | > Если у вас был установлен плагин 'webadmin', вы можете удалить его, так как он теперь является частью базового кода Trac. |
| 28 | |
| 29 | |
| 30 | |
| 31 | === Обновление окружения Trac === |
| 32 | |
| 33 | После перезапуска Trac должен показать экземпляры которые нуждаются в ручном обновлении через автоматизированные скрипты обновления. Эти скрипты запускаются через [TracAdmin trac-admin]: |
| 34 | {{{ |
| 35 | trac-admin /path/to/projenv upgrade |
| 36 | }}} |
| 37 | |
| 38 | Эта команда ничего не сделает, если версия окружения уже обновлена. |
| 39 | |
| 40 | Обратите внимание, что если вы используете базу данных PostgreSQL, эта команда завершится ошибкой с сообщением о том, что резервная копия окружения может быть сделана только при использовании базы данных SQLite. Это значит, что вам придется сделать резервную копию репозитория и базы данных вручную. После, чтобы запустить собственно обновление, выполните: |
| 41 | {{{ |
| 42 | trac-admin /path/to/projenv upgrade --no-backup |
| 43 | }}} |
| 44 | |
| 45 | === Обновление документации Trac === |
| 46 | |
| 47 | Каждое [TracEnvironment окружение Trac] содержит документацию Trac для установленной версии. Так как вы, вероятно, хотите поддерживать встроенную документацию соответствующей установленной версии Trac, [TracAdmin trac-admin] предлагает команду для обновления документации: |
| 48 | {{{ |
| 49 | trac-admin /path/to/projenv wiki upgrade |
| 50 | }}} |
| 51 | |
| 52 | Заметьте, что эта процедура, конечно, оставит не затронутой вашу страницу `WikiStart`. |
| 53 | |
| 54 | === Макросы и Плагины Trac === |
| 55 | Макросы Trac должны быть обновлены, так как макросы wiki старого формата больше не поддерживаются (изза отказа от ClearSilver и HDF); они должны быть конвертированы в новый формат макросов, смотрите WikiMacros. |
| 56 | |
| 57 | |
| 58 | === Перезапуск Web сервера === |
| 59 | Если вы не используете [wiki:TracCgi CGI], перезагрузите новый код Trac путем перезапуска вашего web сервера. |
| 60 | |
| 61 | == Известные проблемы == |
| 62 | === родительская директория === |
| 63 | Если вы используете trac конфигурацию с 'parent env' и один из плагинов в одном из дочерних экземпляров не работает, ни один из дочерних экземпляров не будет работать. |
| 64 | === некоторые встроенные модули не загружаются === |
| 65 | Это изредко может случиться с Python 2.3 на Windows, когда обновление идет без предварительного удаления программы. |
| 66 | Некотрые модули были сначала в верхнем регистре, а сейчас переведены в нижний, к примеру trac/About.py стал trac/about.py. Вы можете обнаружить такие сообщения в логах Trac: |
| 67 | {{{ |
| 68 | ERROR: Skipping "trac.about = trac.about": (can't import "No module named about") |
| 69 | }}} |
| 70 | Удалите директорию `Lib/site-packages/trac` и переустановите программу. |
| 71 | |
| 72 | == Изменение формата базы данных == |
| 73 | == SQLite в PostgreSQL == |
| 74 | |
| 75 | Скрипт [http://trac-hacks.org/wiki/SqliteToPgScript sqlite2pg] на сайте [http://trac-hacks.org trac-hacks.org] был написан чтобы помочь в переходе с базы данных SQLite на PostgreSQL. |
| 76 | |
| 77 | == Более старые версии == |
| 78 | |
| 79 | Для обновления с предыдущих версий, обращайтесь к wiki:0.10/TracUpgrade. |
| 80 | |
| 81 | ----- |
| 82 | Смотрите также: TracGuide, TracInstall |