Project

General

Profile

RusRedmineInstall » History » Version 9

Andrey Polyakov, 2011-08-05 12:40

1 2 Ruslan Khasanov
[[RusGuide|Руководство]]->[[RusInstallation_guide|Руководство по установке]]
2
3 7 Andrey Polyakov
Оригинал: [[RedmineInstall|Installing Redmine v.133]]
4 4 Ruslan Khasanov
5 5 Andrey Polyakov
h1. Установка Redmine
6 1 Ruslan Khasanov
7
{{>toc}}
8
9 5 Andrey Polyakov
h2. Требования
10 1 Ruslan Khasanov
11 5 Andrey Polyakov
h3. Операционная система
12 1 Ruslan Khasanov
13 5 Andrey Polyakov
Redmine должен работать на Unix, Linux, [[RedmineInstallOSX|Mac]], [[RedmineInstallOSXServer|Mac Server]] and Windows поскольку Ruby доступен для этих платформ. Конкретные инструкции доступны здесь [[RusHowTos|тут]].
14
15
h3. Ruby & Ruby on Rails & Rack
16 9 Andrey Polyakov
17
|_=.версия Redmine|_=.Поддерживаемая 
18
                    версия Ruby     |_=.Необходимая
19
                                     версия Rails  |_=.Необходимая
20
                                                     версия Rack |
21 5 Andrey Polyakov
|текущий
22
 транк          |/9.ruby 1.8.6,1.8.7|Rails 2.3.11   |Rack 1.1.1   |
23
|транк с
24
 r2887 по r4903                     |Rails 2.3.5    |Rack 1.0.1   |  
25
|транк с
26
 r2493 по r2286                     |Rails 2.2.2    |             |
