Project

General

Profile

RedmineInstallOSXMavericksServer » History » Version 19

Khedron Wilk, 2014-03-01 14:20

1 17 Khedron Wilk
h1. Installing Redmine on OS X 10.9 Mavericks Server and Client
2 2 Roland Laussat
3 17 Khedron Wilk
This is a quick summary of the necessary steps for a simple install of Redmine on Apple OS X Mavericks Server 10.9. This summary can also be applied on Mavericks Client. This is slightly different from the install for [[RedmineInstallOSXServer|Snow Leopard Server]]. This is meant only as a supplement, not a replacement, to the official install guide found [[RedmineInstall|here]]. This summary contains instructions for MySQL only, for PostgreSQL please see related part of the official install guide.
4 2 Roland Laussat
5
h2. Install Prerequisites 
6
7 9 Roland Laussat
*Xcode 5 and MySQL Server*
8 2 Roland Laussat
9 17 Khedron Wilk
Get Xcode 5 from the Mac App Store or register for a free account and download from: https://developer.apple.com/downloads/. (It seems that strictly speaking the full Xcode installation is not needed to install the command-line tools but download and install ful Xcode anyway to be on the safe side.)
10 2 Roland Laussat
Next, install the command line-tools via Terminal:
11 14 Khedron Wilk
<pre>xcode-select --install</pre>
12 2 Roland Laussat
13 1 Roland Laussat
Then install MySQL Community Server - get it from http://dev.mysql.com/downloads/mysql (get the Mac OS X 10.7 64-bit DMG archive).
14
It will install a nifty little preference pane to start and stop the MySQL server.
15
16 17 Khedron Wilk
To make database administration easier you should include the database binaries in your path:
17 18 Khedron Wilk
<pre>export PATH=/usr/local/mysql/bin:$PATH</pre> (To make your life easier in the long run you may want to include this command in your ~/.bash_profile file.)
18 17 Khedron Wilk
19 1 Roland Laussat
Because the installer doesn't set a root password during the installation, you've got to set it with mysqladmin:
20 2 Roland Laussat
<pre>mysqladmin -u root password "newpwd"</pre>
21 17 Khedron Wilk
Next, login to mysql. 
22 2 Roland Laussat
<pre>mysql -u root -p</pre>
23 17 Khedron Wilk
Create the database, the database user and set privileges:
24
<pre><code class="sql">CREATE DATABASE redmine CHARACTER SET utf8 COLLATE utf8_general_ci;
25
CREATE USER 'redmine'@'localhost' IDENTIFIED BY 'my_password';
26
GRANT ALL PRIVILEGES ON redmine.* TO 'redmine'@'localhost';</code></pre>
27 9 Roland Laussat
28 17 Khedron Wilk
29 2 Roland Laussat
The Redmine installer expects the MySQL client library in a different place, so you need to create a symbolic link to the original location:
30 1 Roland Laussat
<pre>sudo ln -s /usr/local/mysql/lib/libmysqlclient.18.dylib  /usr/lib/libmysqlclient.18.dylib</pre>
31
32
*Redmine Prerequisites*
33
34
Redmine is built on Ruby which comes with Xcode, but some gems are missing:
35
<pre>sudo gem install rails bundler passenger</pre>
36
Next, use passenger to build the apache2-passenger module:
37
<pre>sudo passenger-install-apache2-module</pre>
38 17 Khedron Wilk
This will in the end output few lines of configuration code that you'll have to add to your Apache configuration. Here follows an example, be aware that exact content may change with newer versions of related software:
39
<pre><code class="xml">LoadModule passenger_module /Library/Ruby/Gems/2.0.0/gems/passenger-4.0.37/buildout/apache2/mod_passenger.so
40
<IfModule mod_passenger.c>
41
	PassengerRoot /Library/Ruby/Gems/2.0.0/gems/passenger-4.0.37
42
	PassengerDefaultRuby /System/Library/Frameworks/Ruby.framework/Versions/2.0/usr/bin/ruby
