Работа с плагинами REDMINE

By | 11.10.2012

Всем добрый день! В данном посте я расскажу как устанавливать дополнительные плагины в Redmine. Идея с плагинами достаточна интересна, так как позволяет расширить рабочий функционал redmine, но к сожалению работоспособность плагинов на данном этапе вызывает некоторую обеспокоенность: не все плагины ставятся красиво, для многих необходимы дополнительные танцы с бубном. Если же вы все-таки решили установить понравившийся вам плагин, то перед установкой хотелось бы дать некоторые рекомендации, чтобы в последствии не пришлось ломать руки от того, что все криво работает.

Предварительные рекомендации:

  1. Проверьте, чтобы версия вашего плагина была совместима с вашей версией Redmine
  2. Почитайте в интернете, что люди пишут об этом плагине и его работе: различные специализированные форумы, блоги и т. п.
  3. Перед установкой плагина сделайте полный бэкап базы (как это сделать, читайте в статье Красивый перенос Redmine)
  4. Установите плагин точно согласно приведенной ниже инструкции.
  5. Если в процессе установки появляются ошибки, внимательно читаем их описание в командной строке, в 90% там будет ваш ответ
  6. Проверьте, все ли запустились службы после перезапуска (особое внимание уделить Thin_redmine)
  7. Проверьте работоспособность плагина в системе (бывает, что стал хорошо, а не работает или работает криво)
  8. Если не понравился или не работает — удаляйте (также согласно приведенной ниже инструкции).

Ну а теперь непосредственно сама инструкция по работе с плагинами.

Установка плагинов

1. Скопируйте распакованный плагин в каталог

  • для Redmine 1.x: #{RAILS_ROOT}/vendor/plugins (по умолчанию c:\Program Files\BitNami Redmine Stack\apps\redmine\vendor\plugins)
  • для Redmine 2.x: #{RAILS_ROOT}/plugins (по умолчанию c:\Program Files\BitNami Redmine Stack\apps\redmine\htdocs\plugins)

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

git clone git://github.com/user_name/name_of_the_plugin.git

2. Если плагин требует миграции, выполните следующую команду, чтобы обновить базу данных (сделать резервную копию БД перед миграцией ОБЯЗАТЕЛЬНО!!!).

  • для Redmine 1.x: rake db:migrate_plugins RAILS_ENV=production
  • для Redmine 2.x: rake redmine:plugins:migrate RAILS_ENV=production

3. Перезагрузите Redmine.

Теперь вы в состоянии видеть список плагинов в Администрирование -> Модули и настроить только что установленный плагин (если плагин требует, чтобы он быть сконфигурирован).

Удаление плагина

1. Если плагин требует миграции, выполните следующую команду, чтобы очистить вашу базу данных (сделать резервную копию БД перед миграцией ОБЯЗАТЕЛЬНО!!!):

  • для Redmine 1.x : rake db:migrate:plugin NAME=plugin_name VERSION=0 RAILS_ENV=production
  • для Redmine 2.x: rake redmine:plugins:migrate NAME=plugin_name VERSION=0 RAILS_ENV=production

2. Удалите плагин из папки плагинов:

  • для Redmine 1.x : #{RAILS_ROOT}/vendor/plugins
  • для Redmine 2.x: #{RAILS_ROOT}/plugins

3. Перезагрузите Redmine.

Если есть вопросы, пишите — будем разбираться. Удачи!

Если вы нашли ошибку, пожалуйста, выделите фрагмент текста и нажмите Ctrl+Enter.

