|
|
| Line 1: |
Line 1: |
| See below for an installation history from 2005. | | See http://bugzilla.readthedocs.org/en/latest/installing/mac-os-x.html . |
| | |
| I installed [[Bugzilla]] (versions 3.6, 4.2, 4.4, and 4.5) on a MacBook Pro (running OSX 10.7.5) on 2012-11-10. Here are the steps I used. The steps below are for installing from trunk, but they can be adapted to any branch.
| |
| | |
| Notes:
| |
| # My steps don't involved using [http://www.macports.org macports]. Note that the CGI scripts in [[Bugzilla]] use <tt>/usr/bin/perl</tt>, whereas macports installs its Perl into <tt>/opt/local/bin/perl</tt>.
| |
| # Some packages, notably Bazaar and MySQL, have binary installers for OSX 10.6 but not for 10.7. The 10.6 installers work fine.
| |
| | |
| Steps:
| |
| # OSX 10.7 provides Perl 5.12 and Apache 2.2. Install the following additional packages:
| |
| #* Bazaar: Download an installer from https://launchpad.net/bzr/+download. I installed https://launchpad.net/bzr/2.5/2.5.1/+download/Bazaar-2.5.1-OSX-10.6-1.dmg
| |
| #* MySQL: Download an installer from http://dev.mysql.com/downloads/mysql/.
| |
| # In MySQL, create a <tt>bugs</tt> database:
| |
| #* <tt>CREATE DATABASE bugs;</tt>
| |
| #* <tt>GRANT ALL PRIVILEGES ON bugs.* TO bugs@'localhost' IDENTIFIED BY 'bugs';</tt>
| |
| # Branch the Bugzilla source into some directory:
| |
| #* <tt>$ bzr branch bzr://bzr.mozilla.org/bugzilla/trunk bugzilla-trunk</tt>
| |
| # Run <tt>checksetup.pl</tt> in the directory :
| |
| #* <tt>perl checksetup.pl</tt> (If you are using macports, you should use <tt>/usr/bin/perl checksetup.pl</tt>
| |
| #* Run <tt>perl install-module.pl --all</tt> if needed. This will install any missing modules into the local directory <tt>lib</tt>. You can also install modules individually. To install them in <tt>/usr/local</tt> instead of <tt>lib</tt>, run <tt>install-module.pl</tt> as <tt>root</tt> with the <tt>--global</tt> option
| |
| # Create a symbolic link in Apache's <tt>DocumentRoot</tt>
| |
| #* <tt>cd /Library/WebServer/Documents</tt>
| |
| #* <tt>sudo ln -s $HOME/bugzilla-trunk bugzilla</tt>
| |
| # Edit Apache's configuration file:
| |
| #* <tt>cd /etc/apache2</tt>
| |
| #* <tt>sudo vim httpd.conf</tt>
| |
| #** Add the line <tt>Include /private/etc/apache2/extra/httpd-bugzilla.conf</tt>
| |
| # Create <tt>httpd-bugzilla.conf</tt>
| |
| #* <tt>cd /etc/apache2/extra</tt>
| |
| #* <tt>sudo vim httpd-bugzilla.conf</tt>
| |
| #* Add the contents of the <tt><Directory&rt;</tt> section for whichever version of Bugzilla you are installing.
| |
| #* The directory name should be <tt>/Library/WebServer/Documents/bugzilla</tt>
| |
| #* Include <tt>+FollowSymLinks</tt> in the <tt>Options</tt> directive.
| |
| # In "System Preferences" ⇒ "Sharing": enable the "Web Sharing" checkbox to start Apache.
| |
| # Visit <tt>http://localhost/bugzilla</tt> to complete configuration.
| |
| | |
| ----
| |
| | |
| See Also: http://wiki.springsurprise.com/2009/09/30/installing-bugzilla-on-mac-os-x-server/ and http://www.bitstampede.com/2011/05/11/installing-bugzilla-on-mac-os-x-server-10-6/ .
| |
| | |
| I installed [[Bugzilla]] 2.20 on MacOS X Server 10.4 on 2005-10-24. Here are some notes that might help others:
| |
| | |
| * GUI apps to manage Apache ("Server Admin") and MySQL ("MySQL Manager"). Pretty straightforward. I figured it would be GUI and used Google on site:apple.com to find the instructions for this.
| |
| | |
| * CPAN wasn't working for me; something to do with FTP, with an error message I hadn't seen before, something like "OOPS: can't bind to IPv4 socket". This only came up on some FTP sites, but ftp.cpan.org was one of them. Switching passive mode on and off didn't help. I've had CPAN problems on other platforms, and used my usual solution (used CPAN web search to locate module sources, downloaded, unpacked, installed by hand (perl Makefile.PL && make && make test && make install).
| |
| | |
| * Didn't have "make", to build the CPAN packages. To get it, I installed the optional Developer Tools package from the MacOS X Server 10.4 install DVDs. This needs 1.5 GB of disk space. Seems like a lot just to get GNU make (and gcc, as it happens).
| |
| | |
| * Didn't have libgd (I know that this is mentioned in the 2.20 Bugzilla Guide, but I had forgotten). Downloaded, built, very smooth.
| |
| | |
| * Once I had checksetup running, I tried loading the index page and got a MySQL error message, complaining that I couldn't talk to MySQL on the socket /var/mysql/mysql.sock and suggesting I check the localconfig db_user and db_pass. <br> This was a nightmare for about two solid hours, during which time I tried a lot of things. I was incidentally reminded that I don't know how to force the MySQL shell client to use TCP/IP sockets (doing what it says in the man page just doesn't work).<br> Part of the problem was the Apache GUI config, as that meant I couldn't see and tweak the httpd.conf or the Apache startup script. (for a while I thought that the web server must be running in a jail or similar).<br> What it eventually turned out to be was that the MySQL socket /var/mysql/mysql.sock had permissions 770, and the Apache user (www) was not in the necessary group.<br> I fixed it (for now) by changing the permissions on the socket to 777.<br>On reflection, obviously the right thing would be to put the Apache user in whatever group owns this file (presumably the mysql group). Next time I visit that site I'll change this over.
| |
| | |
| * Apache out-of-the-box from Apple doesn't kill runaway CGI. I only found this out when the disk filled up with an 21 GB Apache log file generated from a broken script which I wrote to test a hypothesis for point #4. The web browser loading the CGI had long since been closed.
| |
| | |
| [[category:Bugzilla|M]]
| |