RusRedmineInstall » History » Revision 5
Revision 4 (Ruslan Khasanov, 2011-04-17 12:08) → Revision 5/18 (Andrey Polyakov, 2011-08-05 11:10)
[[RusGuide|Руководство]]->[[RusInstallation_guide|Руководство по установке]] Оригинал: [[RedmineInstall|Installing Redmine v.118]] h1. Установка Redmine {{>toc}} h2. Требования для версии 1.1.x: h3. Операционная система Redmine должен работать на * операционная система: Unix, Linux, [[RedmineInstallOSX|Mac]], [[RedmineInstallOSXServer|Mac Server]] and Windows поскольку Ruby доступен для этих платформ. Конкретные инструкции доступны здесь [[RusHowTos|тут]]. h3. Ruby & Ruby on Windows. Инструкции см. [[RusHowTos|тут]] * ruby 1.8.6, 1.8.7 * Rails & Rack 2.3.5 |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 | | * База данных: MySQL 5.0 or higher (recommended), PostgreSQL 8, SQLite 3 Официальный релиз включает соответствующую версию Rails в директории vendor. Поэтому обычно дополнительных действий не требуется. Если вы устанавливаете Redmine из хранилища, вы можете установить конкретную версию Rails на вашем компьютере выполнив: <pre> gem install rails -v=2.3.11 -v=2.3.5 </pre> Установка Rack: <pre> gem install rack -v=1.1.0 -v=1.0.1 </pre> h3. Примечания о совместимости: * *Ruby Примечания: Ruby 1.9 пока не поддерживается.* поддерживается. Вы должны использовать Ruby 1.8.x, как указано выше. * Требуется RubyGems 1.3.7 1.3.1 или выше со следующими ограничениями: ** *Rails (Rails 2.3.5 не будет работать с RubyGems 1.5.0 и выше*, более поздние, придерживайтесь предыдущих версий RubyGems RubyGems) ** *Rails 2.3.11 не будет работать с RubyGems 1.7.0 и выше*, придерживайтесь предыдущих версий RubyGems * *Требуется Rake 0.8.7* (Rails пока не поддерживает rake 0.9.x) 0.8.3 или выше * *Требуется Rack 1.1.x*, 1.1.0 содержит ошибку с кавычками(#8416). Миграция 1.0.1. Если у вас нет этой версии, перенос базы данных не будет работать с другими версиями. работать. * *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]] для получения информации о совместимости и требованиях. Смотри [[RusRedmineRepositories|Настройка репозиториев]]. * "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 в настоящее время новые версии Redmine выпускаются выпускает новую версию каждые 6 месяцев, и эти релизы считаются стабильными очень полезным и пригодными к использованияю. стабильным. Не рекомендуется устанавливать Redmine из trunc репозитария, пока если вы глубоко не изучите знакомы с Ruby On Rails и не сможете идти в ногу с изменениями - Rails, т.к. время от времени транк ломается. trunc-версия сбоит. h2. Установка # Получите исходный код Redmine, загрузив упакованный Redmine либо загрузки упакованных релиз или получив просмотреть код из хранилища. См. [[Download]]. [[Download]] # Создайте пустую базу данных и сопутствующих пользователя, например, пользователя с именем @redmine@. 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(реальное окружения, используемое для работы)" окружения. "производственной" среды. Пример для базы данных 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 pt-get install libopenssl-ruby1.8@ 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 только для тестирования. # Используйте учетную запись администратора по умолчанию, чтобы войти: * Логин: admin * Пароль: admin Теперь вы можете посетить раздел _Admin&Settings_(Администрирование) bq. Примечание: Webrick не подходит для изменения настроек приложения. нормальной эксплуатации, пожалуйста, используйте WEBrick только для тестирования. h2. Конфигурация логирования По умолчанию в Redmine уровень журналирования :info (информация). В зависимости от использования сайта, лог может сильно вырасти. Чтобы это избежать, необходимо его ротировать, либо с помощью системной утилиты Logrotate, либо через файл Config/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. Конфигурирование SMTP-сервера Скопировать config/email.yml.example в config/email.yml и отредактировать этот файл. См. пример [[Настройка почты]] Не забудьте перезапустить приложение после любого изменения. h2. Резервное копирование Копии 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>