RusRedmineInstall » History » Revision 11
Revision 10 (Andrey Polyakov, 2011-08-05 12:43) → Revision 11/18 (Ruslan Khasanov, 2013-02-03 13:37)
[[RusGuide|Руководство]]->[[RusInstallation_guide|Руководство по установке]] Оригинал: [[RedmineInstall|Installing Redmine v.195]] v.133]] h1. Установка Redmine {{>toc}} Данная документацию по установке Redmine 1.4.0 и выше. Вы все еще можете прочитать документ для 1.3.x "здесь":/projects/redmine/wiki/RedmineInstall?version=146. h2. Требования h3. Операционная система Redmine должен работать на Unix, Linux, [[RedmineInstallOSX|Mac]], [[RedmineInstallOSXServer|Mac Server]] and Windows поскольку Ruby доступен для этих платформ. Конкретные инструкции доступны здесь [[HowTos|тут]]. [[RusHowTos|тут]]. h3. Ruby & Ruby on Rails & Rack |_=.версия Redmine|_=.Поддерживаемая версия Ruby |_=.Необходимая версия Rails |_=.Поддерживаемая |_=.Необходимая версия RubyGems Rack | |текущий trunk |ruby 1.8.7, 1.9.2, 1.9.3, jruby-1.6.7|Rails 3.2.11 |RubyGems <= 1.8| транк |/9.ruby 1.8.6,1.8.7|Rails 2.3.11 |Rack 1.1.1 | |2.2.1 |транк с r2887 по r4903 |Rails 2.3.5 |Rack 1.0.1 | |транк с r2493 по r2286 |Rails 2.2.2 | |ruby 1.8.7, 1.9.2, 1.9.3, jruby-1.6.7|Rails 3.2.11 |RubyGems <= 1.8| | |2.2.0 |транк до r2493 |Rails 2.1.2 | |ruby 1.8.7, 1.9.2, 1.9.3, jruby-1.6.7|Rails 3.2.9 |RubyGems <= 1.8| | |2.1.6 |ruby 1.8.7, 1.9.2, 1.9.3, jruby-1.6.7|Rails 3.2.11 |RubyGems <= 1.8| |1.2.x |Rails 2.3.11 |Rack 1.1.1 | |2.1.[0-5] |ruby 1.8.7, 1.9.2, 1.9.3, jruby-1.6.7|Rails 3.2.8 |RubyGems <= 1.8| |1.1.x |/3. Rails 2.3.5|/3.Rack 1.0.1| |2.0.[3-4] |ruby 1.8.7, 1.9.2, 1.9.3, jruby-1.6.7|Rails 3.2.6 |RubyGems <= 1.8| |1.0.x | |2.0.2 |0.9.x | |0.8.x |Rails 2.1.2 | |ruby 1.8.7, 1.9.2, 1.9.3, jruby-1.6.7|Rails 3.2.5 |RubyGems <= 1.8| | Официальный релиз включает соответствующую версию Rails в директории vendor. Поэтому обычно дополнительных действий не требуется. |2.0.[0-1] |ruby 1.8.7, 1.9.2, 1.9.3, jruby-1.6.7|Rails 3.2.3 |RubyGems <= 1.8| Если вы устанавливаете Redmine из хранилища, вы можете установить конкретную версию Rails на вашем компьютере выполнив: <pre> |1.4.6 |ruby 1.8.7, 1.9.2, 1.9.3, jruby-1.6.7|Rails 2.3.15 |RubyGems <= 1.8| gem install rails -v=2.3.11 |1.4.[0-5] |ruby 1.8.7, 1.9.2, 1.9.3, jruby-1.6.7|Rails 2.3.14 |RubyGems <= 1.8| </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 8.2 или выше ** убедитесь, что тип данных ваш стиль даты установлен в ISO (настройка по-умолчанию для Postgres). Вы можете установить ее используя: @ALTER DATABASE "redmine_db" SET datestyle="ISO,MDY";@ ** некоторые ошибки в PostgreSQL 8.4.0 и 8.4.1 вызывают ошибки в Redmine(#4259, #4314), они исправлены в PostgreSQL 8.4.2 * Microsoft SQL Server *<notextile>*новое*</notextile>* ** поддержка запланирована установите PostgreSQL адаптер для версии version#60 (но она уже доступна в trunk 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]] для получения информации о совместимости и требованиях. * "ImageMagick":http://www.imagemagick.org/ "RMagick":http://rmagick.rubyforge.org (чтобы включить возможность экспорта диаграммы Ганта в png изображение) * "Ruby OpenID Library":http://openidenabled.com/ruby-openid/ (чтобы активировать поддержку OpenID). OpenID) [только в Redmine trunk / 0.9-dev] Требуется версия 2 или выше. h2. Версии Redmine Большинству пользователей рекомендуется устанавливать последние версии релизов Redmine. В настроящее время новые версии Redmine выпускаются каждые 6 месяцев, эти релизы считаются стабильными и пригодными к использованияю. Не рекомендуется устанавливать Redmine из trunc репозитария, пока если вы глубоко не изучите Ruby On Rails и не сможете идти в ногу с изменениями - время от времени транк ломается. h2. Установка h3. Шаг 1 - Redmine application # Получите исходный код Redmine, загрузив архив релиза упакованный релиз или получив код из хранилища. См. [[Download]]. h3. Шаг 2 - Установка зависимостей Redmine использует "Bundler":http://gembundler.com/ для управления зависимостями gems пакетов. Вам необходимо вначале установить Bundler: gem install bundler Затем вы можете установить все зависимости требующиеся Redmine с помощью следующей команды: bundle install --without development test h4. не обязательные зависимости h5. RMagick (позволяет использовать ImageMagick для работы с изображениями в при экспорте в PDF и PNG) Если ImageMagick не установлен в вашей системе, вы должны пропустить установку gem-пакета rmagick используя команду: @bundle install --without development test rmagick@ Если у вас проблемы с установкой @rmagick@ на Windows, посмотрите [[HowTo_install_rmagick_gem_on_Windows|это HowTo]]. h5. Неиспользуемые адаптеры баз данных Вы также можете пропустить установку адаптеров баз данных, которые вы не используете. Например, если вы используете MySQL, вы можете пропустить установку пакетов PostgreSQL, SQLite с помощью команды: @bundle install --without development test postgresql sqlite@ h4. Дополнительные зависимости (@Gemfile.local@) Если вам нужно загрузить gem-пакеты, которые не требуются для ядра Redmine (например, Puma, FCGI), создайте файл @Gemfile.local@ в корневом каталог Redmine. Данный файл будет автоматически загружаться при запуске @bundle install@. Например: <pre> # Gemfile.local gem 'puma' </pre> h3. Создайте пустую базу данных и сопутствующего пользователя Здесь для примера база данных и пользователь базы будет назван @redmine@, но вы его можете заменить на что-нибудь ещё. h4. MySQL <pre> сопутствующих пользователя, например, с именем @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'; </pre> </code></pre> Для версий MySQL до 5.0.2 вместо шага вмести @create user@ используйте: <pre> <pre><code class="sql"> grant all privileges on redmine.* to 'redmine'@'localhost' identified by 'my_password'; </pre> h4. PostgreSQL <pre> </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; </pre> h3. Шаг 4 - Настройка подключения к базе данных Скопируйте файл </code></pre> # Скопировать config/database.yml.example в config/database.yml и отредактируйте отредактировать этот файл так, для того, чтобы настроить параметры базы данных для "production" окружения(реальное окружения, используемое для работы). Пример для базы данных MySQL, использующей ruby1.8 или jruby: MySQL: <pre> production: adapter: mysql database: redmine host: localhost username: redmine password: my_password </pre> Пример для базы данных MySQL, использующей ruby1.9 (адаптер должен быть установлен в @mysql2@): <pre> production: adapter: mysql2 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> h3. Шаг 5 - # Генерация ключа для безопасного хранения сессий Этот шаг генерирует случайный ключ, используемый Rails для шифрования хранилища, содержащего данные сессий, тем самым предотвращая их фальсификацию. Генерация нового ключа сделает недействительными все существующие сеансы после перезагрузки. * для Redmine 1.4.x: <pre> rake generate_session_store </pre> * для Redmine 2.x: <pre> rake generate_secret_token </pre> h3. Шаг 6 - Создание структуры базы данных # Создайте структуру базы данных, выполнив следующую команду в корневом каталоге приложения: <pre> RAILS_ENV=production rake db:migrate </pre> в Windows: <pre> set RAILS_ENV=production rake db:migrate </pre> Это создаст таблицы и учетную запись администратора с именем @admin@. +проблемы в Ubuntu:+ Если вы получите вот такую ошибку: <pre> Rake aborted! no such file to load -- net/https </pre> вам необходимо установить @libopenssl-ruby1.8@, libopenssl-ruby1.8, в Ubuntu выполните: @apt-get install libopenssl-ruby1.8@ h3. Шаг 7 - Загрузка данных по умолчанию # Установите в базу данных конфигурацию по умолчанию, выполнив следующую команду: <pre> RAILS_ENV=production rake redmine:load_default_data </pre> Redmine запросит у вас язык набора данных, которые должны быть загружен. Вы можете также перед запуском команды установить в переменную окружения @REDMINE_LANG@ значение, которое будет автоматически использовано в процессе загрузки. Например: в Unix-подобных: <pre> RAILS_ENV=production REDMINE_LANG=fr rake redmine:load_default_data </pre> в Windows: <pre> set RAILS_ENV=production Этот шаг является необязательным, *но строго рекомендуется к выполнению*, также вы можете создать свою собственныю конфигурацию с нуля. Будут загружены роли, трекеры, статусы, рабочие процессы и перечисления по-умолчанию set REDMINE_LANG=fr rake redmine:load_default_data </pre> h3. Шаг 8 - # Настройка разрешений _Пользователи Windows могут пропустить этот шаг._ Пользователь, который запускает Redmine должны иметь разрешение на запись в следующие подкаталоги: # @files@ (хранит вложения) files , log , tmp (создайте последний, если его нет). # @log@ (логи приложения @production.log@) # @tmp@ and @tmp/pdf@ (создайте, если их нет. Используется для создания PDF документов). Предполагается, что вы запустили Redmine от пользователя redmine: <pre> mkdir tmp tmp/pdf 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> h3. Шаг 9 - Тестирование установки # Протестируйте установку путем запуска веб-сервера WEBrick: * для Redmine 1.4.x: <pre> ruby script/server webrick -e production </pre> * для Redmine 2.x: <pre> ruby script/rails server webrick -e production </pre> После старта WEBrick, откройте в браузере http://localhost:3000/. Теперь вы должны увидеть страницу приветствия приложения. > Примечание: Webrick не подходит для нормальной эксплуатации, пожалуйста, используйте WEBrick только для тестирования установки. Не рекомендуется использовать webrick ни для чего кроме разработки. Используйте одно из многих руководств в этой вики для настройки Passenger(также passenger(также известного как @mod_rails@), FCGI mod_rails) или Rack сервер (Unicorn, Thin, Puma, hellip;) mongrel для обслуживания вашего redmine. h3. Step 10 - Вход в приложение 9. Используйте учетную запись администратора по умолчанию, чтобы войти: * Логин: admin * Пароль: admin Теперь вы можете посетить раздел ??Administration?? (Администрирование) _Admin&Settings_(Администрирование) для изменения настроек приложения. h2. h1. Настройка Настройки Начиная с версии "1.2.0":http://www.redmine.org/projects/redmine/versions/27, настройки Redmine определяются в файле @config/configuration.yml@. config/configuration.yml. Если вам необходимо изменить настройки по-умолчанию, просто скопируйте @config/configuration.yml.example@ config/configuration.yml.example в @config/configuration.yml@ config/configuration.yml и отредактируйте новый файл. Этот файл хорошо прокомментирован, прокоментирован, так что смотрите его. Эти настройки могут быть определены для каждого окружения Rails (@production@/@development@/@test@). +Важно+: (production/development/test). +*Важно*+: Не забудьте забудте перезапустить приложение после любого изменения. h3. Настройка h2. Email / SMTP-серверов SMTP-сервер Настройка email описана на [[RusEmailConfiguration|отдельной странице]]. h2. Настройки SCM(система управления исходным кодом) Эта секция настроек позволяет вам: * изменить имена команд по-умолчанию, если бинарники SCM в @PATH@ PATH используют нестандартные имена (Windows .bat/.cmd не работают) * определить полный путь к бинарникам Пример(для Subversion): Переопределение имени команды: <pre> scm_subversion_command: "svn_replacement.exe" </pre> Абсолютный </pre>Абсолютный путь: <pre> scm_subversion_command: "C:\Program Files\Subversion\bin\svn.exe" </pre> h3. h2. Настройка хранилища вложений Вы можете задать путь, где Redmine будет хранить вложения, который отличается от стандартного 'files', используя параметр @attachments_storage_path@. Примеры: <pre> attachments_storage_path: /var/redmine/files </pre> <pre> </pre><pre> attachments_storage_path: D:/redmine/files </pre> h2. Настройка Конфигурация логирования По-умолчанию в Redmine уровень журналирования :info (информация). В зависимости от использования сайта, лог может сильно вырасти. Чтобы это избежать, необходимо его ротировать, либо с помощью системной утилиты @logrotate@, либо через файл @сonfig/additional_environment.rb@. Для использования последнего, необходимо скопировать @config/additional_environment.rb.example@ в @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> h2. h1. Резервное копирование Резервная копия Redmine должна включать: * данные (хранящиеся в базе данных Redmine) * вложения (хранится в директории files вашей установки 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> h2. h1. Замечания по установке на Windows Существует готовый инсталлятор Ruby MRI, который можно получить http://rubyinstaller.org. После его установки, Получите и установите rubyinstaller с http://rubyforge.org/. Из меню "Пуск" выберите _Start Command Prompt Promt with Ruby_ в меню Пуск. Ruby_. +Установите переменную окружения @RAILS_ENV@:+ При выполнении команд, описанных в данном руководстве, вы должны установить переменной окружения @RAILS_ENV@ с помощью отдельной команды. Например команды со В командной строке следуйте следующим синтаксисом: инструкциям. <pre>RAILS_ENV=production <any commmand></pre> <pre><any commmand> RAILS_ENV=production</pre> должны быть превращены в 2-е последовательные команды: <pre>set Команды:<pre> RAILS_ENV=production <any commmand></pre> +Проблемы при установке gem-пакета MySQL:+ Вам 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> В </pre>В некоторых случаях необходимо скопировать _libmysql.dll_ libmysql.dll в вашу директорию ruby/bin. Не все libmysql.dll подходят, эта похоже работает http://instantrails.rubyforge.org/svn/trunk/InstantRails-win/InstantRails/mysql/bin/libmySQL.dll *Важное замечание для Win7 и последующих* В Win7 и последующих, запись @localhost@ закомментирована в host-файле[1], а IPV6 является записью по умолчанию[2]. Так как gem-пакет mysql2 не поддерживает адресацию IPV6[3], то соединение с базой данных не может быть установлено и вы получаете ошибку "@Can't connect to MySQL server on 'localhost' (10061)@". Вы можете проверить это пропинговав @localhost@, если будет пинговаться "::1:", значит используется адресация IPV6. +Решение:+ В файле database.yml заменить @localhost@ на @127.0.0.1@. fn1. http://serverfault.com/questions/4689/windows-7-localhost-name-resolution-is-handled-within-dns-itself-why fn2. http://www.victor-ratajczyk.com/post/2012/02/25/mysql-fails-to-resolve-localhost-disable-ipv6-on-windows.aspx fn3. https://github.com/brianmario/mysql2/issues/279 h2. h1. Альтернатива ручной установке Некоторые пользователи предпочитают пропустить ручную установку и использовать один из [[Download#Third-party-Redmine-bundles|сторонних "сторонних пакетов Redmine]] Redmine":http://www.redmine.org/projects/redmine/wiki/Download#Third-party-Redmine-bundles со страницы загрузки.