RusRedmineInstall » History » Revision 7
Revision 6 (Andrey Polyakov, 2011-08-05 11:16) → Revision 7/18 (Andrey Polyakov, 2011-08-05 12:35)
[[RusGuide|Руководство]]->[[RusInstallation_guide|Руководство по установке]] Оригинал: [[RedmineInstall|Installing Redmine v.133]] v.118]] h1. Установка Redmine {{>toc}} h2. Требования h3. Операционная система Redmine должен работать на Unix, Linux, [[RedmineInstallOSX|Mac]], [[RedmineInstallOSXServer|Mac Server]] and Windows поскольку Ruby доступен для этих платформ. Конкретные инструкции доступны здесь [[RusHowTos|тут]]. h3. Ruby & Ruby on Rails & Rack |Redmine version|Supported Ruby versions |Required Rails version |Required Rack version | |текущий транк |/9.ruby 1.8.6,1.8.7|Rails 2.3.11 |Rack 1.1.1 | |транк с r2887 по r4903 |Rails 2.3.5 |Rack 1.0.1 | |транк с r2493 по r2286 |Rails 2.2.2 | | |транк до r2493 |Rails 2.1.2 | | |1.2.x |Rails 2.3.11 |Rack 1.1.1 | |1.1.x |/3. Rails 2.3.5|/3.Rack 1.0.1| |1.0.x | |0.9.x | |0.8.x |Rails 2.1.2 | | Официальный релиз включает соответствующую версию Rails в директории vendor. Поэтому обычно дополнительных действий не требуется. Если вы устанавливаете Redmine из хранилища, вы можете установить конкретную версию Rails на вашем компьютере выполнив: <pre> gem install rails -v=2.3.11 </pre> Установка Rack: <pre> gem install rack -v=1.1.0 </pre> h3. Примечания о совместимости: * *Ruby 1.9 пока не поддерживается.* Вы должны использовать Ruby 1.8.x, как указано выше. * Требуется RubyGems 1.3.7 или выше со следующими ограничениями: ** *Rails 2.3.5 не будет работать с RubyGems 1.5.0 и выше*, придерживайтесь предыдущих версий RubyGems ** *Rails 2.3.11 не будет работать с RubyGems 1.7.0 и выше*, придерживайтесь предыдущих версий RubyGems * *Требуется Rake 0.8.7* (Rails пока не поддерживает rake 0.9.x) * *Требуется Rack 1.1.x*, 1.1.0 содержит ошибку с кавычками(#8416). Миграция базы данных не будет работать с другими версиями. * *Mongrel 1.1.5 требует патча* прикреплённого к #7688 для нормальной работы с Rails 2.3.11. В случае обновления другие ошибки могут появляется после миграции (#7857). * I18n 0.4.2 требуется для Redmine >= 1.0.5 h3. База данных * MySQL 5.0 и выше (рекомендуется) ** установите C биндинги для Ruby, которые существенно улучшают производительность. Вы можете получить их запустив @gem install mysql@. Если у вас возникают проблемы с установкой mysql гема обратитесь к "Rails Wiki pages":http://wiki.rubyonrails.org/database-support/mysql * PostgresSQL ** убедитесь, что ваш стиль даты установлен в ISO (настройка по-умолчанию для Postgres). Вы можете установить ее используя: @ALTER DATABASE "redmine_db" SET datestyle="ISO,MDY";@ ** некоторые ошибки в PostgreSQL 8.4.0 и 8.4.1 вызывают ошибки в Redmine(#4259, #4314), они исправлены в PostgreSQL 8.4.2 ** установите PostgreSQL адаптер для Ruby. Вы можете получить его, запустив(выберите *один* вариант из списка): *** @gem install postgres-pr@ (нативная Ruby реализация больше активно не сопровождается автором, вызывает "ошибки":https://github.com/mneumann/postgres-pr/issues#issue/4 с 9.x) *** @gem install pg@ (работает с SSL подключениями, может требовать пакетов/библиотек разработчика для вашей ОС для компиляции) **** Ubuntu: библиотеки разработчика могут быть установлены с помощью: @sudo aptitude install libdbd-pg-ruby1.8@ * SQLite 3 h3. Опционально * Бинарники системы управления исходным кодом версиями (SCM) (например svn), для просмотра хранилища(должны быть доступны в PATH). Прочитайте[[RusRedmineRepositories|хранилища Redmine]] для получения информации о совместимости и требованиях. * "RMagick":http://rmagick.rubyforge.org (чтобы включить возможность экспорта диаграммы Ганта в png изображение) * "Ruby OpenID Library":http://openidenabled.com/ruby-openid/ (чтобы активировать поддержку OpenID) [только в Redmine trunk / 0.9-dev] Требуется версия 2 или выше. h2. Версии Redmine Большинству пользователей рекомендуется устанавливать последние версии релизов Redmine. В настроящее время новые версии Redmine выпускаются каждые 6 месяцев, эти релизы считаются стабильными и пригодными к использованияю. Не рекомендуется устанавливать Redmine из trunc репозитария, пока если вы глубоко не изучите Ruby On Rails и не сможете идти в ногу с изменениями - время от времени транк ломается. h2. Установка # Получите исходный код Redmine, загрузив упакованный релиз или получив код из хранилища. См. [[Download]]. # Создайте пустую базу данных и сопутствующих пользователя, например, с именем @redmine@. Для MySQL: <pre><code class="sql"> create database redmine character set utf8; create user 'redmine'@'localhost' identified by 'my_password'; grant all privileges on redmine.* to 'redmine'@'localhost'; </code></pre> Для версий MySQL до 5.0.2 вмести @create user@ используйте: <pre><code class="sql"> grant all privileges on redmine.* to 'redmine'@'localhost' identified by 'my_password'; </code></pre> Для PostgreSQL: <pre><code class="sql"> CREATE ROLE redmine LOGIN ENCRYPTED PASSWORD 'my_password' NOINHERIT VALID UNTIL 'infinity'; CREATE DATABASE redmine WITH ENCODING='UTF8' OWNER=redmine; </code></pre> # Скопировать config/database.yml.example в config/database.yml и отредактировать этот файл для того, чтобы настроить параметры базы данных для "production" окружения(реальное "production(реальное окружения, используемое для работы). работы)" окружения. Пример для базы данных MySQL: <pre> production: adapter: mysql database: redmine host: localhost username: redmine password: my_password </pre> Если ваш сервер не работает со стандартным портом (3306), используйте эту конфигурацию: <pre> production: adapter: mysql database: redmine host: localhost port: 3307 username: redmine password: my_password </pre> Пример для PostgreSQL (порт по-умолчанию): <pre> production: adapter: postgresql database: <your_database_name> host: <postgres_host> username: <postgres_user> password: <postgres_user_password> encoding: utf8 schema_search_path: <database_schema> (default - public) </pre> # Генерация ключа для безопасного хранения сессий <pre> rake generate_session_store </pre> # Создайте структуру базы данных, выполнив следующую команду в корневом каталоге приложения: <pre> RAILS_ENV=production rake db:migrate </pre> Это создаст таблицы и учетную запись администратора Если вы получите вот такую ошибку: <pre> Rake aborted! no such file to load -- net/https </pre> вам необходимо установить libopenssl-ruby1.8, в Ubuntu выполните: @apt-get install libopenssl-ruby1.8@ # Установите в базу данных конфигурацию по умолчанию, выполнив следующую команду: <pre> RAILS_ENV=production rake redmine:load_default_data </pre> Этот шаг является необязательным, *но строго рекомендуется к выполнению*, также вы можете создать свою собственныю конфигурацию с нуля. Будут загружены роли, трекеры, статусы, рабочие процессы и перечисления по-умолчанию # Настройка разрешений _Пользователи Windows могут пропустить этот шаг._ Пользователь, который запускает Redmine должны иметь разрешение на запись в следующие подкаталоги: files , log , tmp (создайте последний, если его нет). Предполагается, что вы запустили Redmine от пользователя redmine: <pre> mkdir tmp public/plugin_assets sudo chown -R redmine:redmine files log tmp public/plugin_assets sudo chmod -R 755 files log tmp public/plugin_assets </pre> # Протестируйте установку путем запуска веб-сервера WEBrick: <pre> ruby script/server webrick -e production </pre> После старта WEBrick, откройте в браузере http://localhost:3000/. Теперь вы должны увидеть страницу приветствия приложения. > Примечание: Webrick не подходит для нормальной эксплуатации, пожалуйста, используйте WEBrick только для тестирования установки. Не рекомендуется использовать webrick ни для чего кроме разработки. Используйте одно из многих руководств в этой вики для настройки passenger(также известного как mod_rails) или mongrel для обслуживания вашего redmine. тестирования. 9. Используйте учетную запись администратора по умолчанию, чтобы войти: * Логин: admin * Пароль: admin Теперь вы можете посетить раздел _Admin&Settings_(Администрирование) для изменения настроек приложения. h1. Настройка Начиная с версии "1.2.0":http://www.redmine.org/projects/redmine/versions/27, настройки Redmine определяются в файле config/configuration.yml. Если вам необходимо изменить настройки по-умолчанию, просто скопируйте config/configuration.yml.example в config/configuration.yml и отредактируйте новый файл. Этот файл хорошо прокоментирован, так что смотрите его. Эти настройки могут быть определены для каждого окружения Rails (production/development/test). +*Важно*+: Не забудте перезапустить приложение после любого изменения. h2. Email / SMTP-сервер Настройка email описана на [[RusEmailConfiguration|отдельной странице]]. h2. Настройки системы управления исходным кодом (SCM) Эта секция настроек позволяет вам: * изменить имена команд по-умолчанию, если бинарники SCM в PATH используют нестандартные имена (Windows .bat/.cmd не работают) * определить полный путь к бинарникам Пример(для Subversion): Переопределение имени команды: <pre> scm_subversion_command: "svn_replacement.exe" </pre>Абсолютный путь: <pre> scm_subversion_command: "C:\Program Files\Subversion\bin\svn.exe" </pre> h3. Настройка хранилища вложений(файлы которые загружаются в систему) Вы можете задать путь, где Redmine будет хранить вложения, который отличается от стандартного 'files', используя параметр @attachments_storage_path@. Примеры: <pre> attachments_storage_path: /var/redmine/files </pre><pre> attachments_storage_path: D:/redmine/files </pre> h1. Конфигурация логирования По-умолчанию По умолчанию в Redmine уровень журналирования :info (информация). В зависимости от использования сайта, лог может сильно вырасти. Чтобы это избежать, необходимо его ротировать, либо с помощью системной утилиты @logrotate@, Logrotate, либо через файл @сonfig/additional_environment.rb@. Config/additional_environment.rb. Для использования последнего, необходимо скопировать @config/additional_environment.rb.example@ config/additional_environment.rb.example в @config/additional_environment.rb@ config/additional_environment.rb и в нем добавить следующие строки. Отметим, что по умолчанию в файле установлен высокий уровнь журналирования, следовательно, должен быть явно установлен в информацию. <pre><code class="ruby"> #Logger.new(PATH,NUM_FILES_TO_ROTATE,FILE_SIZE) config.logger = Logger.new(config.log_path, 2, 1000000) config.logger.level = Logger::INFO </code></pre> h1. h2. Конфигурирование SMTP-сервера Скопировать config/email.yml.example в config/email.yml и отредактировать этот файл. См. пример [[Настройка почты]] Не забудьте перезапустить приложение после любого изменения. h2. Резервное копирование Резервная копия Копии Redmine должна должны включать: * данные (хранящиеся в базе данных Redmine) * вложения (хранится в директории files вашей установки Redmine, если не настроено иное местоположение этих файлов) Redmine) Вот простой скрипт, который может быть использован для создания ежедневных резервных копий (предположим (если вы используете базу данных MySQL): <pre> # База данных /usr/bin/mysqldump -u <username> -p<password> <redmine_database> | gzip > /path/to/backup/db/redmine_`date +%y_%m_%d`.gz # Вложения rsync -a /path/to/redmine/files /path/to/backup/files </pre> h1. Замечания по установке на Windows Получите и установите rubyinstaller с http://rubyforge.org/. Из меню "Пуск" выберите _Start Command Promt with Ruby_. В командной строке следуйте следующим инструкциям. Команды:<pre> RAILS_ENV=production rake db:migrate RAILS_ENV=production rake redmine:load_default_data </pre>измените на:<pre> set RAILS_ENV=production rake db:migrate rake redmine:load_default_data </pre>Вам может понадобиться установить gem mysql с помощью команды: <pre> gem install mysql </pre>В некоторых случаях необходимо скопировать libmysql.dll в вашу директорию ruby/bin. Не все libmysql.dll подходят, эта похоже работает http://instantrails.rubyforge.org/svn/trunk/InstantRails-win/InstantRails/mysql/bin/libmySQL.dll h1. Альтернатива ручной установки Некоторые пользователи предпочитают пропустить ручную установку и использовать один из "сторонних пакетов Redmine":http://www.redmine.org/projects/redmine/wiki/Download#Third-party-Redmine-bundles со страницы загрузки.