7 thoughts on “Работа с плагинами REDMINE

  1. Антон

    Доброго дня. Мне необходимо обновить три плагина в Redmine 2.4.1.-stable
    Установить это вроде понятно. Как именно обновить? Заранее спасибо.

    Reply
    1. Николай Post author

      День добрый, Антон. Жаль, что не написали какие именно плагины Вы хотите обновить. Поэтому опишу общую процедуру обновления, которой пользуюсь непосредственно сам.
      Есть несколько вариантов решения:
      1. Удаляем (а лучше копируем в другое место в случае необходимости восстановления старой версии) папку со старым плагином, записываем на его место новый. После этого обязательно перезапускаем все службы. После перезапуска смотрим, чтобы все службы запустились нормально. в 70% случаев этого достаточно.
      2. Если некоторые службы не запустились (или Redmine выдает ошибку), то необходимо пройти процедуру установки плагина, как будто Вы устанавливаете плагин по-новому.
      Еще бывает, что данный плагин не поддерживает новую версию Redmine или ему нужны дополнительные модули или их новые версии. Тут уж нужно пробовать и смотреть, что получится. Удачи!!!

      Reply
  2. Антон

    О! Спасибо за ответ!
    вот эти плагинчики надо обновить
    redmine_finance-1_0_8-pro
    redmine_contacts-3_2_13-pro
    redmine_contacts_invoices-3_1_0-pro

    по поводу служб, можно подробнее?
    /etc/init.d/redmine restart будет достаточно?

    Debian
    Release: 7.4
    Codename: wheezy

    Reply
    1. Николай Post author

      Я Redmine кручу на Windows, но в принципе должно и у Вас работать моя схема. Ставил у себя redmine_contacts. При обновлении данного плагина работает только пункт 2. Насчет служб смотрите в сторону thin_redmine и thin_redmine2

      Reply
  3. Андрей

    А как на счет редмайн 3.x? как с него снести плагин?

    Reply
    1. Николай Post author

      Какой плагин у вас не получается деинсталлировать? Какие действия Вы совершали и какие ошибки получили? Ваш вопрос не несет конкретной информации. Деинсталляция плагинов в версии 3.х , имхо, не изменилась, например, с версии 2.х. Или просто удаляем папку и перезапускаем сервисы, или выполняем типа:
      rake redmine:plugins:migrate NAME=name_your_plugin VERSION=0 RAILS_ENV=production

      Reply
  4. Andrey D.

    Николай, есть вопрос: какой плагин Redmine глючит?
    Список самих плагинов:
    1. Application Space plugin
    2. Timesheets Application
    3. Bootstrap Kit plugin
    4. Default Custom Query
    5. Git Hosting Plugin
    6. Helpdesk plugin
    7. Mylyn Connector plugin
    8. Startpage plugin
    9. Scrum Redmine plugin
    Приложение выдаёт ошибку «internal error»
    Работает только переход по прямой ссылке. Сеть и браузер — неважно. Т.е. по линку в проекте перейти на объект (задачу) не даёт у некоторых пользователей, кто не админ в Redmine. У админов такая проблема не наблюдается.
    Как лечить? Куда смотреть?
    В файле «production.log» инфо много, но локализовать проблему пока не удалось.
    Прошу вашей помощи.

    Redmine поднят на Debian 6.0.10
    Environment:
    Redmine version 2.6.3.stable
    Ruby version 1.9.3-p551 (2014-11-13) [x86_64-linux]
    Rails version 3.2.21
    Environment production
    Database adapter PostgreSQL
    SCM:
    Subversion 1.6.12
    Mercurial 1.6.4
    Bazaar 2.1.2
    Git 1.7.2.5
    Filesystem
    Xitolite 1.7.2.5
    Redmine plugins:
    redmine_app__space 1.0.3
    redmine_app_timesheets 1.5.3
    redmine_bootstrap_kit 0.2.2
    redmine_default_custom_query 1.1.0
    redmine_git_hosting 1.0.1
    redmine_helpdesk 0.0.15
    redmine_mylyn_connector 2.8.2.stable
    redmine_startpage 0.1.0
    scrum 0.9.1

    Reply

Добавить комментарий

Ваш e-mail не будет опубликован. Обязательные поля помечены *

Лимит времени истёк. Пожалуйста, перезагрузите CAPTCHA.