Installing MEEG on OS X 10.4

Installing MEEG on OS X 10.4

Installing MEEG on OS X 10.4 (tiger)

This tutorial will guide you through the installation of MEEG on your OS X 10.4 system, using the included Apache server. This process usually takes about 20-30 minutes. Some additional free software will be required so a connection to the internet might be useful.

Introduction

To use OS X internal web server for running MEEG source code some settings must be changed. First of all, php must be enabled in the apache server. To do that some Terminal commands will be needed.

Then a MySQL server must be installed on your system, and php interpreter has to be enabled to reach that server.

Please refer to the Manual Section of the MEEG application menu (by opening MEEG in your Browser and clicking on the Manual button) to continue the installation and start to use MEEG.

Modify the Apache configuration (to enable php)

1. Open System Preferences -> Sharing and make sure that “personal web sharing” is turned off (if it is on, you can turn it off during this installation)
2. Open Terminal (on Applications/Utilities) and type the following string:sudo pico /etc/httpd/httpd.conf

   You will be asked for the administrator password. Once you have typed it (please notice that you won’t be able to see what you are typing!) press return.

   A text editor (pico) window will be opened with the apache configuration text file in it.

   

3. By using the down arrow key, reach the line that reads:“#LoadModule php4_module libexec/httpd/libphp4.so”

   (tip: you can search this line by using the search function of pico (Ctrl+W) typing the word “php”)

   

4. To uncomment this line use the arrows keys go to the beginning of the line and remove the character “#” using the backspace key. now the line should be displayed as:LoadModule php4_module libexec/httpd/libphp4.so

   

5. Now find the line “#AddModule mod_php4.c” (again you can use the search function by pressing Ctrl+W and return)Remove the # at the beginning and the result should be:

   AddModule mod_php4.c

   

6. Press Ctrl+O and then press Return to confirm that you want to save settings.
7. Press Ctrl-X to quit Pico.

Installing MySQL

1. Go to the website http://dev.mysql.com
2. From the download section of the site, download the package “Mac OS X (package format)” (ver 5.0 required)
3. Open the downloaded .dmg file, and install the “mysql-5.0.XX-osx10.4-i686.pkg” package first.
4. Then install “MySQLStartupItem.pkg” and finally “MySQL.prefPane”.
5. Now you should see the new MySQL pane in the System Preferences window.
6. Click on the MySQL pane and Start the server (for your ease you can check “Automatically Start MySQL on Startup”).
7. Open Terminal and typesudo cp /etc/php.ini.default /etc/php.ini
8. Now edit with pico the /etc/php.ini file. To do this, type the following line in Terminal:sudo pico /etc/php.ini

   

9. search the line “mysql.default_socket =” and change it to:mysql.default_socket = /tmp/mysql.sock

   

10. Press Ctrl+O and then press Return to confirm that you want to save settings.
11. Press Ctrl+X to quit Pico.

Create a new user (‘meeg’) in MySQL

1. Open Terminal and type:/usr/local/mysql/bin/mysql –user=root mysql

   

2. Type the following line in MySQL Shell:GRANT ALL PRIVILEGES ON *.* TO ‘meeg’@’%’;

   (the final semicolon is essential!) and press return.

   Now type:

   GRANT ALL PRIVILEGES ON *.* TO ‘meeg’@’localhost’;

   and press return.

   

3. If you want to set a password for the database user ‘meeg’ please use this two queries following the previous ones or in place of them:GRANT ALL PRIVILEGES ON *.* TO ‘meeg’@’localhost’ IDENTIFIED BY ‘YourPassword’ WITH GRANT OPTION;

   GRANT ALL PRIVILEGES ON *.* TO ‘meeg’@’%’ IDENTIFIED BY ‘YourPassword’ WITH GRANT OPTION;

4. Finally, type ‘quit’ and hit return to exit from the MySQL Shell

To complete the installation open System preference / sharing and (re)start the personal web sharing.

Installing the MEEG source code

1. Unpack the MEEG installer package and copy the meeg folder into your sites folder (YourUserName Home / Sites)
2. Now open a web browser (Firefox is highly recommended) and go to the address: http://localhost/~YourUserName/meeg.
3. If you are notified the following error: “Forbidden. You don’t have permission to access /~YourUserName/meeg/ on this server.” you will have to change the permissions of this folder to “Read Only” for all users.To do this, follow these steps:
   • Open Sites folder on finder. Select “meeg” folder and “Get Info” about it.
   • Now open the “Ownership & Permissions” section and under “details” select at least “Read only” for “Group” and “Others”.
   • Press the button “Apply to enclosed items”.

   

Now MEEG should be reachable at the address: http://localhost/~YourUserName/meeg.

Press the Manual button to continue the installation and start using MEEG.