Project

General

Profile

RedmineInstallOSX » History » Revision 8

Revision 7 (Daniel Lopez, 2010-09-23 12:56) → Revision 8/9 (arthur me, 2011-04-05 23:15)

h1. Installing Redmine on Mac OS X 10.6 (Desktop — not the Server edition) 

 > [[RedmineInstallOSXServer|Instructions for the server edition are here]]. 

 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. 

 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; 

 # Skip the steps about: 
     1. @passenger-install-apache2-module@ 
          • Use webrick instead only if using for development environment only, passenger has better performance.  
          • You don't need @gem install passenger@ or the Passenger preferences pane if using webrick. 
     2. Enabling MySql with Server Admin 
     3. Establishing defaults with rake and RAILS_ENV 

 
 # You may need to build your mysql gem if run the following command instead of @sudo gem install mysql@ fails. For example you may try the following depending on where you have mysql installed: — I'm not sure. 
   @sudo env ARCHFLAGS="-arch x86_64" gem install --no-rdoc --no-ri mysql -- --with-mysql-config=/usr/local/bin/mysql_config@ 
   @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@   
 
 # You my You'll still 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. 
 # Start your server-stack and check the MySQL server is running 
 # Either; 
   1. Use the stack's phpMyAdmin or its it's equivalent tool to create the database and user, *OR* 
   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]]. 
 # Link Mac OS X's mysql socket to the stack's socket to trick Ruby into finding the right mysql instance: 
   @sudo ln -s /Applications/acquia-drupal/mysql/data/mysql.sock /var/mysql/mysql.sock@ 
   - or -  
   @sudo ln -s /Applications/MAMP/tmp/mysql/mysql.sock /tmp/mysql.sock@ 
   - or - 
   In your config/database.yml add parameter @socket: /path/to/socket.sock@ 

 
 # Start the Ruby web server with @ruby script/server webrick -e production@. 
     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. 
 # Point your web browser at http://localhost:3000 if using webrick 

 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. 

 There is a freely available all-in-one GUI installer for OS X that can be downloaded at http://bitnami.org/stack/redmine