Project

General

Profile

F29Installation » History » Version 29

Gerd Pokorra, 2019-01-03 18:34

1 1 Gerd Pokorra
h1. HowTo Install Redmine 4.0.0 on Fedora 29
2
3
{{toc}}
4
5
This guide is not complete. It will be completed in the next two weeks.
6
7
h2.  System Requirements
8
9
It is assumed that the Server Edition is installed on the system in this guide.
10
11 13 Gerd Pokorra
h3. Updating the System
12
  
13
It is recommended to install Redmine on an update system. To ensure that all installed packages are up-to-date issue the following command:
14
15
<pre>> dnf update
16
</pre>
17
18 14 Gerd Pokorra
h3. Installing Dependencies
19
20
A number of dependencies need to be installed:
21
22
<pre>> dnf install rubygem-bundler
23
> dnf install rubygem-rails
24
25
> dnf install ruby-devel rubygem-rmagick
26
> dnf install gcc redhat-rpm-config
27
28
> dnf groupinstall "C Development Tools and Libraries"
29
> dnf groupinstall "Development Tools"
30
</pre>
31
32 28 Gerd Pokorra
Database adapter for PostgreSQL:
33 16 Gerd Pokorra
  
34 1 Gerd Pokorra
<pre>> dnf install rubygem-pg
35
</pre>
36 17 Gerd Pokorra
37 28 Gerd Pokorra
Database adapter for MySQL:
38 27 Gerd Pokorra
<pre>> dnf install rubygem-mysql2
39
</pre>
40
41 29 Gerd Pokorra
Database adapter for MS SQL:
42
43
The Fedora distribution has not ruby software package for @tiny_tds@. The following dependency is needed for the build:
44
45
<pre>> dnf install freetds-devel
46
> # Now the build should work
47
> bundle install --without development test
48
</pre>
49
50
51
52 17 Gerd Pokorra
The list of dependencies may not complete. Problems of the installation or build of a compoment can be solved by installing the necessary dependency.
53 16 Gerd Pokorra
54 12 Gerd Pokorra
h2. Obtaining Redmine (Step 1)
55
56
Get the Redmine source code by downloading the packaged release.
57
58
<pre>> dnf install wget
59
60
> mkdir /var/www
61
> cd /var/www
62
63
> wget http://www.redmine.org/releases/redmine-4.0.0.tar.gz
64
> tar xf redmine-4.0.0.tar.gz
65
</pre>
66
67
At this guide is accepted that the location of the Redmine source code is:
68
69
<pre>/var/www/redmine-4.0.0
70
</pre>
71
72
For example the nginx configuration refer to the path @/var/www/redmine-4.0.0@.
73 16 Gerd Pokorra
74 22 Gerd Pokorra
h2. Setup a local database server (Step 2)
75 16 Gerd Pokorra
76
This section discribes the setup of a database server that will be configured to allow access from the localhost.
77
78
h3. PostgreSQL
79
80 18 Gerd Pokorra
The followings commands are for installing the packages, initializing the database, enable and start the postgresql server, switch the user to interact with @postgres@, create an empty database and accompanying user.
81
82
<pre>> dnf install postgresql-server postgresql-contrib
83
> postgresql-setup --initdb --unit postgresql
84
 * Initializing database in '/var/lib/pgsql/data'
85
 * Initialized, logs are in /var/lib/pgsql/initdb_postgresql.log
