Project

General

Profile

RedmineInstallOSX » History » Version 9

Josue Alvarez, 2011-08-04 19:52

1 2 Bevan Rudge
h1. Installing Redmine on Mac OS X 10.6 (Desktop — not the Server edition)
2 1 Bevan Rudge
3 2 Bevan Rudge
> [[RedmineInstallOSXServer|Instructions for the server edition are here]].
4
5 5 Redmine User
Since Mac OS X doesn't have the "Server Admin" application, you'll need to start & configure MySQL manually from the command line. If you have the MySQL Preference Pane installed in the System Preferences, you can start/stop MySQL from there.
6 2 Bevan Rudge
7 7 Daniel Lopez
Alternatively, if you are installing *for a development environment only*, you can use another instance of MySQL, such as those bundled with "MAMP":http://www.mamp.info/en/index.htm, "MAPStack":http://bitnami.org/stack/mampstack, "XAMPP":http://www.apachefriends.org/en/xampp.html, the "Acquia Drupal Stack Installer":http://acquia.com/downloads and other pre-compiled and packaged server stacks.  To do this;
8 2 Bevan Rudge
9
# Skip the steps about:
10
    1. @passenger-install-apache2-module@
11 3 Josh Galvez
         • Use webrick instead only if using for development environment only, passenger has better performance. 
12
         • You don't need @gem install passenger@ or the Passenger preferences pane if using webrick.
13 2 Bevan Rudge
    2. Enabling MySql with Server Admin
14
    3. Establishing defaults with rake and RAILS_ENV
15 8 arthur me
16
# You may need to build your mysql gem if @sudo gem install mysql@ fails. For example you may try the following depending on where you have mysql installed:
17 1 Bevan Rudge
  @sudo env ARCHFLAGS="-arch x86_64" gem install --no-rdoc --no-ri mysql -- --with-mysql-config=/usr/local/bin/mysql_config@
18 8 arthur me
  @sudo env ARCHFLAGS="-arch x86_64" gem install --no-rdoc --no-ri mysql -- --with-mysql-config=/usr/local/mysql-5.1.34-osx10.5-x86_64/bin/mysql_config@  
19
# You my need to download and install MySql binaries from the opensource.apple.com link in [[RedmineInstallOSXServer]].  @gem@ needs this in order to build the ruby-to-mysql plugin. If you installed the developer's tools, this should be in place.
20 1 Bevan Rudge
# Start your server-stack and check the MySQL server is running
21 2 Bevan Rudge
# Either;
22 8 arthur me
  1. Use the stack's phpMyAdmin or its equivalent tool to create the database and user, *OR*
23 1 Bevan Rudge
  2. Check that @mysql@ on the command line points to the mysql binary for your stack (@which mysql@) and create a database and user as per [[RedmineInstallOSXServer]].
24 8 arthur me
# Link Mac OS X's mysql socket to the stack's socket to trick Ruby into finding the right mysql instance:
25 1 Bevan Rudge
  @sudo ln -s /Applications/acquia-drupal/mysql/data/mysql.sock /var/mysql/mysql.sock@
26 8 arthur me
  - or - 
27
  @sudo ln -s /Applications/MAMP/tmp/mysql/mysql.sock /tmp/mysql.sock@
28
  - or -
29
  In your config/database.yml add parameter @socket: /path/to/socket.sock@
30
31 2 Bevan Rudge
# Start the Ruby web server with @ruby script/server webrick -e production@.
32
    If you set the development database settings in @config/databases.yaml@ instead of the production database settings, you can replace _production_ with _development_ in the above command.
33 3 Josh Galvez
# Point your web browser at http://localhost:3000 if using webrick
34 4 Redmine User
35
Alternatively, follow the standard installation instructions at [[RedmineInstall]], making the alterations suggested in the forum post "Mac OS X - Snow Leopard installation notes" at http://www.redmine.org/boards/2/topics/17148.
36 6 Daniel Lopez
37
There is a freely available all-in-one GUI installer for OS X that can be downloaded at http://bitnami.org/stack/redmine
38 9 Josue Alvarez
39
See also the [[How to install Redmine in Linux Windows and OS X using BitNami Redmine Stack|BitNami Redmine on OS X tutorial]]