Project

General

Profile

RedmineInstallOSXServer » History » Revision 9

Revision 8 (Art Kuo, 2011-06-09 02:21) → Revision 9/12 (Art Kuo, 2011-06-09 02:22)

h1. Installing Redmine on Mac OS X 10.6 

 {{>TOC}} 

 This is a quick summary of the necessary steps for a simple install of Redmine on Apple OS X Snow Leopard Server 10.6.4 (or 10.6.7).    It is meant only as a supplement, not a replacement, to the official install guide found [[RedmineInstall|here]]. 

 h2. Step by Step 

 h3. Install Prerequisites  

 # Install Xcode/OS X Developer Tools 
 Install from OS X Server DVD that was shipped with your Mac, or register for a free account and download from: http://developer.apple.com/technologies/xcode.html 
 # Install OS X MySQL Libraries ( http://support.apple.com/kb/HT4006 ) 
 Download http://www.opensource.apple.com/other/MySQL-53.binaries.tar.gz (or MySQL-54 for OSX 10.6.7) 
	 @sudo tar -xvf ~/Downloads/MySQL-53.binaries.tar -C ~/Downloads@ 
 or if you downloaded a .gz file, 
	 @sudo tar -xzvf ~/Downloads/MySQL-53.binaries.tar.gz -C ~/Downloads@ 
 This will produce a root.tar archive, which must then be extracted 
	 @sudo tar -xzvf ~/Downloads/MySQL-53.binaries/MySQL-53.root.tar.gz -C /@ 
 If successful, tar should list the many files being placed in appropriate locations  
 # Install Ruby Gems 
	 @sudo gem install rails -v=2.3.5@ 
	 @sudo gem install rack -v=1.0.1@ 
	 @sudo gem install rake -v=0.8.3@ 
	 @sudo gem install fastthread@ 
	 @sudo env ARCHFLAGS="-arch x86_64" gem install mysql -v=2.8.1@ 
 # If you are running desktop OS X    (not the Server edition):    See [[RedmineInstallOSX]] 
 # If you are running OS X *Server*: Install Passenger 
	 @sudo gem install passenger@ 
	 @sudo passenger-install-apache2-module@ 
 The apache2 module installation will ask you to add several lines to the apache configuration file. Some likely locations for this are /etc/apache2/httpd.conf (standard OS X Server installation) and /opt/local/apache2/conf/httpd.conf (MacPorts installation). 
 # Install Passenger Pref Pane 
 Download and Install: http://www.fngtps.com/passenger-preference-pane 

 h3. Install Redmine 

 # Checkout Redmine 
	 @cd /Library/WebServer/Sites/@ 
	 @sudo svn checkout http://redmine.rubyforge.org/svn/trunk redmine@ 
 # Configure Passenger 
	 Open /Library/WebServer/Sites/redmine in Finder 
	 Start Passenger preference pane in System Preferences 
	 Drag redmine folder to Passenger (you may have to 'click to make changes') 
	 Set "Address" and click "Production" 
 # If you are running desktop OS X    (not the Server edition):    See [[RedmineInstallOSX]] 
 # If you are running OS X *Server*: Enable MySQL 
	 Launch Server Admin, click + Sign, Add Service, Check MySQL box, click Save 
	 Choose the MySQL service, click Set Root Password, click Start to start the service 
 # Setup Database 
	 @mysql -u root -p@ 
 <pre> 	 create database redmine character set utf8; 
	 create user 'redmine'@'localhost' identified by 'my_password'; 
	 grant all privileges on redmine.* to 'redmine'@'localhost';</pre> 
 # Configure Redmine 
	 @cd /Library/WebServer/Sites/redmine@ 
	 @sudo mkdir tmp public/plugin_assets@ 
	 @sudo chmod -R 755 files log tmp public/plugin_assets@ 
	 @sudo cp config/database.yml.example config/database.yml@ 
 Edit database.yml, ie.: 
 <pre> 
 production: 
   adapter: mysql 
   database: redmine 
   host: localhost 
   username: redmine 
   password: my_password 
 </pre> 
 # Establish Defaults 
	 @sudo rake generate_session_store@ (may require gems i18n and updated rails) 
	 @sudo RAILS_ENV=production rake db:migrate@ 
	 @RAILS_ENV=production rake redmine:load_default_data@ 
 (If rails cannot access log file, do this: @sudo chmod 0666 log/production.log@) 

 h3. Try out using webrick 

 # Run the ruby web server with 
 @ruby script/server webrick -e production@ production 
 # Go to a web browser and view @http://localhost:3000@ 
 There may be some errors. An error regarding undefined "csrf_meta_tag" can be dealt with by deleting the corresponding line in app/views/layouts/base.rhtml (perhaps line 8, but use the error message to be sure of proper line).