86
>
87
> systemctl enable postgresql
88
> systemctl start postgresql
89
> su - postgres
90
> psql
91
psql (10.6)
92
Type "help" for help.
93
94
postgres=# CREATE ROLE redmine LOGIN ENCRYPTED PASSWORD 'my_secret' NOINHERIT VALID UNTIL 'infinity';
95
CREATE ROLE
96
postgres=# CREATE DATABASE redmine WITH ENCODING='UTF8' OWNER=redmine;
97
CREATE DATABASE
98
postgres=# \q
99
> exit
100
</pre>
101
102 19 Gerd Pokorra
Edit the file @/var/lib/pgsql/data/pg_hba.conf@ to specify that the client has to supply password processed with MD5 algorithm:
103
104
<pre>#host    all             all             127.0.0.1/32            ident
105
host    all             all             127.0.0.1/32            md5
106
# IPv6 local connections:
107
#host    all             all             ::1/128                 ident
108
host    all             all             ::1/128                 md5
109
</pre>
110
111
You can check the access with the following command:
112
113
<pre>> su - postgres
114 20 Gerd Pokorra
> psql -h localhost -U redmine redmine
115 1 Gerd Pokorra
</pre>
116 20 Gerd Pokorra
117
The appropriate Redmine database configuration file for local access is:
118
119 21 Gerd Pokorra
<pre>> cat /var/www/redmine-4.0.0/config/database.yml
120 20 Gerd Pokorra
# PostgreSQL configuration
121
production:
122
  adapter: postgresql
123
  database: redmine
124
  host: localhost
125
  username: redmine
126
  password: "my_secret"
127
  encoding: utf8
128 1 Gerd Pokorra
  schema_search_path: public
129 21 Gerd Pokorra
</pre>
130 20 Gerd Pokorra
131
If you want to use IPv4 you have to specify @localhost4@ as hostname.
132 19 Gerd Pokorra
133 1 Gerd Pokorra
h3. MySQL
134 22 Gerd Pokorra
135
Install the MySQL repositry
136
137
<pre>> dnf -y install https://dev.mysql.com/get/mysql80-community-release-fc29-1.noarch.rpm
138
</pre>
139
140
If you prefer to stick to MySQL 5.7
141
142
<pre>> dnf config-manager --set-enabled mysql57-community
143
> dnf config-manager --set-disabled mysql80-community
144
</pre>
145
146 23 Gerd Pokorra
Install the MySQL server package, start the MySQL server and autostart the daemon on boot
147
148 22 Gerd Pokorra
<pre>> dnf -y install mysql-community-server
149
> systemctl start mysqld.service
150
> systemctl enable mysqld.service
151
</pre>
152 12 Gerd Pokorra
153 24 Gerd Pokorra
Get your generated random root password you will need it at the next step.
154
155
<pre>> grep 'A temporary password is generated for root@localhost' /var/log/mysqld.log |tail -1
156
</pre>
157
158
Start the secure installation assistant to
159
160 25 Gerd Pokorra
* change root password
161
* remove anonymous users
162
* disallow root login remotely
163
* remove test database and access to it
164
* reload privilege tables
165 24 Gerd Pokorra
166
<pre>> mysql_secure_installation
167
</pre>
168
169 26 Gerd Pokorra
Creation of user and database for Redmine
170
171
<pre>> mysql -h localhost -u root -p
172
Enter password:
173
...
174
mysql> CREATE DATABASE redmine CHARACTER SET utf8mb4;
175
mysql> CREATE USER 'redmine'@'localhost' IDENTIFIED BY 'my_secret';
176
mysql> GRANT ALL PRIVILEGES ON redmine.* TO 'redmine'@'localhost';
177
mysql> \q
178
</pre>
179
180 11 Gerd Pokorra
h2. Firewall
181
182
Open the firewall for https:
183
184
<pre>> firewall-cmd --add-service=https
185
> firewall-cmd --permanent --add-service=https
186
</pre>
187
188 1 Gerd Pokorra
h2. Web Server
189
190 5 Gerd Pokorra
h3. Nginx/Passenger
191 2 Gerd Pokorra
192
The Fedora @nginx@ package do not include Passenger, so you have to build @nginx@ with the passenger module. The guide assume that the sources are extracted under the directory @/opt@ . The @nginx@ software will be installed at @/opt/ngnix@. At the time of writting that guide this was the current stable releases of @passenger@ and @nginx@:
193
194
* passenger-6.0.0
195
* nginx-1.14.2
196
197 4 Gerd Pokorra
h4. Downloading the sources:
198 2 Gerd Pokorra
199
<pre>Passenger
200
201
> cd /opt
202
> wget https://s3.amazonaws.com/phusion-passenger/releases/passenger-6.0.0.tar.gz
203
> tar xf passenger-6.0.0.tar.gz
204
205
Nginx
206
207
> wget http://nginx.org/download/nginx-1.14.2.tar.gz
208
> mkdir /opt/src
209
> cd /opt/src
210
> tar xf nginx-1.14.2.tar.gz
211
</pre>
212 1 Gerd Pokorra
213 3 Gerd Pokorra
h4. Installing additional packages
214
215
For the build of @passenger@ and @nginx@ the following additional packages are needed to be installed:
216
217
<pre>> dnf install install gcc-c++ libcurl-devel openssl-devel zlib-devel
218
</pre>
219 1 Gerd Pokorra
220 5 Gerd Pokorra
h4. Execute the ruby script for building and installing
221 1 Gerd Pokorra
222 5 Gerd Pokorra
The simplest way to build and install the @nginx@ web server with the @passenger@ module is to run the script @passenger-install-nginx-module@.
223
224
<pre>> /opt/passenger-6.0.0/bin
225
> ./passenger-install-nginx-module --prefix=/opt/nginx --nginx-source-dir=/opt/src/nginx-1.14.2 --languages ruby
226
</pre>
227 3 Gerd Pokorra
228 7 Gerd Pokorra
With the same @passenger@ locality the installer modify the @nginx@ configuration file @/opt/nginx/conf/nginx.conf@ and output the same text:
229 6 Gerd Pokorra
230
<pre>  http {
231
      ...
232
      passenger_root /opt/passenger-6.0.0;
233
      passenger_ruby /usr/bin/ruby;
234
      ...
235
  }