43
</IfModule></code></pre>
44
In OS X Mavericks it's necessary to put this code in one of two files:
45 19 Khedron Wilk
Server:<pre>/Library/Server/Web/Config/apache2/httpd_server_app.conf</pre>
46
Client:<pre>/etc/apache2/httpd.conf</pre>
47 17 Khedron Wilk
Simply add the lines to the end of your Apache configuration files. Or put the code lines in a separate file that is included by the main conf-file. A suggestion is to create the following file and put the code in there:
48 19 Khedron Wilk
Server:<pre>/Library/Server/Web/Config/apache2/other/passenger.conf</pre>
49
Client:<pre>/etc/apache2/other/passenger.conf</pre>
50 15 Khedron Wilk
51 17 Khedron Wilk
52 2 Roland Laussat
Finally, OS X Mavericks has a problem to install the rmagick gem which is optional for a successful installation of Redmine, but if you want to display images and charts it's necessary.
53
Get the following packages:
54
ImageMagick - http://cactuslab.com/imagemagick/ (Note there are two versions, one with free type which requires XQuartz to be installed - the basic version is sufficient.)
55 1 Roland Laussat
Pgkconfig - http://macpkg.sourceforge.net
56
rmagick - http://rubygems.org/gems/rmagick (sometimes the download during installation fails, it's easier to have it stored locally)
57
58
Install ImageMagick and Pkgconfig, both should be installed in the /opt directory by default.
59
Because neither ImageMagick or Pkgconfig seems to add the path to the executable during the installation, you have to export the path variable:
60
<pre>export PATH=/opt/ImageMagick/bin:/opt/pkgconfig/bin:$PATH</pre>
61
62
The following command should install the rmagick gem without errors (if it fails please check the paths to MagickCore.pc and MagickWand.h):
63
<pre>sudo C_INCLUDE_PATH=/opt/ImageMagick/include/ImageMagick-6/ PKG_CONFIG_PATH=/opt/ImageMagick/lib/pkgconfig/ gem install --local ~/Downloads/rmagick-2.13.2.gem</pre>
64 9 Roland Laussat
(Assuming rmagick has been downloaded to your Downloads directory)
65
66
h2. Install Redmine
67 3 Roland Laussat
68 13 Roland Laussat
Get the latest stable build of Redmine and move the redmine directory to your web server root folder.
69 12 Roland Laussat
70 3 Roland Laussat
*Configure Redmine*
71
72 17 Khedron Wilk
<pre>cd /Library/WebServer/Sites/redmine
73
sudo mkdir public/plugin_assets
74
sudo chown -R _www:_www tmp public/plugin_assets log files
75
sudo chmod -R 755 files log tmp public/plugin_assets
76
sudo cp config/database.yml.example config/database.yml</pre>
77 1 Roland Laussat
Edit database.yml, e.g.
78 17 Khedron Wilk
<pre><code class="yaml">production:
79
  adapter: mysql2
80 3 Roland Laussat
  database: redmine
81 1 Roland Laussat
  host: localhost
82
  username: redmine
83 17 Khedron Wilk
  password: my_password</code></pre>
84 1 Roland Laussat
85 3 Roland Laussat
*Run Bundler*
86 9 Roland Laussat
87 10 Roland Laussat
<pre>sudo bundle install --without development test</pre>
88 9 Roland Laussat
Assuming the installation finished without errors you can generate the secret token:
89 2 Roland Laussat
<pre>sudo rake generate_secret_token</pre>
90
Next steps:
91
<pre>sudo RAILS_ENV=production rake db:migrate</pre>
92
<pre>sudo RAILS_ENV=production rake redmine:load_default_data</pre>
93
94 17 Khedron Wilk
If you want to do a quick test and take Redmine for a ride your can now do so:
95
<pre>sudo ruby script/rails server webrick -e production</pre>
96
This will make your redmine available att http://localhost:3000
97
98
99 2 Roland Laussat
Last but not least you need to point Apache to the public folder inside the red mine directory to serve Redmine as a website.
100
Please make sure you tick _Allow overrides using .htaccess file_ in the advanced settings of your website configuration.
101 17 Khedron Wilk
102 2 Roland Laussat
103
For further information please see
104 1 Roland Laussat
[[RedmineInstallOSXServer|HowTo Install Redmine on Mac OS X Server]] 10.6 Snow Leopard
105
and
106
[[RedmineInstallOSXLionServer|HowTo Install Redmine on Mac OS X Lion Server]]
107
in case some details are missing here.