27
|транк до r2493                     |Rails 2.1.2    |             |
28
|1.2.x                              |Rails 2.3.11   |Rack 1.1.1   |
29
|1.1.x                              |/3. Rails 2.3.5|/3.Rack 1.0.1|
30
|1.0.x                              |
31
|0.9.x                              |
32
|0.8.x                              |Rails 2.1.2    |             |
33
34
35 1 Ruslan Khasanov
Официальный релиз включает соответствующую версию Rails в директории vendor. Поэтому обычно дополнительных действий не требуется.
36
Если вы устанавливаете Redmine из хранилища, вы можете установить конкретную версию Rails на вашем компьютере выполнив:
37
38
<pre>
39 5 Andrey Polyakov
gem install rails -v=2.3.11
40 1 Ruslan Khasanov
</pre>
41
42
Установка Rack:
43
44
<pre>
45 5 Andrey Polyakov
gem install rack -v=1.1.0
46 1 Ruslan Khasanov
</pre>
47
48 5 Andrey Polyakov
h3. Примечания о совместимости:
49 1 Ruslan Khasanov
50 5 Andrey Polyakov
* *Ruby 1.9 пока не поддерживается.* Вы должны использовать Ruby 1.8.x, как указано выше.
51
* Требуется RubyGems 1.3.7 или выше со следующими ограничениями:
52
** *Rails 2.3.5 не будет работать с RubyGems 1.5.0 и выше*, придерживайтесь предыдущих версий RubyGems
53
** *Rails 2.3.11 не будет работать с RubyGems 1.7.0 и выше*, придерживайтесь предыдущих версий RubyGems
54
* *Требуется Rake 0.8.7* (Rails пока не поддерживает rake 0.9.x)
55
* *Требуется Rack 1.1.x*, 1.1.0 содержит ошибку с кавычками(#8416). Миграция базы данных не будет работать с другими версиями.
56
* *Mongrel 1.1.5 требует патча* прикреплённого к #7688 для нормальной работы с Rails 2.3.11. В случае обновления другие ошибки могут появляется после миграции (#7857).
57
* I18n 0.4.2 требуется для Redmine >= 1.0.5
58
59
h3. База данных
60
61
* MySQL 5.0 и выше (рекомендуется)
62
** установите C биндинги для Ruby, которые существенно улучшают производительность. Вы можете получить их запустив @gem install mysql@. Если у вас возникают проблемы с установкой mysql гема обратитесь к "Rails Wiki pages":http://wiki.rubyonrails.org/database-support/mysql
63
64
* PostgresSQL
65
** убедитесь, что ваш стиль даты установлен в ISO (настройка по-умолчанию для Postgres). Вы можете установить ее используя: @ALTER DATABASE "redmine_db" SET datestyle="ISO,MDY";@
66
** некоторые ошибки в PostgreSQL 8.4.0 и 8.4.1 вызывают ошибки в Redmine(#4259, #4314), они исправлены в PostgreSQL 8.4.2
67
** установите PostgreSQL адаптер для Ruby. Вы можете получить его, запустив(выберите *один* вариант из списка):
68
*** @gem install postgres-pr@ (нативная Ruby реализация больше активно не сопровождается автором, вызывает "ошибки":https://github.com/mneumann/postgres-pr/issues#issue/4 с 9.x)
69
*** @gem install pg@ (работает с SSL подключениями, может требовать пакетов/библиотек разработчика для вашей ОС для компиляции)
70
**** Ubuntu: библиотеки разработчика могут быть установлены с помощью: @sudo aptitude install libdbd-pg-ruby1.8@
71
* SQLite 3
72
73 1 Ruslan Khasanov
h3. Опционально
74
75 7 Andrey Polyakov
* Бинарники системы управления исходным кодом (SCM) (например svn), для просмотра хранилища(должны быть доступны в PATH). Прочитайте[[RusRedmineRepositories|хранилища Redmine]] для получения информации о совместимости и требованиях.
76 1 Ruslan Khasanov
* "RMagick":http://rmagick.rubyforge.org (чтобы включить возможность экспорта диаграммы Ганта в png изображение)
77
* "Ruby OpenID Library":http://openidenabled.com/ruby-openid/ (чтобы активировать поддержку OpenID) [только в Redmine trunk / 0.9-dev] Требуется версия 2 или выше.
78
79
h2. Версии Redmine
80
81 5 Andrey Polyakov
Большинству пользователей рекомендуется устанавливать последние версии релизов Redmine. В настроящее время новые версии Redmine выпускаются каждые 6 месяцев, эти релизы считаются стабильными и пригодными к использованияю. Не рекомендуется устанавливать Redmine из trunc репозитария, пока если вы глубоко не изучите Ruby On Rails и не сможете идти в ногу с изменениями - время от времени транк ломается.
82 1 Ruslan Khasanov
83
h2. Установка
84
85 5 Andrey Polyakov
# Получите исходный код Redmine, загрузив упакованный релиз или получив код из хранилища. См. [[Download]].
86
# Создайте пустую базу данных и сопутствующих пользователя, например, с именем @redmine@.
87 1 Ruslan Khasanov
Для MySQL:
88
<pre><code class="sql">
89
create database redmine character set utf8; 
90
create user 'redmine'@'localhost' identified by 'my_password'; 
91 3 Ruslan Khasanov
grant all privileges on redmine.* to 'redmine'@'localhost';
92 1 Ruslan Khasanov
</code></pre>
93 5 Andrey Polyakov
Для версий MySQL до 5.0.2 вмести @create user@ используйте:
94
<pre><code class="sql">
95
grant all privileges on redmine.* to 'redmine'@'localhost' identified by 'my_password';
96
</code></pre>
97
Для PostgreSQL:
98
<pre><code class="sql">
99
CREATE ROLE redmine LOGIN ENCRYPTED PASSWORD 'my_password' NOINHERIT VALID UNTIL 'infinity';
100
CREATE DATABASE redmine WITH ENCODING='UTF8' OWNER=redmine;
101
</code></pre>
102 7 Andrey Polyakov
# Скопировать config/database.yml.example в config/database.yml и отредактировать этот файл для того, чтобы настроить параметры базы данных для "production" окружения(реальное окружения, используемое для работы).
103 1 Ruslan Khasanov
Пример для базы данных MySQL:
104
<pre>
105
production: 
106 5 Andrey Polyakov
 adapter: mysql 
107
 database: redmine 
108
 host: localhost 
109
 username: redmine 
110
 password: my_password
111 1 Ruslan Khasanov
</pre>
112
Если ваш сервер не работает со стандартным портом (3306), используйте эту конфигурацию:
113
<pre>
114
production: 
115 5 Andrey Polyakov
  adapter: mysql 
116
  database: redmine 
117
  host: localhost 
118
  port: 3307
119
  username: redmine 
120
  password: my_password
121 1 Ruslan Khasanov
</pre>
122 5 Andrey Polyakov
Пример для PostgreSQL (порт по-умолчанию):
123 1 Ruslan Khasanov
<pre>
124 5 Andrey Polyakov
production:
125
  adapter: postgresql
126
  database: <your_database_name>
127
  host: <postgres_host>
128
  username: <postgres_user>
129
  password: <postgres_user_password>
130
  encoding: utf8
131
  schema_search_path: <database_schema> (default - public)
132
</pre>
133
# Генерация ключа для безопасного хранения сессий
134
<pre>
135 1 Ruslan Khasanov
rake generate_session_store
136
</pre>
137 4 Ruslan Khasanov
# Создайте структуру базы данных, выполнив следующую команду в корневом каталоге приложения:
138
<pre>
139
RAILS_ENV=production rake db:migrate
140
</pre>
141
Это создаст таблицы и учетную запись администратора
142
Если вы получите вот такую ошибку:
143 1 Ruslan Khasanov
<pre>
144
Rake aborted!
145
no such file to load -- net/https
146
</pre>
147 5 Andrey Polyakov
вам необходимо установить libopenssl-ruby1.8, в Ubuntu выполните: @apt-get install libopenssl-ruby1.8@
148 1 Ruslan Khasanov
# Установите в базу данных конфигурацию по умолчанию, выполнив следующую команду:
149 4 Ruslan Khasanov
<pre>
150 1 Ruslan Khasanov
RAILS_ENV=production rake redmine:load_default_data
151
</pre>
152 5 Andrey Polyakov
Этот шаг является необязательным, *но строго рекомендуется к выполнению*, также вы можете создать свою собственныю конфигурацию с нуля. Будут загружены роли, трекеры, статусы, рабочие процессы и перечисления по-умолчанию
153 1 Ruslan Khasanov
# Настройка разрешений
154
_Пользователи Windows могут пропустить этот шаг._
155
Пользователь, который запускает Redmine должны иметь разрешение на запись в следующие подкаталоги:  files , log , tmp  (создайте последний, если его нет).
156
Предполагается, что вы запустили Redmine от пользователя redmine:
157
<pre>
158
mkdir tmp public/plugin_assets
159
sudo chown -R redmine:redmine files log tmp public/plugin_assets
160
sudo chmod -R 755 files log tmp public/plugin_assets
161
</pre>
162
# Протестируйте установку путем запуска веб-сервера WEBrick:
163 4 Ruslan Khasanov
<pre>
164
ruby script/server webrick -e production
165 1 Ruslan Khasanov
</pre>
166
После старта WEBrick, откройте в браузере http://localhost:3000/. Теперь вы должны увидеть страницу приветствия приложения.
167 7 Andrey Polyakov
> Примечание: Webrick не подходит для нормальной эксплуатации, пожалуйста, используйте WEBrick только для тестирования установки. Не рекомендуется использовать webrick ни для чего кроме разработки. Используйте одно из многих руководств в этой вики для настройки passenger(также известного как mod_rails) или mongrel для обслуживания вашего redmine. 
168 6 Andrey Polyakov
169
9. Используйте учетную запись администратора по умолчанию, чтобы войти:
170 1 Ruslan Khasanov
* Логин: admin
171
* Пароль: admin
172
Теперь вы можете посетить раздел _Admin&Settings_(Администрирование) для изменения настроек приложения.
173
174 7 Andrey Polyakov
h1. Настройка
175 1 Ruslan Khasanov
176 7 Andrey Polyakov
Начиная с версии "1.2.0":http://www.redmine.org/projects/redmine/versions/27, настройки Redmine определяются в файле config/configuration.yml.
177 1 Ruslan Khasanov
178 7 Andrey Polyakov
Если вам необходимо изменить настройки по-умолчанию, просто скопируйте config/configuration.yml.example в config/configuration.yml и отредактируйте новый файл. Этот файл хорошо прокоментирован, так что смотрите его.
179
180
Эти настройки могут быть определены для каждого окружения Rails (production/development/test).
181
+*Важно*+: Не забудте перезапустить приложение после любого изменения.
182
183
h2. Email / SMTP-сервер
184
185
Настройка email описана на [[RusEmailConfiguration|отдельной странице]].
186
187
h2. Настройки системы управления исходным кодом (SCM)
188
189
Эта секция настроек позволяет вам:
190
* изменить имена команд по-умолчанию, если бинарники SCM в PATH используют нестандартные имена (Windows .bat/.cmd не работают)
191
* определить полный путь к бинарникам
192
Пример(для Subversion):
193
Переопределение имени команды:
194
<pre>
195
scm_subversion_command: "svn_replacement.exe"
196
</pre>Абсолютный путь:
197
<pre>
198
scm_subversion_command: "C:\Program Files\Subversion\bin\svn.exe"
199
</pre>
200
201 8 Andrey Polyakov
h2. Настройка хранилища вложений(файлы которые загружаются в систему)
202 7 Andrey Polyakov
203
Вы можете задать путь, где Redmine будет хранить вложения, который отличается от стандартного 'files', используя параметр @attachments_storage_path@.
204
Примеры:
205
<pre>
206
attachments_storage_path: /var/redmine/files
207
</pre><pre>
208
attachments_storage_path: D:/redmine/files
209
</pre>
210
211 8 Andrey Polyakov
h2. Конфигурация логирования
212 7 Andrey Polyakov
213
По-умолчанию в Redmine уровень журналирования :info (информация). В зависимости от использования сайта, лог может сильно вырасти. Чтобы это избежать, необходимо его ротировать, либо с помощью системной утилиты @logrotate@, либо через файл @сonfig/additional_environment.rb@.
214
215
Для использования последнего, необходимо скопировать @config/additional_environment.rb.example@ в @config/additional_environment.rb@ и в нем добавить следующие строки. Отметим, что по умолчанию в файле установлен высокий уровнь журналирования, следовательно, должен быть явно установлен в информацию.
216 1 Ruslan Khasanov
<pre><code class="ruby">
217
#Logger.new(PATH,NUM_FILES_TO_ROTATE,FILE_SIZE)
218
config.logger = Logger.new(config.log_path, 2, 1000000)
219
config.logger.level = Logger::INFO
220
</code></pre>
221
222 7 Andrey Polyakov
h1. Резервное копирование
223 1 Ruslan Khasanov
224 7 Andrey Polyakov
Резервная копия Redmine должна включать:
225 1 Ruslan Khasanov
* данные (хранящиеся в базе данных Redmine)
226 7 Andrey Polyakov
* вложения (хранится в директории files вашей установки Redmine, если не настроено иное местоположение этих файлов)
227 1 Ruslan Khasanov
228 7 Andrey Polyakov
Вот простой скрипт, который может быть использован для создания ежедневных резервных копий (предположим вы используете базу данных MySQL):
229 1 Ruslan Khasanov
<pre>
230
# База данных 
231
/usr/bin/mysqldump -u <username> -p<password> <redmine_database> | gzip > /path/to/backup/db/redmine_`date +%y_%m_%d`.gz 
232
233
# Вложения 
234
rsync -a /path/to/redmine/files /path/to/backup/files
235
</pre>
236 7 Andrey Polyakov
237
h1. Замечания по установке на Windows
238
239
Получите и установите rubyinstaller с http://rubyforge.org/. Из меню "Пуск" выберите _Start Command Promt with Ruby_.
240
241
В командной строке следуйте следующим инструкциям.
242
243
Команды:<pre>
244
RAILS_ENV=production rake db:migrate
245
RAILS_ENV=production rake redmine:load_default_data
246
</pre>измените на:<pre>
247
set RAILS_ENV=production
248
rake db:migrate
249
rake redmine:load_default_data
250
</pre>Вам может понадобиться установить gem mysql с помощью команды:
251
<pre>
252
gem install mysql
253
</pre>В некоторых случаях необходимо скопировать libmysql.dll в вашу директорию ruby/bin. Не все libmysql.dll подходят, эта похоже работает http://instantrails.rubyforge.org/svn/trunk/InstantRails-win/InstantRails/mysql/bin/libmySQL.dll
254
255 8 Andrey Polyakov
h1. Альтернатива ручной установке
256 7 Andrey Polyakov
257
Некоторые пользователи предпочитают пропустить ручную установку и использовать один из "сторонних пакетов Redmine":http://www.redmine.org/projects/redmine/wiki/Download#Third-party-Redmine-bundles со страницы загрузки.