236
</pre>
237
238 8 Gerd Pokorra
h4. Add a systemd service file
239
240
To start the @nginx@ process during the boot add the file @/usr/lib/systemd/system/nginx.service@ with the following content:
241
242
<pre>[Unit]
243
Description=The nginx HTTP and reverse proxy server
244
After=network.target remote-fs.target nss-lookup.target
245
246
[Service]
247
Type=forking
248
#PIDFile=/run/nginx.pid
249
PIDFile=/opt/nginx/logs/nginx.pid
250
# Nginx will fail to start if /run/nginx.pid already exists but has the wrong
251
# SELinux context. This might happen when running `nginx -t` from the cmdline.
252
# https://bugzilla.redhat.com/show_bug.cgi?id=1268621
253
ExecStartPre=/usr/bin/rm -f /opt/nginx/logs/nginx.pid
254
#ExecStartPre=/usr/sbin/nginx -t
255
#ExecStart=/usr/sbin/nginx
256
ExecStartPre=/opt/nginx/sbin/nginx -t
257
ExecStart=/opt/nginx/sbin/nginx -c /opt/nginx/conf/nginx.conf
258
ExecReload=/bin/kill -s HUP $MAINPID
259
KillSignal=SIGQUIT
260
TimeoutStopSec=5
261
KillMode=mixed
262
PrivateTmp=true
263
264
[Install]
265
WantedBy=multi-user.target
266
</pre>
267
268
The paths are modified to start the executable @/opt/nginx/sbin/nginx@.
269
270
<pre>> systemctl start nginx
271
> systemctl enable nginx
272
</pre>
273
274 9 Gerd Pokorra
h4. Nginx Configuration
275
276
For http add the two lines and comment out the four lines:
277
278
<pre>    server {
279
        listen       80;
280
...
281
        root         /var/www/redmine-4.0.0/public;
282
        passenger_enabled on;
283
        #location / {
284
        #    root   html;
285
        #    index  index.html index.htm;
286
        #}
287
...
288
       }
289
</pre>
290
291 10 Gerd Pokorra
For https add you can use lines like this:
292
293
<pre>    # HTTPS server
294
    #
295
    server {
296
        listen       443 ssl;
297
        server_name  my_web_serv.domain;
298
299
        ssl_certificate      /etc/ssl/certs/my_web_serv.pem;
300
        ssl_certificate_key  /etc/ssl/private/privkey.pem;
301
302
        root         /var/www/redmine-4.0.0/public;
303
        passenger_enabled on;
304
    }
305
</pre>
306
307 1 Gerd Pokorra
h3. Apache