Forum

Ben · Posted: Thu Feb 17, 2005 6:36 am Post subject:

Thanks to Nunzio Gambale at Bearcage Productions (http://www.bearcage.com.au) for this tutorial.

For those wishing to install copper on MAC OS X (Client or Server) here is a breakdown of the extra steps required to install PHP and MYSQL. This is when not using the provided installer.

Should you already have php and mysql running you should be able to simply upload the copper files and run the /install directory in a browser.

***********************************************
Machine Configuration:

imac G3 400Mhz, 320 MB RAM, 10GB hard drive (circa 1999/2000)
OS X client (10.3.4...should work for 10.3.5 as well)

This hard drive was erased and the OS was installed. We are using this machine to host our master calendar (ical via ical exchange) no other software is running.

Process.

1. Download the Complete Apache2, PHP and mySql install packages from:

http://www.serverlogistics.com/software.php

2. Read and Install Apache2 , then PHP and lastly mySql. Apache2 and mySql have System Preference Panes that you can use to configure passwords etc.

3. Follow the instructions provided with the packages to confirm each service is working.

4. If the PHP service doesn't work (on my install it kept downloading the test.php file instead of displaying it), find the file named 'httpd.conf' inside the conf folder in the Apache2 folder.

On my machine it is at: LocalDrive/Library/Apache2/conf.

Open this in a proper text editor (BBedit, or Text Wrangler at http://www.barebones.com/index.shtml). I used the demo version of Text Wrangler. DON'T USE TEXT EDIT. This will change the creator of the file and apache2 won't recognise it.

Once you have opened the file, search for the line that says:

DirectoryIndex index.html index.html.var

Add index .php to the end of the line. So the line should look like:

DirectoryIndex index.html index.html.var index.php

Save this file and then run the test to see if the test.php file works. Worked for me, your mileage may vary!

5. Now onto the copper files. Unzip the provided .zip file

6. I renamed the folder named copper-2.5_Corporate to just plain 'copper', and placed it in Apache2's htdocs folder. This is located on my machine at:

LocalDrive/Library/Apache2/htdocs

7. Next, create a folder ONE level above the 'copper' folder called 'copper_files'. This is where files you upload in copper as stored. On my machine this is at:

LocalDrive/Library/Apache2/

8. Next, you need to change the permissions of the 'copper_files' folder and the file named config.php. The simplest 'GUI' way to do this is to download the freeware app called 'Batchmod from:

http://www.versiontracker.com/dyn/moreinfo/macosx/12057

This app is pretty straight forward, simply run it and locate the file or folder and set the permissions to allow everyone to access it.

9. Next, you need to create the database in mySql. I used the demo version of Navicat.

http://www.versiontracker.com/dyn/moreinfo/macosx/13371

Once you have it running, you need to make a 'connection' to the database. The host should be 'localhost' and the username should be root and the password should be the mySql password you setup when installing it at step 2 above.

Once you have connected to the server, look under the 'connection' menu and select 'new database'. The name for this Database should be 'copper'. Then click on 'manage users' and then 'add user'. This user name can be whatever you like, but it must have TOTAL access to the copper database. Once the user is created you can add privileges.

Navicat is a great tool and can be used for all sorts of mysql fun stuff....like creating backups of your data and importing stuff into tables (like contacts and clients).

10. Open a web browser on the machine and go to:

localhost/copper/install/index.php

this assumes you have renamed your copper folder to 'copper' like i did!!

Then enter all the relevant details including the stuff Ben sent you...registration info etc. The mysql server will likely be 'localhost', and you'll need the full path to your copper_files directory. On my machine this is:

/Library/Apache2/Copper_Files/

11. There is no other step. This should do it!!