Project

General

Profile

RusRedmineInstall » History » Revision 6

Revision 5 (Andrey Polyakov, 2011-08-05 11:10) → Revision 6/18 (Andrey Polyakov, 2011-08-05 11:16)

[[RusGuide|Руководство]]->[[RusInstallation_guide|Руководство по установке]] 

 Оригинал: [[RedmineInstall|Installing Redmine 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(реальное окружения, используемое для работы)" окружения. 
 Пример для базы данных 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 только для тестирования. 

 9. 
 # Используйте учетную запись администратора по умолчанию, чтобы войти: 
 * Логин: admin 
 * Пароль: admin 
 Теперь вы можете посетить раздел _Admin&Settings_(Администрирование) для изменения настроек приложения. 

 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>