MoodleDocs - User contributions [en]

Complete Install Packages for Mac OS X

2011-07-08T13:15:14Z

Krause: /* Look Inside ... */

Complete install packages for Mac OS X are available from [http://download.moodle.org/macosx/ Moodle Downloads] which uses '''MAMP'''. You will find a separate card for the Mac OS X downloads. They are designed for new and local installations on a Mac computer/server. There are other downloads for Linux, and Window Operating Systems that may involve more customization of configuration files.

The complete install packages for Mac OS X are named Moodle4Mac. These do not have sufficient security for public, production servers--only use for private, local testing purposes. These packages allow Moodle to be installed, along with the prerequisites that includes a web server, database and scripting language (Apache, MySQL and PHP in this case). Several versions of the complete install package are available. You will find versions for Intel based Macs and for older PPC based Macs. Please use the correct version for your processor. The instructions on the download page provide guidance on which version is likely to be most suitable.

'''Note 1:''' The latest complete install package version components, may not be backwardly compatible. Always check version compatibility of each component if you intend to develop materials on a later version of Moodle than the version installed on your "main" Moodle site. In short, complete install packages are designed for first time install on a "clean" machine.

'''Note 2:''' If you want a secure, public server with OS X, you may be interested to use the normal web server that comes preinstalled with every Mac Computer--see the [[Step-by-step Guide for Installing Moodle on Mac OS X 10.4 Client]] for Moodle. However, remember that the complete package Moodle4Mac is ready to use and no additional programs must be installed and configured together.

==System requirements==
+ Apple Mac Computer
+ iMac, Mac mini, MacBook, iBook, PowerBook, Mac Pro, Xserve
+ Processor: Intel Core 2 Duo or PPC (G4, G5)
+ RAM: 1 GB or better
+ Hard Disk: 500 MB free
+ System Software: Mac OS X 10.4, 10.5, or 10.6

==Install complete package Moodle4Mac==
===Download and install Moodle4Mac===
'''Step 1:''' [http://download.moodle.org/macosx/ Download] the zipped disk image file from the Moodle download page. Please choose the correct file for your processor type. The zip archive should be unzipped automatically when the download is complete. If the download file is not unzipped please do this manually.

'''Step 2:''' Doubleclick the file Moodle4Mac.dmg to mount the installation disk.

[[Image:Moodle4Mac_1.png]]

'''Step 3:''' Move the folder '''MAMP''' into the folder '''Applications'''. Moodle4Mac is based on MAMP (Mac, Apache, MySQL, PHP). MAMP makes no entries in any registry and no settings for the system variables. If you want to know more about MAMP please read the project page http://mamp.info/

'''Step 4:''' Now you are ready to start your web server. Go to the Applications folder. Find the MAMP folder and open it.

[[Image:Moodle4Mac_2.png]]

'''Step 5:''' Doubleclick the icon MAMP to start the server.

[[Image:Moodle4Mac_4.png]]

'''Step 6:''' Start your browser and type <nowiki> http://127.0.0.1:8888 or http://localhost:8888 </nowiki> in the address bar. You will start your preinstalled Moodle. You do not need to do any installation. You are ready. Done ... hey, that was easy, wasn't it??

[[Image:Moodle4Mac_3.jpg]]

'''Step 7:''' Please login with the username '''admin''' and the password '''12345''' and you will be the main administrator of your new local Moodle.

==Using Moodle4Mac as a local server in your network==

In some workshops we used Moodle4Mac as a quick server installation for our local network. You should change the admin passwords (Moodle and MySQL) before you do this. There are only two steps to get the server connection from every computer in your network. One step is the change of only one line in the Moodle config.php, and the second step is that you must open the firewall of the Mac OS X. This chapter shows how you can do this.

===Edit the file config.php===

Use the current ip address of your computer instead of localhost so an external computer can connect the the web server. If your network is configured to dynamic ip addresses via DHCP please make sure that your computer retains its ip address while you want to use it as a Moodle server.The best thing would be to get a static ip address for your computer. Mostly your ip address in a local network will show one of the following numbers 10.x.x.x, 172.x.x.x, or 192.168.x.x

If your computer for example has the ip address 192.168.0.20 then you must change the configuration from ''localhost'' to ''192.168.0.20''. In the following box you will see this address in the line $CFG->wwwroot. This ip address will be different in your own network. You must use own address for your own network!! Please do not use an ip address if you do not know what you are doing ... ask your network administrator.

<pre><?php /// Moodle Configuration File

unset($CFG);

$CFG->dbtype = 'mysql';
$CFG->dbhost = 'localhost';
$CFG->dbname = 'moodle20';
$CFG->dbuser = 'moodle';
$CFG->dbpass = 'moodle';
$CFG->dbpersist = false;
$CFG->prefix = 'mdl_';
$CFG->dboptions = array ('dbpersit' => 0, );

// Use the ip address of your computer instead of localhost
$CFG->wwwroot = 'http://192.168.0.20:8888/moodle20';
$CFG->dirroot = '/Applications/MAMP/htdocs/moodle20';
$CFG->dataroot = '/Applications/MAMP/data/moodle20';
$CFG->admin = 'admin';

$CFG->passwordsaltmain = 'some_very_long_secret!#A12345678901234567890!';
$CFG->directorypermissions = 00777; // try 02777 on a server in Safe Mode

require_once("$CFG->dirroot/lib/setup.php");

// There is no php closing tag in this file,
// it is intentional because it prevents trailing whitespace problems!
</pre>

===Open the firewall===
The web server that comes together with Moodle4Mac works on the TCP port 8888. Moodle4Mac uses this port because this gets no conflicts with the normal web server of Mac OS X that answers on TCP port 80. You can switch the port from 8888 to 80 but you must know the administration password of your Mac. In this case the normal web server will not work.

To open the firewall please go to '''System Preferences > Sharing > Firewall'''. Choose '''New...''', fill in TCP port 8888, and set the rule name '''Moodle4Mac'''.

[[Image:Moodle4Mac_Firewall1.png]]

When the rule exists it must be activated to get a connection to Moodle from any computer in your internal network.

[[Image:Moodle4Mac_Firewall2.png]]

===Connect Moodle from your network ...===
Your web server can be connected with the url http://x.x.x.x:8888/moodle18/ in your local network, where x.x.x.x is the address your Mac was given by the local router on your LAN. Usually such numbers start with 10.x.x.x, 172.x.x.x, or 192.168.x.x. All users from any computer in your network can use your Moodle via this address.

This also works if your computer is connected to the internet directly. If you open the firewall in your internet router and if you forward the port 8888 to your computer then any user everywhere on the world would be able to work with your Moodle ... but please remember also that there are a lot of security risks if you do this ... it would be better if you don't do this!!

[[Image:Moodle4Mac_Network1.png]]

[[Image:Moodle4Mac_Network2.png]]

==Some words about the security ...==
===MAMP is designed for local computers===
MAMP can be used for testing and developing websites locally on their Apple computers. MAMP should not be used in a production environment because everybody knows all the settings and all the predefined passwords. It's prepared for an easy start and not for a public web server!! But with some careful modfications, you can sufficiently secure MAMP and Moodle4Mac to use them in public development environments.

===How to secure MAMP?===
I found some ideas in the following document: [http://www.network0.org/2006/09/23/how-to-secure-mamp/ How to secure MAMP?]. It's really old and some of the instructions are not correct for the current version.

There is also a new package MAMP Pro that will let you do a lot of settings for a more secure web server. Please look to the web page for this product. You can find a describtion for MAMP Pro on the [http://www.living-e.com/MAMP-PRO/ MAMP internet server]. It's commertial and not free!

===Step by step to secure Moodle4Mac===

  
==How to set up SSL/https in MAMP for a development/test environment==
The text is copied from [http://www.webopius.com/content/355/getting-mamp-working-with-ssl-on-os-x webopius web site] (excepted the last steps).

#stop MAMP
#backup your /Applications/MAMP/conf folder
#open a terminal
#enter: ''openssl genrsa -des3 -out server.key 1024''. Enter a password twice.
#enter: ''openssl req -new -key server.key -out server.csr''. Enter the previous password. You need to answer some questions. ''Common name'' expects your local name (for me it was jerome.moodle.local)
#enter: ''openssl x509 -req -days 365 -in server.csr -signkey server.key -out server.crt''
#enter: ''cp server.key server.tmp''
#enter: ''openssl rsa -in server.tmp -out server.key''. Enter the previous password.
#enter: ''mkdir /Applications/MAMP/conf/ssl''
#enter: cp server.crt /Applications/MAMP/conf/ssl
#enter: cp server.key /Applications/MAMP/conf/ssl
# Edit Applications/MAMP/conf/apache/ssl.conf:
##comment <IfDefine SSL> tag to closing tag (but not the content)
##SSLCertificateFile /Applications/MAMP/conf/ssl/server.crt
##SSLCertificateKeyFile /Applications/MAMP/conf/ssl/server.key
# Edit /Applications/MAMP/conf/apache/httpd.conf:
##Listen 80
##comment <IfDefine SSL> tag to closing tag (but not the content)
# Edit /Application/MAMP/conf/apache/ssl.conf, change the document root (DocumentRoot) for the one you have into /Application/MAMP/conf/apache/httpd.conf
#in a terminal enter: ''cd /Applications/MAMP/bin/apache2/bin''
#enter: ''sudo ./apachectl startssl''
#start MAMP

From now MAMP should start/stop with the SSL support activated. Note that these steps have only be tested with Apache port set to 80 into MAMP preferences.

==How To Update Your Moodle4Mac==

It is very simple to update your locally installed Moodle. If you have got this course together with Moodle4Mac then you should have everything you need for a CVS update.

The only software you must have installed on your Apple computer is the Xcode Tools package from your system installation media. After this it only needs a doubleclick to get the newest Moodle version without downloading the complete installation package.

===Update the local Moodle via CVS===

Be sure that the Xcode Tools are installed on your Mac computer. You also must have an internet connection to get the files from the update server.

Now the only thing you need to do is to doubleclick on an icon inside your MAMP folder. That's all .... really .... it's easy!!

Please look for the document '''UpdateMoodle.sh'''. If you doubleclick this file you will see that the system utility '''Terminal''' opens and the update process starts automatically. You must allow to connect to the Moodle internet server ... but think about this fact only if a system tool asks you.

[[Image:Moodle4Mac_Update1.png]]

The update tool CVS connects to the Moodle internet server and looks for all those files that must be downloaded. If the process asks for a password you press the return button to enter ... the password is "empty". The update needs a few moments to find all the updated or new files but then only those files are transfered. Please wait for some minutes.

[[Image:Moodle4Mac_Update2.png]]

Every updated file is shown in the update log so you can control if the updater works and when it is completed. At least you will see the config.php because this file does not come from the update server.

If the update takes too long you may break with <strg>-C. It doesn't matter because only text files are copied. On break the process stops working. If you restart the update again the CVS tool runs through all folders and files again to find those that need to be renewed.

===Look Inside ... ===

If you want to see what is inside the document '''UpdateMoodle.sh''' please feel free to open it with a text editor. It is only a text file but it uses the Mac OS X feature to open a file with a chosen program via doubleclick.

[[Image:Moodle4Mac_Update3.png]]

I chose the system utility '''Terminal''' to open the file '''UpdateMoodle.sh''' and to run the script it contains automatically. So everything can be done with a doubleclick. It's easy and everybody can do it!!

<pre>
#! /bin/sh
#
# This CVS updater for Mac OS X is part
# of the installation package Moodle4Mac
#
# 20110708 - Ralf Krause
#

export CVS_RSH=ssh

echo
echo "+--------------------------------------------+"
echo "| CVS update for your local Moodle server "
echo "+--------------------------------------------+"
echo

### file ~/.cvspass must exist
if ! test -e ~/.cvspass ; then
touch ~/.cvspass
fi

cd /Applications/MAMP/htdocs/moodle21/

### login to the cvs server only for the first time
if ! grep "uk.cvs.moodle.org" ~/.cvspass > /dev/null ; then
echo "CVS password is empty ... please only press <return> to start"
cvs -d :pserver:anonymous@uk.cvs.moodle.org:/cvsroot/moodle login
echo
fi

echo "Connecting to the CVS server. Download will take a few moments!"
echo "If the CVS update runs too long you may break with <strg>-C"
echo
cvs -q update -dP -r MOODLE_21_STABLE

</pre>

The different versions of the update script are different in only two things ... first you need to choose the correct folder for the Moodle files and seconds you must input the correct CVS tag for the Moodle version in the last line. The shown script is for updating the version Moodle 2.1
* Moodle 1.6 uses MOODLE_16_STABLE
* Moodle 1.7 uses MOODLE_17_STABLE
* Moodle 1.8 uses MOODLE_18_STABLE
* Moodle 1.9 uses MOODLE_19_STABLE
* Moodle 2.0 uses MOODLE_20_STABLE
* Moodle 2.1 uses MOODLE_21_STABLE
* Moodle 2.2dev uses HEAD

===Install Xcode Tools on your Mac===

Xcode Tools is the developer tools package for Mac OS X. This package includes an integrated suite of software development tools, including compilers and applications.

If you do not know whether the Xcode Tools are installed on your Mac please look on your main harddrive. If there is a folder named Developer then you must do nothing.

[[Image:Moodle4Mac_Update4.png]]

If you cannot find this on your harddrive then you must install this package before following the instructions in this document. The Xcode Tools package is part of the Mac OS X installation media. You will find the Xcode Tools on your installation CD or DVD set.

[[Image:Moodle4Mac_Update5.png]]

If you do not find your installation media anymore you also can download the Xcode Tools from the URL http://developer.apple.com/tools/xcode/. It is free but you have to register as a developer. If you start the download from there please remember that the Xcode package brings a lot of bytes and will need a very few minutes to complete.

After you have put these things into your system you will see a new folder named Developer on your harddisk. If you only want to update your Moodle you do not need all these nice developer tools from the inside of the folder. Sorry about this but there is no separate installer for the CVS update process.
  

==See also==
* [http://mamp.info MAMP = Mac + Apache + MySQL + PHP]
* [http://en.wikipedia.org/wiki/MAMP MAMP in Wikipedia]
* [[Step by Step Installation on a Mac OS X Server|Step by Step Installation on a Mac OS X Server 10.5/10.6]]
* [[Step-by-step Guide for Installing Moodle on Mac OS X 10.4 Client|Step by step Installation on a Mac OS X Client 10.4]]
* [[CVS for Administrators]]

* [http://en.wikipedia.org/wiki/Private_network Private network addresses in Wikipedia]
* [http://moodle.org/mod/forum/discuss.php?d=24632 Using Moodle: Dynamic DNS Home Server]

* [[Configuring aspell on Mac OS X]]

[[Category:Administrator]]
[[Category:Installation]]
[[Category:Mac OS X]]

[[de:Vollständiges Installationspaket für Mac OS X]]

Complete Install Packages for Mac OS X

2011-07-08T13:14:26Z

Krause: /* Look Inside ... */

Complete install packages for Mac OS X are available from [http://download.moodle.org/macosx/ Moodle Downloads] which uses '''MAMP'''. You will find a separate card for the Mac OS X downloads. They are designed for new and local installations on a Mac computer/server. There are other downloads for Linux, and Window Operating Systems that may involve more customization of configuration files.

The complete install packages for Mac OS X are named Moodle4Mac. These do not have sufficient security for public, production servers--only use for private, local testing purposes. These packages allow Moodle to be installed, along with the prerequisites that includes a web server, database and scripting language (Apache, MySQL and PHP in this case). Several versions of the complete install package are available. You will find versions for Intel based Macs and for older PPC based Macs. Please use the correct version for your processor. The instructions on the download page provide guidance on which version is likely to be most suitable.

'''Note 1:''' The latest complete install package version components, may not be backwardly compatible. Always check version compatibility of each component if you intend to develop materials on a later version of Moodle than the version installed on your "main" Moodle site. In short, complete install packages are designed for first time install on a "clean" machine.

'''Note 2:''' If you want a secure, public server with OS X, you may be interested to use the normal web server that comes preinstalled with every Mac Computer--see the [[Step-by-step Guide for Installing Moodle on Mac OS X 10.4 Client]] for Moodle. However, remember that the complete package Moodle4Mac is ready to use and no additional programs must be installed and configured together.

==System requirements==
+ Apple Mac Computer
+ iMac, Mac mini, MacBook, iBook, PowerBook, Mac Pro, Xserve
+ Processor: Intel Core 2 Duo or PPC (G4, G5)
+ RAM: 1 GB or better
+ Hard Disk: 500 MB free
+ System Software: Mac OS X 10.4, 10.5, or 10.6

==Install complete package Moodle4Mac==
===Download and install Moodle4Mac===
'''Step 1:''' [http://download.moodle.org/macosx/ Download] the zipped disk image file from the Moodle download page. Please choose the correct file for your processor type. The zip archive should be unzipped automatically when the download is complete. If the download file is not unzipped please do this manually.

'''Step 2:''' Doubleclick the file Moodle4Mac.dmg to mount the installation disk.

[[Image:Moodle4Mac_1.png]]

'''Step 3:''' Move the folder '''MAMP''' into the folder '''Applications'''. Moodle4Mac is based on MAMP (Mac, Apache, MySQL, PHP). MAMP makes no entries in any registry and no settings for the system variables. If you want to know more about MAMP please read the project page http://mamp.info/

'''Step 4:''' Now you are ready to start your web server. Go to the Applications folder. Find the MAMP folder and open it.

[[Image:Moodle4Mac_2.png]]

'''Step 5:''' Doubleclick the icon MAMP to start the server.

[[Image:Moodle4Mac_4.png]]

'''Step 6:''' Start your browser and type <nowiki> http://127.0.0.1:8888 or http://localhost:8888 </nowiki> in the address bar. You will start your preinstalled Moodle. You do not need to do any installation. You are ready. Done ... hey, that was easy, wasn't it??

[[Image:Moodle4Mac_3.jpg]]

'''Step 7:''' Please login with the username '''admin''' and the password '''12345''' and you will be the main administrator of your new local Moodle.

==Using Moodle4Mac as a local server in your network==

In some workshops we used Moodle4Mac as a quick server installation for our local network. You should change the admin passwords (Moodle and MySQL) before you do this. There are only two steps to get the server connection from every computer in your network. One step is the change of only one line in the Moodle config.php, and the second step is that you must open the firewall of the Mac OS X. This chapter shows how you can do this.

===Edit the file config.php===

Use the current ip address of your computer instead of localhost so an external computer can connect the the web server. If your network is configured to dynamic ip addresses via DHCP please make sure that your computer retains its ip address while you want to use it as a Moodle server.The best thing would be to get a static ip address for your computer. Mostly your ip address in a local network will show one of the following numbers 10.x.x.x, 172.x.x.x, or 192.168.x.x

If your computer for example has the ip address 192.168.0.20 then you must change the configuration from ''localhost'' to ''192.168.0.20''. In the following box you will see this address in the line $CFG->wwwroot. This ip address will be different in your own network. You must use own address for your own network!! Please do not use an ip address if you do not know what you are doing ... ask your network administrator.

<pre><?php /// Moodle Configuration File

unset($CFG);

$CFG->dbtype = 'mysql';
$CFG->dbhost = 'localhost';
$CFG->dbname = 'moodle20';
$CFG->dbuser = 'moodle';
$CFG->dbpass = 'moodle';
$CFG->dbpersist = false;
$CFG->prefix = 'mdl_';
$CFG->dboptions = array ('dbpersit' => 0, );

// Use the ip address of your computer instead of localhost
$CFG->wwwroot = 'http://192.168.0.20:8888/moodle20';
$CFG->dirroot = '/Applications/MAMP/htdocs/moodle20';
$CFG->dataroot = '/Applications/MAMP/data/moodle20';
$CFG->admin = 'admin';

$CFG->passwordsaltmain = 'some_very_long_secret!#A12345678901234567890!';
$CFG->directorypermissions = 00777; // try 02777 on a server in Safe Mode

require_once("$CFG->dirroot/lib/setup.php");

// There is no php closing tag in this file,
// it is intentional because it prevents trailing whitespace problems!
</pre>

===Open the firewall===
The web server that comes together with Moodle4Mac works on the TCP port 8888. Moodle4Mac uses this port because this gets no conflicts with the normal web server of Mac OS X that answers on TCP port 80. You can switch the port from 8888 to 80 but you must know the administration password of your Mac. In this case the normal web server will not work.

To open the firewall please go to '''System Preferences > Sharing > Firewall'''. Choose '''New...''', fill in TCP port 8888, and set the rule name '''Moodle4Mac'''.

[[Image:Moodle4Mac_Firewall1.png]]

When the rule exists it must be activated to get a connection to Moodle from any computer in your internal network.

[[Image:Moodle4Mac_Firewall2.png]]

===Connect Moodle from your network ...===
Your web server can be connected with the url http://x.x.x.x:8888/moodle18/ in your local network, where x.x.x.x is the address your Mac was given by the local router on your LAN. Usually such numbers start with 10.x.x.x, 172.x.x.x, or 192.168.x.x. All users from any computer in your network can use your Moodle via this address.

This also works if your computer is connected to the internet directly. If you open the firewall in your internet router and if you forward the port 8888 to your computer then any user everywhere on the world would be able to work with your Moodle ... but please remember also that there are a lot of security risks if you do this ... it would be better if you don't do this!!

[[Image:Moodle4Mac_Network1.png]]

[[Image:Moodle4Mac_Network2.png]]

==Some words about the security ...==
===MAMP is designed for local computers===
MAMP can be used for testing and developing websites locally on their Apple computers. MAMP should not be used in a production environment because everybody knows all the settings and all the predefined passwords. It's prepared for an easy start and not for a public web server!! But with some careful modfications, you can sufficiently secure MAMP and Moodle4Mac to use them in public development environments.

===How to secure MAMP?===
I found some ideas in the following document: [http://www.network0.org/2006/09/23/how-to-secure-mamp/ How to secure MAMP?]. It's really old and some of the instructions are not correct for the current version.

There is also a new package MAMP Pro that will let you do a lot of settings for a more secure web server. Please look to the web page for this product. You can find a describtion for MAMP Pro on the [http://www.living-e.com/MAMP-PRO/ MAMP internet server]. It's commertial and not free!

===Step by step to secure Moodle4Mac===

  
==How to set up SSL/https in MAMP for a development/test environment==
The text is copied from [http://www.webopius.com/content/355/getting-mamp-working-with-ssl-on-os-x webopius web site] (excepted the last steps).

#stop MAMP
#backup your /Applications/MAMP/conf folder
#open a terminal
#enter: ''openssl genrsa -des3 -out server.key 1024''. Enter a password twice.
#enter: ''openssl req -new -key server.key -out server.csr''. Enter the previous password. You need to answer some questions. ''Common name'' expects your local name (for me it was jerome.moodle.local)
#enter: ''openssl x509 -req -days 365 -in server.csr -signkey server.key -out server.crt''
#enter: ''cp server.key server.tmp''
#enter: ''openssl rsa -in server.tmp -out server.key''. Enter the previous password.
#enter: ''mkdir /Applications/MAMP/conf/ssl''
#enter: cp server.crt /Applications/MAMP/conf/ssl
#enter: cp server.key /Applications/MAMP/conf/ssl
# Edit Applications/MAMP/conf/apache/ssl.conf:
##comment <IfDefine SSL> tag to closing tag (but not the content)
##SSLCertificateFile /Applications/MAMP/conf/ssl/server.crt
##SSLCertificateKeyFile /Applications/MAMP/conf/ssl/server.key
# Edit /Applications/MAMP/conf/apache/httpd.conf:
##Listen 80
##comment <IfDefine SSL> tag to closing tag (but not the content)
# Edit /Application/MAMP/conf/apache/ssl.conf, change the document root (DocumentRoot) for the one you have into /Application/MAMP/conf/apache/httpd.conf
#in a terminal enter: ''cd /Applications/MAMP/bin/apache2/bin''
#enter: ''sudo ./apachectl startssl''
#start MAMP

From now MAMP should start/stop with the SSL support activated. Note that these steps have only be tested with Apache port set to 80 into MAMP preferences.

==How To Update Your Moodle4Mac==

It is very simple to update your locally installed Moodle. If you have got this course together with Moodle4Mac then you should have everything you need for a CVS update.

The only software you must have installed on your Apple computer is the Xcode Tools package from your system installation media. After this it only needs a doubleclick to get the newest Moodle version without downloading the complete installation package.

===Update the local Moodle via CVS===

Be sure that the Xcode Tools are installed on your Mac computer. You also must have an internet connection to get the files from the update server.

Now the only thing you need to do is to doubleclick on an icon inside your MAMP folder. That's all .... really .... it's easy!!

Please look for the document '''UpdateMoodle.sh'''. If you doubleclick this file you will see that the system utility '''Terminal''' opens and the update process starts automatically. You must allow to connect to the Moodle internet server ... but think about this fact only if a system tool asks you.

[[Image:Moodle4Mac_Update1.png]]

The update tool CVS connects to the Moodle internet server and looks for all those files that must be downloaded. If the process asks for a password you press the return button to enter ... the password is "empty". The update needs a few moments to find all the updated or new files but then only those files are transfered. Please wait for some minutes.

[[Image:Moodle4Mac_Update2.png]]

Every updated file is shown in the update log so you can control if the updater works and when it is completed. At least you will see the config.php because this file does not come from the update server.

If the update takes too long you may break with <strg>-C. It doesn't matter because only text files are copied. On break the process stops working. If you restart the update again the CVS tool runs through all folders and files again to find those that need to be renewed.

===Look Inside ... ===

If you want to see what is inside the document '''UpdateMoodle.sh''' please feel free to open it with a text editor. It is only a text file but it uses the Mac OS X feature to open a file with a chosen program via doubleclick.

[[Image:Moodle4Mac_Update3.png]]

I chose the system utility '''Terminal''' to open the file '''UpdateMoodle.sh''' and to run the script it contains automatically. So everything can be done with a doubleclick. It's easy and everybody can do it!!

<pre>
#! /bin/sh
#
# This CVS updater for Mac OS X is part
# of the installation package Moodle4Mac
#
# 20110708 - Ralf Krause
#

export CVS_RSH=ssh

echo
echo "+--------------------------------------------+"
echo "| CVS update for your local Moodle server "
echo "+--------------------------------------------+"
echo

cd /Applications/MAMP/htdocs/moodle21/

### delete all files named .DS_Store
find . -name ".DS_Store" -type f -print0 | xargs -0 rm -f

### file ~/.cvspass must exist
if ! test -e ~/.cvspass ; then
touch ~/.cvspass
fi

### login to the cvs server only for the first time
if ! grep "uk.cvs.moodle.org" ~/.cvspass > /dev/null ; then
echo "CVS password is empty ... please only press <return> to start"
cvs -d :pserver:anonymous@uk.cvs.moodle.org:/cvsroot/moodle login
echo
fi

echo "Connecting to the CVS server. Download will take a few moments!"
echo "If the CVS update runs too long you may break with <strg>-C"
echo
cvs -q update -dP -r MOODLE_21_STABLE

</pre>

The different versions of the update script are different in only two things ... first you need to choose the correct folder for the Moodle files and seconds you must input the correct CVS tag for the Moodle version in the last line. The shown script is for updating the version Moodle 2.1
* Moodle 1.6 uses MOODLE_16_STABLE
* Moodle 1.7 uses MOODLE_17_STABLE
* Moodle 1.8 uses MOODLE_18_STABLE
* Moodle 1.9 uses MOODLE_19_STABLE
* Moodle 2.0 uses MOODLE_20_STABLE
* Moodle 2.1 uses MOODLE_21_STABLE
* Moodle 2.2dev uses HEAD

===Install Xcode Tools on your Mac===

Xcode Tools is the developer tools package for Mac OS X. This package includes an integrated suite of software development tools, including compilers and applications.

If you do not know whether the Xcode Tools are installed on your Mac please look on your main harddrive. If there is a folder named Developer then you must do nothing.

[[Image:Moodle4Mac_Update4.png]]

If you cannot find this on your harddrive then you must install this package before following the instructions in this document. The Xcode Tools package is part of the Mac OS X installation media. You will find the Xcode Tools on your installation CD or DVD set.

[[Image:Moodle4Mac_Update5.png]]

If you do not find your installation media anymore you also can download the Xcode Tools from the URL http://developer.apple.com/tools/xcode/. It is free but you have to register as a developer. If you start the download from there please remember that the Xcode package brings a lot of bytes and will need a very few minutes to complete.

After you have put these things into your system you will see a new folder named Developer on your harddisk. If you only want to update your Moodle you do not need all these nice developer tools from the inside of the folder. Sorry about this but there is no separate installer for the CVS update process.
  

==See also==
* [http://mamp.info MAMP = Mac + Apache + MySQL + PHP]
* [http://en.wikipedia.org/wiki/MAMP MAMP in Wikipedia]
* [[Step by Step Installation on a Mac OS X Server|Step by Step Installation on a Mac OS X Server 10.5/10.6]]
* [[Step-by-step Guide for Installing Moodle on Mac OS X 10.4 Client|Step by step Installation on a Mac OS X Client 10.4]]
* [[CVS for Administrators]]

* [http://en.wikipedia.org/wiki/Private_network Private network addresses in Wikipedia]
* [http://moodle.org/mod/forum/discuss.php?d=24632 Using Moodle: Dynamic DNS Home Server]

* [[Configuring aspell on Mac OS X]]

[[Category:Administrator]]
[[Category:Installation]]
[[Category:Mac OS X]]

[[de:Vollständiges Installationspaket für Mac OS X]]

Complete Install Packages for Mac OS X

2011-07-08T13:14:03Z

Krause: /* Look Inside ... */

Complete install packages for Mac OS X are available from [http://download.moodle.org/macosx/ Moodle Downloads] which uses '''MAMP'''. You will find a separate card for the Mac OS X downloads. They are designed for new and local installations on a Mac computer/server. There are other downloads for Linux, and Window Operating Systems that may involve more customization of configuration files.

The complete install packages for Mac OS X are named Moodle4Mac. These do not have sufficient security for public, production servers--only use for private, local testing purposes. These packages allow Moodle to be installed, along with the prerequisites that includes a web server, database and scripting language (Apache, MySQL and PHP in this case). Several versions of the complete install package are available. You will find versions for Intel based Macs and for older PPC based Macs. Please use the correct version for your processor. The instructions on the download page provide guidance on which version is likely to be most suitable.

'''Note 1:''' The latest complete install package version components, may not be backwardly compatible. Always check version compatibility of each component if you intend to develop materials on a later version of Moodle than the version installed on your "main" Moodle site. In short, complete install packages are designed for first time install on a "clean" machine.

'''Note 2:''' If you want a secure, public server with OS X, you may be interested to use the normal web server that comes preinstalled with every Mac Computer--see the [[Step-by-step Guide for Installing Moodle on Mac OS X 10.4 Client]] for Moodle. However, remember that the complete package Moodle4Mac is ready to use and no additional programs must be installed and configured together.

==System requirements==
+ Apple Mac Computer
+ iMac, Mac mini, MacBook, iBook, PowerBook, Mac Pro, Xserve
+ Processor: Intel Core 2 Duo or PPC (G4, G5)
+ RAM: 1 GB or better
+ Hard Disk: 500 MB free
+ System Software: Mac OS X 10.4, 10.5, or 10.6

==Install complete package Moodle4Mac==
===Download and install Moodle4Mac===
'''Step 1:''' [http://download.moodle.org/macosx/ Download] the zipped disk image file from the Moodle download page. Please choose the correct file for your processor type. The zip archive should be unzipped automatically when the download is complete. If the download file is not unzipped please do this manually.

'''Step 2:''' Doubleclick the file Moodle4Mac.dmg to mount the installation disk.

[[Image:Moodle4Mac_1.png]]

'''Step 3:''' Move the folder '''MAMP''' into the folder '''Applications'''. Moodle4Mac is based on MAMP (Mac, Apache, MySQL, PHP). MAMP makes no entries in any registry and no settings for the system variables. If you want to know more about MAMP please read the project page http://mamp.info/

'''Step 4:''' Now you are ready to start your web server. Go to the Applications folder. Find the MAMP folder and open it.

[[Image:Moodle4Mac_2.png]]

'''Step 5:''' Doubleclick the icon MAMP to start the server.

[[Image:Moodle4Mac_4.png]]

'''Step 6:''' Start your browser and type <nowiki> http://127.0.0.1:8888 or http://localhost:8888 </nowiki> in the address bar. You will start your preinstalled Moodle. You do not need to do any installation. You are ready. Done ... hey, that was easy, wasn't it??

[[Image:Moodle4Mac_3.jpg]]

'''Step 7:''' Please login with the username '''admin''' and the password '''12345''' and you will be the main administrator of your new local Moodle.

==Using Moodle4Mac as a local server in your network==

In some workshops we used Moodle4Mac as a quick server installation for our local network. You should change the admin passwords (Moodle and MySQL) before you do this. There are only two steps to get the server connection from every computer in your network. One step is the change of only one line in the Moodle config.php, and the second step is that you must open the firewall of the Mac OS X. This chapter shows how you can do this.

===Edit the file config.php===

Use the current ip address of your computer instead of localhost so an external computer can connect the the web server. If your network is configured to dynamic ip addresses via DHCP please make sure that your computer retains its ip address while you want to use it as a Moodle server.The best thing would be to get a static ip address for your computer. Mostly your ip address in a local network will show one of the following numbers 10.x.x.x, 172.x.x.x, or 192.168.x.x

If your computer for example has the ip address 192.168.0.20 then you must change the configuration from ''localhost'' to ''192.168.0.20''. In the following box you will see this address in the line $CFG->wwwroot. This ip address will be different in your own network. You must use own address for your own network!! Please do not use an ip address if you do not know what you are doing ... ask your network administrator.

<pre><?php /// Moodle Configuration File

unset($CFG);

$CFG->dbtype = 'mysql';
$CFG->dbhost = 'localhost';
$CFG->dbname = 'moodle20';
$CFG->dbuser = 'moodle';
$CFG->dbpass = 'moodle';
$CFG->dbpersist = false;
$CFG->prefix = 'mdl_';
$CFG->dboptions = array ('dbpersit' => 0, );

// Use the ip address of your computer instead of localhost
$CFG->wwwroot = 'http://192.168.0.20:8888/moodle20';
$CFG->dirroot = '/Applications/MAMP/htdocs/moodle20';
$CFG->dataroot = '/Applications/MAMP/data/moodle20';
$CFG->admin = 'admin';

$CFG->passwordsaltmain = 'some_very_long_secret!#A12345678901234567890!';
$CFG->directorypermissions = 00777; // try 02777 on a server in Safe Mode

require_once("$CFG->dirroot/lib/setup.php");

// There is no php closing tag in this file,
// it is intentional because it prevents trailing whitespace problems!
</pre>

===Open the firewall===
The web server that comes together with Moodle4Mac works on the TCP port 8888. Moodle4Mac uses this port because this gets no conflicts with the normal web server of Mac OS X that answers on TCP port 80. You can switch the port from 8888 to 80 but you must know the administration password of your Mac. In this case the normal web server will not work.

To open the firewall please go to '''System Preferences > Sharing > Firewall'''. Choose '''New...''', fill in TCP port 8888, and set the rule name '''Moodle4Mac'''.

[[Image:Moodle4Mac_Firewall1.png]]

When the rule exists it must be activated to get a connection to Moodle from any computer in your internal network.

[[Image:Moodle4Mac_Firewall2.png]]

===Connect Moodle from your network ...===
Your web server can be connected with the url http://x.x.x.x:8888/moodle18/ in your local network, where x.x.x.x is the address your Mac was given by the local router on your LAN. Usually such numbers start with 10.x.x.x, 172.x.x.x, or 192.168.x.x. All users from any computer in your network can use your Moodle via this address.

This also works if your computer is connected to the internet directly. If you open the firewall in your internet router and if you forward the port 8888 to your computer then any user everywhere on the world would be able to work with your Moodle ... but please remember also that there are a lot of security risks if you do this ... it would be better if you don't do this!!

[[Image:Moodle4Mac_Network1.png]]

[[Image:Moodle4Mac_Network2.png]]

==Some words about the security ...==
===MAMP is designed for local computers===
MAMP can be used for testing and developing websites locally on their Apple computers. MAMP should not be used in a production environment because everybody knows all the settings and all the predefined passwords. It's prepared for an easy start and not for a public web server!! But with some careful modfications, you can sufficiently secure MAMP and Moodle4Mac to use them in public development environments.

===How to secure MAMP?===
I found some ideas in the following document: [http://www.network0.org/2006/09/23/how-to-secure-mamp/ How to secure MAMP?]. It's really old and some of the instructions are not correct for the current version.

There is also a new package MAMP Pro that will let you do a lot of settings for a more secure web server. Please look to the web page for this product. You can find a describtion for MAMP Pro on the [http://www.living-e.com/MAMP-PRO/ MAMP internet server]. It's commertial and not free!

===Step by step to secure Moodle4Mac===

  
==How to set up SSL/https in MAMP for a development/test environment==
The text is copied from [http://www.webopius.com/content/355/getting-mamp-working-with-ssl-on-os-x webopius web site] (excepted the last steps).

#stop MAMP
#backup your /Applications/MAMP/conf folder
#open a terminal
#enter: ''openssl genrsa -des3 -out server.key 1024''. Enter a password twice.
#enter: ''openssl req -new -key server.key -out server.csr''. Enter the previous password. You need to answer some questions. ''Common name'' expects your local name (for me it was jerome.moodle.local)
#enter: ''openssl x509 -req -days 365 -in server.csr -signkey server.key -out server.crt''
#enter: ''cp server.key server.tmp''
#enter: ''openssl rsa -in server.tmp -out server.key''. Enter the previous password.
#enter: ''mkdir /Applications/MAMP/conf/ssl''
#enter: cp server.crt /Applications/MAMP/conf/ssl
#enter: cp server.key /Applications/MAMP/conf/ssl
# Edit Applications/MAMP/conf/apache/ssl.conf:
##comment <IfDefine SSL> tag to closing tag (but not the content)
##SSLCertificateFile /Applications/MAMP/conf/ssl/server.crt
##SSLCertificateKeyFile /Applications/MAMP/conf/ssl/server.key
# Edit /Applications/MAMP/conf/apache/httpd.conf:
##Listen 80
##comment <IfDefine SSL> tag to closing tag (but not the content)
# Edit /Application/MAMP/conf/apache/ssl.conf, change the document root (DocumentRoot) for the one you have into /Application/MAMP/conf/apache/httpd.conf
#in a terminal enter: ''cd /Applications/MAMP/bin/apache2/bin''
#enter: ''sudo ./apachectl startssl''
#start MAMP

From now MAMP should start/stop with the SSL support activated. Note that these steps have only be tested with Apache port set to 80 into MAMP preferences.

==How To Update Your Moodle4Mac==

It is very simple to update your locally installed Moodle. If you have got this course together with Moodle4Mac then you should have everything you need for a CVS update.

The only software you must have installed on your Apple computer is the Xcode Tools package from your system installation media. After this it only needs a doubleclick to get the newest Moodle version without downloading the complete installation package.

===Update the local Moodle via CVS===

Be sure that the Xcode Tools are installed on your Mac computer. You also must have an internet connection to get the files from the update server.

Now the only thing you need to do is to doubleclick on an icon inside your MAMP folder. That's all .... really .... it's easy!!

Please look for the document '''UpdateMoodle.sh'''. If you doubleclick this file you will see that the system utility '''Terminal''' opens and the update process starts automatically. You must allow to connect to the Moodle internet server ... but think about this fact only if a system tool asks you.

[[Image:Moodle4Mac_Update1.png]]

The update tool CVS connects to the Moodle internet server and looks for all those files that must be downloaded. If the process asks for a password you press the return button to enter ... the password is "empty". The update needs a few moments to find all the updated or new files but then only those files are transfered. Please wait for some minutes.

[[Image:Moodle4Mac_Update2.png]]

Every updated file is shown in the update log so you can control if the updater works and when it is completed. At least you will see the config.php because this file does not come from the update server.

If the update takes too long you may break with <strg>-C. It doesn't matter because only text files are copied. On break the process stops working. If you restart the update again the CVS tool runs through all folders and files again to find those that need to be renewed.

===Look Inside ... ===

If you want to see what is inside the document '''UpdateMoodle.sh''' please feel free to open it with a text editor. It is only a text file but it uses the Mac OS X feature to open a file with a chosen program via doubleclick.

[[Image:Moodle4Mac_Update3.png]]

I chose the system utility '''Terminal''' to open the file '''UpdateMoodle.sh''' and to run the script it contains automatically. So everything can be done with a doubleclick. It's easy and everybody can do it!!

<pre>
#! /bin/sh
#
# This CVS updater for Mac OS X is part
# of the installation package Moodle4Mac
#
# 20110708 - Ralf Krause
#

export CVS_RSH=ssh

echo
echo "+--------------------------------------------+"
echo "| CVS update for your local Moodle server "
echo "+--------------------------------------------+"
echo

cd /Applications/MAMP/htdocs/moodle20/

### delete all files named .DS_Store
find . -name ".DS_Store" -type f -print0 | xargs -0 rm -f

### file ~/.cvspass must exist
if ! test -e ~/.cvspass ; then
touch ~/.cvspass
fi

### login to the cvs server only for the first time
if ! grep "uk.cvs.moodle.org" ~/.cvspass > /dev/null ; then
echo "CVS password is empty ... please only press <return> to start"
cvs -d :pserver:anonymous@uk.cvs.moodle.org:/cvsroot/moodle login
echo
fi

echo "Connecting to the CVS server. Download will take a few moments!"
echo "If the CVS update runs too long you may break with <strg>-C"
echo
cvs -q update -dP -r MOODLE_21_STABLE

</pre>

The different versions of the update script are different in only two things ... first you need to choose the correct folder for the Moodle files and seconds you must input the correct CVS tag for the Moodle version in the last line. The shown script is for updating the version Moodle 2.1
* Moodle 1.6 uses MOODLE_16_STABLE
* Moodle 1.7 uses MOODLE_17_STABLE
* Moodle 1.8 uses MOODLE_18_STABLE
* Moodle 1.9 uses MOODLE_19_STABLE
* Moodle 2.0 uses MOODLE_20_STABLE
* Moodle 2.1 uses MOODLE_21_STABLE
* Moodle 2.2dev uses HEAD

===Install Xcode Tools on your Mac===

Xcode Tools is the developer tools package for Mac OS X. This package includes an integrated suite of software development tools, including compilers and applications.

If you do not know whether the Xcode Tools are installed on your Mac please look on your main harddrive. If there is a folder named Developer then you must do nothing.

[[Image:Moodle4Mac_Update4.png]]

If you cannot find this on your harddrive then you must install this package before following the instructions in this document. The Xcode Tools package is part of the Mac OS X installation media. You will find the Xcode Tools on your installation CD or DVD set.

[[Image:Moodle4Mac_Update5.png]]

If you do not find your installation media anymore you also can download the Xcode Tools from the URL http://developer.apple.com/tools/xcode/. It is free but you have to register as a developer. If you start the download from there please remember that the Xcode package brings a lot of bytes and will need a very few minutes to complete.

After you have put these things into your system you will see a new folder named Developer on your harddisk. If you only want to update your Moodle you do not need all these nice developer tools from the inside of the folder. Sorry about this but there is no separate installer for the CVS update process.
  

==See also==
* [http://mamp.info MAMP = Mac + Apache + MySQL + PHP]
* [http://en.wikipedia.org/wiki/MAMP MAMP in Wikipedia]
* [[Step by Step Installation on a Mac OS X Server|Step by Step Installation on a Mac OS X Server 10.5/10.6]]
* [[Step-by-step Guide for Installing Moodle on Mac OS X 10.4 Client|Step by step Installation on a Mac OS X Client 10.4]]
* [[CVS for Administrators]]

* [http://en.wikipedia.org/wiki/Private_network Private network addresses in Wikipedia]
* [http://moodle.org/mod/forum/discuss.php?d=24632 Using Moodle: Dynamic DNS Home Server]

* [[Configuring aspell on Mac OS X]]

[[Category:Administrator]]
[[Category:Installation]]
[[Category:Mac OS X]]

[[de:Vollständiges Installationspaket für Mac OS X]]

Complete Install Packages for Mac OS X

2011-07-08T13:10:52Z

Krause: /* Look Inside ... */

Complete install packages for Mac OS X are available from [http://download.moodle.org/macosx/ Moodle Downloads] which uses '''MAMP'''. You will find a separate card for the Mac OS X downloads. They are designed for new and local installations on a Mac computer/server. There are other downloads for Linux, and Window Operating Systems that may involve more customization of configuration files.

The complete install packages for Mac OS X are named Moodle4Mac. These do not have sufficient security for public, production servers--only use for private, local testing purposes. These packages allow Moodle to be installed, along with the prerequisites that includes a web server, database and scripting language (Apache, MySQL and PHP in this case). Several versions of the complete install package are available. You will find versions for Intel based Macs and for older PPC based Macs. Please use the correct version for your processor. The instructions on the download page provide guidance on which version is likely to be most suitable.

'''Note 1:''' The latest complete install package version components, may not be backwardly compatible. Always check version compatibility of each component if you intend to develop materials on a later version of Moodle than the version installed on your "main" Moodle site. In short, complete install packages are designed for first time install on a "clean" machine.

'''Note 2:''' If you want a secure, public server with OS X, you may be interested to use the normal web server that comes preinstalled with every Mac Computer--see the [[Step-by-step Guide for Installing Moodle on Mac OS X 10.4 Client]] for Moodle. However, remember that the complete package Moodle4Mac is ready to use and no additional programs must be installed and configured together.

==System requirements==
+ Apple Mac Computer
+ iMac, Mac mini, MacBook, iBook, PowerBook, Mac Pro, Xserve
+ Processor: Intel Core 2 Duo or PPC (G4, G5)
+ RAM: 1 GB or better
+ Hard Disk: 500 MB free
+ System Software: Mac OS X 10.4, 10.5, or 10.6

==Install complete package Moodle4Mac==
===Download and install Moodle4Mac===
'''Step 1:''' [http://download.moodle.org/macosx/ Download] the zipped disk image file from the Moodle download page. Please choose the correct file for your processor type. The zip archive should be unzipped automatically when the download is complete. If the download file is not unzipped please do this manually.

'''Step 2:''' Doubleclick the file Moodle4Mac.dmg to mount the installation disk.

[[Image:Moodle4Mac_1.png]]

'''Step 3:''' Move the folder '''MAMP''' into the folder '''Applications'''. Moodle4Mac is based on MAMP (Mac, Apache, MySQL, PHP). MAMP makes no entries in any registry and no settings for the system variables. If you want to know more about MAMP please read the project page http://mamp.info/

'''Step 4:''' Now you are ready to start your web server. Go to the Applications folder. Find the MAMP folder and open it.

[[Image:Moodle4Mac_2.png]]

'''Step 5:''' Doubleclick the icon MAMP to start the server.

[[Image:Moodle4Mac_4.png]]

'''Step 6:''' Start your browser and type <nowiki> http://127.0.0.1:8888 or http://localhost:8888 </nowiki> in the address bar. You will start your preinstalled Moodle. You do not need to do any installation. You are ready. Done ... hey, that was easy, wasn't it??

[[Image:Moodle4Mac_3.jpg]]

'''Step 7:''' Please login with the username '''admin''' and the password '''12345''' and you will be the main administrator of your new local Moodle.

==Using Moodle4Mac as a local server in your network==

In some workshops we used Moodle4Mac as a quick server installation for our local network. You should change the admin passwords (Moodle and MySQL) before you do this. There are only two steps to get the server connection from every computer in your network. One step is the change of only one line in the Moodle config.php, and the second step is that you must open the firewall of the Mac OS X. This chapter shows how you can do this.

===Edit the file config.php===

Use the current ip address of your computer instead of localhost so an external computer can connect the the web server. If your network is configured to dynamic ip addresses via DHCP please make sure that your computer retains its ip address while you want to use it as a Moodle server.The best thing would be to get a static ip address for your computer. Mostly your ip address in a local network will show one of the following numbers 10.x.x.x, 172.x.x.x, or 192.168.x.x

If your computer for example has the ip address 192.168.0.20 then you must change the configuration from ''localhost'' to ''192.168.0.20''. In the following box you will see this address in the line $CFG->wwwroot. This ip address will be different in your own network. You must use own address for your own network!! Please do not use an ip address if you do not know what you are doing ... ask your network administrator.

<pre><?php /// Moodle Configuration File

unset($CFG);

$CFG->dbtype = 'mysql';
$CFG->dbhost = 'localhost';
$CFG->dbname = 'moodle20';
$CFG->dbuser = 'moodle';
$CFG->dbpass = 'moodle';
$CFG->dbpersist = false;
$CFG->prefix = 'mdl_';
$CFG->dboptions = array ('dbpersit' => 0, );

// Use the ip address of your computer instead of localhost
$CFG->wwwroot = 'http://192.168.0.20:8888/moodle20';
$CFG->dirroot = '/Applications/MAMP/htdocs/moodle20';
$CFG->dataroot = '/Applications/MAMP/data/moodle20';
$CFG->admin = 'admin';

$CFG->passwordsaltmain = 'some_very_long_secret!#A12345678901234567890!';
$CFG->directorypermissions = 00777; // try 02777 on a server in Safe Mode

require_once("$CFG->dirroot/lib/setup.php");

// There is no php closing tag in this file,
// it is intentional because it prevents trailing whitespace problems!
</pre>

===Open the firewall===
The web server that comes together with Moodle4Mac works on the TCP port 8888. Moodle4Mac uses this port because this gets no conflicts with the normal web server of Mac OS X that answers on TCP port 80. You can switch the port from 8888 to 80 but you must know the administration password of your Mac. In this case the normal web server will not work.

To open the firewall please go to '''System Preferences > Sharing > Firewall'''. Choose '''New...''', fill in TCP port 8888, and set the rule name '''Moodle4Mac'''.

[[Image:Moodle4Mac_Firewall1.png]]

When the rule exists it must be activated to get a connection to Moodle from any computer in your internal network.

[[Image:Moodle4Mac_Firewall2.png]]

===Connect Moodle from your network ...===
Your web server can be connected with the url http://x.x.x.x:8888/moodle18/ in your local network, where x.x.x.x is the address your Mac was given by the local router on your LAN. Usually such numbers start with 10.x.x.x, 172.x.x.x, or 192.168.x.x. All users from any computer in your network can use your Moodle via this address.

This also works if your computer is connected to the internet directly. If you open the firewall in your internet router and if you forward the port 8888 to your computer then any user everywhere on the world would be able to work with your Moodle ... but please remember also that there are a lot of security risks if you do this ... it would be better if you don't do this!!

[[Image:Moodle4Mac_Network1.png]]

[[Image:Moodle4Mac_Network2.png]]

==Some words about the security ...==
===MAMP is designed for local computers===
MAMP can be used for testing and developing websites locally on their Apple computers. MAMP should not be used in a production environment because everybody knows all the settings and all the predefined passwords. It's prepared for an easy start and not for a public web server!! But with some careful modfications, you can sufficiently secure MAMP and Moodle4Mac to use them in public development environments.

===How to secure MAMP?===
I found some ideas in the following document: [http://www.network0.org/2006/09/23/how-to-secure-mamp/ How to secure MAMP?]. It's really old and some of the instructions are not correct for the current version.

There is also a new package MAMP Pro that will let you do a lot of settings for a more secure web server. Please look to the web page for this product. You can find a describtion for MAMP Pro on the [http://www.living-e.com/MAMP-PRO/ MAMP internet server]. It's commertial and not free!

===Step by step to secure Moodle4Mac===

  
==How to set up SSL/https in MAMP for a development/test environment==
The text is copied from [http://www.webopius.com/content/355/getting-mamp-working-with-ssl-on-os-x webopius web site] (excepted the last steps).

#stop MAMP
#backup your /Applications/MAMP/conf folder
#open a terminal
#enter: ''openssl genrsa -des3 -out server.key 1024''. Enter a password twice.
#enter: ''openssl req -new -key server.key -out server.csr''. Enter the previous password. You need to answer some questions. ''Common name'' expects your local name (for me it was jerome.moodle.local)
#enter: ''openssl x509 -req -days 365 -in server.csr -signkey server.key -out server.crt''
#enter: ''cp server.key server.tmp''
#enter: ''openssl rsa -in server.tmp -out server.key''. Enter the previous password.
#enter: ''mkdir /Applications/MAMP/conf/ssl''
#enter: cp server.crt /Applications/MAMP/conf/ssl
#enter: cp server.key /Applications/MAMP/conf/ssl
# Edit Applications/MAMP/conf/apache/ssl.conf:
##comment <IfDefine SSL> tag to closing tag (but not the content)
##SSLCertificateFile /Applications/MAMP/conf/ssl/server.crt
##SSLCertificateKeyFile /Applications/MAMP/conf/ssl/server.key
# Edit /Applications/MAMP/conf/apache/httpd.conf:
##Listen 80
##comment <IfDefine SSL> tag to closing tag (but not the content)
# Edit /Application/MAMP/conf/apache/ssl.conf, change the document root (DocumentRoot) for the one you have into /Application/MAMP/conf/apache/httpd.conf
#in a terminal enter: ''cd /Applications/MAMP/bin/apache2/bin''
#enter: ''sudo ./apachectl startssl''
#start MAMP

From now MAMP should start/stop with the SSL support activated. Note that these steps have only be tested with Apache port set to 80 into MAMP preferences.

==How To Update Your Moodle4Mac==

It is very simple to update your locally installed Moodle. If you have got this course together with Moodle4Mac then you should have everything you need for a CVS update.

The only software you must have installed on your Apple computer is the Xcode Tools package from your system installation media. After this it only needs a doubleclick to get the newest Moodle version without downloading the complete installation package.

===Update the local Moodle via CVS===

Be sure that the Xcode Tools are installed on your Mac computer. You also must have an internet connection to get the files from the update server.

Now the only thing you need to do is to doubleclick on an icon inside your MAMP folder. That's all .... really .... it's easy!!

Please look for the document '''UpdateMoodle.sh'''. If you doubleclick this file you will see that the system utility '''Terminal''' opens and the update process starts automatically. You must allow to connect to the Moodle internet server ... but think about this fact only if a system tool asks you.

[[Image:Moodle4Mac_Update1.png]]

The update tool CVS connects to the Moodle internet server and looks for all those files that must be downloaded. If the process asks for a password you press the return button to enter ... the password is "empty". The update needs a few moments to find all the updated or new files but then only those files are transfered. Please wait for some minutes.

[[Image:Moodle4Mac_Update2.png]]

Every updated file is shown in the update log so you can control if the updater works and when it is completed. At least you will see the config.php because this file does not come from the update server.

If the update takes too long you may break with <strg>-C. It doesn't matter because only text files are copied. On break the process stops working. If you restart the update again the CVS tool runs through all folders and files again to find those that need to be renewed.

===Look Inside ... ===

If you want to see what is inside the document '''UpdateMoodle.sh''' please feel free to open it with a text editor. It is only a text file but it uses the Mac OS X feature to open a file with a chosen program via doubleclick.

[[Image:Moodle4Mac_Update3.png]]

I chose the system utility '''Terminal''' to open the file '''UpdateMoodle.sh''' and to run the script it contains automatically. So everything can be done with a doubleclick. It's easy and everybody can do it!!

<pre>
#! /bin/sh
#
# This CVS updater for Mac OS X is part
# of the installation package Moodle4Mac
#
# 20101201 - Ralf Krause
#

export CVS_RSH=ssh

echo
echo "+--------------------------------------------+"
echo "| CVS update for your local Moodle server "
echo "+--------------------------------------------+"
echo

cd /Applications/MAMP/htdocs/moodle20/

### delete all files named .DS_Store
find . -name ".DS_Store" -type f -print0 | xargs -0 rm -f

### file ~/.cvspass must exist
if ! test -e ~/.cvspass ; then
touch ~/.cvspass
fi

### login to the cvs server only for the first time
if ! grep "uk.cvs.moodle.org" ~/.cvspass > /dev/null ; then
echo "CVS password is empty ... please only press <return> to start"
cvs -d :pserver:anonymous@uk.cvs.moodle.org:/cvsroot/moodle login
echo
fi

echo "Connecting to the CVS server. Download will take a few moments!"
echo "If the CVS update runs too long you may break with <strg>-C"
echo
cvs -q update -dP -r MOODLE_20_STABLE

</pre>

The different versions of the update script are different in only two things ... first you need to choose the correct folder for the Moodle files and seconds you must input the correct CVS tag for the Moodle version in the last line. The shown script is for updating the version Moodle 1.8
* Moodle 1.6 uses MOODLE_16_STABLE
* Moodle 1.7 uses MOODLE_17_STABLE
* Moodle 1.8 uses MOODLE_18_STABLE
* Moodle 1.9 uses MOODLE_19_STABLE
* Moodle 2.0 uses MOODLE_20_STABLE
* Moodle 2.1 uses MOODLE_21_STABLE
* Moodle 2.2dev uses HEAD

===Install Xcode Tools on your Mac===

Xcode Tools is the developer tools package for Mac OS X. This package includes an integrated suite of software development tools, including compilers and applications.

If you do not know whether the Xcode Tools are installed on your Mac please look on your main harddrive. If there is a folder named Developer then you must do nothing.

[[Image:Moodle4Mac_Update4.png]]

If you cannot find this on your harddrive then you must install this package before following the instructions in this document. The Xcode Tools package is part of the Mac OS X installation media. You will find the Xcode Tools on your installation CD or DVD set.

[[Image:Moodle4Mac_Update5.png]]

If you do not find your installation media anymore you also can download the Xcode Tools from the URL http://developer.apple.com/tools/xcode/. It is free but you have to register as a developer. If you start the download from there please remember that the Xcode package brings a lot of bytes and will need a very few minutes to complete.

After you have put these things into your system you will see a new folder named Developer on your harddisk. If you only want to update your Moodle you do not need all these nice developer tools from the inside of the folder. Sorry about this but there is no separate installer for the CVS update process.
  

==See also==
* [http://mamp.info MAMP = Mac + Apache + MySQL + PHP]
* [http://en.wikipedia.org/wiki/MAMP MAMP in Wikipedia]
* [[Step by Step Installation on a Mac OS X Server|Step by Step Installation on a Mac OS X Server 10.5/10.6]]
* [[Step-by-step Guide for Installing Moodle on Mac OS X 10.4 Client|Step by step Installation on a Mac OS X Client 10.4]]
* [[CVS for Administrators]]

* [http://en.wikipedia.org/wiki/Private_network Private network addresses in Wikipedia]
* [http://moodle.org/mod/forum/discuss.php?d=24632 Using Moodle: Dynamic DNS Home Server]

* [[Configuring aspell on Mac OS X]]

[[Category:Administrator]]
[[Category:Installation]]
[[Category:Mac OS X]]

[[de:Vollständiges Installationspaket für Mac OS X]]

Complete Install Packages for Mac OS X

2011-06-09T21:21:31Z

Krause: /* Look Inside ... */

Complete install packages for Mac OS X are available from [http://download.moodle.org/macosx/ Moodle Downloads] which uses '''MAMP'''. You will find a separate card for the Mac OS X downloads. They are designed for new and local installations on a Mac computer/server. There are other downloads for Linux, and Window Operating Systems that may involve more customization of configuration files.

The complete install packages for Mac OS X are named Moodle4Mac. These do not have sufficient security for public, production servers--only use for private, local testing purposes. These packages allow Moodle to be installed, along with the prerequisites that includes a web server, database and scripting language (Apache, MySQL and PHP in this case). Several versions of the complete install package are available. You will find versions for Intel based Macs and for older PPC based Macs. Please use the correct version for your processor. The instructions on the download page provide guidance on which version is likely to be most suitable.

'''Note 1:''' The latest complete install package version components, may not be backwardly compatible. Always check version compatibility of each component if you intend to develop materials on a later version of Moodle than the version installed on your "main" Moodle site. In short, complete install packages are designed for first time install on a "clean" machine.

'''Note 2:''' If you want a secure, public server with OS X, you may be interested to use the normal web server that comes preinstalled with every Mac Computer--see the [[Step-by-step Guide for Installing Moodle on Mac OS X 10.4 Client]] for Moodle. However, remember that the complete package Moodle4Mac is ready to use and no additional programs must be installed and configured together.

==System requirements==
+ Apple Mac Computer
+ iMac, Mac mini, MacBook, iBook, PowerBook, Mac Pro, Xserve
+ Processor: Intel Core 2 Duo or PPC (G4, G5)
+ RAM: 1 GB or better
+ Hard Disk: 500 MB free
+ System Software: Mac OS X 10.4, 10.5, or 10.6

==Install complete package Moodle4Mac==
===Download and install Moodle4Mac===
'''Step 1:''' [http://download.moodle.org/macosx/ Download] the zipped disk image file from the Moodle download page. Please choose the correct file for your processor type. The zip archive should be unzipped automatically when the download is complete. If the download file is not unzipped please do this manually.

'''Step 2:''' Doubleclick the file Moodle4Mac.dmg to mount the installation disk.

[[Image:Moodle4Mac_1.png]]

'''Step 3:''' Move the folder '''MAMP''' into the folder '''Applications'''. Moodle4Mac is based on MAMP (Mac, Apache, MySQL, PHP). MAMP makes no entries in any registry and no settings for the system variables. If you want to know more about MAMP please read the project page http://mamp.info/

'''Step 4:''' Now you are ready to start your web server. Go to the Applications folder. Find the MAMP folder and open it.

[[Image:Moodle4Mac_2.png]]

'''Step 5:''' Doubleclick the icon MAMP to start the server.

[[Image:Moodle4Mac_4.png]]

'''Step 6:''' Start your browser and type <nowiki> http://127.0.0.1:8888 or http://localhost:8888 </nowiki> in the address bar. You will start your preinstalled Moodle. You do not need to do any installation. You are ready. Done ... hey, that was easy, wasn't it??

[[Image:Moodle4Mac_3.jpg]]

'''Step 7:''' Please login with the username '''admin''' and the password '''12345''' and you will be the main administrator of your new local Moodle.

==Using Moodle4Mac as a local server in your network==

In some workshops we used Moodle4Mac as a quick server installation for our local network. You should change the admin passwords (Moodle and MySQL) before you do this. There are only two steps to get the server connection from every computer in your network. One step is the change of only one line in the Moodle config.php, and the second step is that you must open the firewall of the Mac OS X. This chapter shows how you can do this.

===Edit the file config.php===

Use the current ip address of your computer instead of localhost so an external computer can connect the the web server. If your network is configured to dynamic ip addresses via DHCP please make sure that your computer retains its ip address while you want to use it as a Moodle server.The best thing would be to get a static ip address for your computer. Mostly your ip address in a local network will show one of the following numbers 10.x.x.x, 172.x.x.x, or 192.168.x.x

If your computer for example has the ip address 192.168.0.20 then you must change the configuration from ''localhost'' to ''192.168.0.20''. In the following box you will see this address in the line $CFG->wwwroot. This ip address will be different in your own network. You must use own address for your own network!! Please do not use an ip address if you do not know what you are doing ... ask your network administrator.

<pre><?php /// Moodle Configuration File

unset($CFG);

$CFG->dbtype = 'mysql';
$CFG->dbhost = 'localhost';
$CFG->dbname = 'moodle20';
$CFG->dbuser = 'moodle';
$CFG->dbpass = 'moodle';
$CFG->dbpersist = false;
$CFG->prefix = 'mdl_';
$CFG->dboptions = array ('dbpersit' => 0, );

// Use the ip address of your computer instead of localhost
$CFG->wwwroot = 'http://192.168.0.20:8888/moodle20';
$CFG->dirroot = '/Applications/MAMP/htdocs/moodle20';
$CFG->dataroot = '/Applications/MAMP/data/moodle20';
$CFG->admin = 'admin';

$CFG->passwordsaltmain = 'some_very_long_secret!#A12345678901234567890!';
$CFG->directorypermissions = 00777; // try 02777 on a server in Safe Mode

require_once("$CFG->dirroot/lib/setup.php");

// There is no php closing tag in this file,
// it is intentional because it prevents trailing whitespace problems!
</pre>

===Open the firewall===
The web server that comes together with Moodle4Mac works on the TCP port 8888. Moodle4Mac uses this port because this gets no conflicts with the normal web server of Mac OS X that answers on TCP port 80. You can switch the port from 8888 to 80 but you must know the administration password of your Mac. In this case the normal web server will not work.

To open the firewall please go to '''System Preferences > Sharing > Firewall'''. Choose '''New...''', fill in TCP port 8888, and set the rule name '''Moodle4Mac'''.

[[Image:Moodle4Mac_Firewall1.png]]

When the rule exists it must be activated to get a connection to Moodle from any computer in your internal network.

[[Image:Moodle4Mac_Firewall2.png]]

===Connect Moodle from your network ...===
Your web server can be connected with the url http://x.x.x.x:8888/moodle18/ in your local network, where x.x.x.x is the address your Mac was given by the local router on your LAN. Usually such numbers start with 10.x.x.x, 172.x.x.x, or 192.168.x.x. All users from any computer in your network can use your Moodle via this address.

This also works if your computer is connected to the internet directly. If you open the firewall in your internet router and if you forward the port 8888 to your computer then any user everywhere on the world would be able to work with your Moodle ... but please remember also that there are a lot of security risks if you do this ... it would be better if you don't do this!!

[[Image:Moodle4Mac_Network1.png]]

[[Image:Moodle4Mac_Network2.png]]

==Some words about the security ...==
===MAMP is designed for local computers===
MAMP can be used for testing and developing websites locally on their Apple computers. MAMP should not be used in a production environment because everybody knows all the settings and all the predefined passwords. It's prepared for an easy start and not for a public web server!! But with some careful modfications, you can sufficiently secure MAMP and Moodle4Mac to use them in public development environments.

===How to secure MAMP?===
I found some ideas in the following document: [http://www.network0.org/2006/09/23/how-to-secure-mamp/ How to secure MAMP?]. It's really old and some of the instructions are not correct for the current version.

There is also a new package MAMP Pro that will let you do a lot of settings for a more secure web server. Please look to the web page for this product. You can find a describtion for MAMP Pro on the [http://www.living-e.com/MAMP-PRO/ MAMP internet server]. It's commertial and not free!

===Step by step to secure Moodle4Mac===

  
==How to set up SSL/https in MAMP for a development/test environment==
The text is copied from [http://www.webopius.com/content/355/getting-mamp-working-with-ssl-on-os-x webopius web site] (excepted the last steps).

#stop MAMP
#backup your /Applications/MAMP/conf folder
#open a terminal
#enter: ''openssl genrsa -des3 -out server.key 1024''. Enter a password twice.
#enter: ''openssl req -new -key server.key -out server.csr''. Enter the previous password. You need to answer some questions. ''Common name'' expects your local name (for me it was jerome.moodle.local)
#enter: ''openssl x509 -req -days 365 -in server.csr -signkey server.key -out server.crt''
#enter: ''cp server.key server.tmp''
#enter: ''openssl rsa -in server.tmp -out server.key''. Enter the previous password.
#enter: ''mkdir /Applications/MAMP/conf/ssl''
#enter: cp server.crt /Applications/MAMP/conf/ssl
#enter: cp server.key /Applications/MAMP/conf/ssl
# Edit Applications/MAMP/conf/apache/ssl.conf:
##comment <IfDefine SSL> tag to closing tag (but not the content)
##SSLCertificateFile /Applications/MAMP/conf/ssl/server.crt
##SSLCertificateKeyFile /Applications/MAMP/conf/ssl/server.key
# Edit /Applications/MAMP/conf/apache/httpd.conf:
##Listen 80
##comment <IfDefine SSL> tag to closing tag (but not the content)
# Edit /Application/MAMP/conf/apache/ssl.conf, change the document root (DocumentRoot) for the one you have into /Application/MAMP/conf/apache/httpd.conf
#in a terminal enter: ''cd /Applications/MAMP/bin/apache2/bin''
#enter: ''sudo ./apachectl startssl''
#start MAMP

From now MAMP should start/stop with the SSL support activated. Note that these steps have only be tested with Apache port set to 80 into MAMP preferences.

==How To Update Your Moodle4Mac==

It is very simple to update your locally installed Moodle. If you have got this course together with Moodle4Mac then you should have everything you need for a CVS update.

The only software you must have installed on your Apple computer is the Xcode Tools package from your system installation media. After this it only needs a doubleclick to get the newest Moodle version without downloading the complete installation package.

===Update the local Moodle via CVS===

Be sure that the Xcode Tools are installed on your Mac computer. You also must have an internet connection to get the files from the update server.

Now the only thing you need to do is to doubleclick on an icon inside your MAMP folder. That's all .... really .... it's easy!!

Please look for the document '''UpdateMoodle.sh'''. If you doubleclick this file you will see that the system utility '''Terminal''' opens and the update process starts automatically. You must allow to connect to the Moodle internet server ... but think about this fact only if a system tool asks you.

[[Image:Moodle4Mac_Update1.png]]

The update tool CVS connects to the Moodle internet server and looks for all those files that must be downloaded. If the process asks for a password you press the return button to enter ... the password is "empty". The update needs a few moments to find all the updated or new files but then only those files are transfered. Please wait for some minutes.

[[Image:Moodle4Mac_Update2.png]]

Every updated file is shown in the update log so you can control if the updater works and when it is completed. At least you will see the config.php because this file does not come from the update server.

If the update takes too long you may break with <strg>-C. It doesn't matter because only text files are copied. On break the process stops working. If you restart the update again the CVS tool runs through all folders and files again to find those that need to be renewed.

===Look Inside ... ===

If you want to see what is inside the document '''UpdateMoodle.sh''' please feel free to open it with a text editor. It is only a text file but it uses the Mac OS X feature to open a file with a chosen program via doubleclick.

[[Image:Moodle4Mac_Update3.png]]

I chose the system utility '''Terminal''' to open the file '''UpdateMoodle.sh''' and to run the script it contains automatically. So everything can be done with a doubleclick. It's easy and everybody can do it!!

<pre>
#! /bin/sh
#
# This CVS updater for Mac OS X is part
# of the installation package Moodle4Mac
#
# 20101201 - Ralf Krause
#

export CVS_RSH=ssh

echo
echo "+--------------------------------------------+"
echo "| CVS update for your local Moodle server "
echo "+--------------------------------------------+"
echo

cd /Applications/MAMP/htdocs/moodle20/

### delete all files named .DS_Store
find . -name ".DS_Store" -type f -print0 | xargs -0 rm -f

### file ~/.cvspass must exist
if ! test -e ~/.cvspass ; then
touch ~/.cvspass
fi

### login to the cvs server only for the first time
if ! grep "uk.cvs.moodle.org" ~/.cvspass > /dev/null ; then
echo "CVS password is empty ... please only press <return> to start"
cvs -d :pserver:anonymous@uk.cvs.moodle.org:/cvsroot/moodle login
echo
fi

echo "Connecting to the CVS server. Download will take a few moments!"
echo "If the CVS update runs too long you may break with <strg>-C"
echo
cvs -q update -dP -r MOODLE_20_STABLE

</pre>

The different versions of the update script are different in only two things ... first you need to choose the correct folder for the Moodle files and seconds you must input the correct CVS tag for the Moodle version in the last line. The shown script is for updating the version Moodle 1.8
* Moodle 1.6 uses MOODLE_16_STABLE
* Moodle 1.7 uses MOODLE_17_STABLE
* Moodle 1.8 uses MOODLE_18_STABLE
* Moodle 1.9 uses MOODLE_19_STABLE
* Moodle 2.0 uses MOODLE_20_STABLE
* Moodle 2.1dev uses HEAD

===Install Xcode Tools on your Mac===

Xcode Tools is the developer tools package for Mac OS X. This package includes an integrated suite of software development tools, including compilers and applications.

If you do not know whether the Xcode Tools are installed on your Mac please look on your main harddrive. If there is a folder named Developer then you must do nothing.

[[Image:Moodle4Mac_Update4.png]]

If you cannot find this on your harddrive then you must install this package before following the instructions in this document. The Xcode Tools package is part of the Mac OS X installation media. You will find the Xcode Tools on your installation CD or DVD set.

[[Image:Moodle4Mac_Update5.png]]

If you do not find your installation media anymore you also can download the Xcode Tools from the URL http://developer.apple.com/tools/xcode/. It is free but you have to register as a developer. If you start the download from there please remember that the Xcode package brings a lot of bytes and will need a very few minutes to complete.

After you have put these things into your system you will see a new folder named Developer on your harddisk. If you only want to update your Moodle you do not need all these nice developer tools from the inside of the folder. Sorry about this but there is no separate installer for the CVS update process.
  

==See also==
* [http://mamp.info MAMP = Mac + Apache + MySQL + PHP]
* [http://en.wikipedia.org/wiki/MAMP MAMP in Wikipedia]
* [[Step by Step Installation on a Mac OS X Server|Step by Step Installation on a Mac OS X Server 10.5/10.6]]
* [[Step-by-step Guide for Installing Moodle on Mac OS X 10.4 Client|Step by step Installation on a Mac OS X Client 10.4]]
* [[CVS for Administrators]]

* [http://en.wikipedia.org/wiki/Private_network Private network addresses in Wikipedia]
* [http://moodle.org/mod/forum/discuss.php?d=24632 Using Moodle: Dynamic DNS Home Server]

* [[Configuring aspell on Mac OS X]]

[[Category:Administrator]]
[[Category:Installation]]
[[Category:Mac OS X]]

[[de:Vollständiges Installationspaket für Mac OS X]]

Step by Step Installation on a Mac OS X Server

2011-06-03T16:48:51Z

Krause: /* Use the CVS update script */

==Overview==
This guide shows all steps for the installation of Moodle on a [http://www.apple.com/server/macosx Mac OS X Server]. This server is a commercial product. You will find [http://www.apple.com/server/macosx/resources/documentation.html all documentations] about the web server on the Apple support pages.

This installation guide can't be useful for an installation on MAMP or XAMPP. If you are looking for an easy way to install Moodle on your local machine please use [[Complete Install Packages for Mac OS X | Complete install packages for Mac OS X 10.4/10.5/10.6 Clients]] that can be downloaded from http://download.moodle.org/macosx/ ... but if you are planning to set up a Moodle internet server on a Mac then you should think about some more security as the ever local package could give.

Please feel free to add your ideas and wishes to the discussion page for this article. You may also write a complete chapter if you tried the facts yourself on your own Mac Server. I am most interested to make the things better.

==System requirements==

+ Apple Computer
+ Mac mini, Mac Pro or Xserve
+ Processor: Intel Core 2 Duo, Intel Core i3/i5/i7
+ RAM: 2 GB or better
+ Hard Disk: 500 MB free
+ System Software: Mac OS X Server 10.5 or 10.6

==Configure PHP for your Moodle installation==
===Mac OS X 10.6 Server - No PHP installation needed===

The Mac OS X 10.6.5 Server (SnowLeopard) comes with PHP 5.3.3 and a lot of PHP extensions. This would be the best choice for Moodle 1.9.x and for Moodle 2.0 on a Mac OS X Server. Please forget everything you read about the missing GD Library! The PHP installation is totally complete for Moodle. You only have to switch on the PHP module and to control if the file ''/etc/php.ini'' sets the right values for Moodle.

[[Image:Server-admin-106.png]]

===Mac OS X 10.5 Server - Install PHP 5.3.0 and the GD Library===

The Mac OS X 10.5.8 Server (Leopard) comes with PHP 5.2.6 ... this is correct for Moodle 1.9.x. But you have to add the missing GD Library support to get Moodle running on your server. For Moodle 2.0 the server must have PHP 5.2.8 (or better) and some more PHP extensions ... in this case you need to get the better PHP version. These instructions are helpful in both cases.

To see which PHP version and extensions are installed on your server you should edit the file ''/Library/WebServer/Documents/info.php''. You must activate the function call phpinfo() by deleting the both slashes // at the start of the function line. After saving the file you can get all PHP informations in your browser. Please look at http://your-server-address/info.php ... you will not find any GD library support ... bad thing for Moodle!!

<?php
// You can use Server Admin to enable the Apache PHP module; it's disabled by default.
// You can uncomment the phpinfo() directive below to provide a default PHP info page
// but note that this displays information about your host's configuration.
phpinfo();
?>

The easiest way to get the GD library support and to get a better PHP version would be the installation of the complete PHP 5.3.0 package from http://www.entropy.ch/software/macosx/php/. Marc Liyanage precompiled this package to use it on Mac clients and Mac servers. Please get the package and install it by following the instructions on the download page. The installer does everything for you ... it copies PHP into the correct folder ''/usr/local/php5'' and changes its owner to ''root'' automatically. You will find the file php.ini inside the new package folder. Open the file ''/usr/local/php5/lib/php.ini'' and edit some settings for Moodle.

Note: If you want to install Moodle 1.8.x on the server you need to get the Entropy PHP-5.2.9-7.pkg instead. Moodle 1.8.x does not run with PHP 5.3.0. (MDL-20128)

Now the Apache web server must get knowledge that you want to use the new PHP library instead of the old. Open the application Server Admin to switch to the new library. Go to the web server settings and find the entry php5_module. The normal place for PHP the Mac server is ''libexec/apache2/libphp5.so''. Please change to ''/usr/local/php5/libphp5.so'' and save the settings.

[[Image:Server-admin.png]]

===PHP settings in your php.ini===
The next thing is to configure the file ''php.ini''. Most of the settings are okay but not all of them. To communicate to the MySQL database with PHP you have to set the default socket name for local MySQL connects. The default socket name for local MySQLi connects is needed for Moodle 2.0.

If you want to upload any file to your Moodle you should add a little bit more upload size in php.ini. If your server can't use more than 1 GB RAM you should set the memory_limit to a value less than 128M ... but it should have more than 48M for Moodle 1.9 and Moodle 2.0. Note that these sections are not likely to be consecutive in the php.ini file; the quickest way to find each one is search on the initial term (such as 'mysql.default_socket').

; Default socket name for local MySQL connects.
; If empty, uses the built-in MySQL defaults.
mysql.default_socket = /var/mysql/mysql.sock

; Default socket name for local MySQL connects.
; If empty, uses the built-in MySQL defaults.
mysqli.default_socket = /var/mysql/mysql.sock

; Maximum amount of memory a script may consume (128MB)
memory_limit = 128M

; Maximum allowed size for uploaded files.
upload_max_filesize = 128M

; Maximum size of POST data that PHP will accept.
post_max_size = 128M

; Defines the default timezone used by the date functions
; http://php.net/date.timezone
date.timezone = 'Europe/Berlin';

That's all ... save the file ''php.ini'' and restart the web server. Now you should look at http://your-server-address/info.php again. I hope that everything will be okay. You will find the version number PHP 5.3.x and the running GD library support. Congratulations ... the first step for Moodle on your Mac server is done!

[[Image:phpinfo.png]]

[[Image:phpinfo2.png]]

==Configure the MySQL database for your Moodle installation==

In standard case the database MySQL is installed on the Mac OS X Server but it is not running yet. Please make sure that you start the MySQL database server.

===Use the graphical way===
Sorry ... there are some more installations and a lot of clicks to configure MySQL in a graphical way.

First of all start the ''Server Admin''. You will find this program by the way ''Applications > Server > Server Admin''. Activate MySQL on the local server. You must set the password for the user ''root'' before you can start MySQL.

For the next you must download the MySQL database administration tool '''phpMyAdmin''' from http://www.phpmyadmin.net . Move the folder to the web server documents as ''/Library/WebServer/Documents/phpMyAdmin''.

Add the security phrase to the file ''config.inc.php'' in between the single quotes on the line $cfg['blowfish_secret'] = ''; /* YOU MUST FILL IN THIS FOR COOKIE AUTH! */

Now you will be able to start http://your-server-address/phpMyAdmin/ in your browser and to log into the database as the user ''root''. Add a database ''moodle19''. Add a database user ''moodle'' to the server ''localhost''. Don't forget to set a secure password. The database user ''moodle'' should be allowed to administrate the database ''moodle19'' only. It is a bad way to set ''root'' to administrate the database ''moodle19''. If you want to install also Moodle 2.0 dev please add a second database ''moodle20'' and use the same database user for it.

phpMyAdmin is a nice thing to look into the database while Moodle is running for some time. It's much easier to see in the graphical interface than in the command line tools. The image shows the database after Moodle 1.9 and Moodle 2.0 were already installed on this server.

[[Image:phpmyadmin.png]]

===Use the Terminal===

If you want a quick installation then don't fear to use the Terminal. It's easier to tell you all the commands for the right way with the Terminal than showing you all the pictures to do the same with graphical tools. There are only a few commands to do everything I told you before.

Start the Terminal. You will find this program by the way ''Applications > Tools > Terminal''. You will see that we must do the same steps as before but you can read them in a text form.

First of all you need to set the root password. If you didn't this before then use the first command line. If you want to change an existing password then use the second one.

Server:~ $ mysqladmin -u root password 'secret'
Server:~ $ mysqladmin -u root -p password 'topsecret'

The next steps are creating a new database ''moodle19'' with correct character set and setting up a database user ''moodle'', with an assigned password (IDENTIFIED BY), to administrate the new database ... and if you want, then do the same for ''moodle20''.

Server:~ $ mysqladmin -u root -p create moodle19
Server:~ $ mysql -u root -p

mysql> ALTER DATABASE moodle19 CHARSET 'utf8';
mysql> GRANT ALL PRIVILEGES ON moodle19.* TO moodle@localhost
-> IDENTIFIED BY 'moodle!';
mysql> quit

Server:~ $

That's really all with the Terminal. You are just ready!

===Use InnoDB with Moodle 2.0===

For Moodle 2.0 you should setup the support for InnoDB in your MySQL database.

Open the file /etc/my.cnf an delete every # in all lines beginning with innodb. This uncomments the InnoDB settings. Please save the file and restart your MySQL database.

# Uncomment the following if you are using InnoDB tables
innodb_data_home_dir = /var/mysql/
innodb_data_file_path = ibdata1:2000M;ibdata2:10M:autoextend
innodb_log_group_home_dir = /var/mysql/
innodb_log_arch_dir = /var/mysql/
# You can set .._buffer_pool_size up to 50 - 80 %
# of RAM but beware of setting memory usage too high
innodb_buffer_pool_size = 384M
innodb_additional_mem_pool_size = 20M
# Set .._log_file_size to 25 % of buffer pool size
innodb_log_file_size = 100M
innodb_log_buffer_size = 8M
innodb_flush_log_at_trx_commit = 1
innodb_lock_wait_timeout = 50

==Copy the Moodle files to the web server==

The documents for the web server are saved in the folder ''/Library/WebServer/Documents/''. You will place your Moodle folder here after you got it from http://download.moodle.org. Download the standard package MOODLE_19_WEEKLY because this is the best choice for new servers. Set the owner ''_www'' for the moodle folder ... this is the user for the web server. The folder permissions should be 755 before the installation and 555 after it's done ... please remember to set this later!

You also need the moodledata folder outside of the Documents folder ... so please make one. Go to the folder ''/Library/WebServer/'' and add the folder ''moodledata''. Because I want to install Moodle 1.9.x and Moodle 2.0 dev together on the same Mac server I add two folders ''moodle19'' and ''moodle20'' inside the moodledata folder. Please set the owner ''_www'' for both folders ''moodle19'' and ''moodle20'' and the folder permissions to 755.

cd /Library/WebServer/
mkdir moodledata
mkdir moodledata/moodle19
mkdir moodledata/moodle20
sudo chown -R _www moodledata
sudo chmod -R 755 moodledata

If you'd like to put the moodledata folder on another volume (not a bad idea if you think you'll have a substantial amount of data within the moodle), note that you cannot simply reference it using the /Volumes/<volume_name>/folder syntax during the moodle setup. Instead, you'll need to create the folder (assigning the user and permissions), then create a '''link''' to it within the /Library/WebServer folder. To create the link, use the following command in a terminal window, substituting your data volume and folder name:

cd /Library/WebServer
ln -s /Volumes/Data_Volume/moodledata moodledata

==Run the Moodle installation==
The installation on the Mac server is the same like the installation on every other server.
Open a web browser to http://your-server-address/moodle/install.php to begin the installation process.
On the screen picture and in the shown config.php you see the web address ''your-server-address'' ... it's only a placeholder for a real address or url ... please set yours. Also a user 'moodle' with a password 'moodle' would be very unsafe settings for your installation.

[[Image:moodle-install1.png]]

[[Image:moodle-install2.png]]

The installer generates the config.php automatically and saves it in the folder ''/Library/WebServer/Documents/moodle19''. Please edit the config.php with a text editor and add the line ''date_default_timezone_set('UTC');''. You may change ''UTC'' to your own timezone ... this is needed for PHP 5.3.0. In case you don't know all the relevant time zone identifiers by heart, there is a [http://phpbuilder.com/manual/en/timezones.php list available online].

<?php /// Moodle Configuration File

unset($CFG);

$CFG->dbtype = 'mysql';
$CFG->dbhost = 'localhost';
$CFG->dbname = 'moodle19';
$CFG->dbuser = 'moodle';
$CFG->dbpass = 'moodle';
$CFG->dbpersist = false;
$CFG->prefix = 'mdl_';

$CFG->wwwroot = 'http://your-server-address/moodle19';
$CFG->dirroot = '/Library/WebServer/Documents/moodle19';
$CFG->dataroot = '/Library/WebServer/moodledata/moodle19';
$CFG->admin = 'admin';

$CFG->directorypermissions = 00777; // try 02777 on a server in Safe Mode

date_default_timezone_set('Europe/Berlin'); // timezone for PHP 5.3.0
require_once("$CFG->dirroot/lib/setup.php");
// MAKE SURE WHEN YOU EDIT THIS FILE THAT THERE ARE NO SPACES, BLANK LINES,
// RETURNS, OR ANYTHING ELSE AFTER THE TWO CHARACTERS ON THE NEXT LINE.
?>

After this, the web-based installation component will walk you through '''several''' screens worth of database configurations and updates, for most of which you'll just click the continue button. You'll set up an admin user and give the site a basic configuration (title, description, etc). When the installation is ready you should change the folder permission for ''/Library/WebServer/Documents/moodle19'' to 555 so the web server is not able to write into this folder again.

==Download the language packages==

==Moodle is running ...==
[[Image:moodle-on-macosx-server.png]]

==How to setup the cron job with launchd==

It's really important to start the cron job every 5 minutes. The cron job assists most of Moodle's modules to perform tasks on a scheduled basis. For example, the discussion forums can only mail out copies of new posts to all subscribers if the cron job tells Moodle to do this.

In Mac OS X you will find the system daemon ''launchd'' for this service. This daemon offers a standardized interface to any user and all programs started automatically by the system. Please look at http://developer.apple.com/macosx/launchd.html for more information about the configurations and all parameters.

In our case the service should get the web page http://your-server-address/moodle19/admin/cron.php every 5 minutes. The configuration will be done by the file named ''moodle4mac.cron.plist'' which must be placed in the system folder ''/Library/LaunchDaemons/'' ... surely you can use any other file name but it should say something about the function of the service. The extension must be ''.plist''. After any reboot of your Mac server the cron service will start automaticly because the file is placed in the correct system folder.

===Use the graphical way===
You can use Lingon to add a new daemon plist or to edit one. It produces the same text as you can write in your text editor. http://sourceforge.net/projects/lingon/files/

[[Image:macosx-lingon.png]]

===Use a text editor===
Please use a text editor to write the needed file. You can open the Terminal and use the system editors vi or pico. But you can also write the text file with any GUI text editor ... I mostly use TextWrangler ... but do NOT take an editor for formatted texts like Microsoft Word or OpenOffice Writer. You must get pure text!

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0//EN"
"http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>KeepAlive</key><false/>
<key>Label</key><string>moodle4mac.cron</string>
<key>ProgramArguments</key>
<array>
<string>curl</string>
<string>-s</string>
<string>http://your-server-address/moodle19/admin/cron.php</string>
</array>
<key>RunAtLoad</key><true />
<key>StartInterval</key><integer>300</integer>
<key>StandardErrorPath</key><string>/dev/null</string>
<key>StandardOutPath</key><string>/dev/null</string>
</dict>
</plist>

The label string must be the same as the file name is but without the extension ''.plist''. Save the text file ''/Library/LaunchDaemons/moodle4mac.cron.plist''. The owner of the file must be set to the system user ''root''. That's all, really!

===How to start and stop the cron service===
You can start the new cron service in the Terminal.

sudo launchctl load /Library/LaunchDaemons/moodle4mac.cron.plist

The following command would stop the service. If you want to activate changes in the cron service you need to ''unload'' and then to ''load'' the daemon again.

sudo launchctl unload /Library/LaunchDaemons/moodle4mac.cron.plist

===Only one service for two servers?===
For my server I needed to have a cron service for to instances ''moodle19'' and ''moodle20'' ... no problem ... with the typo ''moodle[19-20]'' the server will get a cron service for both instances.

<nowiki>curl -s http://your-server-address/moodle[19-20]/admin/cron.php</nowiki>

To see if the cron service works correctly you should look at the ''access.log'' of your web server. The cron.php should be accessed every 5 minutes ... on my server for both Moodle instances ''moodle19'' and ''moodle20'' ... oh yes, it works!!

192.168.0.220 - - [30/Jul/2009:22:10:56 +0200] "GET /moodle19/admin/cron.php HTTP/1.1" 200 1136
192.168.0.220 - - [30/Jul/2009:22:10:57 +0200] "GET /moodle20/admin/cron.php HTTP/1.1" 200 1403
192.168.0.220 - - [30/Jul/2009:22:11:18 +0200] "OPTIONS * HTTP/1.0" 200 -
192.168.0.220 - - [30/Jul/2009:22:15:56 +0200] "GET /moodle19/admin/cron.php HTTP/1.1" 200 735
192.168.0.220 - - [30/Jul/2009:22:15:57 +0200] "GET /moodle20/admin/cron.php HTTP/1.1" 200 964
192.168.0.220 - - [30/Jul/2009:22:20:56 +0200] "GET /moodle19/admin/cron.php HTTP/1.1" 200 1136
192.168.0.220 - - [30/Jul/2009:22:20:57 +0200] "GET /moodle20/admin/cron.php HTTP/1.1" 200 1365

==How to install and update Moodle via CVS==

CVS is very simple way to install and update your Moodle.

The only software you must have installed on your Mac server is the Xcode Tools package from your system installation media. You also must have an internet connection to get the files from the update server. After you installed both script files on your server desktop it only needs a doubleclick to get the newest Moodle version without downloading the complete installation package. Please remember - before you can update your Moodle via CVS you must install Moodle via CVS at once.

That's all .... really .... it's easy!!

===Use the CVS installation script===
If your Moodle is already installed via CVS please use the CVS updater (see below). Running the CVS installer will install only the standard version of Moodle on your server.

If you already have a working Moodle on your server then this script copies the file config.php into your new installation but it does not copy your additional modules or plugins or themes. You will find your old moodle folder in same directory and it will be renamed with an additional date stamp.

<pre>
#! /bin/sh
#
# CVS installer for Moodle
# on a Mac OS X Server
#
# 20100818 - Ralf Krause
#

export CVS_RSH=ssh

### file ~/.cvspass must exist
if ! test -e ~/.cvspass ; then
touch ~/.cvspass
fi

echo
echo "+--------------------------------------------+"
echo "| CVS installer for the Moodle server "
echo "+--------------------------------------------+"
echo

cd /Library/WebServer/Documents

### get the cvs installation into a tmp folder
if ! test -e tmp ; then
sudo mkdir tmp
sudo chmod 777 tmp
fi

echo "Connecting to the CVS server. Download will take a few moments!"
echo "If the CVS update runs too long you may break with <ctrl>-C"
echo

### do the cvs installation
cd tmp
cvs -z9 -d:pserver:anonymous@uk.cvs.moodle.org:/cvsroot/moodle co -P -r MOODLE_19_WEEKLY moodle
cd ..

### copy config.php from your current moodle folder if it exists
if ! test -e moodle/config.php ; then
cp moodle19/config.php tmp/moodle/config.php
fi

### move the new moodle to the right place
DATE=`date +%Y%m%d-%H%M`
sudo mv moodle19 moodle19-$DATE
sudo mv tmp/moodle moodle19
sudo chown -R _www moodle19
</pre>

===Use the CVS update script===
To be able to update Moodle via CVS please check that your Moodle was already installed via CVS (see above).

<pre>
#! /bin/sh
#
# CVS updater for Moodle
# on a Mac OS X Server
#
# 20100818 - Ralf Krause
#

export CVS_RSH=ssh

echo
echo "+--------------------------------------------+"
echo "| CVS updater for the Moodle server "
echo "+--------------------------------------------+"
echo

cd /Library/WebServer/Documents/moodle19/

### file ~/.cvspass must exist
if ! test -e ~/.cvspass ; then
touch ~/.cvspass
fi

### login to the cvs server only for the first time
if ! grep "uk.cvs.moodle.org" ~/.cvspass > /dev/null ; then
echo "CVS password is empty ... please only press <return> to start"
sudo cvs -d :pserver:anonymous@uk.cvs.moodle.org:/cvsroot/moodle login
echo
fi

echo "Connecting to the CVS server. Download will take a few moments!"
echo "If the CVS update runs too long you may break with <ctrl>-C"
echo

### do the cvs installation
sudo cvs -q update -dP -r MOODLE_19_STABLE
sudo chown -R _www .
</pre>

Please look at the documentation [https://docs.moodle.org/en/CVS_for_Administrators CVS for Administrators] if you want to learn more about Moodle and CVS. There you will also find a list of different [https://docs.moodle.org/en/CVS_for_Administrators#CVS_Servers CVS servers for Moodle] which you may choose for your updates.

The shown update script should be modified in only three things ... first you need to choose the correct folder for the Moodle files, second choose a CVS server near your server place to minimate internet traffic, and third you must input the correct CVS tag for the Moodle version in the last line. The shown script is for updating the version Moodle 1.9
* Moodle 1.8 uses MOODLE_18_STABLE
* Moodle 1.9 uses MOODLE_19_STABLE
* Moodle 2.0 uses MOODLE_20_STABLE
* Moodle 2.1 uses HEAD

===Troubleshooting===

If CVS does not work on your server please check that the connection port is open. 
If you see something like this, make sure that there is no firewall blocking the port (it's port 2401):

$ cvs -d:pserver:anonymous@us.cvs.moodle.org:/cvsroot/moodle login
Logging in to :pserver:anonymous@us.cvs.moodle.org:2401/cvsroot/moodle
CVS password:
cvs [login aborted]: connect to us.cvs.moodle.org(130.212.64.111):2401 failed: Connection timed out

===Install Xcode Tools and CVS on your Mac Server===

To test if cvs is already on your Mac Server please open the Terminal and type ''cvs -v''. The output of this command should show a version notice of your Concurrent Versions System (CVS). If you get the ''command not found'' message then you must search for your Mac OS X 10.5 Server installation media. You will find the Xcode Tools on your installation CD or DVD set.

If you can't find your installation media anymore you also can download the Xcode Tools from the URL http://developer.apple.com/tools/xcode/. It is free but you have to register as a developer. Starting the download then the Xcode package copies a lot of bytes on your harddisk and will need a very few minutes to complete.

After you installed the Xcode Tools in your server system you will get the correct version answer from the Terminal command ''cvs -v''. If you only want to update your Moodle you do not need all these nice developer tools from the inside of the folder. Sorry about this but there is no separate installer for the CVS update process.
  

==User administration via LDAP==

The following settings will work on 10.5 Server running LDAP - edit them to customize to your own environment. Please note that moodle requires some fields - it is best to have these fields completed in Workgroup Manager on 10.5 Server - otherwise they'll be prompted to enter info into their moodle profile on first login, but the way we've got it set up, moodle can't modify LDAP for security and data integrity. The necessary fields are user name, first name, surname, Email address, City/Town, country, description, ID number.
<pre>
LDAP SERVER SETTINGS
Host URL = ourserver.example.com
Version = 3
LDAP encoding = utf-8

BIND SETTINGS
Hide passwords = Yes
Distinguished Name = (blank)
Password = (blank)

USER LOOKUP SETTINGS
User type = posixAccount (rfc2307)
Contexts = cn=users,dc=ourserver,dc=example,dc=com
Search subcontexts = Yes
Dereference aliases = No
User attribute = (blank)
Member attribute = (blank)
Member attribute uses dn = (blank)
Object class = (blank)

FORCE CHANGE PASSWORD
Force change password = No
Use standard Change Password Page = No
Password format = Plain text
Password change URL = (blank)

LDAP PASSWORD EXPIRATION SETTINGS
Expiration = no
Expiration warning = 10
Expiration attribute = ""
Grace logins = No
Grace login attribute = (blank)

ENABLE USER CREATION
Create users externally = No
Context for new users = (blank)

COURSE CREATOR
Creators = (blank)

CRON SYNCHRONIZATION SCRIPT
Removed ext user = Keep internal

NTLM SSO
Enable = No
Subnet = (blank)
First name = givenName (On every login, Never, Locked)
Surname = sn (On every login, Never, Locked)
Email address = mail (On every login, Never, Locked)
Phone 1 = (blank)
Phone 2 = (blank)
Department = (blank)
Address = (blank)
City/Town = l (On every login, Never, Locked)
Country = c (On every login, Never, Locked)
Description = description (On every login, Never, Locked)
ID number = uidNumber (On every login, Never, Locked)
Language = (blank)
</pre>

==See also==
* [[Complete Install Packages for Mac OS X | Complete install packages for Mac OS X Clients 10.4/10.5/10.6]]
* [[Step-by-step Guide for Installing Moodle on Mac OS X 10.4 Client|Step by step installation on a Mac OS X Client 10.4]]
* [[Cron | Installation of cron for Moodle]]
* [[CVS for Administrators]]

* [http://moodle.org/mod/forum/discuss.php?d=24632 Using Moodle: Dynamic DNS Home Server]

[[Category:Administrator]]
[[Category:Installation]]
[[Category:Mac OS X]]

Dropbox repository

2011-04-29T11:32:40Z

Krause: /* See also */

{{stub}}{{Moodle 2.0}}

A Dropbox repository can be enabled by an administrator in ''Site administration > Modules > Repositories > Manage repositories''.

==Sign up app keys at dropbox==

# Go to https://www.dropbox.com/developers/apps
# Create an app, you must change app status to Production
# Copy the app keys

==Configuration==
Once enabled by the administrator a Dropbox API Key and Secret will need to be added to the Dropbox settings in order for it to work. This will be ''the'' Dropbox available to all users throughout the site (and each will need the correct Dropbox login credentials to access it from their courses). To gather the Dropbox API Key and Secret click the "Dropbox Developers" link on the Dropbox repository settings page. On the next page you'll be prompted to login with your Dropbox username and password and to create a Dropbox app.

Once the App has been created at Dropbox.com you'll have the API Secret and Key available at the bottom of the App page. Entering those on the Dropbox settings page (and clicking Save) back in Moodle will finish the configuration. Dropbox is now available to the entire site.

To access it editing teachers need only "Add..." a new file while editing or creating a resource to see Dropbox as a new option.

==See also==

* [http://www.youtube.com/watch?v=V221JLCywWs Import files from Dropbox into Moodle 2.0 video]
* MDL-19168
* MDL-26949 - Can't change the Dropbox API key and secret to production status

[[Category:Repositories]]
[[de:Dropbox]]

Dropbox repository

2011-04-29T11:31:00Z

Krause: /* See also */

{{stub}}{{Moodle 2.0}}

A Dropbox repository can be enabled by an administrator in ''Site administration > Modules > Repositories > Manage repositories''.

==Sign up app keys at dropbox==

# Go to https://www.dropbox.com/developers/apps
# Create an app, you must change app status to Production
# Copy the app keys

==Configuration==
Once enabled by the administrator a Dropbox API Key and Secret will need to be added to the Dropbox settings in order for it to work. This will be ''the'' Dropbox available to all users throughout the site (and each will need the correct Dropbox login credentials to access it from their courses). To gather the Dropbox API Key and Secret click the "Dropbox Developers" link on the Dropbox repository settings page. On the next page you'll be prompted to login with your Dropbox username and password and to create a Dropbox app.

Once the App has been created at Dropbox.com you'll have the API Secret and Key available at the bottom of the App page. Entering those on the Dropbox settings page (and clicking Save) back in Moodle will finish the configuration. Dropbox is now available to the entire site.

To access it editing teachers need only "Add..." a new file while editing or creating a resource to see Dropbox as a new option.

==See also==

* [http://www.youtube.com/watch?v=V221JLCywWs Import files from Dropbox into Moodle 2.0 video]
* MDL-19168
* MDL-26949 - Can't get the Dropbox API key and secret for productive status

[[Category:Repositories]]
[[de:Dropbox]]

Development:Filters 2.0

2010-12-25T11:10:47Z

Krause:

'''Please note:''' This page contains information for developers. You may prefer to read the [[Filters 2.0| information about filters for teachers and administrators]]. Once Moodle 2.0 is released, [[Development:Filters]] will be renamed to 'Development:Filters 1.9 and before' and this page will be renamed to 'Development:Filters'.

'''Filters''' are a way to automatically transform content before it is output. For example
* render embedded equations to images (the TeX filter)
* Links to media files can be automatically converted to an embedded applet for playing the media.
* Mentions of glossary terms can be automatically converted to links.
The possibilities are endless. There are a number of standard filters included with Moodle, or you can create your own. Filters are one of the easiest types of plugin to create. This page explains how.

==Two types of filter==

Moodle supports two types of filter:
* Stand-alone filters. These live in a folder inside the 'filter' folder. For example, in 'filter/myfilter'. 'filter/tex' is an example of a core filter of this type.
* Filters that are part of an activity module. In this case, the filter code lives inside the 'mod/mymod' folder. 'mod/glossary' is an example of a core module with a filter.
The two types of filter work in exactly the same way, and to create one, you put your code in files with the same name, just in different places in the code base.

==Creating a basic filter==

During this tutorial, we will build a simple example filter. We will make one that adds the word 'hello' before every occurrence of the word 'world'.

1. Since our filter is not part of a module, we should put it inside the 'filter' folder. Therefore, we create a directory called 'filter/helloworld'.

2. Inside that folder, we create a file called 'filter.php'.

3. Inside that PHP file, we define a class called helloworld_filter, that extends the moodle_text_filter class.
<code php>
<?php
class helloworld_filter extends moodle_text_filter {
// ...
}
?>
</code>

4. Inside that class, we have to define one method, called 'filter'. This takes the HTML to be filtered as an argument. The method should then transform that, and return the processed text. Replace the '// ...' above with
<code php>
class helloworld_filter extends moodle_text_filter {
public function filter($text) {
return str_replace('world', 'hello world!', $text);
}
}
</code>

That is basically all there is to it!

==Giving your filter a name==

To try the new filter, you first have to log in as Administrator and enable it by going to the page Administration ► Plugins ► Filters ► Manage filters.

When you do, you will find that your plugin does not have a name. We missed a step:

5. Inside the 'filter/helloworld' folder, create a folder called 'lang', and in there, create a folder called 'en'.

6. Inside there, create a file called 'filter_helloworld.php'. That is, you have just created the file 'filter/helloworld/lang/en/filter_helloworld.php'.

7. In that file, put
<code php>
<?php // $Id$
// Language string for filter/helloworld.

$string['filtername'] = 'Hello world!';
</code>

That may seem a little involved, just to give your filter a name, but it is just [[Development:Places_to_search_for_lang_strings|the standard way Moodle stores language strings for plugins]].

==Trying out your filter==

We had just got to the [[Filters|filters administration screen]]. If you reload that page now, it should now show your filter with its proper name. Turn your filter on now.

Filters are applied to all text that is printed with the [[Development:Output functions|output functions]] format_text(), and, if you have turned on that option, format_string(). So, to see your filter in action, add some content containing the work 'world' somewhere, for example, create a test course, and use the work in the course description. When you look at that course in the course listing, you should see that your filter has transformed it.

==Adding a global settings screen==

Some filters can benefit from some settings to let the administrator control how they work. Suppose we want to greet something other than 'world'. To add global settings to the filter you need to:

8. Create a file called 'filtersettings.php' inside the 'filter/helloworld' folder.

9. In the 'filtersettings.php' file, put something like:
<code php>
$settings->add(new admin_setting_configtext('filter_helloworld_word',
get_string('word', 'filter_helloworld'),
get_string('configword', 'filter_helloworld'), 'world', PARAM_NOTAG));
</code>

10. In the language file 'filter/helloworld/lang/en/filter_helloworld.php' add the necessary strings:
<code php>
$string['word'] = 'The thing to greet';
$string['configword'] = 'The hello world filter will add the word \'hello\' in front of every occurrence of this word in any content.';
</code>

11. Change the filter to use the new setting:
<code php>
class helloworld_filter extends moodle_text_filter {
public function filter($text) {
global $CFG;
return str_replace($CFG->filter_helloworld_word,
"hello $CFG->filter_helloworld_word!", $text);
}
}
</code>

In standard Moodle, the censor, mediaplugin and tex filters all provide good examples of of how filters use global configuration like this.

==A note about performance==

One important thing to remember when creating a filter is that the filter will be called to transform every bit of text output using format_text(), and possibly also format_string(). That means that you have to be careful, or you could cause big performance problems. If you have to get data out of the database, try to cache it so that you only do a fixed number of database queries per page load. The Glossary filter is an example of this. (I am not sure how good an example ;-))

==Local configuration==

In addition, in Moodle 2.0, filters can also have different configuration in each context. For example, the glossary could be changes so that in Forum A, you can choose to only link words from a particular glossary, sat Glossary A, while in Forum B you choose to link words from Glossary B.

To do that sort of thing, you need to add a file called filterlocalsettings.php. In it, you must define a [[Development:lib/formslib.php|Moodle form]] that is a subclass of filter_local_settings_form. In addition to the standard formslib methods, you also need to define a save_changes method. There is not a good example of this in the standard Moodle install yet. To continue our example:

12. Create a file called 'filterlocalsettings.php' inside the 'filter/helloworld' folder.

13. In the 'filterlocalsettings.php' file, put:
<code php>
class helloworld_filter_local_settings_form extends filter_local_settings_form {
protected function definition_inner($mform) {
$mform->addElement('text', 'word', get_string('word', 'filter_helloworld'), array('size' => 20));
$mform->setType('word', PARAM_NOTAGS);
}
}
?>
</code>

14. Extend the filter to use the new setting, if it is present. The filter must be able to work if the setting is not set, for example by falling back to the global or default setting in this case
<code php>
<?php
class helloworld_filter extends moodle_text_filter {
public function filter($text) {
global $CFG;
if (isset($this->localconfig['word'])) {
$word = $this->localconfig['word'];
} else {
$word = $CFG->filter_helloworld_word;
}
return str_replace($word, "hello $word!", $text);
}
}
?>
</code>

==See also==

* The example filter built here is in contrib CVS at http://cvs.moodle.org/contrib/plugins/filter/helloworld/
* [[Development:Filters]] how to write filters for Moodle 1.9 and before. Note that a Moodle 1.9 filter will still work in Moodle 2.0, but you should still update your code when you get the chance.
* [[Filters schema]] - a page containing some ideas and thoughts about modifications to the filters system
* [[Filters 2.0]] - user documentation about filters.

[[Category:Developer|Filters]]
[[Category:Filter]]

Development:Filters 2.0

2010-12-25T11:09:17Z

Krause:

'''Please note:''' This page contains information for developers. You may prefer to read the [[Filters 2.0| information about filters for teachers and administrators]]. Once Moodle 2.0 is released, [[Development:Filters]] will be renamed to 'Development:Filters 1.9 and before' and this page will be renamed to 'Development:Filters'.

'''Filters''' are a way to automatically transform content before it is output. For example
* render embedded equations to images (the TeX filter)
* Links to media files can be automatically converted to an embedded applet for playing the media.
* Mentions of glossary terms can be automatically converted to links.
The possibilities are endless. There are a number of standard filters included with Moodle, or you can create your own. Filters are one of the easiest types of plugin to create. This page explains how.

==Two types of filter==

Moodle supports two types of filter:
* Stand-alone filters. These live in a folder inside the 'filter' folder. For example, in 'filter/myfilter'. 'filter/tex' is an example of a core filter of this type.
* Filters that are part of an activity module. In this case, the filter code lives inside the 'mod/mymod' folder. 'mod/glossary' is an example of a core module with a filter.
The two types of filter work in exactly the same way, and to create one, you put your code in files with the same name, just in different places in the code base.

==Creating a basic filter==

During this tutorial, we will build a simple example filter. We will make one that adds the word 'hello' before every occurrence of the word 'world'.

1. Since our filter is not part of a module, we should put it inside the 'filter' folder. Therefore, we create a directory called 'filter/helloworld'.

2. Inside that folder, we create a file called 'filter.php'.

3. Inside that PHP file, we define a class called helloworld_filter, that extends the moodle_text_filter class.
<code php>
<?php
class helloworld_filter extends moodle_text_filter {
// ...
}
?>
</code>

4. Inside that class, we have to define one method, called 'filter'. This takes the HTML to be filtered as an argument. The method should then transform that, and return the processed text. Replace the '// ...' above with
<code php>
class helloworld_filter extends moodle_text_filter {
public function filter($text) {
return str_replace('world', 'hello world!', $text);
}
}
</code>

That is basically all there is to it!

==Giving your filter a name==

To try the new filter, you first have to log in as Administrator and enable it by going to the page Administration ► Plugins ► Filters ► Manage filters.

When you do, you will find that your plugin does not have a name. We missed a step:

5. Inside the 'filter/helloworld' folder, create a folder called 'lang', and in there, create a folder called 'en'.

6. Inside there, create a file called 'filter_helloworld.php'. That is, you have just created the file 'filter/helloworld/lang/en/filter_helloworld.php'.

7. In that file, put
<code php>
<?php // $Id$
// Language string for filter/helloworld.

$string['filtername'] = 'Hello world!';
</code>

That may seem a little involved, just to give your filter a name, but it is just [[Development:Places_to_search_for_lang_strings|the standard way Moodle stores language strings for plugins]].

==Trying out your filter==

We had just got to the [[Filters|filters administration screen]]. If you reload that page now, it should now show your filter with its proper name. Turn your filter on now.

Filters are applied to all text that is printed with the [[Development:Output functions|output functions]] format_text(), and, if you have turned on that option, format_string(). So, to see your filter in action, add some content containing the work 'world' somewhere, for example, create a test course, and use the work in the course description. When you look at that course in the course listing, you should see that your filter has transformed it.

==Adding a global settings screen==

Some filters can benefit from some settings to let the administrator control how they work. Suppose we want to greet something other than 'world'. To add global settings to the filter you need to:

8. Create a file called 'filtersettings.php' inside the 'filter/helloworld' folder.

9. In the 'filtersettings.php' file, put something like:
<code php>
$settings->add(new admin_setting_configtext('filter_helloworld_word',
get_string('word', 'filter_helloworld'),
get_string('configword', 'filter_helloworld'), 'world', PARAM_NOTAG));
</code>

10. In the language file 'filter/helloworld/lang/en_utf8/filter_helloworld.php' add the necessary strings:
<code php>
$string['word'] = 'The thing to greet';
$string['configword'] = 'The hello world filter will add the word \'hello\' in front of every occurrence of this word in any content.';
</code>

11. Change the filter to use the new setting:
<code php>
class helloworld_filter extends moodle_text_filter {
public function filter($text) {
global $CFG;
return str_replace($CFG->filter_helloworld_word,
"hello $CFG->filter_helloworld_word!", $text);
}
}
</code>

In standard Moodle, the censor, mediaplugin and tex filters all provide good examples of of how filters use global configuration like this.

==A note about performance==

One important thing to remember when creating a filter is that the filter will be called to transform every bit of text output using format_text(), and possibly also format_string(). That means that you have to be careful, or you could cause big performance problems. If you have to get data out of the database, try to cache it so that you only do a fixed number of database queries per page load. The Glossary filter is an example of this. (I am not sure how good an example ;-))

==Local configuration==

In addition, in Moodle 2.0, filters can also have different configuration in each context. For example, the glossary could be changes so that in Forum A, you can choose to only link words from a particular glossary, sat Glossary A, while in Forum B you choose to link words from Glossary B.

To do that sort of thing, you need to add a file called filterlocalsettings.php. In it, you must define a [[Development:lib/formslib.php|Moodle form]] that is a subclass of filter_local_settings_form. In addition to the standard formslib methods, you also need to define a save_changes method. There is not a good example of this in the standard Moodle install yet. To continue our example:

12. Create a file called 'filterlocalsettings.php' inside the 'filter/helloworld' folder.

13. In the 'filterlocalsettings.php' file, put:
<code php>
class helloworld_filter_local_settings_form extends filter_local_settings_form {
protected function definition_inner($mform) {
$mform->addElement('text', 'word', get_string('word', 'filter_helloworld'), array('size' => 20));
$mform->setType('word', PARAM_NOTAGS);
}
}
?>
</code>

14. Extend the filter to use the new setting, if it is present. The filter must be able to work if the setting is not set, for example by falling back to the global or default setting in this case
<code php>
<?php
class helloworld_filter extends moodle_text_filter {
public function filter($text) {
global $CFG;
if (isset($this->localconfig['word'])) {
$word = $this->localconfig['word'];
} else {
$word = $CFG->filter_helloworld_word;
}
return str_replace($word, "hello $word!", $text);
}
}
?>
</code>

==See also==

* The example filter built here is in contrib CVS at http://cvs.moodle.org/contrib/plugins/filter/helloworld/
* [[Development:Filters]] how to write filters for Moodle 1.9 and before. Note that a Moodle 1.9 filter will still work in Moodle 2.0, but you should still update your code when you get the chance.
* [[Filters schema]] - a page containing some ideas and thoughts about modifications to the filters system
* [[Filters 2.0]] - user documentation about filters.

[[Category:Developer|Filters]]
[[Category:Filter]]

Step by Step Installation on a Mac OS X Server

2010-12-18T15:44:51Z

Krause: /* Use the CVS update script */

==Overview==
This guide shows all steps for the installation of Moodle on a [http://www.apple.com/server/macosx Mac OS X Server]. This server is a commercial product. You will find [http://www.apple.com/server/macosx/resources/documentation.html all documentations] about the web server on the Apple support pages.

This installation guide can't be useful for an installation on MAMP or XAMPP. If you are looking for an easy way to install Moodle on your local machine please use [[Complete Install Packages for Mac OS X | Complete install packages for Mac OS X 10.4/10.5/10.6 Clients]] that can be downloaded from http://download.moodle.org/macosx/ ... but if you are planning to set up a Moodle internet server on a Mac then you should think about some more security as the ever local package could give.

Please feel free to add your ideas and wishes to the discussion page for this article. You may also write a complete chapter if you tried the facts yourself on your own Mac Server. I am most interested to make the things better.

==System requirements==

+ Apple Computer
+ Mac mini, Mac Pro or Xserve
+ Processor: Intel Core 2 Duo, Intel Core i3/i5/i7
+ RAM: 2 GB or better
+ Hard Disk: 500 MB free
+ System Software: Mac OS X Server 10.5 or 10.6

==Configure PHP for your Moodle installation==
===Mac OS X 10.6 Server - No PHP installation needed===

The Mac OS X 10.6.5 Server (SnowLeopard) comes with PHP 5.3.3 and a lot of PHP extensions. This would be the best choice for Moodle 1.9.x and for Moodle 2.0 on a Mac OS X Server. Please forget everything you read about the missing GD Library! The PHP installation is totally complete for Moodle. You only have to switch on the PHP module and to control if the file ''/etc/php.ini'' sets the right values for Moodle.

[[Image:Server-admin-106.png]]

===Mac OS X 10.5 Server - Install PHP 5.3.0 and the GD Library===

The Mac OS X 10.5.8 Server (Leopard) comes with PHP 5.2.6 ... this is correct for Moodle 1.9.x. But you have to add the missing GD Library support to get Moodle running on your server. For Moodle 2.0 the server must have PHP 5.2.8 (or better) and some more PHP extensions ... in this case you need to get the better PHP version. These instructions are helpful in both cases.

To see which PHP version and extensions are installed on your server you should edit the file ''/Library/WebServer/Documents/info.php''. You must activate the function call phpinfo() by deleting the both slashes // at the start of the function line. After saving the file you can get all PHP informations in your browser. Please look at http://your-server-address/info.php ... you will not find any GD library support ... bad thing for Moodle!!

<?php
// You can use Server Admin to enable the Apache PHP module; it's disabled by default.
// You can uncomment the phpinfo() directive below to provide a default PHP info page
// but note that this displays information about your host's configuration.
phpinfo();
?>

The easiest way to get the GD library support and to get a better PHP version would be the installation of the complete PHP 5.3.0 package from http://www.entropy.ch/software/macosx/php/. Marc Liyanage precompiled this package to use it on Mac clients and Mac servers. Please get the package and install it by following the instructions on the download page. The installer does everything for you ... it copies PHP into the correct folder ''/usr/local/php5'' and changes its owner to ''root'' automatically. You will find the file php.ini inside the new package folder. Open the file ''/usr/local/php5/lib/php.ini'' and edit some settings for Moodle.

Note: If you want to install Moodle 1.8.x on the server you need to get the Entropy PHP-5.2.9-7.pkg instead. Moodle 1.8.x does not run with PHP 5.3.0. (MDL-20128)

Now the Apache web server must get knowledge that you want to use the new PHP library instead of the old. Open the application Server Admin to switch to the new library. Go to the web server settings and find the entry php5_module. The normal place for PHP the Mac server is ''libexec/apache2/libphp5.so''. Please change to ''/usr/local/php5/libphp5.so'' and save the settings.

[[Image:Server-admin.png]]

===PHP settings in your php.ini===
The next thing is to configure the file ''php.ini''. Most of the settings are okay but not all of them. To communicate to the MySQL database with PHP you have to set the default socket name for local MySQL connects. The default socket name for local MySQLi connects is needed for Moodle 2.0.

If you want to upload any file to your Moodle you should add a little bit more upload size in php.ini. If your server can't use more than 1 GB RAM you should set the memory_limit to a value less than 128M ... but it should have more than 48M for Moodle 1.9 and Moodle 2.0. Note that these sections are not likely to be consecutive in the php.ini file; the quickest way to find each one is search on the initial term (such as 'mysql.default_socket').

; Default socket name for local MySQL connects.
; If empty, uses the built-in MySQL defaults.
mysql.default_socket = /var/mysql/mysql.sock

; Default socket name for local MySQL connects.
; If empty, uses the built-in MySQL defaults.
mysqli.default_socket = /var/mysql/mysql.sock

; Maximum amount of memory a script may consume (128MB)
memory_limit = 128M

; Maximum allowed size for uploaded files.
upload_max_filesize = 128M

; Maximum size of POST data that PHP will accept.
post_max_size = 128M

; Defines the default timezone used by the date functions
; http://php.net/date.timezone
date.timezone = 'Europe/Berlin';

That's all ... save the file ''php.ini'' and restart the web server. Now you should look at http://your-server-address/info.php again. I hope that everything will be okay. You will find the version number PHP 5.3.x and the running GD library support. Congratulations ... the first step for Moodle on your Mac server is done!

[[Image:phpinfo.png]]

[[Image:phpinfo2.png]]

==Configure the MySQL database for your Moodle installation==

In standard case the database MySQL is installed on the Mac OS X Server but it is not running yet. Please make sure that you start the MySQL database server.

===Use the graphical way===
Sorry ... there are some more installations and a lot of clicks to configure MySQL in a graphical way.

First of all start the ''Server Admin''. You will find this program by the way ''Applications > Server > Server Admin''. Activate MySQL on the local server. You must set the password for the user ''root'' before you can start MySQL.

For the next you must download the MySQL database administration tool '''phpMyAdmin''' from http://www.phpmyadmin.net . Move the folder to the web server documents as ''/Library/WebServer/Documents/phpMyAdmin''.

Add the security phrase to the file ''config.inc.php'' in between the single quotes on the line $cfg['blowfish_secret'] = ''; /* YOU MUST FILL IN THIS FOR COOKIE AUTH! */

Now you will be able to start http://your-server-address/phpMyAdmin/ in your browser and to log into the database as the user ''root''. Add a database ''moodle19''. Add a database user ''moodle'' to the server ''localhost''. Don't forget to set a secure password. The database user ''moodle'' should be allowed to administrate the database ''moodle19'' only. It is a bad way to set ''root'' to administrate the database ''moodle19''. If you want to install also Moodle 2.0 dev please add a second database ''moodle20'' and use the same database user for it.

phpMyAdmin is a nice thing to look into the database while Moodle is running for some time. It's much easier to see in the graphical interface than in the command line tools. The image shows the database after Moodle 1.9 and Moodle 2.0 were already installed on this server.

[[Image:phpmyadmin.png]]

===Use the Terminal===

If you want a quick installation then don't fear to use the Terminal. It's easier to tell you all the commands for the right way with the Terminal than showing you all the pictures to do the same with graphical tools. There are only a few commands to do everything I told you before.

Start the Terminal. You will find this program by the way ''Applications > Tools > Terminal''. You will see that we must do the same steps as before but you can read them in a text form.

First of all you need to set the root password. If you didn't this before then use the first command line. If you want to change an existing password then use the second one.

Server:~ $ mysqladmin -u root password 'secret'
Server:~ $ mysqladmin -u root -p password 'topsecret'

The next steps are creating a new database ''moodle19'' with correct character set and setting up a database user ''moodle'', with an assigned password (IDENTIFIED BY), to administrate the new database ... and if you want, then do the same for ''moodle20''.

Server:~ $ mysqladmin -u root -p create moodle19
Server:~ $ mysql -u root -p

mysql> ALTER DATABASE moodle19 CHARSET 'utf8';
mysql> GRANT ALL PRIVILEGES ON moodle19.* TO moodle@localhost
-> IDENTIFIED BY 'moodle!';
mysql> quit

Server:~ $

That's really all with the Terminal. You are just ready!

===Use InnoDB with Moodle 2.0===

For Moodle 2.0 you should setup the support for InnoDB in your MySQL database.

Open the file /etc/my.cnf an delete every # in all lines beginning with innodb. This uncomments the InnoDB settings. Please save the file and restart your MySQL database.

# Uncomment the following if you are using InnoDB tables
innodb_data_home_dir = /var/mysql/
innodb_data_file_path = ibdata1:2000M;ibdata2:10M:autoextend
innodb_log_group_home_dir = /var/mysql/
innodb_log_arch_dir = /var/mysql/
# You can set .._buffer_pool_size up to 50 - 80 %
# of RAM but beware of setting memory usage too high
innodb_buffer_pool_size = 384M
innodb_additional_mem_pool_size = 20M
# Set .._log_file_size to 25 % of buffer pool size
innodb_log_file_size = 100M
innodb_log_buffer_size = 8M
innodb_flush_log_at_trx_commit = 1
innodb_lock_wait_timeout = 50

==Copy the Moodle files to the web server==

The documents for the web server are saved in the folder ''/Library/WebServer/Documents/''. You will place your Moodle folder here after you got it from http://download.moodle.org. Download the standard package MOODLE_19_WEEKLY because this is the best choice for new servers. Set the owner ''_www'' for the moodle folder ... this is the user for the web server. The folder permissions should be 755 before the installation and 555 after it's done ... please remember to set this later!

You also need the moodledata folder outside of the Documents folder ... so please make one. Go to the folder ''/Library/WebServer/'' and add the folder ''moodledata''. Because I want to install Moodle 1.9.x and Moodle 2.0 dev together on the same Mac server I add two folders ''moodle19'' and ''moodle20'' inside the moodledata folder. Please set the owner ''_www'' for both folders ''moodle19'' and ''moodle20'' and the folder permissions to 755.

cd /Library/WebServer/
mkdir moodledata
mkdir moodledata/moodle19
mkdir moodledata/moodle20
sudo chown -R _www moodledata
sudo chmod -R 755 moodledata

If you'd like to put the moodledata folder on another volume (not a bad idea if you think you'll have a substantial amount of data within the moodle), note that you cannot simply reference it using the /Volumes/<volume_name>/folder syntax during the moodle setup. Instead, you'll need to create the folder (assigning the user and permissions), then create a '''link''' to it within the /Library/WebServer folder. To create the link, use the following command in a terminal window, substituting your data volume and folder name:

cd /Library/WebServer
ln -s /Volumes/Data_Volume/moodledata moodledata

==Run the Moodle installation==
The installation on the Mac server is the same like the installation on every other server.
Open a web browser to http://your-server-address/moodle/install.php to begin the installation process.
On the screen picture and in the shown config.php you see the web address ''your-server-address'' ... it's only a placeholder for a real address or url ... please set yours. Also a user 'moodle' with a password 'moodle' would be very unsafe settings for your installation.

[[Image:moodle-install1.png]]

[[Image:moodle-install2.png]]

The installer generates the config.php automatically and saves it in the folder ''/Library/WebServer/Documents/moodle19''. Please edit the config.php with a text editor and add the line ''date_default_timezone_set('UTC');''. You may change ''UTC'' to your own timezone ... this is needed for PHP 5.3.0. In case you don't know all the relevant time zone identifiers by heart, there is a [http://phpbuilder.com/manual/en/timezones.php list available online].

<?php /// Moodle Configuration File

unset($CFG);

$CFG->dbtype = 'mysql';
$CFG->dbhost = 'localhost';
$CFG->dbname = 'moodle19';
$CFG->dbuser = 'moodle';
$CFG->dbpass = 'moodle';
$CFG->dbpersist = false;
$CFG->prefix = 'mdl_';

$CFG->wwwroot = 'http://your-server-address/moodle19';
$CFG->dirroot = '/Library/WebServer/Documents/moodle19';
$CFG->dataroot = '/Library/WebServer/moodledata/moodle19';
$CFG->admin = 'admin';

$CFG->directorypermissions = 00777; // try 02777 on a server in Safe Mode

date_default_timezone_set('Europe/Berlin'); // timezone for PHP 5.3.0
require_once("$CFG->dirroot/lib/setup.php");
// MAKE SURE WHEN YOU EDIT THIS FILE THAT THERE ARE NO SPACES, BLANK LINES,
// RETURNS, OR ANYTHING ELSE AFTER THE TWO CHARACTERS ON THE NEXT LINE.
?>

After this, the web-based installation component will walk you through '''several''' screens worth of database configurations and updates, for most of which you'll just click the continue button. You'll set up an admin user and give the site a basic configuration (title, description, etc). When the installation is ready you should change the folder permission for ''/Library/WebServer/Documents/moodle19'' to 555 so the web server is not able to write into this folder again.

==Download the language packages==

==Moodle is running ...==
[[Image:moodle-on-macosx-server.png]]

==How to setup the cron job with launchd==

It's really important to start the cron job every 5 minutes. The cron job assists most of Moodle's modules to perform tasks on a scheduled basis. For example, the discussion forums can only mail out copies of new posts to all subscribers if the cron job tells Moodle to do this.

In Mac OS X you will find the system daemon ''launchd'' for this service. This daemon offers a standardized interface to any user and all programs started automatically by the system. Please look at http://developer.apple.com/macosx/launchd.html for more information about the configurations and all parameters.

In our case the service should get the web page http://your-server-address/moodle19/admin/cron.php every 5 minutes. The configuration will be done by the file named ''moodle4mac.cron.plist'' which must be placed in the system folder ''/Library/LaunchDaemons/'' ... surely you can use any other file name but it should say something about the function of the service. The extension must be ''.plist''. After any reboot of your Mac server the cron service will start automaticly because the file is placed in the correct system folder.

===Use the graphical way===
You can use Lingon to add a new daemon plist or to edit one. It produces the same text as you can write in your text editor. http://sourceforge.net/projects/lingon/files/

[[Image:macosx-lingon.png]]

===Use a text editor===
Please use a text editor to write the needed file. You can open the Terminal and use the system editors vi or pico. But you can also write the text file with any GUI text editor ... I mostly use TextWrangler ... but do NOT take an editor for formatted texts like Microsoft Word or OpenOffice Writer. You must get pure text!

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0//EN"
"http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>KeepAlive</key><false/>
<key>Label</key><string>moodle4mac.cron</string>
<key>ProgramArguments</key>
<array>
<string>curl</string>
<string>-s</string>
<string>http://your-server-address/moodle19/admin/cron.php</string>
</array>
<key>RunAtLoad</key><true />
<key>StartInterval</key><integer>300</integer>
<key>StandardErrorPath</key><string>/dev/null</string>
<key>StandardOutPath</key><string>/dev/null</string>
</dict>
</plist>

The label string must be the same as the file name is but without the extension ''.plist''. Save the text file ''/Library/LaunchDaemons/moodle4mac.cron.plist''. The owner of the file must be set to the system user ''root''. That's all, really!

===How to start and stop the cron service===
You can start the new cron service in the Terminal.

sudo launchctl load /Library/LaunchDaemons/moodle4mac.cron.plist

The following command would stop the service. If you want to activate changes in the cron service you need to ''unload'' and then to ''load'' the daemon again.

sudo launchctl unload /Library/LaunchDaemons/moodle4mac.cron.plist

===Only one service for two servers?===
For my server I needed to have a cron service for to instances ''moodle19'' and ''moodle20'' ... no problem ... with the typo ''moodle[19-20]'' the server will get a cron service for both instances.

<nowiki>curl -s http://your-server-address/moodle[19-20]/admin/cron.php</nowiki>

To see if the cron service works correctly you should look at the ''access.log'' of your web server. The cron.php should be accessed every 5 minutes ... on my server for both Moodle instances ''moodle19'' and ''moodle20'' ... oh yes, it works!!

192.168.0.220 - - [30/Jul/2009:22:10:56 +0200] "GET /moodle19/admin/cron.php HTTP/1.1" 200 1136
192.168.0.220 - - [30/Jul/2009:22:10:57 +0200] "GET /moodle20/admin/cron.php HTTP/1.1" 200 1403
192.168.0.220 - - [30/Jul/2009:22:11:18 +0200] "OPTIONS * HTTP/1.0" 200 -
192.168.0.220 - - [30/Jul/2009:22:15:56 +0200] "GET /moodle19/admin/cron.php HTTP/1.1" 200 735
192.168.0.220 - - [30/Jul/2009:22:15:57 +0200] "GET /moodle20/admin/cron.php HTTP/1.1" 200 964
192.168.0.220 - - [30/Jul/2009:22:20:56 +0200] "GET /moodle19/admin/cron.php HTTP/1.1" 200 1136
192.168.0.220 - - [30/Jul/2009:22:20:57 +0200] "GET /moodle20/admin/cron.php HTTP/1.1" 200 1365

==How to install and update Moodle via CVS==

CVS is very simple way to install and update your Moodle.

The only software you must have installed on your Mac server is the Xcode Tools package from your system installation media. You also must have an internet connection to get the files from the update server. After you installed both script files on your server desktop it only needs a doubleclick to get the newest Moodle version without downloading the complete installation package. Please remember - before you can update your Moodle via CVS you must install Moodle via CVS at once.

That's all .... really .... it's easy!!

===Use the CVS installation script===
If your Moodle is already installed via CVS please use the CVS updater (see below). Running the CVS installer will install only the standard version of Moodle on your server.

If you already have a working Moodle on your server then this script copies the file config.php into your new installation but it does not copy your additional modules or plugins or themes. You will find your old moodle folder in same directory and it will be renamed with an additional date stamp.

<pre>
#! /bin/sh
#
# CVS installer for Moodle
# on a Mac OS X Server
#
# 20100818 - Ralf Krause
#

export CVS_RSH=ssh

### file ~/.cvspass must exist
if ! test -e ~/.cvspass ; then
touch ~/.cvspass
fi

echo
echo "+--------------------------------------------+"
echo "| CVS installer for the Moodle server "
echo "+--------------------------------------------+"
echo

cd /Library/WebServer/Documents

### get the cvs installation into a tmp folder
if ! test -e tmp ; then
sudo mkdir tmp
sudo chmod 777 tmp
fi

echo "Connecting to the CVS server. Download will take a few moments!"
echo "If the CVS update runs too long you may break with <ctrl>-C"
echo

### do the cvs installation
cd tmp
cvs -z9 -d:pserver:anonymous@uk.cvs.moodle.org:/cvsroot/moodle co -P -r MOODLE_19_WEEKLY moodle
cd ..

### copy config.php from your current moodle folder if it exists
if ! test -e moodle/config.php ; then
cp moodle19/config.php tmp/moodle/config.php
fi

### move the new moodle to the right place
DATE=`date +%Y%m%d-%H%M`
sudo mv moodle19 moodle19-$DATE
sudo mv tmp/moodle moodle19
sudo chown -R _www moodle19
</pre>

===Use the CVS update script===
To be able to update Moodle via CVS please check that your Moodle was already installed via CVS (see above).

<pre>
#! /bin/sh
#
# CVS updater for Moodle
# on a Mac OS X Server
#
# 20100818 - Ralf Krause
#

export CVS_RSH=ssh

echo
echo "+--------------------------------------------+"
echo "| CVS updater for the Moodle server "
echo "+--------------------------------------------+"
echo

cd /Library/WebServer/Documents/moodle19/

### file ~/.cvspass must exist
if ! test -e ~/.cvspass ; then
touch ~/.cvspass
fi

### login to the cvs server only for the first time
if ! grep "uk.cvs.moodle.org" ~/.cvspass > /dev/null ; then
echo "CVS password is empty ... please only press <return> to start"
sudo cvs -d :pserver:anonymous@uk.cvs.moodle.org:/cvsroot/moodle login
echo
fi

echo "Connecting to the CVS server. Download will take a few moments!"
echo "If the CVS update runs too long you may break with <ctrl>-C"
echo

### do the cvs installation
sudo cvs -q update -dP -r MOODLE_19_WEEKLY
sudo chown -R _www .
</pre>

Please look at the documentation [https://docs.moodle.org/en/CVS_for_Administrators CVS for Administrators] if you want to learn more about Moodle and CVS. There you will also find a list of different [https://docs.moodle.org/en/CVS_for_Administrators#CVS_Servers CVS servers for Moodle] which you may choose for your updates.

The shown update script should be modified in only three things ... first you need to choose the correct folder for the Moodle files, second choose a CVS server near your server place to minimate internet traffic, and third you must input the correct CVS tag for the Moodle version in the last line. The shown script is for updating the version Moodle 1.9
* Moodle 1.8 uses MOODLE_18_WEEKLY
* Moodle 1.9 uses MOODLE_19_WEEKLY
* Moodle 2.0 still uses HEAD

===Troubleshooting===

If CVS does not work on your server please check that the connection port is open. 
If you see something like this, make sure that there is no firewall blocking the port (it's port 2401):

$ cvs -d:pserver:anonymous@us.cvs.moodle.org:/cvsroot/moodle login
Logging in to :pserver:anonymous@us.cvs.moodle.org:2401/cvsroot/moodle
CVS password:
cvs [login aborted]: connect to us.cvs.moodle.org(130.212.64.111):2401 failed: Connection timed out

===Install Xcode Tools and CVS on your Mac Server===

To test if cvs is already on your Mac Server please open the Terminal and type ''cvs -v''. The output of this command should show a version notice of your Concurrent Versions System (CVS). If you get the ''command not found'' message then you must search for your Mac OS X 10.5 Server installation media. You will find the Xcode Tools on your installation CD or DVD set.

If you can't find your installation media anymore you also can download the Xcode Tools from the URL http://developer.apple.com/tools/xcode/. It is free but you have to register as a developer. Starting the download then the Xcode package copies a lot of bytes on your harddisk and will need a very few minutes to complete.

After you installed the Xcode Tools in your server system you will get the correct version answer from the Terminal command ''cvs -v''. If you only want to update your Moodle you do not need all these nice developer tools from the inside of the folder. Sorry about this but there is no separate installer for the CVS update process.
  

==User administration via LDAP==

The following settings will work on 10.5 Server running LDAP - edit them to customize to your own environment. Please note that moodle requires some fields - it is best to have these fields completed in Workgroup Manager on 10.5 Server - otherwise they'll be prompted to enter info into their moodle profile on first login, but the way we've got it set up, moodle can't modify LDAP for security and data integrity. The necessary fields are user name, first name, surname, Email address, City/Town, country, description, ID number.
<pre>
LDAP SERVER SETTINGS
Host URL = ourserver.example.com
Version = 3
LDAP encoding = utf-8

BIND SETTINGS
Hide passwords = Yes
Distinguished Name = (blank)
Password = (blank)

USER LOOKUP SETTINGS
User type = posixAccount (rfc2307)
Contexts = cn=users,dc=ourserver,dc=example,dc=com
Search subcontexts = Yes
Dereference aliases = No
User attribute = (blank)
Member attribute = (blank)
Member attribute uses dn = (blank)
Object class = (blank)

FORCE CHANGE PASSWORD
Force change password = No
Use standard Change Password Page = No
Password format = Plain text
Password change URL = (blank)

LDAP PASSWORD EXPIRATION SETTINGS
Expiration = no
Expiration warning = 10
Expiration attribute = ""
Grace logins = No
Grace login attribute = (blank)

ENABLE USER CREATION
Create users externally = No
Context for new users = (blank)

COURSE CREATOR
Creators = (blank)

CRON SYNCHRONIZATION SCRIPT
Removed ext user = Keep internal

NTLM SSO
Enable = No
Subnet = (blank)
First name = givenName (On every login, Never, Locked)
Surname = sn (On every login, Never, Locked)
Email address = mail (On every login, Never, Locked)
Phone 1 = (blank)
Phone 2 = (blank)
Department = (blank)
Address = (blank)
City/Town = l (On every login, Never, Locked)
Country = c (On every login, Never, Locked)
Description = description (On every login, Never, Locked)
ID number = uidNumber (On every login, Never, Locked)
Language = (blank)
</pre>

==See also==
* [[Complete Install Packages for Mac OS X | Complete install packages for Mac OS X Clients 10.4/10.5/10.6]]
* [[Step-by-step Guide for Installing Moodle on Mac OS X 10.4 Client|Step by step installation on a Mac OS X Client 10.4]]
* [[Cron | Installation of cron for Moodle]]
* [[CVS for Administrators]]

* [http://moodle.org/mod/forum/discuss.php?d=24632 Using Moodle: Dynamic DNS Home Server]

[[Category:Administrator]]
[[Category:Installation]]
[[Category:Mac OS X]]

File:Moodle4Mac 4.png

2010-12-18T15:40:52Z

Krause: uploaded a new version of "Image:Moodle4Mac 4.png"

File:Moodle4Mac 1.png

2010-12-18T15:38:50Z

Krause: uploaded a new version of "Image:Moodle4Mac 1.png"

File:Moodle4Mac 2.png

2010-12-18T15:37:58Z

Krause: uploaded a new version of "Image:Moodle4Mac 2.png"

File:Moodle4Mac 1.png

2010-12-18T15:36:22Z

Krause: uploaded a new version of "Image:Moodle4Mac 1.png"

File:Moodle4Mac 1.png

2010-12-18T15:35:15Z

Krause: uploaded a new version of "Image:Moodle4Mac 1.png"

Complete Install Packages for Mac OS X

2010-12-18T15:31:01Z

Krause: /* Download and install Moodle4Mac */

Complete install packages for Mac OS X are available from [http://download.moodle.org/macosx/ Moodle Downloads] which uses '''MAMP'''. You will find a separate card for the Mac OS X downloads. They are designed for new and local installations on a Mac computer/server. There are other downloads for Linux, and Window Operating Systems that may involve more customization of configuration files.

The complete install packages for Mac OS X are named Moodle4Mac. These do not have sufficient security for public, production servers--only use for private, local testing purposes. These packages allow Moodle to be installed, along with the prerequisites that includes a web server, database and scripting language (Apache, MySQL and PHP in this case). Several versions of the complete install package are available. You will find versions for Intel based Macs and for older PPC based Macs. Please use the correct version for your processor. The instructions on the download page provide guidance on which version is likely to be most suitable.

'''Note 1:''' The latest complete install package version components, may not be backwardly compatible. Always check version compatibility of each component if you intend to develop materials on a later version of Moodle than the version installed on your "main" Moodle site. In short, complete install packages are designed for first time install on a "clean" machine.

'''Note 2:''' If you want a secure, public server with OS X, you may be interested to use the normal web server that comes preinstalled with every Mac Computer--see the [[Step-by-step Guide for Installing Moodle on Mac OS X 10.4 Client]] for Moodle. However, remember that the complete package Moodle4Mac is ready to use and no additional programs must be installed and configured together.

==System requirements==
+ Apple Mac Computer
+ iMac, Mac mini, MacBook, iBook, PowerBook, Mac Pro, Xserve
+ Processor: Intel Core 2 Duo or PPC (G4, G5)
+ RAM: 1 GB or better
+ Hard Disk: 500 MB free
+ System Software: Mac OS X 10.4, 10.5, or 10.6

==Install complete package Moodle4Mac==
===Download and install Moodle4Mac===
'''Step 1:''' [http://download.moodle.org/macosx/ Download] the zipped disk image file from the Moodle download page. Please choose the correct file for your processor type. The zip archive should be unzipped automatically when the download is complete. If the download file is not unzipped please do this manually.

'''Step 2:''' Doubleclick the file Moodle4Mac.dmg to mount the installation disk.

[[Image:Moodle4Mac_1.png]]

'''Step 3:''' Move the folder '''MAMP''' into the folder '''Applications'''. Moodle4Mac is based on MAMP (Mac, Apache, MySQL, PHP). MAMP makes no entries in any registry and no settings for the system variables. If you want to know more about MAMP please read the project page http://mamp.info/

'''Step 4:''' Now you are ready to start your web server. Go to the Applications folder. Find the MAMP folder and open it.

[[Image:Moodle4Mac_2.png]]

'''Step 5:''' Doubleclick the icon MAMP to start the server.

[[Image:Moodle4Mac_4.png]]

'''Step 6:''' Start your browser and type <nowiki> http://127.0.0.1:8888 or http://localhost:8888 </nowiki> in the address bar. You will start your preinstalled Moodle. You do not need to do any installation. You are ready. Done ... hey, that was easy, wasn't it??

[[Image:Moodle4Mac_3.jpg]]

'''Step 7:''' Please login with the username '''admin''' and the password '''12345''' and you will be the main administrator of your new local Moodle.

==Using Moodle4Mac as a local server in your network==

In some workshops we used Moodle4Mac as a quick server installation for our local network. You should change the admin passwords (Moodle and MySQL) before you do this. There are only two steps to get the server connection from every computer in your network. One step is the change of only one line in the Moodle config.php, and the second step is that you must open the firewall of the Mac OS X. This chapter shows how you can do this.

===Edit the file config.php===

Use the current ip address of your computer instead of localhost so an external computer can connect the the web server. If your network is configured to dynamic ip addresses via DHCP please make sure that your computer retains its ip address while you want to use it as a Moodle server.The best thing would be to get a static ip address for your computer. Mostly your ip address in a local network will show one of the following numbers 10.x.x.x, 172.x.x.x, or 192.168.x.x

If your computer for example has the ip address 192.168.0.20 then you must change the configuration from ''localhost'' to ''192.168.0.20''. In the following box you will see this address in the line $CFG->wwwroot. This ip address will be different in your own network. You must use own address for your own network!! Please do not use an ip address if you do not know what you are doing ... ask your network administrator.

<pre><?php /// Moodle Configuration File

unset($CFG);

$CFG->dbtype = 'mysql';
$CFG->dbhost = 'localhost';
$CFG->dbname = 'moodle20';
$CFG->dbuser = 'moodle';
$CFG->dbpass = 'moodle';
$CFG->dbpersist = false;
$CFG->prefix = 'mdl_';
$CFG->dboptions = array ('dbpersit' => 0, );

// Use the ip address of your computer instead of localhost
$CFG->wwwroot = 'http://192.168.0.20:8888/moodle20';
$CFG->dirroot = '/Applications/MAMP/htdocs/moodle20';
$CFG->dataroot = '/Applications/MAMP/data/moodle20';
$CFG->admin = 'admin';

$CFG->passwordsaltmain = 'some_very_long_secret!#A12345678901234567890!';
$CFG->directorypermissions = 00777; // try 02777 on a server in Safe Mode

require_once("$CFG->dirroot/lib/setup.php");

// There is no php closing tag in this file,
// it is intentional because it prevents trailing whitespace problems!
</pre>

===Open the firewall===
The web server that comes together with Moodle4Mac works on the TCP port 8888. Moodle4Mac uses this port because this gets no conflicts with the normal web server of Mac OS X that answers on TCP port 80. You can switch the port from 8888 to 80 but you must know the administration password of your Mac. In this case the normal web server will not work.

To open the firewall please go to '''System Preferences > Sharing > Firewall'''. Choose '''New...''', fill in TCP port 8888, and set the rule name '''Moodle4Mac'''.

[[Image:Moodle4Mac_Firewall1.png]]

When the rule exists it must be activated to get a connection to Moodle from any computer in your internal network.

[[Image:Moodle4Mac_Firewall2.png]]

===Connect Moodle from your network ...===
Your web server can be connected with the url http://x.x.x.x:8888/moodle18/ in your local network, where x.x.x.x is the address your Mac was given by the local router on your LAN. Usually such numbers start with 10.x.x.x, 172.x.x.x, or 192.168.x.x. All users from any computer in your network can use your Moodle via this address.

This also works if your computer is connected to the internet directly. If you open the firewall in your internet router and if you forward the port 8888 to your computer then any user everywhere on the world would be able to work with your Moodle ... but please remember also that there are a lot of security risks if you do this ... it would be better if you don't do this!!

[[Image:Moodle4Mac_Network1.png]]

[[Image:Moodle4Mac_Network2.png]]

==Some words about the security ...==
===MAMP is designed for local computers===
MAMP can be used for testing and developing websites locally on their Apple computers. MAMP should not be used in a production environment because everybody knows all the settings and all the predefined passwords. It's prepared for an easy start and not for a public web server!! But with some careful modfications, you can sufficiently secure MAMP and Moodle4Mac to use them in public development environments.

===How to secure MAMP?===
I found some ideas in the following document: [http://www.network0.org/2006/09/23/how-to-secure-mamp/ How to secure MAMP?]. It's really old and some of the instructions are not correct for the current version.

There is also a new package MAMP Pro that will let you do a lot of settings for a more secure web server. Please look to the web page for this product. You can find a describtion for MAMP Pro on the [http://www.living-e.com/MAMP-PRO/ MAMP internet server]. It's commertial and not free!

===Step by step to secure Moodle4Mac===

  
==How to set up SSL/https in MAMP for a development/test environment==
The text is copied from [http://www.webopius.com/content/355/getting-mamp-working-with-ssl-on-os-x webopius web site] (excepted the last steps).

#stop MAMP
#backup your /Applications/MAMP/conf folder
#open a terminal
#enter: ''openssl genrsa -des3 -out server.key 1024''. Enter a password twice.
#enter: ''openssl req -new -key server.key -out server.csr''. Enter the previous password. You need to answer some questions. ''Common name'' expects your local name (for me it was jerome.moodle.local)
#enter: ''openssl x509 -req -days 365 -in server.csr -signkey server.key -out server.crt''
#enter: ''cp server.key server.tmp''
#enter: ''openssl rsa -in server.tmp -out server.key''. Enter the previous password.
#enter: ''mkdir /Applications/MAMP/conf/ssl''
#enter: cp server.crt /Applications/MAMP/conf/ssl
#enter: cp server.key /Applications/MAMP/conf/ssl
# Edit Applications/MAMP/conf/apache/ssl.conf:
##comment <IfDefine SSL> tag to closing tag (but not the content)
##SSLCertificateFile /Applications/MAMP/conf/ssl/server.crt
##SSLCertificateKeyFile /Applications/MAMP/conf/ssl/server.key
# Edit /Applications/MAMP/conf/apache/httpd.conf:
##Listen 80
##comment <IfDefine SSL> tag to closing tag (but not the content)
# Edit /Application/MAMP/conf/apache/ssl.conf, change the document root (DocumentRoot) for the one you have into /Application/MAMP/conf/apache/httpd.conf
#in a terminal enter: ''cd /Applications/MAMP/bin/apache2/bin''
#enter: ''sudo ./apachectl startssl''
#start MAMP

From now MAMP should start/stop with the SSL support activated. Note that these steps have only be tested with Apache port set to 80 into MAMP preferences.

==How To Update Your Moodle4Mac==

It is very simple to update your locally installed Moodle. If you have got this course together with Moodle4Mac then you should have everything you need for a CVS update.

The only software you must have installed on your Apple computer is the Xcode Tools package from your system installation media. After this it only needs a doubleclick to get the newest Moodle version without downloading the complete installation package.

===Update the local Moodle via CVS===

Be sure that the Xcode Tools are installed on your Mac computer. You also must have an internet connection to get the files from the update server.

Now the only thing you need to do is to doubleclick on an icon inside your MAMP folder. That's all .... really .... it's easy!!

Please look for the document '''UpdateMoodle.sh'''. If you doubleclick this file you will see that the system utility '''Terminal''' opens and the update process starts automatically. You must allow to connect to the Moodle internet server ... but think about this fact only if a system tool asks you.

[[Image:Moodle4Mac_Update1.png]]

The update tool CVS connects to the Moodle internet server and looks for all those files that must be downloaded. If the process asks for a password you press the return button to enter ... the password is "empty". The update needs a few moments to find all the updated or new files but then only those files are transfered. Please wait for some minutes.

[[Image:Moodle4Mac_Update2.png]]

Every updated file is shown in the update log so you can control if the updater works and when it is completed. At least you will see the config.php because this file does not come from the update server.

If the update takes too long you may break with <strg>-C. It doesn't matter because only text files are copied. On break the process stops working. If you restart the update again the CVS tool runs through all folders and files again to find those that need to be renewed.

===Look Inside ... ===

If you want to see what is inside the document '''UpdateMoodle.sh''' please feel free to open it with a text editor. It is only a text file but it uses the Mac OS X feature to open a file with a chosen program via doubleclick.

[[Image:Moodle4Mac_Update3.png]]

I chose the system utility '''Terminal''' to open the file '''UpdateMoodle.sh''' and to run the script it contains automatically. So everything can be done with a doubleclick. It's easy and everybody can do it!!

<pre>
#! /bin/sh
#
# This CVS updater for Mac OS X is part
# of the installation package Moodle4Mac
#
# 20101201 - Ralf Krause
#

export CVS_RSH=ssh

echo
echo "+--------------------------------------------+"
echo "| CVS update for your local Moodle server "
echo "+--------------------------------------------+"
echo

cd /Applications/MAMP/htdocs/moodle20/

### delete all files named .DS_Store
find . -name ".DS_Store" -type f -print0 | xargs -0 rm -f

### file ~/.cvspass must exist
if ! test -e ~/.cvspass ; then
touch ~/.cvspass
fi

### login to the cvs server only for the first time
if ! grep "uk.cvs.moodle.org" ~/.cvspass > /dev/null ; then
echo "CVS password is empty ... please only press <return> to start"
cvs -d :pserver:anonymous@uk.cvs.moodle.org:/cvsroot/moodle login
echo
fi

echo "Connecting to the CVS server. Download will take a few moments!"
echo "If the CVS update runs too long you may break with <strg>-C"
echo
cvs -q update -dP -r HEAD

</pre>

The different versions of the update script are different in only two things ... first you need to choose the correct folder for the Moodle files and seconds you must input the correct CVS tag for the Moodle version in the last line. The shown script is for updating the version Moodle 1.8
* Moodle 1.6 uses MOODLE_16_WEEKLY
* Moodle 1.7 uses MOODLE_17_WEEKLY
* Moodle 1.8 uses MOODLE_18_WEEKLY
* Moodle 1.9 uses MOODLE_19_WEEKLY
* Moodle 2.0 still uses HEAD

===Install Xcode Tools on your Mac===

Xcode Tools is the developer tools package for Mac OS X. This package includes an integrated suite of software development tools, including compilers and applications.

If you do not know whether the Xcode Tools are installed on your Mac please look on your main harddrive. If there is a folder named Developer then you must do nothing.

[[Image:Moodle4Mac_Update4.png]]

If you cannot find this on your harddrive then you must install this package before following the instructions in this document. The Xcode Tools package is part of the Mac OS X installation media. You will find the Xcode Tools on your installation CD or DVD set.

[[Image:Moodle4Mac_Update5.png]]

If you do not find your installation media anymore you also can download the Xcode Tools from the URL http://developer.apple.com/tools/xcode/. It is free but you have to register as a developer. If you start the download from there please remember that the Xcode package brings a lot of bytes and will need a very few minutes to complete.

After you have put these things into your system you will see a new folder named Developer on your harddisk. If you only want to update your Moodle you do not need all these nice developer tools from the inside of the folder. Sorry about this but there is no separate installer for the CVS update process.
  

==See also==
* [http://mamp.info MAMP = Mac + Apache + MySQL + PHP]
* [http://en.wikipedia.org/wiki/MAMP MAMP in Wikipedia]
* [[Step by Step Installation on a Mac OS X Server|Step by Step Installation on a Mac OS X Server 10.5/10.6]]
* [[Step-by-step Guide for Installing Moodle on Mac OS X 10.4 Client|Step by step Installation on a Mac OS X Client 10.4]]
* [[CVS for Administrators]]

* [http://en.wikipedia.org/wiki/Private_network Private network addresses in Wikipedia]
* [http://moodle.org/mod/forum/discuss.php?d=24632 Using Moodle: Dynamic DNS Home Server]

* [[Configuring aspell on Mac OS X]]

[[Category:Administrator]]
[[Category:Installation]]
[[Category:Mac OS X]]

[[de:Vollständiges Installationspaket für Mac OS X]]

File:Moodle4Mac 3.jpg

2010-12-18T15:30:13Z

Krause: uploaded a new version of "Image:Moodle4Mac 3.jpg"

Complete Install Packages for Mac OS X

2010-12-18T15:28:31Z

Krause: /* Download and install Moodle4Mac */

Complete install packages for Mac OS X are available from [http://download.moodle.org/macosx/ Moodle Downloads] which uses '''MAMP'''. You will find a separate card for the Mac OS X downloads. They are designed for new and local installations on a Mac computer/server. There are other downloads for Linux, and Window Operating Systems that may involve more customization of configuration files.

The complete install packages for Mac OS X are named Moodle4Mac. These do not have sufficient security for public, production servers--only use for private, local testing purposes. These packages allow Moodle to be installed, along with the prerequisites that includes a web server, database and scripting language (Apache, MySQL and PHP in this case). Several versions of the complete install package are available. You will find versions for Intel based Macs and for older PPC based Macs. Please use the correct version for your processor. The instructions on the download page provide guidance on which version is likely to be most suitable.

'''Note 1:''' The latest complete install package version components, may not be backwardly compatible. Always check version compatibility of each component if you intend to develop materials on a later version of Moodle than the version installed on your "main" Moodle site. In short, complete install packages are designed for first time install on a "clean" machine.

'''Note 2:''' If you want a secure, public server with OS X, you may be interested to use the normal web server that comes preinstalled with every Mac Computer--see the [[Step-by-step Guide for Installing Moodle on Mac OS X 10.4 Client]] for Moodle. However, remember that the complete package Moodle4Mac is ready to use and no additional programs must be installed and configured together.

==System requirements==
+ Apple Mac Computer
+ iMac, Mac mini, MacBook, iBook, PowerBook, Mac Pro, Xserve
+ Processor: Intel Core 2 Duo or PPC (G4, G5)
+ RAM: 1 GB or better
+ Hard Disk: 500 MB free
+ System Software: Mac OS X 10.4, 10.5, or 10.6

==Install complete package Moodle4Mac==
===Download and install Moodle4Mac===
'''Step 1:''' [http://download.moodle.org/macosx/ Download] the zipped disk image file from the Moodle download page. Please choose the correct file for your processor type. The zip archive should be unzipped automatically when the download is complete. If the download file is not unzipped please do this manually.

'''Step 2:''' Doubleclick the file Moodle4Mac.dmg to mount the installation disk.

[[Image:Moodle4Mac_1.png]]

'''Step 3:''' Move the folder '''MAMP''' into the folder '''Applications'''. Moodle4Mac is based on MAMP (Mac, Apache, MySQL, PHP). MAMP makes no entries in any registry and no settings for the system variables. If you want to know more about MAMP please read the project page http://mamp.info/

'''Step 4:''' Now you are ready to start your web server. Go to the Applications folder. Find the MAMP folder and open it.

[[Image:Moodle4Mac_2.png]]

'''Step 5:''' Doubleclick the icon MAMP to start the server.

[[Image:Moodle4Mac_4.png]]

'''Step 6:''' Start your browser and type <nowiki> http://127.0.0.1:8888 or http://localhost:8888 </nowiki> in the address bar. You will start your preinstalled Moodle. You do not need to do any installation. You are ready. Done ... hey, that was easy, wasn't it??

[[Image:Moodle4Mac_3.png]]

'''Step 7:''' Please login with the username '''admin''' and the password '''12345''' and you will be the main administrator of your new local Moodle.

==Using Moodle4Mac as a local server in your network==

In some workshops we used Moodle4Mac as a quick server installation for our local network. You should change the admin passwords (Moodle and MySQL) before you do this. There are only two steps to get the server connection from every computer in your network. One step is the change of only one line in the Moodle config.php, and the second step is that you must open the firewall of the Mac OS X. This chapter shows how you can do this.

===Edit the file config.php===

Use the current ip address of your computer instead of localhost so an external computer can connect the the web server. If your network is configured to dynamic ip addresses via DHCP please make sure that your computer retains its ip address while you want to use it as a Moodle server.The best thing would be to get a static ip address for your computer. Mostly your ip address in a local network will show one of the following numbers 10.x.x.x, 172.x.x.x, or 192.168.x.x

If your computer for example has the ip address 192.168.0.20 then you must change the configuration from ''localhost'' to ''192.168.0.20''. In the following box you will see this address in the line $CFG->wwwroot. This ip address will be different in your own network. You must use own address for your own network!! Please do not use an ip address if you do not know what you are doing ... ask your network administrator.

<pre><?php /// Moodle Configuration File

unset($CFG);

$CFG->dbtype = 'mysql';
$CFG->dbhost = 'localhost';
$CFG->dbname = 'moodle20';
$CFG->dbuser = 'moodle';
$CFG->dbpass = 'moodle';
$CFG->dbpersist = false;
$CFG->prefix = 'mdl_';
$CFG->dboptions = array ('dbpersit' => 0, );

// Use the ip address of your computer instead of localhost
$CFG->wwwroot = 'http://192.168.0.20:8888/moodle20';
$CFG->dirroot = '/Applications/MAMP/htdocs/moodle20';
$CFG->dataroot = '/Applications/MAMP/data/moodle20';
$CFG->admin = 'admin';

$CFG->passwordsaltmain = 'some_very_long_secret!#A12345678901234567890!';
$CFG->directorypermissions = 00777; // try 02777 on a server in Safe Mode

require_once("$CFG->dirroot/lib/setup.php");

// There is no php closing tag in this file,
// it is intentional because it prevents trailing whitespace problems!
</pre>

===Open the firewall===
The web server that comes together with Moodle4Mac works on the TCP port 8888. Moodle4Mac uses this port because this gets no conflicts with the normal web server of Mac OS X that answers on TCP port 80. You can switch the port from 8888 to 80 but you must know the administration password of your Mac. In this case the normal web server will not work.

To open the firewall please go to '''System Preferences > Sharing > Firewall'''. Choose '''New...''', fill in TCP port 8888, and set the rule name '''Moodle4Mac'''.

[[Image:Moodle4Mac_Firewall1.png]]

When the rule exists it must be activated to get a connection to Moodle from any computer in your internal network.

[[Image:Moodle4Mac_Firewall2.png]]

===Connect Moodle from your network ...===
Your web server can be connected with the url http://x.x.x.x:8888/moodle18/ in your local network, where x.x.x.x is the address your Mac was given by the local router on your LAN. Usually such numbers start with 10.x.x.x, 172.x.x.x, or 192.168.x.x. All users from any computer in your network can use your Moodle via this address.

This also works if your computer is connected to the internet directly. If you open the firewall in your internet router and if you forward the port 8888 to your computer then any user everywhere on the world would be able to work with your Moodle ... but please remember also that there are a lot of security risks if you do this ... it would be better if you don't do this!!

[[Image:Moodle4Mac_Network1.png]]

[[Image:Moodle4Mac_Network2.png]]

==Some words about the security ...==
===MAMP is designed for local computers===
MAMP can be used for testing and developing websites locally on their Apple computers. MAMP should not be used in a production environment because everybody knows all the settings and all the predefined passwords. It's prepared for an easy start and not for a public web server!! But with some careful modfications, you can sufficiently secure MAMP and Moodle4Mac to use them in public development environments.

===How to secure MAMP?===
I found some ideas in the following document: [http://www.network0.org/2006/09/23/how-to-secure-mamp/ How to secure MAMP?]. It's really old and some of the instructions are not correct for the current version.

There is also a new package MAMP Pro that will let you do a lot of settings for a more secure web server. Please look to the web page for this product. You can find a describtion for MAMP Pro on the [http://www.living-e.com/MAMP-PRO/ MAMP internet server]. It's commertial and not free!

===Step by step to secure Moodle4Mac===

  
==How to set up SSL/https in MAMP for a development/test environment==
The text is copied from [http://www.webopius.com/content/355/getting-mamp-working-with-ssl-on-os-x webopius web site] (excepted the last steps).

#stop MAMP
#backup your /Applications/MAMP/conf folder
#open a terminal
#enter: ''openssl genrsa -des3 -out server.key 1024''. Enter a password twice.
#enter: ''openssl req -new -key server.key -out server.csr''. Enter the previous password. You need to answer some questions. ''Common name'' expects your local name (for me it was jerome.moodle.local)
#enter: ''openssl x509 -req -days 365 -in server.csr -signkey server.key -out server.crt''
#enter: ''cp server.key server.tmp''
#enter: ''openssl rsa -in server.tmp -out server.key''. Enter the previous password.
#enter: ''mkdir /Applications/MAMP/conf/ssl''
#enter: cp server.crt /Applications/MAMP/conf/ssl
#enter: cp server.key /Applications/MAMP/conf/ssl
# Edit Applications/MAMP/conf/apache/ssl.conf:
##comment <IfDefine SSL> tag to closing tag (but not the content)
##SSLCertificateFile /Applications/MAMP/conf/ssl/server.crt
##SSLCertificateKeyFile /Applications/MAMP/conf/ssl/server.key
# Edit /Applications/MAMP/conf/apache/httpd.conf:
##Listen 80
##comment <IfDefine SSL> tag to closing tag (but not the content)
# Edit /Application/MAMP/conf/apache/ssl.conf, change the document root (DocumentRoot) for the one you have into /Application/MAMP/conf/apache/httpd.conf
#in a terminal enter: ''cd /Applications/MAMP/bin/apache2/bin''
#enter: ''sudo ./apachectl startssl''
#start MAMP

From now MAMP should start/stop with the SSL support activated. Note that these steps have only be tested with Apache port set to 80 into MAMP preferences.

==How To Update Your Moodle4Mac==

It is very simple to update your locally installed Moodle. If you have got this course together with Moodle4Mac then you should have everything you need for a CVS update.

The only software you must have installed on your Apple computer is the Xcode Tools package from your system installation media. After this it only needs a doubleclick to get the newest Moodle version without downloading the complete installation package.

===Update the local Moodle via CVS===

Be sure that the Xcode Tools are installed on your Mac computer. You also must have an internet connection to get the files from the update server.

Now the only thing you need to do is to doubleclick on an icon inside your MAMP folder. That's all .... really .... it's easy!!

Please look for the document '''UpdateMoodle.sh'''. If you doubleclick this file you will see that the system utility '''Terminal''' opens and the update process starts automatically. You must allow to connect to the Moodle internet server ... but think about this fact only if a system tool asks you.

[[Image:Moodle4Mac_Update1.png]]

The update tool CVS connects to the Moodle internet server and looks for all those files that must be downloaded. If the process asks for a password you press the return button to enter ... the password is "empty". The update needs a few moments to find all the updated or new files but then only those files are transfered. Please wait for some minutes.

[[Image:Moodle4Mac_Update2.png]]

Every updated file is shown in the update log so you can control if the updater works and when it is completed. At least you will see the config.php because this file does not come from the update server.

If the update takes too long you may break with <strg>-C. It doesn't matter because only text files are copied. On break the process stops working. If you restart the update again the CVS tool runs through all folders and files again to find those that need to be renewed.

===Look Inside ... ===

If you want to see what is inside the document '''UpdateMoodle.sh''' please feel free to open it with a text editor. It is only a text file but it uses the Mac OS X feature to open a file with a chosen program via doubleclick.

[[Image:Moodle4Mac_Update3.png]]

I chose the system utility '''Terminal''' to open the file '''UpdateMoodle.sh''' and to run the script it contains automatically. So everything can be done with a doubleclick. It's easy and everybody can do it!!

<pre>
#! /bin/sh
#
# This CVS updater for Mac OS X is part
# of the installation package Moodle4Mac
#
# 20101201 - Ralf Krause
#

export CVS_RSH=ssh

echo
echo "+--------------------------------------------+"
echo "| CVS update for your local Moodle server "
echo "+--------------------------------------------+"
echo

cd /Applications/MAMP/htdocs/moodle20/

### delete all files named .DS_Store
find . -name ".DS_Store" -type f -print0 | xargs -0 rm -f

### file ~/.cvspass must exist
if ! test -e ~/.cvspass ; then
touch ~/.cvspass
fi

### login to the cvs server only for the first time
if ! grep "uk.cvs.moodle.org" ~/.cvspass > /dev/null ; then
echo "CVS password is empty ... please only press <return> to start"
cvs -d :pserver:anonymous@uk.cvs.moodle.org:/cvsroot/moodle login
echo
fi

echo "Connecting to the CVS server. Download will take a few moments!"
echo "If the CVS update runs too long you may break with <strg>-C"
echo
cvs -q update -dP -r HEAD

</pre>

The different versions of the update script are different in only two things ... first you need to choose the correct folder for the Moodle files and seconds you must input the correct CVS tag for the Moodle version in the last line. The shown script is for updating the version Moodle 1.8
* Moodle 1.6 uses MOODLE_16_WEEKLY
* Moodle 1.7 uses MOODLE_17_WEEKLY
* Moodle 1.8 uses MOODLE_18_WEEKLY
* Moodle 1.9 uses MOODLE_19_WEEKLY
* Moodle 2.0 still uses HEAD

===Install Xcode Tools on your Mac===

Xcode Tools is the developer tools package for Mac OS X. This package includes an integrated suite of software development tools, including compilers and applications.

If you do not know whether the Xcode Tools are installed on your Mac please look on your main harddrive. If there is a folder named Developer then you must do nothing.

[[Image:Moodle4Mac_Update4.png]]

If you cannot find this on your harddrive then you must install this package before following the instructions in this document. The Xcode Tools package is part of the Mac OS X installation media. You will find the Xcode Tools on your installation CD or DVD set.

[[Image:Moodle4Mac_Update5.png]]

If you do not find your installation media anymore you also can download the Xcode Tools from the URL http://developer.apple.com/tools/xcode/. It is free but you have to register as a developer. If you start the download from there please remember that the Xcode package brings a lot of bytes and will need a very few minutes to complete.

After you have put these things into your system you will see a new folder named Developer on your harddisk. If you only want to update your Moodle you do not need all these nice developer tools from the inside of the folder. Sorry about this but there is no separate installer for the CVS update process.
  

==See also==
* [http://mamp.info MAMP = Mac + Apache + MySQL + PHP]
* [http://en.wikipedia.org/wiki/MAMP MAMP in Wikipedia]
* [[Step by Step Installation on a Mac OS X Server|Step by Step Installation on a Mac OS X Server 10.5/10.6]]
* [[Step-by-step Guide for Installing Moodle on Mac OS X 10.4 Client|Step by step Installation on a Mac OS X Client 10.4]]
* [[CVS for Administrators]]

* [http://en.wikipedia.org/wiki/Private_network Private network addresses in Wikipedia]
* [http://moodle.org/mod/forum/discuss.php?d=24632 Using Moodle: Dynamic DNS Home Server]

* [[Configuring aspell on Mac OS X]]

[[Category:Administrator]]
[[Category:Installation]]
[[Category:Mac OS X]]

[[de:Vollständiges Installationspaket für Mac OS X]]

File:Moodle4Mac 3.png

2010-12-18T15:27:52Z

Krause:

Complete Install Packages for Mac OS X

2010-12-18T15:08:57Z

Krause: /* System requirements */

Complete install packages for Mac OS X are available from [http://download.moodle.org/macosx/ Moodle Downloads] which uses '''MAMP'''. You will find a separate card for the Mac OS X downloads. They are designed for new and local installations on a Mac computer/server. There are other downloads for Linux, and Window Operating Systems that may involve more customization of configuration files.

The complete install packages for Mac OS X are named Moodle4Mac. These do not have sufficient security for public, production servers--only use for private, local testing purposes. These packages allow Moodle to be installed, along with the prerequisites that includes a web server, database and scripting language (Apache, MySQL and PHP in this case). Several versions of the complete install package are available. You will find versions for Intel based Macs and for older PPC based Macs. Please use the correct version for your processor. The instructions on the download page provide guidance on which version is likely to be most suitable.

'''Note 1:''' The latest complete install package version components, may not be backwardly compatible. Always check version compatibility of each component if you intend to develop materials on a later version of Moodle than the version installed on your "main" Moodle site. In short, complete install packages are designed for first time install on a "clean" machine.

'''Note 2:''' If you want a secure, public server with OS X, you may be interested to use the normal web server that comes preinstalled with every Mac Computer--see the [[Step-by-step Guide for Installing Moodle on Mac OS X 10.4 Client]] for Moodle. However, remember that the complete package Moodle4Mac is ready to use and no additional programs must be installed and configured together.

==System requirements==
+ Apple Mac Computer
+ iMac, Mac mini, MacBook, iBook, PowerBook, Mac Pro, Xserve
+ Processor: Intel Core 2 Duo or PPC (G4, G5)
+ RAM: 1 GB or better
+ Hard Disk: 500 MB free
+ System Software: Mac OS X 10.4, 10.5, or 10.6

==Install complete package Moodle4Mac==
===Download and install Moodle4Mac===
'''Step 1:''' [http://download.moodle.org/macosx/ Download] the zipped disk image file from the Moodle download page. Please choose the correct file for your processor type. The zip archive should be unzipped automatically when the download is complete. If the download file is not unzipped please do this manually.

'''Step 2:''' Doubleclick the file Moodle4Mac.dmg to mount the installation disk.

[[Image:Moodle4Mac_1.png]]

'''Step 3:''' Move the folder '''MAMP''' into the folder '''Applications'''. Moodle4Mac is based on MAMP (Mac, Apache, MySQL, PHP). MAMP makes no entries in any registry and no settings for the system variables. If you want to know more about MAMP please read the project page http://mamp.info/

'''Step 4:''' Now you are ready to start your web server. Go to the Applications folder. Find the MAMP folder and open it.

[[Image:Moodle4Mac_2.png]]

'''Step 5:''' Doubleclick the icon MAMP to start the server.

[[Image:Moodle4Mac_4.png]]

'''Step 6:''' Start your browser and type <nowiki> http://127.0.0.1:8888 or http://localhost:8888 </nowiki> in the address bar. You will start your preinstalled Moodle. You do not need to do any installation. You are ready. Done ... hey, that was easy, wasn't it??

[[Image:Moodle4Mac_3.jpg]]

'''Step 7:''' Please login with the username '''admin''' and the password '''12345''' and you will be the main administrator of your new local Moodle.

==Using Moodle4Mac as a local server in your network==

In some workshops we used Moodle4Mac as a quick server installation for our local network. You should change the admin passwords (Moodle and MySQL) before you do this. There are only two steps to get the server connection from every computer in your network. One step is the change of only one line in the Moodle config.php, and the second step is that you must open the firewall of the Mac OS X. This chapter shows how you can do this.

===Edit the file config.php===

Use the current ip address of your computer instead of localhost so an external computer can connect the the web server. If your network is configured to dynamic ip addresses via DHCP please make sure that your computer retains its ip address while you want to use it as a Moodle server.The best thing would be to get a static ip address for your computer. Mostly your ip address in a local network will show one of the following numbers 10.x.x.x, 172.x.x.x, or 192.168.x.x

If your computer for example has the ip address 192.168.0.20 then you must change the configuration from ''localhost'' to ''192.168.0.20''. In the following box you will see this address in the line $CFG->wwwroot. This ip address will be different in your own network. You must use own address for your own network!! Please do not use an ip address if you do not know what you are doing ... ask your network administrator.

<pre><?php /// Moodle Configuration File

unset($CFG);

$CFG->dbtype = 'mysql';
$CFG->dbhost = 'localhost';
$CFG->dbname = 'moodle20';
$CFG->dbuser = 'moodle';
$CFG->dbpass = 'moodle';
$CFG->dbpersist = false;
$CFG->prefix = 'mdl_';
$CFG->dboptions = array ('dbpersit' => 0, );

// Use the ip address of your computer instead of localhost
$CFG->wwwroot = 'http://192.168.0.20:8888/moodle20';
$CFG->dirroot = '/Applications/MAMP/htdocs/moodle20';
$CFG->dataroot = '/Applications/MAMP/data/moodle20';
$CFG->admin = 'admin';

$CFG->passwordsaltmain = 'some_very_long_secret!#A12345678901234567890!';
$CFG->directorypermissions = 00777; // try 02777 on a server in Safe Mode

require_once("$CFG->dirroot/lib/setup.php");

// There is no php closing tag in this file,
// it is intentional because it prevents trailing whitespace problems!
</pre>

===Open the firewall===
The web server that comes together with Moodle4Mac works on the TCP port 8888. Moodle4Mac uses this port because this gets no conflicts with the normal web server of Mac OS X that answers on TCP port 80. You can switch the port from 8888 to 80 but you must know the administration password of your Mac. In this case the normal web server will not work.

To open the firewall please go to '''System Preferences > Sharing > Firewall'''. Choose '''New...''', fill in TCP port 8888, and set the rule name '''Moodle4Mac'''.

[[Image:Moodle4Mac_Firewall1.png]]

When the rule exists it must be activated to get a connection to Moodle from any computer in your internal network.

[[Image:Moodle4Mac_Firewall2.png]]

===Connect Moodle from your network ...===
Your web server can be connected with the url http://x.x.x.x:8888/moodle18/ in your local network, where x.x.x.x is the address your Mac was given by the local router on your LAN. Usually such numbers start with 10.x.x.x, 172.x.x.x, or 192.168.x.x. All users from any computer in your network can use your Moodle via this address.

This also works if your computer is connected to the internet directly. If you open the firewall in your internet router and if you forward the port 8888 to your computer then any user everywhere on the world would be able to work with your Moodle ... but please remember also that there are a lot of security risks if you do this ... it would be better if you don't do this!!

[[Image:Moodle4Mac_Network1.png]]

[[Image:Moodle4Mac_Network2.png]]

==Some words about the security ...==
===MAMP is designed for local computers===
MAMP can be used for testing and developing websites locally on their Apple computers. MAMP should not be used in a production environment because everybody knows all the settings and all the predefined passwords. It's prepared for an easy start and not for a public web server!! But with some careful modfications, you can sufficiently secure MAMP and Moodle4Mac to use them in public development environments.

===How to secure MAMP?===
I found some ideas in the following document: [http://www.network0.org/2006/09/23/how-to-secure-mamp/ How to secure MAMP?]. It's really old and some of the instructions are not correct for the current version.

There is also a new package MAMP Pro that will let you do a lot of settings for a more secure web server. Please look to the web page for this product. You can find a describtion for MAMP Pro on the [http://www.living-e.com/MAMP-PRO/ MAMP internet server]. It's commertial and not free!

===Step by step to secure Moodle4Mac===

  
==How to set up SSL/https in MAMP for a development/test environment==
The text is copied from [http://www.webopius.com/content/355/getting-mamp-working-with-ssl-on-os-x webopius web site] (excepted the last steps).

#stop MAMP
#backup your /Applications/MAMP/conf folder
#open a terminal
#enter: ''openssl genrsa -des3 -out server.key 1024''. Enter a password twice.
#enter: ''openssl req -new -key server.key -out server.csr''. Enter the previous password. You need to answer some questions. ''Common name'' expects your local name (for me it was jerome.moodle.local)
#enter: ''openssl x509 -req -days 365 -in server.csr -signkey server.key -out server.crt''
#enter: ''cp server.key server.tmp''
#enter: ''openssl rsa -in server.tmp -out server.key''. Enter the previous password.
#enter: ''mkdir /Applications/MAMP/conf/ssl''
#enter: cp server.crt /Applications/MAMP/conf/ssl
#enter: cp server.key /Applications/MAMP/conf/ssl
# Edit Applications/MAMP/conf/apache/ssl.conf:
##comment <IfDefine SSL> tag to closing tag (but not the content)
##SSLCertificateFile /Applications/MAMP/conf/ssl/server.crt
##SSLCertificateKeyFile /Applications/MAMP/conf/ssl/server.key
# Edit /Applications/MAMP/conf/apache/httpd.conf:
##Listen 80
##comment <IfDefine SSL> tag to closing tag (but not the content)
# Edit /Application/MAMP/conf/apache/ssl.conf, change the document root (DocumentRoot) for the one you have into /Application/MAMP/conf/apache/httpd.conf
#in a terminal enter: ''cd /Applications/MAMP/bin/apache2/bin''
#enter: ''sudo ./apachectl startssl''
#start MAMP

From now MAMP should start/stop with the SSL support activated. Note that these steps have only be tested with Apache port set to 80 into MAMP preferences.

==How To Update Your Moodle4Mac==

It is very simple to update your locally installed Moodle. If you have got this course together with Moodle4Mac then you should have everything you need for a CVS update.

The only software you must have installed on your Apple computer is the Xcode Tools package from your system installation media. After this it only needs a doubleclick to get the newest Moodle version without downloading the complete installation package.

===Update the local Moodle via CVS===

Be sure that the Xcode Tools are installed on your Mac computer. You also must have an internet connection to get the files from the update server.

Now the only thing you need to do is to doubleclick on an icon inside your MAMP folder. That's all .... really .... it's easy!!

Please look for the document '''UpdateMoodle.sh'''. If you doubleclick this file you will see that the system utility '''Terminal''' opens and the update process starts automatically. You must allow to connect to the Moodle internet server ... but think about this fact only if a system tool asks you.

[[Image:Moodle4Mac_Update1.png]]

The update tool CVS connects to the Moodle internet server and looks for all those files that must be downloaded. If the process asks for a password you press the return button to enter ... the password is "empty". The update needs a few moments to find all the updated or new files but then only those files are transfered. Please wait for some minutes.

[[Image:Moodle4Mac_Update2.png]]

Every updated file is shown in the update log so you can control if the updater works and when it is completed. At least you will see the config.php because this file does not come from the update server.

If the update takes too long you may break with <strg>-C. It doesn't matter because only text files are copied. On break the process stops working. If you restart the update again the CVS tool runs through all folders and files again to find those that need to be renewed.

===Look Inside ... ===

If you want to see what is inside the document '''UpdateMoodle.sh''' please feel free to open it with a text editor. It is only a text file but it uses the Mac OS X feature to open a file with a chosen program via doubleclick.

[[Image:Moodle4Mac_Update3.png]]

I chose the system utility '''Terminal''' to open the file '''UpdateMoodle.sh''' and to run the script it contains automatically. So everything can be done with a doubleclick. It's easy and everybody can do it!!

<pre>
#! /bin/sh
#
# This CVS updater for Mac OS X is part
# of the installation package Moodle4Mac
#
# 20101201 - Ralf Krause
#

export CVS_RSH=ssh

echo
echo "+--------------------------------------------+"
echo "| CVS update for your local Moodle server "
echo "+--------------------------------------------+"
echo

cd /Applications/MAMP/htdocs/moodle20/

### delete all files named .DS_Store
find . -name ".DS_Store" -type f -print0 | xargs -0 rm -f

### file ~/.cvspass must exist
if ! test -e ~/.cvspass ; then
touch ~/.cvspass
fi

### login to the cvs server only for the first time
if ! grep "uk.cvs.moodle.org" ~/.cvspass > /dev/null ; then
echo "CVS password is empty ... please only press <return> to start"
cvs -d :pserver:anonymous@uk.cvs.moodle.org:/cvsroot/moodle login
echo
fi

echo "Connecting to the CVS server. Download will take a few moments!"
echo "If the CVS update runs too long you may break with <strg>-C"
echo
cvs -q update -dP -r HEAD

</pre>

The different versions of the update script are different in only two things ... first you need to choose the correct folder for the Moodle files and seconds you must input the correct CVS tag for the Moodle version in the last line. The shown script is for updating the version Moodle 1.8
* Moodle 1.6 uses MOODLE_16_WEEKLY
* Moodle 1.7 uses MOODLE_17_WEEKLY
* Moodle 1.8 uses MOODLE_18_WEEKLY
* Moodle 1.9 uses MOODLE_19_WEEKLY
* Moodle 2.0 still uses HEAD

===Install Xcode Tools on your Mac===

Xcode Tools is the developer tools package for Mac OS X. This package includes an integrated suite of software development tools, including compilers and applications.

If you do not know whether the Xcode Tools are installed on your Mac please look on your main harddrive. If there is a folder named Developer then you must do nothing.

[[Image:Moodle4Mac_Update4.png]]

If you cannot find this on your harddrive then you must install this package before following the instructions in this document. The Xcode Tools package is part of the Mac OS X installation media. You will find the Xcode Tools on your installation CD or DVD set.

[[Image:Moodle4Mac_Update5.png]]

If you do not find your installation media anymore you also can download the Xcode Tools from the URL http://developer.apple.com/tools/xcode/. It is free but you have to register as a developer. If you start the download from there please remember that the Xcode package brings a lot of bytes and will need a very few minutes to complete.

After you have put these things into your system you will see a new folder named Developer on your harddisk. If you only want to update your Moodle you do not need all these nice developer tools from the inside of the folder. Sorry about this but there is no separate installer for the CVS update process.
  

==See also==
* [http://mamp.info MAMP = Mac + Apache + MySQL + PHP]
* [http://en.wikipedia.org/wiki/MAMP MAMP in Wikipedia]
* [[Step by Step Installation on a Mac OS X Server|Step by Step Installation on a Mac OS X Server 10.5/10.6]]
* [[Step-by-step Guide for Installing Moodle on Mac OS X 10.4 Client|Step by step Installation on a Mac OS X Client 10.4]]
* [[CVS for Administrators]]

* [http://en.wikipedia.org/wiki/Private_network Private network addresses in Wikipedia]
* [http://moodle.org/mod/forum/discuss.php?d=24632 Using Moodle: Dynamic DNS Home Server]

* [[Configuring aspell on Mac OS X]]

[[Category:Administrator]]
[[Category:Installation]]
[[Category:Mac OS X]]

[[de:Vollständiges Installationspaket für Mac OS X]]

Complete Install Packages for Mac OS X

2010-12-18T15:08:33Z

Krause: /* System requirements */

Complete install packages for Mac OS X are available from [http://download.moodle.org/macosx/ Moodle Downloads] which uses '''MAMP'''. You will find a separate card for the Mac OS X downloads. They are designed for new and local installations on a Mac computer/server. There are other downloads for Linux, and Window Operating Systems that may involve more customization of configuration files.

The complete install packages for Mac OS X are named Moodle4Mac. These do not have sufficient security for public, production servers--only use for private, local testing purposes. These packages allow Moodle to be installed, along with the prerequisites that includes a web server, database and scripting language (Apache, MySQL and PHP in this case). Several versions of the complete install package are available. You will find versions for Intel based Macs and for older PPC based Macs. Please use the correct version for your processor. The instructions on the download page provide guidance on which version is likely to be most suitable.

'''Note 1:''' The latest complete install package version components, may not be backwardly compatible. Always check version compatibility of each component if you intend to develop materials on a later version of Moodle than the version installed on your "main" Moodle site. In short, complete install packages are designed for first time install on a "clean" machine.

'''Note 2:''' If you want a secure, public server with OS X, you may be interested to use the normal web server that comes preinstalled with every Mac Computer--see the [[Step-by-step Guide for Installing Moodle on Mac OS X 10.4 Client]] for Moodle. However, remember that the complete package Moodle4Mac is ready to use and no additional programs must be installed and configured together.

==System requirements==
+ Apple Mac Computer
+ iMac, Mac mini, MacBook, iBook, PowerBook, Mac Pro, Xserve
+ Processor: Intel Core 2 Duo or PPC (G3, G4, G5)
+ RAM: 1 GB or better
+ Hard Disk: 500 MB free
+ System Software: Mac OS X 10.4, 10.5, or 10.6

==Install complete package Moodle4Mac==
===Download and install Moodle4Mac===
'''Step 1:''' [http://download.moodle.org/macosx/ Download] the zipped disk image file from the Moodle download page. Please choose the correct file for your processor type. The zip archive should be unzipped automatically when the download is complete. If the download file is not unzipped please do this manually.

'''Step 2:''' Doubleclick the file Moodle4Mac.dmg to mount the installation disk.

[[Image:Moodle4Mac_1.png]]

'''Step 3:''' Move the folder '''MAMP''' into the folder '''Applications'''. Moodle4Mac is based on MAMP (Mac, Apache, MySQL, PHP). MAMP makes no entries in any registry and no settings for the system variables. If you want to know more about MAMP please read the project page http://mamp.info/

'''Step 4:''' Now you are ready to start your web server. Go to the Applications folder. Find the MAMP folder and open it.

[[Image:Moodle4Mac_2.png]]

'''Step 5:''' Doubleclick the icon MAMP to start the server.

[[Image:Moodle4Mac_4.png]]

'''Step 6:''' Start your browser and type <nowiki> http://127.0.0.1:8888 or http://localhost:8888 </nowiki> in the address bar. You will start your preinstalled Moodle. You do not need to do any installation. You are ready. Done ... hey, that was easy, wasn't it??

[[Image:Moodle4Mac_3.jpg]]

'''Step 7:''' Please login with the username '''admin''' and the password '''12345''' and you will be the main administrator of your new local Moodle.

==Using Moodle4Mac as a local server in your network==

In some workshops we used Moodle4Mac as a quick server installation for our local network. You should change the admin passwords (Moodle and MySQL) before you do this. There are only two steps to get the server connection from every computer in your network. One step is the change of only one line in the Moodle config.php, and the second step is that you must open the firewall of the Mac OS X. This chapter shows how you can do this.

===Edit the file config.php===

Use the current ip address of your computer instead of localhost so an external computer can connect the the web server. If your network is configured to dynamic ip addresses via DHCP please make sure that your computer retains its ip address while you want to use it as a Moodle server.The best thing would be to get a static ip address for your computer. Mostly your ip address in a local network will show one of the following numbers 10.x.x.x, 172.x.x.x, or 192.168.x.x

If your computer for example has the ip address 192.168.0.20 then you must change the configuration from ''localhost'' to ''192.168.0.20''. In the following box you will see this address in the line $CFG->wwwroot. This ip address will be different in your own network. You must use own address for your own network!! Please do not use an ip address if you do not know what you are doing ... ask your network administrator.

<pre><?php /// Moodle Configuration File

unset($CFG);

$CFG->dbtype = 'mysql';
$CFG->dbhost = 'localhost';
$CFG->dbname = 'moodle20';
$CFG->dbuser = 'moodle';
$CFG->dbpass = 'moodle';
$CFG->dbpersist = false;
$CFG->prefix = 'mdl_';
$CFG->dboptions = array ('dbpersit' => 0, );

// Use the ip address of your computer instead of localhost
$CFG->wwwroot = 'http://192.168.0.20:8888/moodle20';
$CFG->dirroot = '/Applications/MAMP/htdocs/moodle20';
$CFG->dataroot = '/Applications/MAMP/data/moodle20';
$CFG->admin = 'admin';

$CFG->passwordsaltmain = 'some_very_long_secret!#A12345678901234567890!';
$CFG->directorypermissions = 00777; // try 02777 on a server in Safe Mode

require_once("$CFG->dirroot/lib/setup.php");

// There is no php closing tag in this file,
// it is intentional because it prevents trailing whitespace problems!
</pre>

===Open the firewall===
The web server that comes together with Moodle4Mac works on the TCP port 8888. Moodle4Mac uses this port because this gets no conflicts with the normal web server of Mac OS X that answers on TCP port 80. You can switch the port from 8888 to 80 but you must know the administration password of your Mac. In this case the normal web server will not work.

To open the firewall please go to '''System Preferences > Sharing > Firewall'''. Choose '''New...''', fill in TCP port 8888, and set the rule name '''Moodle4Mac'''.

[[Image:Moodle4Mac_Firewall1.png]]

When the rule exists it must be activated to get a connection to Moodle from any computer in your internal network.

[[Image:Moodle4Mac_Firewall2.png]]

===Connect Moodle from your network ...===
Your web server can be connected with the url http://x.x.x.x:8888/moodle18/ in your local network, where x.x.x.x is the address your Mac was given by the local router on your LAN. Usually such numbers start with 10.x.x.x, 172.x.x.x, or 192.168.x.x. All users from any computer in your network can use your Moodle via this address.

This also works if your computer is connected to the internet directly. If you open the firewall in your internet router and if you forward the port 8888 to your computer then any user everywhere on the world would be able to work with your Moodle ... but please remember also that there are a lot of security risks if you do this ... it would be better if you don't do this!!

[[Image:Moodle4Mac_Network1.png]]

[[Image:Moodle4Mac_Network2.png]]

==Some words about the security ...==
===MAMP is designed for local computers===
MAMP can be used for testing and developing websites locally on their Apple computers. MAMP should not be used in a production environment because everybody knows all the settings and all the predefined passwords. It's prepared for an easy start and not for a public web server!! But with some careful modfications, you can sufficiently secure MAMP and Moodle4Mac to use them in public development environments.

===How to secure MAMP?===
I found some ideas in the following document: [http://www.network0.org/2006/09/23/how-to-secure-mamp/ How to secure MAMP?]. It's really old and some of the instructions are not correct for the current version.

There is also a new package MAMP Pro that will let you do a lot of settings for a more secure web server. Please look to the web page for this product. You can find a describtion for MAMP Pro on the [http://www.living-e.com/MAMP-PRO/ MAMP internet server]. It's commertial and not free!

===Step by step to secure Moodle4Mac===

  
==How to set up SSL/https in MAMP for a development/test environment==
The text is copied from [http://www.webopius.com/content/355/getting-mamp-working-with-ssl-on-os-x webopius web site] (excepted the last steps).

#stop MAMP
#backup your /Applications/MAMP/conf folder
#open a terminal
#enter: ''openssl genrsa -des3 -out server.key 1024''. Enter a password twice.
#enter: ''openssl req -new -key server.key -out server.csr''. Enter the previous password. You need to answer some questions. ''Common name'' expects your local name (for me it was jerome.moodle.local)
#enter: ''openssl x509 -req -days 365 -in server.csr -signkey server.key -out server.crt''
#enter: ''cp server.key server.tmp''
#enter: ''openssl rsa -in server.tmp -out server.key''. Enter the previous password.
#enter: ''mkdir /Applications/MAMP/conf/ssl''
#enter: cp server.crt /Applications/MAMP/conf/ssl
#enter: cp server.key /Applications/MAMP/conf/ssl
# Edit Applications/MAMP/conf/apache/ssl.conf:
##comment <IfDefine SSL> tag to closing tag (but not the content)
##SSLCertificateFile /Applications/MAMP/conf/ssl/server.crt
##SSLCertificateKeyFile /Applications/MAMP/conf/ssl/server.key
# Edit /Applications/MAMP/conf/apache/httpd.conf:
##Listen 80
##comment <IfDefine SSL> tag to closing tag (but not the content)
# Edit /Application/MAMP/conf/apache/ssl.conf, change the document root (DocumentRoot) for the one you have into /Application/MAMP/conf/apache/httpd.conf
#in a terminal enter: ''cd /Applications/MAMP/bin/apache2/bin''
#enter: ''sudo ./apachectl startssl''
#start MAMP

From now MAMP should start/stop with the SSL support activated. Note that these steps have only be tested with Apache port set to 80 into MAMP preferences.

==How To Update Your Moodle4Mac==

It is very simple to update your locally installed Moodle. If you have got this course together with Moodle4Mac then you should have everything you need for a CVS update.

The only software you must have installed on your Apple computer is the Xcode Tools package from your system installation media. After this it only needs a doubleclick to get the newest Moodle version without downloading the complete installation package.

===Update the local Moodle via CVS===

Be sure that the Xcode Tools are installed on your Mac computer. You also must have an internet connection to get the files from the update server.

Now the only thing you need to do is to doubleclick on an icon inside your MAMP folder. That's all .... really .... it's easy!!

Please look for the document '''UpdateMoodle.sh'''. If you doubleclick this file you will see that the system utility '''Terminal''' opens and the update process starts automatically. You must allow to connect to the Moodle internet server ... but think about this fact only if a system tool asks you.

[[Image:Moodle4Mac_Update1.png]]

The update tool CVS connects to the Moodle internet server and looks for all those files that must be downloaded. If the process asks for a password you press the return button to enter ... the password is "empty". The update needs a few moments to find all the updated or new files but then only those files are transfered. Please wait for some minutes.

[[Image:Moodle4Mac_Update2.png]]

Every updated file is shown in the update log so you can control if the updater works and when it is completed. At least you will see the config.php because this file does not come from the update server.

If the update takes too long you may break with <strg>-C. It doesn't matter because only text files are copied. On break the process stops working. If you restart the update again the CVS tool runs through all folders and files again to find those that need to be renewed.

===Look Inside ... ===

If you want to see what is inside the document '''UpdateMoodle.sh''' please feel free to open it with a text editor. It is only a text file but it uses the Mac OS X feature to open a file with a chosen program via doubleclick.

[[Image:Moodle4Mac_Update3.png]]

I chose the system utility '''Terminal''' to open the file '''UpdateMoodle.sh''' and to run the script it contains automatically. So everything can be done with a doubleclick. It's easy and everybody can do it!!

<pre>
#! /bin/sh
#
# This CVS updater for Mac OS X is part
# of the installation package Moodle4Mac
#
# 20101201 - Ralf Krause
#

export CVS_RSH=ssh

echo
echo "+--------------------------------------------+"
echo "| CVS update for your local Moodle server "
echo "+--------------------------------------------+"
echo

cd /Applications/MAMP/htdocs/moodle20/

### delete all files named .DS_Store
find . -name ".DS_Store" -type f -print0 | xargs -0 rm -f

### file ~/.cvspass must exist
if ! test -e ~/.cvspass ; then
touch ~/.cvspass
fi

### login to the cvs server only for the first time
if ! grep "uk.cvs.moodle.org" ~/.cvspass > /dev/null ; then
echo "CVS password is empty ... please only press <return> to start"
cvs -d :pserver:anonymous@uk.cvs.moodle.org:/cvsroot/moodle login
echo
fi

echo "Connecting to the CVS server. Download will take a few moments!"
echo "If the CVS update runs too long you may break with <strg>-C"
echo
cvs -q update -dP -r HEAD

</pre>

The different versions of the update script are different in only two things ... first you need to choose the correct folder for the Moodle files and seconds you must input the correct CVS tag for the Moodle version in the last line. The shown script is for updating the version Moodle 1.8
* Moodle 1.6 uses MOODLE_16_WEEKLY
* Moodle 1.7 uses MOODLE_17_WEEKLY
* Moodle 1.8 uses MOODLE_18_WEEKLY
* Moodle 1.9 uses MOODLE_19_WEEKLY
* Moodle 2.0 still uses HEAD

===Install Xcode Tools on your Mac===

Xcode Tools is the developer tools package for Mac OS X. This package includes an integrated suite of software development tools, including compilers and applications.

If you do not know whether the Xcode Tools are installed on your Mac please look on your main harddrive. If there is a folder named Developer then you must do nothing.

[[Image:Moodle4Mac_Update4.png]]

If you cannot find this on your harddrive then you must install this package before following the instructions in this document. The Xcode Tools package is part of the Mac OS X installation media. You will find the Xcode Tools on your installation CD or DVD set.

[[Image:Moodle4Mac_Update5.png]]

If you do not find your installation media anymore you also can download the Xcode Tools from the URL http://developer.apple.com/tools/xcode/. It is free but you have to register as a developer. If you start the download from there please remember that the Xcode package brings a lot of bytes and will need a very few minutes to complete.

After you have put these things into your system you will see a new folder named Developer on your harddisk. If you only want to update your Moodle you do not need all these nice developer tools from the inside of the folder. Sorry about this but there is no separate installer for the CVS update process.
  

==See also==
* [http://mamp.info MAMP = Mac + Apache + MySQL + PHP]
* [http://en.wikipedia.org/wiki/MAMP MAMP in Wikipedia]
* [[Step by Step Installation on a Mac OS X Server|Step by Step Installation on a Mac OS X Server 10.5/10.6]]
* [[Step-by-step Guide for Installing Moodle on Mac OS X 10.4 Client|Step by step Installation on a Mac OS X Client 10.4]]
* [[CVS for Administrators]]

* [http://en.wikipedia.org/wiki/Private_network Private network addresses in Wikipedia]
* [http://moodle.org/mod/forum/discuss.php?d=24632 Using Moodle: Dynamic DNS Home Server]

* [[Configuring aspell on Mac OS X]]

[[Category:Administrator]]
[[Category:Installation]]
[[Category:Mac OS X]]

[[de:Vollständiges Installationspaket für Mac OS X]]

Complete Install Packages for Mac OS X

2010-12-18T15:07:10Z

Krause: /* Edit the file config.php */

Complete install packages for Mac OS X are available from [http://download.moodle.org/macosx/ Moodle Downloads] which uses '''MAMP'''. You will find a separate card for the Mac OS X downloads. They are designed for new and local installations on a Mac computer/server. There are other downloads for Linux, and Window Operating Systems that may involve more customization of configuration files.

The complete install packages for Mac OS X are named Moodle4Mac. These do not have sufficient security for public, production servers--only use for private, local testing purposes. These packages allow Moodle to be installed, along with the prerequisites that includes a web server, database and scripting language (Apache, MySQL and PHP in this case). Several versions of the complete install package are available. You will find versions for Intel based Macs and for older PPC based Macs. Please use the correct version for your processor. The instructions on the download page provide guidance on which version is likely to be most suitable.

'''Note 1:''' The latest complete install package version components, may not be backwardly compatible. Always check version compatibility of each component if you intend to develop materials on a later version of Moodle than the version installed on your "main" Moodle site. In short, complete install packages are designed for first time install on a "clean" machine.

'''Note 2:''' If you want a secure, public server with OS X, you may be interested to use the normal web server that comes preinstalled with every Mac Computer--see the [[Step-by-step Guide for Installing Moodle on Mac OS X 10.4 Client]] for Moodle. However, remember that the complete package Moodle4Mac is ready to use and no additional programs must be installed and configured together.

==System requirements==
+ Apple Mac Computer
+ iMac, Mac mini, MacBook, iBook, PowerBook, Mac Pro, Xserve
+ Processor: Intel Core 2 Duo or PPC (G3, G4, G5)
+ RAM: 512 MB or better
+ Hard Disk: 500 MB free
+ System Software: Mac OS X 10.4 or 10.5 - for 10.3 you must use a rather old MAMP

==Install complete package Moodle4Mac==
===Download and install Moodle4Mac===
'''Step 1:''' [http://download.moodle.org/macosx/ Download] the zipped disk image file from the Moodle download page. Please choose the correct file for your processor type. The zip archive should be unzipped automatically when the download is complete. If the download file is not unzipped please do this manually.

'''Step 2:''' Doubleclick the file Moodle4Mac.dmg to mount the installation disk.

[[Image:Moodle4Mac_1.png]]

'''Step 3:''' Move the folder '''MAMP''' into the folder '''Applications'''. Moodle4Mac is based on MAMP (Mac, Apache, MySQL, PHP). MAMP makes no entries in any registry and no settings for the system variables. If you want to know more about MAMP please read the project page http://mamp.info/

'''Step 4:''' Now you are ready to start your web server. Go to the Applications folder. Find the MAMP folder and open it.

[[Image:Moodle4Mac_2.png]]

'''Step 5:''' Doubleclick the icon MAMP to start the server.

[[Image:Moodle4Mac_4.png]]

'''Step 6:''' Start your browser and type <nowiki> http://127.0.0.1:8888 or http://localhost:8888 </nowiki> in the address bar. You will start your preinstalled Moodle. You do not need to do any installation. You are ready. Done ... hey, that was easy, wasn't it??

[[Image:Moodle4Mac_3.jpg]]

'''Step 7:''' Please login with the username '''admin''' and the password '''12345''' and you will be the main administrator of your new local Moodle.

==Using Moodle4Mac as a local server in your network==

In some workshops we used Moodle4Mac as a quick server installation for our local network. You should change the admin passwords (Moodle and MySQL) before you do this. There are only two steps to get the server connection from every computer in your network. One step is the change of only one line in the Moodle config.php, and the second step is that you must open the firewall of the Mac OS X. This chapter shows how you can do this.

===Edit the file config.php===

Use the current ip address of your computer instead of localhost so an external computer can connect the the web server. If your network is configured to dynamic ip addresses via DHCP please make sure that your computer retains its ip address while you want to use it as a Moodle server.The best thing would be to get a static ip address for your computer. Mostly your ip address in a local network will show one of the following numbers 10.x.x.x, 172.x.x.x, or 192.168.x.x

If your computer for example has the ip address 192.168.0.20 then you must change the configuration from ''localhost'' to ''192.168.0.20''. In the following box you will see this address in the line $CFG->wwwroot. This ip address will be different in your own network. You must use own address for your own network!! Please do not use an ip address if you do not know what you are doing ... ask your network administrator.

<pre><?php /// Moodle Configuration File

unset($CFG);

$CFG->dbtype = 'mysql';
$CFG->dbhost = 'localhost';
$CFG->dbname = 'moodle20';
$CFG->dbuser = 'moodle';
$CFG->dbpass = 'moodle';
$CFG->dbpersist = false;
$CFG->prefix = 'mdl_';
$CFG->dboptions = array ('dbpersit' => 0, );

// Use the ip address of your computer instead of localhost
$CFG->wwwroot = 'http://192.168.0.20:8888/moodle20';
$CFG->dirroot = '/Applications/MAMP/htdocs/moodle20';
$CFG->dataroot = '/Applications/MAMP/data/moodle20';
$CFG->admin = 'admin';

$CFG->passwordsaltmain = 'some_very_long_secret!#A12345678901234567890!';
$CFG->directorypermissions = 00777; // try 02777 on a server in Safe Mode

require_once("$CFG->dirroot/lib/setup.php");

// There is no php closing tag in this file,
// it is intentional because it prevents trailing whitespace problems!
</pre>

===Open the firewall===
The web server that comes together with Moodle4Mac works on the TCP port 8888. Moodle4Mac uses this port because this gets no conflicts with the normal web server of Mac OS X that answers on TCP port 80. You can switch the port from 8888 to 80 but you must know the administration password of your Mac. In this case the normal web server will not work.

To open the firewall please go to '''System Preferences > Sharing > Firewall'''. Choose '''New...''', fill in TCP port 8888, and set the rule name '''Moodle4Mac'''.

[[Image:Moodle4Mac_Firewall1.png]]

When the rule exists it must be activated to get a connection to Moodle from any computer in your internal network.

[[Image:Moodle4Mac_Firewall2.png]]

===Connect Moodle from your network ...===
Your web server can be connected with the url http://x.x.x.x:8888/moodle18/ in your local network, where x.x.x.x is the address your Mac was given by the local router on your LAN. Usually such numbers start with 10.x.x.x, 172.x.x.x, or 192.168.x.x. All users from any computer in your network can use your Moodle via this address.

This also works if your computer is connected to the internet directly. If you open the firewall in your internet router and if you forward the port 8888 to your computer then any user everywhere on the world would be able to work with your Moodle ... but please remember also that there are a lot of security risks if you do this ... it would be better if you don't do this!!

[[Image:Moodle4Mac_Network1.png]]

[[Image:Moodle4Mac_Network2.png]]

==Some words about the security ...==
===MAMP is designed for local computers===
MAMP can be used for testing and developing websites locally on their Apple computers. MAMP should not be used in a production environment because everybody knows all the settings and all the predefined passwords. It's prepared for an easy start and not for a public web server!! But with some careful modfications, you can sufficiently secure MAMP and Moodle4Mac to use them in public development environments.

===How to secure MAMP?===
I found some ideas in the following document: [http://www.network0.org/2006/09/23/how-to-secure-mamp/ How to secure MAMP?]. It's really old and some of the instructions are not correct for the current version.

There is also a new package MAMP Pro that will let you do a lot of settings for a more secure web server. Please look to the web page for this product. You can find a describtion for MAMP Pro on the [http://www.living-e.com/MAMP-PRO/ MAMP internet server]. It's commertial and not free!

===Step by step to secure Moodle4Mac===

  
==How to set up SSL/https in MAMP for a development/test environment==
The text is copied from [http://www.webopius.com/content/355/getting-mamp-working-with-ssl-on-os-x webopius web site] (excepted the last steps).

#stop MAMP
#backup your /Applications/MAMP/conf folder
#open a terminal
#enter: ''openssl genrsa -des3 -out server.key 1024''. Enter a password twice.
#enter: ''openssl req -new -key server.key -out server.csr''. Enter the previous password. You need to answer some questions. ''Common name'' expects your local name (for me it was jerome.moodle.local)
#enter: ''openssl x509 -req -days 365 -in server.csr -signkey server.key -out server.crt''
#enter: ''cp server.key server.tmp''
#enter: ''openssl rsa -in server.tmp -out server.key''. Enter the previous password.
#enter: ''mkdir /Applications/MAMP/conf/ssl''
#enter: cp server.crt /Applications/MAMP/conf/ssl
#enter: cp server.key /Applications/MAMP/conf/ssl
# Edit Applications/MAMP/conf/apache/ssl.conf:
##comment <IfDefine SSL> tag to closing tag (but not the content)
##SSLCertificateFile /Applications/MAMP/conf/ssl/server.crt
##SSLCertificateKeyFile /Applications/MAMP/conf/ssl/server.key
# Edit /Applications/MAMP/conf/apache/httpd.conf:
##Listen 80
##comment <IfDefine SSL> tag to closing tag (but not the content)
# Edit /Application/MAMP/conf/apache/ssl.conf, change the document root (DocumentRoot) for the one you have into /Application/MAMP/conf/apache/httpd.conf
#in a terminal enter: ''cd /Applications/MAMP/bin/apache2/bin''
#enter: ''sudo ./apachectl startssl''
#start MAMP

From now MAMP should start/stop with the SSL support activated. Note that these steps have only be tested with Apache port set to 80 into MAMP preferences.

==How To Update Your Moodle4Mac==

It is very simple to update your locally installed Moodle. If you have got this course together with Moodle4Mac then you should have everything you need for a CVS update.

The only software you must have installed on your Apple computer is the Xcode Tools package from your system installation media. After this it only needs a doubleclick to get the newest Moodle version without downloading the complete installation package.

===Update the local Moodle via CVS===

Be sure that the Xcode Tools are installed on your Mac computer. You also must have an internet connection to get the files from the update server.

Now the only thing you need to do is to doubleclick on an icon inside your MAMP folder. That's all .... really .... it's easy!!

Please look for the document '''UpdateMoodle.sh'''. If you doubleclick this file you will see that the system utility '''Terminal''' opens and the update process starts automatically. You must allow to connect to the Moodle internet server ... but think about this fact only if a system tool asks you.

[[Image:Moodle4Mac_Update1.png]]

The update tool CVS connects to the Moodle internet server and looks for all those files that must be downloaded. If the process asks for a password you press the return button to enter ... the password is "empty". The update needs a few moments to find all the updated or new files but then only those files are transfered. Please wait for some minutes.

[[Image:Moodle4Mac_Update2.png]]

Every updated file is shown in the update log so you can control if the updater works and when it is completed. At least you will see the config.php because this file does not come from the update server.

If the update takes too long you may break with <strg>-C. It doesn't matter because only text files are copied. On break the process stops working. If you restart the update again the CVS tool runs through all folders and files again to find those that need to be renewed.

===Look Inside ... ===

If you want to see what is inside the document '''UpdateMoodle.sh''' please feel free to open it with a text editor. It is only a text file but it uses the Mac OS X feature to open a file with a chosen program via doubleclick.

[[Image:Moodle4Mac_Update3.png]]

I chose the system utility '''Terminal''' to open the file '''UpdateMoodle.sh''' and to run the script it contains automatically. So everything can be done with a doubleclick. It's easy and everybody can do it!!

<pre>
#! /bin/sh
#
# This CVS updater for Mac OS X is part
# of the installation package Moodle4Mac
#
# 20101201 - Ralf Krause
#

export CVS_RSH=ssh

echo
echo "+--------------------------------------------+"
echo "| CVS update for your local Moodle server "
echo "+--------------------------------------------+"
echo

cd /Applications/MAMP/htdocs/moodle20/

### delete all files named .DS_Store
find . -name ".DS_Store" -type f -print0 | xargs -0 rm -f

### file ~/.cvspass must exist
if ! test -e ~/.cvspass ; then
touch ~/.cvspass
fi

### login to the cvs server only for the first time
if ! grep "uk.cvs.moodle.org" ~/.cvspass > /dev/null ; then
echo "CVS password is empty ... please only press <return> to start"
cvs -d :pserver:anonymous@uk.cvs.moodle.org:/cvsroot/moodle login
echo
fi

echo "Connecting to the CVS server. Download will take a few moments!"
echo "If the CVS update runs too long you may break with <strg>-C"
echo
cvs -q update -dP -r HEAD

</pre>

The different versions of the update script are different in only two things ... first you need to choose the correct folder for the Moodle files and seconds you must input the correct CVS tag for the Moodle version in the last line. The shown script is for updating the version Moodle 1.8
* Moodle 1.6 uses MOODLE_16_WEEKLY
* Moodle 1.7 uses MOODLE_17_WEEKLY
* Moodle 1.8 uses MOODLE_18_WEEKLY
* Moodle 1.9 uses MOODLE_19_WEEKLY
* Moodle 2.0 still uses HEAD

===Install Xcode Tools on your Mac===

Xcode Tools is the developer tools package for Mac OS X. This package includes an integrated suite of software development tools, including compilers and applications.

If you do not know whether the Xcode Tools are installed on your Mac please look on your main harddrive. If there is a folder named Developer then you must do nothing.

[[Image:Moodle4Mac_Update4.png]]

If you cannot find this on your harddrive then you must install this package before following the instructions in this document. The Xcode Tools package is part of the Mac OS X installation media. You will find the Xcode Tools on your installation CD or DVD set.

[[Image:Moodle4Mac_Update5.png]]

If you do not find your installation media anymore you also can download the Xcode Tools from the URL http://developer.apple.com/tools/xcode/. It is free but you have to register as a developer. If you start the download from there please remember that the Xcode package brings a lot of bytes and will need a very few minutes to complete.

After you have put these things into your system you will see a new folder named Developer on your harddisk. If you only want to update your Moodle you do not need all these nice developer tools from the inside of the folder. Sorry about this but there is no separate installer for the CVS update process.
  

==See also==
* [http://mamp.info MAMP = Mac + Apache + MySQL + PHP]
* [http://en.wikipedia.org/wiki/MAMP MAMP in Wikipedia]
* [[Step by Step Installation on a Mac OS X Server|Step by Step Installation on a Mac OS X Server 10.5/10.6]]
* [[Step-by-step Guide for Installing Moodle on Mac OS X 10.4 Client|Step by step Installation on a Mac OS X Client 10.4]]
* [[CVS for Administrators]]

* [http://en.wikipedia.org/wiki/Private_network Private network addresses in Wikipedia]
* [http://moodle.org/mod/forum/discuss.php?d=24632 Using Moodle: Dynamic DNS Home Server]

* [[Configuring aspell on Mac OS X]]

[[Category:Administrator]]
[[Category:Installation]]
[[Category:Mac OS X]]

[[de:Vollständiges Installationspaket für Mac OS X]]

Complete Install Packages for Mac OS X

2010-12-18T15:05:57Z

Krause: /* Edit the file config.php */

Complete install packages for Mac OS X are available from [http://download.moodle.org/macosx/ Moodle Downloads] which uses '''MAMP'''. You will find a separate card for the Mac OS X downloads. They are designed for new and local installations on a Mac computer/server. There are other downloads for Linux, and Window Operating Systems that may involve more customization of configuration files.

The complete install packages for Mac OS X are named Moodle4Mac. These do not have sufficient security for public, production servers--only use for private, local testing purposes. These packages allow Moodle to be installed, along with the prerequisites that includes a web server, database and scripting language (Apache, MySQL and PHP in this case). Several versions of the complete install package are available. You will find versions for Intel based Macs and for older PPC based Macs. Please use the correct version for your processor. The instructions on the download page provide guidance on which version is likely to be most suitable.

'''Note 1:''' The latest complete install package version components, may not be backwardly compatible. Always check version compatibility of each component if you intend to develop materials on a later version of Moodle than the version installed on your "main" Moodle site. In short, complete install packages are designed for first time install on a "clean" machine.

'''Note 2:''' If you want a secure, public server with OS X, you may be interested to use the normal web server that comes preinstalled with every Mac Computer--see the [[Step-by-step Guide for Installing Moodle on Mac OS X 10.4 Client]] for Moodle. However, remember that the complete package Moodle4Mac is ready to use and no additional programs must be installed and configured together.

==System requirements==
+ Apple Mac Computer
+ iMac, Mac mini, MacBook, iBook, PowerBook, Mac Pro, Xserve
+ Processor: Intel Core 2 Duo or PPC (G3, G4, G5)
+ RAM: 512 MB or better
+ Hard Disk: 500 MB free
+ System Software: Mac OS X 10.4 or 10.5 - for 10.3 you must use a rather old MAMP

==Install complete package Moodle4Mac==
===Download and install Moodle4Mac===
'''Step 1:''' [http://download.moodle.org/macosx/ Download] the zipped disk image file from the Moodle download page. Please choose the correct file for your processor type. The zip archive should be unzipped automatically when the download is complete. If the download file is not unzipped please do this manually.

'''Step 2:''' Doubleclick the file Moodle4Mac.dmg to mount the installation disk.

[[Image:Moodle4Mac_1.png]]

'''Step 3:''' Move the folder '''MAMP''' into the folder '''Applications'''. Moodle4Mac is based on MAMP (Mac, Apache, MySQL, PHP). MAMP makes no entries in any registry and no settings for the system variables. If you want to know more about MAMP please read the project page http://mamp.info/

'''Step 4:''' Now you are ready to start your web server. Go to the Applications folder. Find the MAMP folder and open it.

[[Image:Moodle4Mac_2.png]]

'''Step 5:''' Doubleclick the icon MAMP to start the server.

[[Image:Moodle4Mac_4.png]]

'''Step 6:''' Start your browser and type <nowiki> http://127.0.0.1:8888 or http://localhost:8888 </nowiki> in the address bar. You will start your preinstalled Moodle. You do not need to do any installation. You are ready. Done ... hey, that was easy, wasn't it??

[[Image:Moodle4Mac_3.jpg]]

'''Step 7:''' Please login with the username '''admin''' and the password '''12345''' and you will be the main administrator of your new local Moodle.

==Using Moodle4Mac as a local server in your network==

In some workshops we used Moodle4Mac as a quick server installation for our local network. You should change the admin passwords (Moodle and MySQL) before you do this. There are only two steps to get the server connection from every computer in your network. One step is the change of only one line in the Moodle config.php, and the second step is that you must open the firewall of the Mac OS X. This chapter shows how you can do this.

===Edit the file config.php===

Use the current ip address of your computer instead of localhost so an external computer can connect the the web server. If your network is configured to dynamic ip addresses via DHCP please make sure that your computer retains its ip address while you want to use it as a Moodle server.The best thing would be to get a static ip address for your computer. Mostly your ip address in a local network will show one of the following numbers 10.x.x.x, 172.x.x.x, or 192.168.x.x

If your computer for example has the ip address 192.168.0.20 then you must change the configuration from ''localhost'' to ''192.168.0.20''. In the following box you will see this address in the line $CFG->wwwroot. This ip address will be different in your own network. You must use own address for your own network!! Please do not use an ip address if you do not know what you are doing ... ask your network administrator.

<pre><?php /// Moodle Configuration File

unset($CFG);

$CFG->dbtype = 'mysql';
$CFG->dbhost = 'localhost';
$CFG->dbname = 'moodle20';
$CFG->dbuser = 'moodle';
$CFG->dbpass = 'moodle';
$CFG->dbpersist = false;
$CFG->prefix = 'mdl_';

// Use the ip address of your computer instead of localhost
$CFG->wwwroot = 'http://192.168.0.20:8888/moodle20';
$CFG->dirroot = '/Applications/MAMP/htdocs/moodle20';
$CFG->dataroot = '/Applications/MAMP/data/moodle20';
$CFG->admin = 'admin';

$CFG->passwordsaltmain = 'some_very_long_secret!#A12345678901234567890!';
$CFG->directorypermissions = 00777; // try 02777 on a server in Safe Mode

require_once("$CFG->dirroot/lib/setup.php");

// There is no php closing tag in this file,
// it is intentional because it prevents trailing whitespace problems!
</pre>

===Open the firewall===
The web server that comes together with Moodle4Mac works on the TCP port 8888. Moodle4Mac uses this port because this gets no conflicts with the normal web server of Mac OS X that answers on TCP port 80. You can switch the port from 8888 to 80 but you must know the administration password of your Mac. In this case the normal web server will not work.

To open the firewall please go to '''System Preferences > Sharing > Firewall'''. Choose '''New...''', fill in TCP port 8888, and set the rule name '''Moodle4Mac'''.

[[Image:Moodle4Mac_Firewall1.png]]

When the rule exists it must be activated to get a connection to Moodle from any computer in your internal network.

[[Image:Moodle4Mac_Firewall2.png]]

===Connect Moodle from your network ...===
Your web server can be connected with the url http://x.x.x.x:8888/moodle18/ in your local network, where x.x.x.x is the address your Mac was given by the local router on your LAN. Usually such numbers start with 10.x.x.x, 172.x.x.x, or 192.168.x.x. All users from any computer in your network can use your Moodle via this address.

This also works if your computer is connected to the internet directly. If you open the firewall in your internet router and if you forward the port 8888 to your computer then any user everywhere on the world would be able to work with your Moodle ... but please remember also that there are a lot of security risks if you do this ... it would be better if you don't do this!!

[[Image:Moodle4Mac_Network1.png]]

[[Image:Moodle4Mac_Network2.png]]

==Some words about the security ...==
===MAMP is designed for local computers===
MAMP can be used for testing and developing websites locally on their Apple computers. MAMP should not be used in a production environment because everybody knows all the settings and all the predefined passwords. It's prepared for an easy start and not for a public web server!! But with some careful modfications, you can sufficiently secure MAMP and Moodle4Mac to use them in public development environments.

===How to secure MAMP?===
I found some ideas in the following document: [http://www.network0.org/2006/09/23/how-to-secure-mamp/ How to secure MAMP?]. It's really old and some of the instructions are not correct for the current version.

There is also a new package MAMP Pro that will let you do a lot of settings for a more secure web server. Please look to the web page for this product. You can find a describtion for MAMP Pro on the [http://www.living-e.com/MAMP-PRO/ MAMP internet server]. It's commertial and not free!

===Step by step to secure Moodle4Mac===

  
==How to set up SSL/https in MAMP for a development/test environment==
The text is copied from [http://www.webopius.com/content/355/getting-mamp-working-with-ssl-on-os-x webopius web site] (excepted the last steps).

#stop MAMP
#backup your /Applications/MAMP/conf folder
#open a terminal
#enter: ''openssl genrsa -des3 -out server.key 1024''. Enter a password twice.
#enter: ''openssl req -new -key server.key -out server.csr''. Enter the previous password. You need to answer some questions. ''Common name'' expects your local name (for me it was jerome.moodle.local)
#enter: ''openssl x509 -req -days 365 -in server.csr -signkey server.key -out server.crt''
#enter: ''cp server.key server.tmp''
#enter: ''openssl rsa -in server.tmp -out server.key''. Enter the previous password.
#enter: ''mkdir /Applications/MAMP/conf/ssl''
#enter: cp server.crt /Applications/MAMP/conf/ssl
#enter: cp server.key /Applications/MAMP/conf/ssl
# Edit Applications/MAMP/conf/apache/ssl.conf:
##comment <IfDefine SSL> tag to closing tag (but not the content)
##SSLCertificateFile /Applications/MAMP/conf/ssl/server.crt
##SSLCertificateKeyFile /Applications/MAMP/conf/ssl/server.key
# Edit /Applications/MAMP/conf/apache/httpd.conf:
##Listen 80
##comment <IfDefine SSL> tag to closing tag (but not the content)
# Edit /Application/MAMP/conf/apache/ssl.conf, change the document root (DocumentRoot) for the one you have into /Application/MAMP/conf/apache/httpd.conf
#in a terminal enter: ''cd /Applications/MAMP/bin/apache2/bin''
#enter: ''sudo ./apachectl startssl''
#start MAMP

From now MAMP should start/stop with the SSL support activated. Note that these steps have only be tested with Apache port set to 80 into MAMP preferences.

==How To Update Your Moodle4Mac==

It is very simple to update your locally installed Moodle. If you have got this course together with Moodle4Mac then you should have everything you need for a CVS update.

The only software you must have installed on your Apple computer is the Xcode Tools package from your system installation media. After this it only needs a doubleclick to get the newest Moodle version without downloading the complete installation package.

===Update the local Moodle via CVS===

Be sure that the Xcode Tools are installed on your Mac computer. You also must have an internet connection to get the files from the update server.

Now the only thing you need to do is to doubleclick on an icon inside your MAMP folder. That's all .... really .... it's easy!!

Please look for the document '''UpdateMoodle.sh'''. If you doubleclick this file you will see that the system utility '''Terminal''' opens and the update process starts automatically. You must allow to connect to the Moodle internet server ... but think about this fact only if a system tool asks you.

[[Image:Moodle4Mac_Update1.png]]

The update tool CVS connects to the Moodle internet server and looks for all those files that must be downloaded. If the process asks for a password you press the return button to enter ... the password is "empty". The update needs a few moments to find all the updated or new files but then only those files are transfered. Please wait for some minutes.

[[Image:Moodle4Mac_Update2.png]]

Every updated file is shown in the update log so you can control if the updater works and when it is completed. At least you will see the config.php because this file does not come from the update server.

If the update takes too long you may break with <strg>-C. It doesn't matter because only text files are copied. On break the process stops working. If you restart the update again the CVS tool runs through all folders and files again to find those that need to be renewed.

===Look Inside ... ===

If you want to see what is inside the document '''UpdateMoodle.sh''' please feel free to open it with a text editor. It is only a text file but it uses the Mac OS X feature to open a file with a chosen program via doubleclick.

[[Image:Moodle4Mac_Update3.png]]

I chose the system utility '''Terminal''' to open the file '''UpdateMoodle.sh''' and to run the script it contains automatically. So everything can be done with a doubleclick. It's easy and everybody can do it!!

<pre>
#! /bin/sh
#
# This CVS updater for Mac OS X is part
# of the installation package Moodle4Mac
#
# 20101201 - Ralf Krause
#

export CVS_RSH=ssh

echo
echo "+--------------------------------------------+"
echo "| CVS update for your local Moodle server "
echo "+--------------------------------------------+"
echo

cd /Applications/MAMP/htdocs/moodle20/

### delete all files named .DS_Store
find . -name ".DS_Store" -type f -print0 | xargs -0 rm -f

### file ~/.cvspass must exist
if ! test -e ~/.cvspass ; then
touch ~/.cvspass
fi

### login to the cvs server only for the first time
if ! grep "uk.cvs.moodle.org" ~/.cvspass > /dev/null ; then
echo "CVS password is empty ... please only press <return> to start"
cvs -d :pserver:anonymous@uk.cvs.moodle.org:/cvsroot/moodle login
echo
fi

echo "Connecting to the CVS server. Download will take a few moments!"
echo "If the CVS update runs too long you may break with <strg>-C"
echo
cvs -q update -dP -r HEAD

</pre>

The different versions of the update script are different in only two things ... first you need to choose the correct folder for the Moodle files and seconds you must input the correct CVS tag for the Moodle version in the last line. The shown script is for updating the version Moodle 1.8
* Moodle 1.6 uses MOODLE_16_WEEKLY
* Moodle 1.7 uses MOODLE_17_WEEKLY
* Moodle 1.8 uses MOODLE_18_WEEKLY
* Moodle 1.9 uses MOODLE_19_WEEKLY
* Moodle 2.0 still uses HEAD

===Install Xcode Tools on your Mac===

Xcode Tools is the developer tools package for Mac OS X. This package includes an integrated suite of software development tools, including compilers and applications.

If you do not know whether the Xcode Tools are installed on your Mac please look on your main harddrive. If there is a folder named Developer then you must do nothing.

[[Image:Moodle4Mac_Update4.png]]

If you cannot find this on your harddrive then you must install this package before following the instructions in this document. The Xcode Tools package is part of the Mac OS X installation media. You will find the Xcode Tools on your installation CD or DVD set.

[[Image:Moodle4Mac_Update5.png]]

If you do not find your installation media anymore you also can download the Xcode Tools from the URL http://developer.apple.com/tools/xcode/. It is free but you have to register as a developer. If you start the download from there please remember that the Xcode package brings a lot of bytes and will need a very few minutes to complete.

After you have put these things into your system you will see a new folder named Developer on your harddisk. If you only want to update your Moodle you do not need all these nice developer tools from the inside of the folder. Sorry about this but there is no separate installer for the CVS update process.
  

==See also==
* [http://mamp.info MAMP = Mac + Apache + MySQL + PHP]
* [http://en.wikipedia.org/wiki/MAMP MAMP in Wikipedia]
* [[Step by Step Installation on a Mac OS X Server|Step by Step Installation on a Mac OS X Server 10.5/10.6]]
* [[Step-by-step Guide for Installing Moodle on Mac OS X 10.4 Client|Step by step Installation on a Mac OS X Client 10.4]]
* [[CVS for Administrators]]

* [http://en.wikipedia.org/wiki/Private_network Private network addresses in Wikipedia]
* [http://moodle.org/mod/forum/discuss.php?d=24632 Using Moodle: Dynamic DNS Home Server]

* [[Configuring aspell on Mac OS X]]

[[Category:Administrator]]
[[Category:Installation]]
[[Category:Mac OS X]]

[[de:Vollständiges Installationspaket für Mac OS X]]

File:Moodle4Mac Network2.png

2010-12-18T15:02:10Z

Krause: uploaded a new version of "Image:Moodle4Mac Network2.png"

File:Moodle4Mac Network1.png

2010-12-18T15:01:47Z

Krause: uploaded a new version of "Image:Moodle4Mac Network1.png"

Complete Install Packages for Mac OS X

2010-12-18T14:56:54Z

Krause: /* Look Inside ... */

Complete install packages for Mac OS X are available from [http://download.moodle.org/macosx/ Moodle Downloads] which uses '''MAMP'''. You will find a separate card for the Mac OS X downloads. They are designed for new and local installations on a Mac computer/server. There are other downloads for Linux, and Window Operating Systems that may involve more customization of configuration files.

The complete install packages for Mac OS X are named Moodle4Mac. These do not have sufficient security for public, production servers--only use for private, local testing purposes. These packages allow Moodle to be installed, along with the prerequisites that includes a web server, database and scripting language (Apache, MySQL and PHP in this case). Several versions of the complete install package are available. You will find versions for Intel based Macs and for older PPC based Macs. Please use the correct version for your processor. The instructions on the download page provide guidance on which version is likely to be most suitable.

'''Note 1:''' The latest complete install package version components, may not be backwardly compatible. Always check version compatibility of each component if you intend to develop materials on a later version of Moodle than the version installed on your "main" Moodle site. In short, complete install packages are designed for first time install on a "clean" machine.

'''Note 2:''' If you want a secure, public server with OS X, you may be interested to use the normal web server that comes preinstalled with every Mac Computer--see the [[Step-by-step Guide for Installing Moodle on Mac OS X 10.4 Client]] for Moodle. However, remember that the complete package Moodle4Mac is ready to use and no additional programs must be installed and configured together.

==System requirements==
+ Apple Mac Computer
+ iMac, Mac mini, MacBook, iBook, PowerBook, Mac Pro, Xserve
+ Processor: Intel Core 2 Duo or PPC (G3, G4, G5)
+ RAM: 512 MB or better
+ Hard Disk: 500 MB free
+ System Software: Mac OS X 10.4 or 10.5 - for 10.3 you must use a rather old MAMP

==Install complete package Moodle4Mac==
===Download and install Moodle4Mac===
'''Step 1:''' [http://download.moodle.org/macosx/ Download] the zipped disk image file from the Moodle download page. Please choose the correct file for your processor type. The zip archive should be unzipped automatically when the download is complete. If the download file is not unzipped please do this manually.

'''Step 2:''' Doubleclick the file Moodle4Mac.dmg to mount the installation disk.

[[Image:Moodle4Mac_1.png]]

'''Step 3:''' Move the folder '''MAMP''' into the folder '''Applications'''. Moodle4Mac is based on MAMP (Mac, Apache, MySQL, PHP). MAMP makes no entries in any registry and no settings for the system variables. If you want to know more about MAMP please read the project page http://mamp.info/

'''Step 4:''' Now you are ready to start your web server. Go to the Applications folder. Find the MAMP folder and open it.

[[Image:Moodle4Mac_2.png]]

'''Step 5:''' Doubleclick the icon MAMP to start the server.

[[Image:Moodle4Mac_4.png]]

'''Step 6:''' Start your browser and type <nowiki> http://127.0.0.1:8888 or http://localhost:8888 </nowiki> in the address bar. You will start your preinstalled Moodle. You do not need to do any installation. You are ready. Done ... hey, that was easy, wasn't it??

[[Image:Moodle4Mac_3.jpg]]

'''Step 7:''' Please login with the username '''admin''' and the password '''12345''' and you will be the main administrator of your new local Moodle.

==Using Moodle4Mac as a local server in your network==

In some workshops we used Moodle4Mac as a quick server installation for our local network. You should change the admin passwords (Moodle and MySQL) before you do this. There are only two steps to get the server connection from every computer in your network. One step is the change of only one line in the Moodle config.php, and the second step is that you must open the firewall of the Mac OS X. This chapter shows how you can do this.

===Edit the file config.php===

Use the current ip address of your computer instead of localhost so an external computer can connect the the web server. If your network is configured to dynamic ip addresses via DHCP please make sure that your computer retains its ip address while you want to use it as a Moodle server.The best thing would be to get a static ip address for your computer. Mostly your ip address in a local network will show one of the following numbers 10.x.x.x, 172.x.x.x, or 192.168.x.x

If your computer for example has the ip address 192.168.0.20 then you must change the configuration from ''localhost'' to ''192.168.0.20''. In the following box you will see this address in the line $CFG->wwwroot. This ip address will be different in your own network. You must use own address for your own network!! Please do not use an ip address if you do not know what you are doing ... ask your network administrator.

<pre><?php /// Moodle Configuration File

unset($CFG);

$CFG->dbtype = 'mysql';
$CFG->dbhost = 'localhost';
$CFG->dbname = 'moodle18';
$CFG->dbuser = 'moodle';
$CFG->dbpass = 'moodle';
$CFG->dbpersist = false;
$CFG->prefix = 'mdl_';

// Use the ip address of your computer instead of localhost
$CFG->wwwroot = 'http://192.168.0.20:8888/moodle18';
$CFG->dirroot = '/Applications/MAMP/htdocs/moodle18';
$CFG->dataroot = '/Applications/MAMP/data/moodle18';
$CFG->admin = 'admin';

$CFG->directorypermissions = 00777; // try 02777 on a server in Safe Mode

$CFG->unicodedb = true; // Database is utf8

require_once("$CFG->dirroot/lib/setup.php");
// MAKE SURE WHEN YOU EDIT THIS FILE THAT THERE ARE NO SPACES, BLANK LINES,
// RETURNS, OR ANYTHING ELSE AFTER THE TWO CHARACTERS ON THE NEXT LINE.
?>
</pre>

===Open the firewall===
The web server that comes together with Moodle4Mac works on the TCP port 8888. Moodle4Mac uses this port because this gets no conflicts with the normal web server of Mac OS X that answers on TCP port 80. You can switch the port from 8888 to 80 but you must know the administration password of your Mac. In this case the normal web server will not work.

To open the firewall please go to '''System Preferences > Sharing > Firewall'''. Choose '''New...''', fill in TCP port 8888, and set the rule name '''Moodle4Mac'''.

[[Image:Moodle4Mac_Firewall1.png]]

When the rule exists it must be activated to get a connection to Moodle from any computer in your internal network.

[[Image:Moodle4Mac_Firewall2.png]]

===Connect Moodle from your network ...===
Your web server can be connected with the url http://x.x.x.x:8888/moodle18/ in your local network, where x.x.x.x is the address your Mac was given by the local router on your LAN. Usually such numbers start with 10.x.x.x, 172.x.x.x, or 192.168.x.x. All users from any computer in your network can use your Moodle via this address.

This also works if your computer is connected to the internet directly. If you open the firewall in your internet router and if you forward the port 8888 to your computer then any user everywhere on the world would be able to work with your Moodle ... but please remember also that there are a lot of security risks if you do this ... it would be better if you don't do this!!

[[Image:Moodle4Mac_Network1.png]]

[[Image:Moodle4Mac_Network2.png]]

==Some words about the security ...==
===MAMP is designed for local computers===
MAMP can be used for testing and developing websites locally on their Apple computers. MAMP should not be used in a production environment because everybody knows all the settings and all the predefined passwords. It's prepared for an easy start and not for a public web server!! But with some careful modfications, you can sufficiently secure MAMP and Moodle4Mac to use them in public development environments.

===How to secure MAMP?===
I found some ideas in the following document: [http://www.network0.org/2006/09/23/how-to-secure-mamp/ How to secure MAMP?]. It's really old and some of the instructions are not correct for the current version.

There is also a new package MAMP Pro that will let you do a lot of settings for a more secure web server. Please look to the web page for this product. You can find a describtion for MAMP Pro on the [http://www.living-e.com/MAMP-PRO/ MAMP internet server]. It's commertial and not free!

===Step by step to secure Moodle4Mac===

  
==How to set up SSL/https in MAMP for a development/test environment==
The text is copied from [http://www.webopius.com/content/355/getting-mamp-working-with-ssl-on-os-x webopius web site] (excepted the last steps).

#stop MAMP
#backup your /Applications/MAMP/conf folder
#open a terminal
#enter: ''openssl genrsa -des3 -out server.key 1024''. Enter a password twice.
#enter: ''openssl req -new -key server.key -out server.csr''. Enter the previous password. You need to answer some questions. ''Common name'' expects your local name (for me it was jerome.moodle.local)
#enter: ''openssl x509 -req -days 365 -in server.csr -signkey server.key -out server.crt''
#enter: ''cp server.key server.tmp''
#enter: ''openssl rsa -in server.tmp -out server.key''. Enter the previous password.
#enter: ''mkdir /Applications/MAMP/conf/ssl''
#enter: cp server.crt /Applications/MAMP/conf/ssl
#enter: cp server.key /Applications/MAMP/conf/ssl
# Edit Applications/MAMP/conf/apache/ssl.conf:
##comment <IfDefine SSL> tag to closing tag (but not the content)
##SSLCertificateFile /Applications/MAMP/conf/ssl/server.crt
##SSLCertificateKeyFile /Applications/MAMP/conf/ssl/server.key
# Edit /Applications/MAMP/conf/apache/httpd.conf:
##Listen 80
##comment <IfDefine SSL> tag to closing tag (but not the content)
# Edit /Application/MAMP/conf/apache/ssl.conf, change the document root (DocumentRoot) for the one you have into /Application/MAMP/conf/apache/httpd.conf
#in a terminal enter: ''cd /Applications/MAMP/bin/apache2/bin''
#enter: ''sudo ./apachectl startssl''
#start MAMP

From now MAMP should start/stop with the SSL support activated. Note that these steps have only be tested with Apache port set to 80 into MAMP preferences.

==How To Update Your Moodle4Mac==

It is very simple to update your locally installed Moodle. If you have got this course together with Moodle4Mac then you should have everything you need for a CVS update.

The only software you must have installed on your Apple computer is the Xcode Tools package from your system installation media. After this it only needs a doubleclick to get the newest Moodle version without downloading the complete installation package.

===Update the local Moodle via CVS===

Be sure that the Xcode Tools are installed on your Mac computer. You also must have an internet connection to get the files from the update server.

Now the only thing you need to do is to doubleclick on an icon inside your MAMP folder. That's all .... really .... it's easy!!

Please look for the document '''UpdateMoodle.sh'''. If you doubleclick this file you will see that the system utility '''Terminal''' opens and the update process starts automatically. You must allow to connect to the Moodle internet server ... but think about this fact only if a system tool asks you.

[[Image:Moodle4Mac_Update1.png]]

The update tool CVS connects to the Moodle internet server and looks for all those files that must be downloaded. If the process asks for a password you press the return button to enter ... the password is "empty". The update needs a few moments to find all the updated or new files but then only those files are transfered. Please wait for some minutes.

[[Image:Moodle4Mac_Update2.png]]

Every updated file is shown in the update log so you can control if the updater works and when it is completed. At least you will see the config.php because this file does not come from the update server.

If the update takes too long you may break with <strg>-C. It doesn't matter because only text files are copied. On break the process stops working. If you restart the update again the CVS tool runs through all folders and files again to find those that need to be renewed.

===Look Inside ... ===

If you want to see what is inside the document '''UpdateMoodle.sh''' please feel free to open it with a text editor. It is only a text file but it uses the Mac OS X feature to open a file with a chosen program via doubleclick.

[[Image:Moodle4Mac_Update3.png]]

I chose the system utility '''Terminal''' to open the file '''UpdateMoodle.sh''' and to run the script it contains automatically. So everything can be done with a doubleclick. It's easy and everybody can do it!!

<pre>
#! /bin/sh
#
# This CVS updater for Mac OS X is part
# of the installation package Moodle4Mac
#
# 20101201 - Ralf Krause
#

export CVS_RSH=ssh

echo
echo "+--------------------------------------------+"
echo "| CVS update for your local Moodle server "
echo "+--------------------------------------------+"
echo

cd /Applications/MAMP/htdocs/moodle20/

### delete all files named .DS_Store
find . -name ".DS_Store" -type f -print0 | xargs -0 rm -f

### file ~/.cvspass must exist
if ! test -e ~/.cvspass ; then
touch ~/.cvspass
fi

### login to the cvs server only for the first time
if ! grep "uk.cvs.moodle.org" ~/.cvspass > /dev/null ; then
echo "CVS password is empty ... please only press <return> to start"
cvs -d :pserver:anonymous@uk.cvs.moodle.org:/cvsroot/moodle login
echo
fi

echo "Connecting to the CVS server. Download will take a few moments!"
echo "If the CVS update runs too long you may break with <strg>-C"
echo
cvs -q update -dP -r HEAD

</pre>

The different versions of the update script are different in only two things ... first you need to choose the correct folder for the Moodle files and seconds you must input the correct CVS tag for the Moodle version in the last line. The shown script is for updating the version Moodle 1.8
* Moodle 1.6 uses MOODLE_16_WEEKLY
* Moodle 1.7 uses MOODLE_17_WEEKLY
* Moodle 1.8 uses MOODLE_18_WEEKLY
* Moodle 1.9 uses MOODLE_19_WEEKLY
* Moodle 2.0 still uses HEAD

===Install Xcode Tools on your Mac===

Xcode Tools is the developer tools package for Mac OS X. This package includes an integrated suite of software development tools, including compilers and applications.

If you do not know whether the Xcode Tools are installed on your Mac please look on your main harddrive. If there is a folder named Developer then you must do nothing.

[[Image:Moodle4Mac_Update4.png]]

If you cannot find this on your harddrive then you must install this package before following the instructions in this document. The Xcode Tools package is part of the Mac OS X installation media. You will find the Xcode Tools on your installation CD or DVD set.

[[Image:Moodle4Mac_Update5.png]]

If you do not find your installation media anymore you also can download the Xcode Tools from the URL http://developer.apple.com/tools/xcode/. It is free but you have to register as a developer. If you start the download from there please remember that the Xcode package brings a lot of bytes and will need a very few minutes to complete.

After you have put these things into your system you will see a new folder named Developer on your harddisk. If you only want to update your Moodle you do not need all these nice developer tools from the inside of the folder. Sorry about this but there is no separate installer for the CVS update process.
  

==See also==
* [http://mamp.info MAMP = Mac + Apache + MySQL + PHP]
* [http://en.wikipedia.org/wiki/MAMP MAMP in Wikipedia]
* [[Step by Step Installation on a Mac OS X Server|Step by Step Installation on a Mac OS X Server 10.5/10.6]]
* [[Step-by-step Guide for Installing Moodle on Mac OS X 10.4 Client|Step by step Installation on a Mac OS X Client 10.4]]
* [[CVS for Administrators]]

* [http://en.wikipedia.org/wiki/Private_network Private network addresses in Wikipedia]
* [http://moodle.org/mod/forum/discuss.php?d=24632 Using Moodle: Dynamic DNS Home Server]

* [[Configuring aspell on Mac OS X]]

[[Category:Administrator]]
[[Category:Installation]]
[[Category:Mac OS X]]

[[de:Vollständiges Installationspaket für Mac OS X]]

File:Moodle4Mac Update2.png

2010-12-18T14:55:48Z

Krause: uploaded a new version of "Image:Moodle4Mac Update2.png"

File:Moodle4Mac Update2.png

2010-12-18T14:53:41Z

Krause: uploaded a new version of "Image:Moodle4Mac Update2.png"

Complete Install Packages for Mac OS X

2010-12-18T14:36:52Z

Krause: /* More about Moodle and CVS ... */

Complete install packages for Mac OS X are available from [http://download.moodle.org/macosx/ Moodle Downloads] which uses '''MAMP'''. You will find a separate card for the Mac OS X downloads. They are designed for new and local installations on a Mac computer/server. There are other downloads for Linux, and Window Operating Systems that may involve more customization of configuration files.

The complete install packages for Mac OS X are named Moodle4Mac. These do not have sufficient security for public, production servers--only use for private, local testing purposes. These packages allow Moodle to be installed, along with the prerequisites that includes a web server, database and scripting language (Apache, MySQL and PHP in this case). Several versions of the complete install package are available. You will find versions for Intel based Macs and for older PPC based Macs. Please use the correct version for your processor. The instructions on the download page provide guidance on which version is likely to be most suitable.

'''Note 1:''' The latest complete install package version components, may not be backwardly compatible. Always check version compatibility of each component if you intend to develop materials on a later version of Moodle than the version installed on your "main" Moodle site. In short, complete install packages are designed for first time install on a "clean" machine.

'''Note 2:''' If you want a secure, public server with OS X, you may be interested to use the normal web server that comes preinstalled with every Mac Computer--see the [[Step-by-step Guide for Installing Moodle on Mac OS X 10.4 Client]] for Moodle. However, remember that the complete package Moodle4Mac is ready to use and no additional programs must be installed and configured together.

==System requirements==
+ Apple Mac Computer
+ iMac, Mac mini, MacBook, iBook, PowerBook, Mac Pro, Xserve
+ Processor: Intel Core 2 Duo or PPC (G3, G4, G5)
+ RAM: 512 MB or better
+ Hard Disk: 500 MB free
+ System Software: Mac OS X 10.4 or 10.5 - for 10.3 you must use a rather old MAMP

==Install complete package Moodle4Mac==
===Download and install Moodle4Mac===
'''Step 1:''' [http://download.moodle.org/macosx/ Download] the zipped disk image file from the Moodle download page. Please choose the correct file for your processor type. The zip archive should be unzipped automatically when the download is complete. If the download file is not unzipped please do this manually.

'''Step 2:''' Doubleclick the file Moodle4Mac.dmg to mount the installation disk.

[[Image:Moodle4Mac_1.png]]

'''Step 3:''' Move the folder '''MAMP''' into the folder '''Applications'''. Moodle4Mac is based on MAMP (Mac, Apache, MySQL, PHP). MAMP makes no entries in any registry and no settings for the system variables. If you want to know more about MAMP please read the project page http://mamp.info/

'''Step 4:''' Now you are ready to start your web server. Go to the Applications folder. Find the MAMP folder and open it.

[[Image:Moodle4Mac_2.png]]

'''Step 5:''' Doubleclick the icon MAMP to start the server.

[[Image:Moodle4Mac_4.png]]

'''Step 6:''' Start your browser and type <nowiki> http://127.0.0.1:8888 or http://localhost:8888 </nowiki> in the address bar. You will start your preinstalled Moodle. You do not need to do any installation. You are ready. Done ... hey, that was easy, wasn't it??

[[Image:Moodle4Mac_3.jpg]]

'''Step 7:''' Please login with the username '''admin''' and the password '''12345''' and you will be the main administrator of your new local Moodle.

==Using Moodle4Mac as a local server in your network==

In some workshops we used Moodle4Mac as a quick server installation for our local network. You should change the admin passwords (Moodle and MySQL) before you do this. There are only two steps to get the server connection from every computer in your network. One step is the change of only one line in the Moodle config.php, and the second step is that you must open the firewall of the Mac OS X. This chapter shows how you can do this.

===Edit the file config.php===

Use the current ip address of your computer instead of localhost so an external computer can connect the the web server. If your network is configured to dynamic ip addresses via DHCP please make sure that your computer retains its ip address while you want to use it as a Moodle server.The best thing would be to get a static ip address for your computer. Mostly your ip address in a local network will show one of the following numbers 10.x.x.x, 172.x.x.x, or 192.168.x.x

If your computer for example has the ip address 192.168.0.20 then you must change the configuration from ''localhost'' to ''192.168.0.20''. In the following box you will see this address in the line $CFG->wwwroot. This ip address will be different in your own network. You must use own address for your own network!! Please do not use an ip address if you do not know what you are doing ... ask your network administrator.

<pre><?php /// Moodle Configuration File

unset($CFG);

$CFG->dbtype = 'mysql';
$CFG->dbhost = 'localhost';
$CFG->dbname = 'moodle18';
$CFG->dbuser = 'moodle';
$CFG->dbpass = 'moodle';
$CFG->dbpersist = false;
$CFG->prefix = 'mdl_';

// Use the ip address of your computer instead of localhost
$CFG->wwwroot = 'http://192.168.0.20:8888/moodle18';
$CFG->dirroot = '/Applications/MAMP/htdocs/moodle18';
$CFG->dataroot = '/Applications/MAMP/data/moodle18';
$CFG->admin = 'admin';

$CFG->directorypermissions = 00777; // try 02777 on a server in Safe Mode

$CFG->unicodedb = true; // Database is utf8

require_once("$CFG->dirroot/lib/setup.php");
// MAKE SURE WHEN YOU EDIT THIS FILE THAT THERE ARE NO SPACES, BLANK LINES,
// RETURNS, OR ANYTHING ELSE AFTER THE TWO CHARACTERS ON THE NEXT LINE.
?>
</pre>

===Open the firewall===
The web server that comes together with Moodle4Mac works on the TCP port 8888. Moodle4Mac uses this port because this gets no conflicts with the normal web server of Mac OS X that answers on TCP port 80. You can switch the port from 8888 to 80 but you must know the administration password of your Mac. In this case the normal web server will not work.

To open the firewall please go to '''System Preferences > Sharing > Firewall'''. Choose '''New...''', fill in TCP port 8888, and set the rule name '''Moodle4Mac'''.

[[Image:Moodle4Mac_Firewall1.png]]

When the rule exists it must be activated to get a connection to Moodle from any computer in your internal network.

[[Image:Moodle4Mac_Firewall2.png]]

===Connect Moodle from your network ...===
Your web server can be connected with the url http://x.x.x.x:8888/moodle18/ in your local network, where x.x.x.x is the address your Mac was given by the local router on your LAN. Usually such numbers start with 10.x.x.x, 172.x.x.x, or 192.168.x.x. All users from any computer in your network can use your Moodle via this address.

This also works if your computer is connected to the internet directly. If you open the firewall in your internet router and if you forward the port 8888 to your computer then any user everywhere on the world would be able to work with your Moodle ... but please remember also that there are a lot of security risks if you do this ... it would be better if you don't do this!!

[[Image:Moodle4Mac_Network1.png]]

[[Image:Moodle4Mac_Network2.png]]

==Some words about the security ...==
===MAMP is designed for local computers===
MAMP can be used for testing and developing websites locally on their Apple computers. MAMP should not be used in a production environment because everybody knows all the settings and all the predefined passwords. It's prepared for an easy start and not for a public web server!! But with some careful modfications, you can sufficiently secure MAMP and Moodle4Mac to use them in public development environments.

===How to secure MAMP?===
I found some ideas in the following document: [http://www.network0.org/2006/09/23/how-to-secure-mamp/ How to secure MAMP?]. It's really old and some of the instructions are not correct for the current version.

There is also a new package MAMP Pro that will let you do a lot of settings for a more secure web server. Please look to the web page for this product. You can find a describtion for MAMP Pro on the [http://www.living-e.com/MAMP-PRO/ MAMP internet server]. It's commertial and not free!

===Step by step to secure Moodle4Mac===

  
==How to set up SSL/https in MAMP for a development/test environment==
The text is copied from [http://www.webopius.com/content/355/getting-mamp-working-with-ssl-on-os-x webopius web site] (excepted the last steps).

#stop MAMP
#backup your /Applications/MAMP/conf folder
#open a terminal
#enter: ''openssl genrsa -des3 -out server.key 1024''. Enter a password twice.
#enter: ''openssl req -new -key server.key -out server.csr''. Enter the previous password. You need to answer some questions. ''Common name'' expects your local name (for me it was jerome.moodle.local)
#enter: ''openssl x509 -req -days 365 -in server.csr -signkey server.key -out server.crt''
#enter: ''cp server.key server.tmp''
#enter: ''openssl rsa -in server.tmp -out server.key''. Enter the previous password.
#enter: ''mkdir /Applications/MAMP/conf/ssl''
#enter: cp server.crt /Applications/MAMP/conf/ssl
#enter: cp server.key /Applications/MAMP/conf/ssl
# Edit Applications/MAMP/conf/apache/ssl.conf:
##comment <IfDefine SSL> tag to closing tag (but not the content)
##SSLCertificateFile /Applications/MAMP/conf/ssl/server.crt
##SSLCertificateKeyFile /Applications/MAMP/conf/ssl/server.key
# Edit /Applications/MAMP/conf/apache/httpd.conf:
##Listen 80
##comment <IfDefine SSL> tag to closing tag (but not the content)
# Edit /Application/MAMP/conf/apache/ssl.conf, change the document root (DocumentRoot) for the one you have into /Application/MAMP/conf/apache/httpd.conf
#in a terminal enter: ''cd /Applications/MAMP/bin/apache2/bin''
#enter: ''sudo ./apachectl startssl''
#start MAMP

From now MAMP should start/stop with the SSL support activated. Note that these steps have only be tested with Apache port set to 80 into MAMP preferences.

==How To Update Your Moodle4Mac==

It is very simple to update your locally installed Moodle. If you have got this course together with Moodle4Mac then you should have everything you need for a CVS update.

The only software you must have installed on your Apple computer is the Xcode Tools package from your system installation media. After this it only needs a doubleclick to get the newest Moodle version without downloading the complete installation package.

===Update the local Moodle via CVS===

Be sure that the Xcode Tools are installed on your Mac computer. You also must have an internet connection to get the files from the update server.

Now the only thing you need to do is to doubleclick on an icon inside your MAMP folder. That's all .... really .... it's easy!!

Please look for the document '''UpdateMoodle.sh'''. If you doubleclick this file you will see that the system utility '''Terminal''' opens and the update process starts automatically. You must allow to connect to the Moodle internet server ... but think about this fact only if a system tool asks you.

[[Image:Moodle4Mac_Update1.png]]

The update tool CVS connects to the Moodle internet server and looks for all those files that must be downloaded. If the process asks for a password you press the return button to enter ... the password is "empty". The update needs a few moments to find all the updated or new files but then only those files are transfered. Please wait for some minutes.

[[Image:Moodle4Mac_Update2.png]]

Every updated file is shown in the update log so you can control if the updater works and when it is completed. At least you will see the config.php because this file does not come from the update server.

If the update takes too long you may break with <strg>-C. It doesn't matter because only text files are copied. On break the process stops working. If you restart the update again the CVS tool runs through all folders and files again to find those that need to be renewed.

===Look Inside ... ===

If you want to see what is inside the document '''UpdateMoodle.sh''' please feel free to open it with a text editor. It is only a text file but it uses the Mac OS X feature to open a file with a chosen program via doubleclick.

[[Image:Moodle4Mac_Update3.png]]

I chose the system utility '''Terminal''' to open the file '''UpdateMoodle.sh''' and to run the script it contains automatically. So everything can be done with a doubleclick. It's easy and everybody can do it!!

<pre>
#! /bin/sh
#
# This CVS updater for Mac OS X is part
# of the installation package Moodle4Mac
#
# 20080514 - Ralf Krause
#

export CVS_RSH=ssh

echo
echo "+--------------------------------------------+"
echo "| CVS update for your local Moodle server "
echo "+--------------------------------------------+"
echo

cd /Applications/MAMP/htdocs/moodle19/

### delete all files named .DS_Store
find . -name ".DS_Store" -type f -print0 | xargs -0 rm -f

### file ~/.cvspass must exist
if ! test -e ~/.cvspass ; then
touch ~/.cvspass
fi

### login to the cvs server only for the first time
if ! grep "uk.cvs.moodle.org" ~/.cvspass > /dev/null ; then
echo "CVS password is empty ... please only press <return> to start"
cvs -d :pserver:anonymous@uk.cvs.moodle.org:/cvsroot/moodle login
echo
fi

echo "Connecting to the CVS server. Download will take a few moments!"
echo "If the CVS update runs too long you may break with <strg>-C"
echo
cvs -q update -dP -r MOODLE_19_WEEKLY

</pre>

The different versions of the update script are different in only two things ... first you need to choose the correct folder for the Moodle files and seconds you must input the correct CVS tag for the Moodle version in the last line. The shown script is for updating the version Moodle 1.8
* Moodle 1.6 uses MOODLE_16_WEEKLY
* Moodle 1.7 uses MOODLE_17_WEEKLY
* Moodle 1.8 uses MOODLE_18_WEEKLY
* Moodle 1.9 uses MOODLE_19_WEEKLY
* Moodle 2.0 still uses HEAD

===Install Xcode Tools on your Mac===

Xcode Tools is the developer tools package for Mac OS X. This package includes an integrated suite of software development tools, including compilers and applications.

If you do not know whether the Xcode Tools are installed on your Mac please look on your main harddrive. If there is a folder named Developer then you must do nothing.

[[Image:Moodle4Mac_Update4.png]]

If you cannot find this on your harddrive then you must install this package before following the instructions in this document. The Xcode Tools package is part of the Mac OS X installation media. You will find the Xcode Tools on your installation CD or DVD set.

[[Image:Moodle4Mac_Update5.png]]

If you do not find your installation media anymore you also can download the Xcode Tools from the URL http://developer.apple.com/tools/xcode/. It is free but you have to register as a developer. If you start the download from there please remember that the Xcode package brings a lot of bytes and will need a very few minutes to complete.

After you have put these things into your system you will see a new folder named Developer on your harddisk. If you only want to update your Moodle you do not need all these nice developer tools from the inside of the folder. Sorry about this but there is no separate installer for the CVS update process.
  

==See also==
* [http://mamp.info MAMP = Mac + Apache + MySQL + PHP]
* [http://en.wikipedia.org/wiki/MAMP MAMP in Wikipedia]
* [[Step by Step Installation on a Mac OS X Server|Step by Step Installation on a Mac OS X Server 10.5/10.6]]
* [[Step-by-step Guide for Installing Moodle on Mac OS X 10.4 Client|Step by step Installation on a Mac OS X Client 10.4]]
* [[CVS for Administrators]]

* [http://en.wikipedia.org/wiki/Private_network Private network addresses in Wikipedia]
* [http://moodle.org/mod/forum/discuss.php?d=24632 Using Moodle: Dynamic DNS Home Server]

* [[Configuring aspell on Mac OS X]]

[[Category:Administrator]]
[[Category:Installation]]
[[Category:Mac OS X]]

[[de:Vollständiges Installationspaket für Mac OS X]]

Complete Install Packages for Mac OS X

2010-12-18T14:33:15Z

Krause: /* Look Inside ... */

Complete install packages for Mac OS X are available from [http://download.moodle.org/macosx/ Moodle Downloads] which uses '''MAMP'''. You will find a separate card for the Mac OS X downloads. They are designed for new and local installations on a Mac computer/server. There are other downloads for Linux, and Window Operating Systems that may involve more customization of configuration files.

The complete install packages for Mac OS X are named Moodle4Mac. These do not have sufficient security for public, production servers--only use for private, local testing purposes. These packages allow Moodle to be installed, along with the prerequisites that includes a web server, database and scripting language (Apache, MySQL and PHP in this case). Several versions of the complete install package are available. You will find versions for Intel based Macs and for older PPC based Macs. Please use the correct version for your processor. The instructions on the download page provide guidance on which version is likely to be most suitable.

'''Note 1:''' The latest complete install package version components, may not be backwardly compatible. Always check version compatibility of each component if you intend to develop materials on a later version of Moodle than the version installed on your "main" Moodle site. In short, complete install packages are designed for first time install on a "clean" machine.

'''Note 2:''' If you want a secure, public server with OS X, you may be interested to use the normal web server that comes preinstalled with every Mac Computer--see the [[Step-by-step Guide for Installing Moodle on Mac OS X 10.4 Client]] for Moodle. However, remember that the complete package Moodle4Mac is ready to use and no additional programs must be installed and configured together.

==System requirements==
+ Apple Mac Computer
+ iMac, Mac mini, MacBook, iBook, PowerBook, Mac Pro, Xserve
+ Processor: Intel Core 2 Duo or PPC (G3, G4, G5)
+ RAM: 512 MB or better
+ Hard Disk: 500 MB free
+ System Software: Mac OS X 10.4 or 10.5 - for 10.3 you must use a rather old MAMP

==Install complete package Moodle4Mac==
===Download and install Moodle4Mac===
'''Step 1:''' [http://download.moodle.org/macosx/ Download] the zipped disk image file from the Moodle download page. Please choose the correct file for your processor type. The zip archive should be unzipped automatically when the download is complete. If the download file is not unzipped please do this manually.

'''Step 2:''' Doubleclick the file Moodle4Mac.dmg to mount the installation disk.

[[Image:Moodle4Mac_1.png]]

'''Step 3:''' Move the folder '''MAMP''' into the folder '''Applications'''. Moodle4Mac is based on MAMP (Mac, Apache, MySQL, PHP). MAMP makes no entries in any registry and no settings for the system variables. If you want to know more about MAMP please read the project page http://mamp.info/

'''Step 4:''' Now you are ready to start your web server. Go to the Applications folder. Find the MAMP folder and open it.

[[Image:Moodle4Mac_2.png]]

'''Step 5:''' Doubleclick the icon MAMP to start the server.

[[Image:Moodle4Mac_4.png]]

'''Step 6:''' Start your browser and type <nowiki> http://127.0.0.1:8888 or http://localhost:8888 </nowiki> in the address bar. You will start your preinstalled Moodle. You do not need to do any installation. You are ready. Done ... hey, that was easy, wasn't it??

[[Image:Moodle4Mac_3.jpg]]

'''Step 7:''' Please login with the username '''admin''' and the password '''12345''' and you will be the main administrator of your new local Moodle.

==Using Moodle4Mac as a local server in your network==

In some workshops we used Moodle4Mac as a quick server installation for our local network. You should change the admin passwords (Moodle and MySQL) before you do this. There are only two steps to get the server connection from every computer in your network. One step is the change of only one line in the Moodle config.php, and the second step is that you must open the firewall of the Mac OS X. This chapter shows how you can do this.

===Edit the file config.php===

Use the current ip address of your computer instead of localhost so an external computer can connect the the web server. If your network is configured to dynamic ip addresses via DHCP please make sure that your computer retains its ip address while you want to use it as a Moodle server.The best thing would be to get a static ip address for your computer. Mostly your ip address in a local network will show one of the following numbers 10.x.x.x, 172.x.x.x, or 192.168.x.x

If your computer for example has the ip address 192.168.0.20 then you must change the configuration from ''localhost'' to ''192.168.0.20''. In the following box you will see this address in the line $CFG->wwwroot. This ip address will be different in your own network. You must use own address for your own network!! Please do not use an ip address if you do not know what you are doing ... ask your network administrator.

<pre><?php /// Moodle Configuration File

unset($CFG);

$CFG->dbtype = 'mysql';
$CFG->dbhost = 'localhost';
$CFG->dbname = 'moodle18';
$CFG->dbuser = 'moodle';
$CFG->dbpass = 'moodle';
$CFG->dbpersist = false;
$CFG->prefix = 'mdl_';

// Use the ip address of your computer instead of localhost
$CFG->wwwroot = 'http://192.168.0.20:8888/moodle18';
$CFG->dirroot = '/Applications/MAMP/htdocs/moodle18';
$CFG->dataroot = '/Applications/MAMP/data/moodle18';
$CFG->admin = 'admin';

$CFG->directorypermissions = 00777; // try 02777 on a server in Safe Mode

$CFG->unicodedb = true; // Database is utf8

require_once("$CFG->dirroot/lib/setup.php");
// MAKE SURE WHEN YOU EDIT THIS FILE THAT THERE ARE NO SPACES, BLANK LINES,
// RETURNS, OR ANYTHING ELSE AFTER THE TWO CHARACTERS ON THE NEXT LINE.
?>
</pre>

===Open the firewall===
The web server that comes together with Moodle4Mac works on the TCP port 8888. Moodle4Mac uses this port because this gets no conflicts with the normal web server of Mac OS X that answers on TCP port 80. You can switch the port from 8888 to 80 but you must know the administration password of your Mac. In this case the normal web server will not work.

To open the firewall please go to '''System Preferences > Sharing > Firewall'''. Choose '''New...''', fill in TCP port 8888, and set the rule name '''Moodle4Mac'''.

[[Image:Moodle4Mac_Firewall1.png]]

When the rule exists it must be activated to get a connection to Moodle from any computer in your internal network.

[[Image:Moodle4Mac_Firewall2.png]]

===Connect Moodle from your network ...===
Your web server can be connected with the url http://x.x.x.x:8888/moodle18/ in your local network, where x.x.x.x is the address your Mac was given by the local router on your LAN. Usually such numbers start with 10.x.x.x, 172.x.x.x, or 192.168.x.x. All users from any computer in your network can use your Moodle via this address.

This also works if your computer is connected to the internet directly. If you open the firewall in your internet router and if you forward the port 8888 to your computer then any user everywhere on the world would be able to work with your Moodle ... but please remember also that there are a lot of security risks if you do this ... it would be better if you don't do this!!

[[Image:Moodle4Mac_Network1.png]]

[[Image:Moodle4Mac_Network2.png]]

==Some words about the security ...==
===MAMP is designed for local computers===
MAMP can be used for testing and developing websites locally on their Apple computers. MAMP should not be used in a production environment because everybody knows all the settings and all the predefined passwords. It's prepared for an easy start and not for a public web server!! But with some careful modfications, you can sufficiently secure MAMP and Moodle4Mac to use them in public development environments.

===How to secure MAMP?===
I found some ideas in the following document: [http://www.network0.org/2006/09/23/how-to-secure-mamp/ How to secure MAMP?]. It's really old and some of the instructions are not correct for the current version.

There is also a new package MAMP Pro that will let you do a lot of settings for a more secure web server. Please look to the web page for this product. You can find a describtion for MAMP Pro on the [http://www.living-e.com/MAMP-PRO/ MAMP internet server]. It's commertial and not free!

===Step by step to secure Moodle4Mac===

  
==How to set up SSL/https in MAMP for a development/test environment==
The text is copied from [http://www.webopius.com/content/355/getting-mamp-working-with-ssl-on-os-x webopius web site] (excepted the last steps).

#stop MAMP
#backup your /Applications/MAMP/conf folder
#open a terminal
#enter: ''openssl genrsa -des3 -out server.key 1024''. Enter a password twice.
#enter: ''openssl req -new -key server.key -out server.csr''. Enter the previous password. You need to answer some questions. ''Common name'' expects your local name (for me it was jerome.moodle.local)
#enter: ''openssl x509 -req -days 365 -in server.csr -signkey server.key -out server.crt''
#enter: ''cp server.key server.tmp''
#enter: ''openssl rsa -in server.tmp -out server.key''. Enter the previous password.
#enter: ''mkdir /Applications/MAMP/conf/ssl''
#enter: cp server.crt /Applications/MAMP/conf/ssl
#enter: cp server.key /Applications/MAMP/conf/ssl
# Edit Applications/MAMP/conf/apache/ssl.conf:
##comment <IfDefine SSL> tag to closing tag (but not the content)
##SSLCertificateFile /Applications/MAMP/conf/ssl/server.crt
##SSLCertificateKeyFile /Applications/MAMP/conf/ssl/server.key
# Edit /Applications/MAMP/conf/apache/httpd.conf:
##Listen 80
##comment <IfDefine SSL> tag to closing tag (but not the content)
# Edit /Application/MAMP/conf/apache/ssl.conf, change the document root (DocumentRoot) for the one you have into /Application/MAMP/conf/apache/httpd.conf
#in a terminal enter: ''cd /Applications/MAMP/bin/apache2/bin''
#enter: ''sudo ./apachectl startssl''
#start MAMP

From now MAMP should start/stop with the SSL support activated. Note that these steps have only be tested with Apache port set to 80 into MAMP preferences.

==How To Update Your Moodle4Mac==

It is very simple to update your locally installed Moodle. If you have got this course together with Moodle4Mac then you should have everything you need for a CVS update.

The only software you must have installed on your Apple computer is the Xcode Tools package from your system installation media. After this it only needs a doubleclick to get the newest Moodle version without downloading the complete installation package.

===Update the local Moodle via CVS===

Be sure that the Xcode Tools are installed on your Mac computer. You also must have an internet connection to get the files from the update server.

Now the only thing you need to do is to doubleclick on an icon inside your MAMP folder. That's all .... really .... it's easy!!

Please look for the document '''UpdateMoodle.sh'''. If you doubleclick this file you will see that the system utility '''Terminal''' opens and the update process starts automatically. You must allow to connect to the Moodle internet server ... but think about this fact only if a system tool asks you.

[[Image:Moodle4Mac_Update1.png]]

The update tool CVS connects to the Moodle internet server and looks for all those files that must be downloaded. If the process asks for a password you press the return button to enter ... the password is "empty". The update needs a few moments to find all the updated or new files but then only those files are transfered. Please wait for some minutes.

[[Image:Moodle4Mac_Update2.png]]

Every updated file is shown in the update log so you can control if the updater works and when it is completed. At least you will see the config.php because this file does not come from the update server.

If the update takes too long you may break with <strg>-C. It doesn't matter because only text files are copied. On break the process stops working. If you restart the update again the CVS tool runs through all folders and files again to find those that need to be renewed.

===Look Inside ... ===

If you want to see what is inside the document '''UpdateMoodle.sh''' please feel free to open it with a text editor. It is only a text file but it uses the Mac OS X feature to open a file with a chosen program via doubleclick.

[[Image:Moodle4Mac_Update3.png]]

I chose the system utility '''Terminal''' to open the file '''UpdateMoodle.sh''' and to run the script it contains automatically. So everything can be done with a doubleclick. It's easy and everybody can do it!!

<pre>
#! /bin/sh
#
# This CVS updater for Mac OS X is part
# of the installation package Moodle4Mac
#
# 20080514 - Ralf Krause
#

export CVS_RSH=ssh

echo
echo "+--------------------------------------------+"
echo "| CVS update for your local Moodle server "
echo "+--------------------------------------------+"
echo

cd /Applications/MAMP/htdocs/moodle19/

### delete all files named .DS_Store
find . -name ".DS_Store" -type f -print0 | xargs -0 rm -f

### file ~/.cvspass must exist
if ! test -e ~/.cvspass ; then
touch ~/.cvspass
fi

### login to the cvs server only for the first time
if ! grep "uk.cvs.moodle.org" ~/.cvspass > /dev/null ; then
echo "CVS password is empty ... please only press <return> to start"
cvs -d :pserver:anonymous@uk.cvs.moodle.org:/cvsroot/moodle login
echo
fi

echo "Connecting to the CVS server. Download will take a few moments!"
echo "If the CVS update runs too long you may break with <strg>-C"
echo
cvs -q update -dP -r MOODLE_19_WEEKLY

</pre>

The different versions of the update script are different in only two things ... first you need to choose the correct folder for the Moodle files and seconds you must input the correct CVS tag for the Moodle version in the last line. The shown script is for updating the version Moodle 1.8
* Moodle 1.6 uses MOODLE_16_WEEKLY
* Moodle 1.7 uses MOODLE_17_WEEKLY
* Moodle 1.8 uses MOODLE_18_WEEKLY
* Moodle 1.9 uses MOODLE_19_WEEKLY
* Moodle 2.0 still uses HEAD

===More about Moodle and CVS ... ===

Please look at the documentation [[CVS for Administrators]] if you want to learn more. Remember that the CVS server for Moodle changed on 25th April 2007 so you have to update your scripts if you already installed an older version. Moodle had problems with the old CVS server so they had to change it.

If you are using an older package Moodle4Mac you must not reload the whole package and you must not reinstall all your local courses again. You only have to download the archive [http://download.moodle.org/macosx/ChangeCVSServer.zip ChangeCVSServer.zip]. It contains the script ChangeCSVSServer.sh ... please run it once and it changes all the CVS data automatically. You also will find new scripts UpdateMoodle.sh for Moodle 1.6, 1.7, 1.8, and 1.9 dev. You must use the correct version of the new script UpdateMoodle.sh for all your future updates. Please delete the old script from your MAMP folder.
  

===Install Xcode Tools on your Mac===

Xcode Tools is the developer tools package for Mac OS X. This package includes an integrated suite of software development tools, including compilers and applications.

If you do not know whether the Xcode Tools are installed on your Mac please look on your main harddrive. If there is a folder named Developer then you must do nothing.

[[Image:Moodle4Mac_Update4.png]]

If you cannot find this on your harddrive then you must install this package before following the instructions in this document. The Xcode Tools package is part of the Mac OS X installation media. You will find the Xcode Tools on your installation CD or DVD set.

[[Image:Moodle4Mac_Update5.png]]

If you do not find your installation media anymore you also can download the Xcode Tools from the URL http://developer.apple.com/tools/xcode/. It is free but you have to register as a developer. If you start the download from there please remember that the Xcode package brings a lot of bytes and will need a very few minutes to complete.

After you have put these things into your system you will see a new folder named Developer on your harddisk. If you only want to update your Moodle you do not need all these nice developer tools from the inside of the folder. Sorry about this but there is no separate installer for the CVS update process.
  

==See also==
* [http://mamp.info MAMP = Mac + Apache + MySQL + PHP]
* [http://en.wikipedia.org/wiki/MAMP MAMP in Wikipedia]
* [[Step by Step Installation on a Mac OS X Server|Step by Step Installation on a Mac OS X Server 10.5/10.6]]
* [[Step-by-step Guide for Installing Moodle on Mac OS X 10.4 Client|Step by step Installation on a Mac OS X Client 10.4]]
* [[CVS for Administrators]]

* [http://en.wikipedia.org/wiki/Private_network Private network addresses in Wikipedia]
* [http://moodle.org/mod/forum/discuss.php?d=24632 Using Moodle: Dynamic DNS Home Server]

* [[Configuring aspell on Mac OS X]]

[[Category:Administrator]]
[[Category:Installation]]
[[Category:Mac OS X]]

[[de:Vollständiges Installationspaket für Mac OS X]]

Step by Step Installation on a Mac OS X Server

2010-11-11T15:42:19Z

Krause: /* Mac OS X 10.6 Server - No PHP installation needed */

==Overview==
This guide shows all steps for the installation of Moodle on a [http://www.apple.com/server/macosx Mac OS X Server]. This server is a commercial product. You will find [http://www.apple.com/server/macosx/resources/documentation.html all documentations] about the web server on the Apple support pages.

This installation guide can't be useful for an installation on MAMP or XAMPP. If you are looking for an easy way to install Moodle on your local machine please use [[Complete Install Packages for Mac OS X | Complete install packages for Mac OS X 10.4/10.5/10.6 Clients]] that can be downloaded from http://download.moodle.org/macosx/ ... but if you are planning to set up a Moodle internet server on a Mac then you should think about some more security as the ever local package could give.

Please feel free to add your ideas and wishes to the discussion page for this article. You may also write a complete chapter if you tried the facts yourself on your own Mac Server. I am most interested to make the things better.

==System requirements==

+ Apple Computer
+ Mac mini, Mac Pro or Xserve
+ Processor: Intel Core 2 Duo, Intel Core i3/i5/i7
+ RAM: 2 GB or better
+ Hard Disk: 500 MB free
+ System Software: Mac OS X Server 10.5 or 10.6

==Configure PHP for your Moodle installation==
===Mac OS X 10.6 Server - No PHP installation needed===

The Mac OS X 10.6.5 Server (SnowLeopard) comes with PHP 5.3.3 and a lot of PHP extensions. This would be the best choice for Moodle 1.9.x and for Moodle 2.0 on a Mac OS X Server. Please forget everything you read about the missing GD Library! The PHP installation is totally complete for Moodle. You only have to switch on the PHP module and to control if the file ''/etc/php.ini'' sets the right values for Moodle.

[[Image:Server-admin-106.png]]

===Mac OS X 10.5 Server - Install PHP 5.3.0 and the GD Library===

The Mac OS X 10.5.8 Server (Leopard) comes with PHP 5.2.6 ... this is correct for Moodle 1.9.x. But you have to add the missing GD Library support to get Moodle running on your server. For Moodle 2.0 the server must have PHP 5.2.8 (or better) and some more PHP extensions ... in this case you need to get the better PHP version. These instructions are helpful in both cases.

To see which PHP version and extensions are installed on your server you should edit the file ''/Library/WebServer/Documents/info.php''. You must activate the function call phpinfo() by deleting the both slashes // at the start of the function line. After saving the file you can get all PHP informations in your browser. Please look at http://your-server-address/info.php ... you will not find any GD library support ... bad thing for Moodle!!

<?php
// You can use Server Admin to enable the Apache PHP module; it's disabled by default.
// You can uncomment the phpinfo() directive below to provide a default PHP info page
// but note that this displays information about your host's configuration.
phpinfo();
?>

The easiest way to get the GD library support and to get a better PHP version would be the installation of the complete PHP 5.3.0 package from http://www.entropy.ch/software/macosx/php/. Marc Liyanage precompiled this package to use it on Mac clients and Mac servers. Please get the package and install it by following the instructions on the download page. The installer does everything for you ... it copies PHP into the correct folder ''/usr/local/php5'' and changes its owner to ''root'' automatically. You will find the file php.ini inside the new package folder. Open the file ''/usr/local/php5/lib/php.ini'' and edit some settings for Moodle.

Note: If you want to install Moodle 1.8.x on the server you need to get the Entropy PHP-5.2.9-7.pkg instead. Moodle 1.8.x does not run with PHP 5.3.0. (MDL-20128)

Now the Apache web server must get knowledge that you want to use the new PHP library instead of the old. Open the application Server Admin to switch to the new library. Go to the web server settings and find the entry php5_module. The normal place for PHP the Mac server is ''libexec/apache2/libphp5.so''. Please change to ''/usr/local/php5/libphp5.so'' and save the settings.

[[Image:Server-admin.png]]

===PHP settings in your php.ini===
The next thing is to configure the file ''php.ini''. Most of the settings are okay but not all of them. To communicate to the MySQL database with PHP you have to set the default socket name for local MySQL connects. The default socket name for local MySQLi connects is needed for Moodle 2.0.

If you want to upload any file to your Moodle you should add a little bit more upload size in php.ini. If your server can't use more than 1 GB RAM you should set the memory_limit to a value less than 128M ... but it should have more than 48M for Moodle 1.9 and Moodle 2.0. Note that these sections are not likely to be consecutive in the php.ini file; the quickest way to find each one is search on the initial term (such as 'mysql.default_socket').

; Default socket name for local MySQL connects.
; If empty, uses the built-in MySQL defaults.
mysql.default_socket = /var/mysql/mysql.sock

; Default socket name for local MySQL connects.
; If empty, uses the built-in MySQL defaults.
mysqli.default_socket = /var/mysql/mysql.sock

; Maximum amount of memory a script may consume (128MB)
memory_limit = 128M

; Maximum allowed size for uploaded files.
upload_max_filesize = 128M

; Maximum size of POST data that PHP will accept.
post_max_size = 128M

; Defines the default timezone used by the date functions
; http://php.net/date.timezone
date.timezone = 'Europe/Berlin';

That's all ... save the file ''php.ini'' and restart the web server. Now you should look at http://your-server-address/info.php again. I hope that everything will be okay. You will find the version number PHP 5.3.x and the running GD library support. Congratulations ... the first step for Moodle on your Mac server is done!

[[Image:phpinfo.png]]

[[Image:phpinfo2.png]]

==Configure the MySQL database for your Moodle installation==

In standard case the database MySQL is installed on the Mac OS X Server but it is not running yet. Please make sure that you start the MySQL database server.

===Use the graphical way===
Sorry ... there are some more installations and a lot of clicks to configure MySQL in a graphical way.

First of all start the ''Server Admin''. You will find this program by the way ''Applications > Server > Server Admin''. Activate MySQL on the local server. You must set the password for the user ''root'' before you can start MySQL.

For the next you must download the MySQL database administration tool '''phpMyAdmin''' from http://www.phpmyadmin.net . Move the folder to the web server documents as ''/Library/WebServer/Documents/phpMyAdmin''.

Add the security phrase to the file ''config.inc.php'' in between the single quotes on the line $cfg['blowfish_secret'] = ''; /* YOU MUST FILL IN THIS FOR COOKIE AUTH! */

Now you will be able to start http://your-server-address/phpMyAdmin/ in your browser and to log into the database as the user ''root''. Add a database ''moodle19''. Add a database user ''moodle'' to the server ''localhost''. Don't forget to set a secure password. The database user ''moodle'' should be allowed to administrate the database ''moodle19'' only. It is a bad way to set ''root'' to administrate the database ''moodle19''. If you want to install also Moodle 2.0 dev please add a second database ''moodle20'' and use the same database user for it.

phpMyAdmin is a nice thing to look into the database while Moodle is running for some time. It's much easier to see in the graphical interface than in the command line tools. The image shows the database after Moodle 1.9 and Moodle 2.0 were already installed on this server.

[[Image:phpmyadmin.png]]

===Use the Terminal===

If you want a quick installation then don't fear to use the Terminal. It's easier to tell you all the commands for the right way with the Terminal than showing you all the pictures to do the same with graphical tools. There are only a few commands to do everything I told you before.

Start the Terminal. You will find this program by the way ''Applications > Tools > Terminal''. You will see that we must do the same steps as before but you can read them in a text form.

First of all you need to set the root password. If you didn't this before then use the first command line. If you want to change an existing password then use the second one.

Server:~ $ mysqladmin -u root password 'secret'
Server:~ $ mysqladmin -u root -p password 'topsecret'

The next steps are creating a new database ''moodle19'' with correct character set and setting up a database user ''moodle'', with an assigned password (IDENTIFIED BY), to administrate the new database ... and if you want, then do the same for ''moodle20''.

Server:~ $ mysqladmin -u root -p create moodle19
Server:~ $ mysql -u root -p

mysql> ALTER DATABASE moodle19 CHARSET 'utf8';
mysql> GRANT ALL PRIVILEGES ON moodle19.* TO moodle@localhost
-> IDENTIFIED BY 'moodle!';
mysql> quit

Server:~ $

That's really all with the Terminal. You are just ready!

===Use InnoDB with Moodle 2.0===

For Moodle 2.0 you should setup the support for InnoDB in your MySQL database.

Open the file /etc/my.cnf an delete every # in all lines beginning with innodb. This uncomments the InnoDB settings. Please save the file and restart your MySQL database.

# Uncomment the following if you are using InnoDB tables
innodb_data_home_dir = /var/mysql/
innodb_data_file_path = ibdata1:2000M;ibdata2:10M:autoextend
innodb_log_group_home_dir = /var/mysql/
innodb_log_arch_dir = /var/mysql/
# You can set .._buffer_pool_size up to 50 - 80 %
# of RAM but beware of setting memory usage too high
innodb_buffer_pool_size = 384M
innodb_additional_mem_pool_size = 20M
# Set .._log_file_size to 25 % of buffer pool size
innodb_log_file_size = 100M
innodb_log_buffer_size = 8M
innodb_flush_log_at_trx_commit = 1
innodb_lock_wait_timeout = 50

==Copy the Moodle files to the web server==

The documents for the web server are saved in the folder ''/Library/WebServer/Documents/''. You will place your Moodle folder here after you got it from http://download.moodle.org. Download the standard package MOODLE_19_WEEKLY because this is the best choice for new servers. Set the owner ''_www'' for the moodle folder ... this is the user for the web server. The folder permissions should be 755 before the installation and 555 after it's done ... please remember to set this later!

You also need the moodledata folder outside of the Documents folder ... so please make one. Go to the folder ''/Library/WebServer/'' and add the folder ''moodledata''. Because I want to install Moodle 1.9.x and Moodle 2.0 dev together on the same Mac server I add two folders ''moodle19'' and ''moodle20'' inside the moodledata folder. Please set the owner ''_www'' for both folders ''moodle19'' and ''moodle20'' and the folder permissions to 755.

cd /Library/WebServer/
mkdir moodledata
mkdir moodledata/moodle19
mkdir moodledata/moodle20
sudo chown -R _www moodledata
sudo chmod -R 755 moodledata

If you'd like to put the moodledata folder on another volume (not a bad idea if you think you'll have a substantial amount of data within the moodle), note that you cannot simply reference it using the /Volumes/<volume_name>/folder syntax during the moodle setup. Instead, you'll need to create the folder (assigning the user and permissions), then create a '''link''' to it within the /Library/WebServer folder. To create the link, use the following command in a terminal window, substituting your data volume and folder name:

cd /Library/WebServer
ln -s /Volumes/Data_Volume/moodledata moodledata

==Run the Moodle installation==
The installation on the Mac server is the same like the installation on every other server.
Open a web browser to http://your-server-address/moodle/install.php to begin the installation process.
On the screen picture and in the shown config.php you see the web address ''your-server-address'' ... it's only a placeholder for a real address or url ... please set yours. Also a user 'moodle' with a password 'moodle' would be very unsafe settings for your installation.

[[Image:moodle-install1.png]]

[[Image:moodle-install2.png]]

The installer generates the config.php automatically and saves it in the folder ''/Library/WebServer/Documents/moodle19''. Please edit the config.php with a text editor and add the line ''date_default_timezone_set('UTC');''. You may change ''UTC'' to your own timezone ... this is needed for PHP 5.3.0. In case you don't know all the relevant time zone identifiers by heart, there is a [http://phpbuilder.com/manual/en/timezones.php list available online].

<?php /// Moodle Configuration File

unset($CFG);

$CFG->dbtype = 'mysql';
$CFG->dbhost = 'localhost';
$CFG->dbname = 'moodle19';
$CFG->dbuser = 'moodle';
$CFG->dbpass = 'moodle';
$CFG->dbpersist = false;
$CFG->prefix = 'mdl_';

$CFG->wwwroot = 'http://your-server-address/moodle19';
$CFG->dirroot = '/Library/WebServer/Documents/moodle19';
$CFG->dataroot = '/Library/WebServer/moodledata/moodle19';
$CFG->admin = 'admin';

$CFG->directorypermissions = 00777; // try 02777 on a server in Safe Mode

date_default_timezone_set('Europe/Berlin'); // timezone for PHP 5.3.0
require_once("$CFG->dirroot/lib/setup.php");
// MAKE SURE WHEN YOU EDIT THIS FILE THAT THERE ARE NO SPACES, BLANK LINES,
// RETURNS, OR ANYTHING ELSE AFTER THE TWO CHARACTERS ON THE NEXT LINE.
?>

After this, the web-based installation component will walk you through '''several''' screens worth of database configurations and updates, for most of which you'll just click the continue button. You'll set up an admin user and give the site a basic configuration (title, description, etc). When the installation is ready you should change the folder permission for ''/Library/WebServer/Documents/moodle19'' to 555 so the web server is not able to write into this folder again.

==Download the language packages==

==Moodle is running ...==
[[Image:moodle-on-macosx-server.png]]

==How to setup the cron job with launchd==

It's really important to start the cron job every 5 minutes. The cron job assists most of Moodle's modules to perform tasks on a scheduled basis. For example, the discussion forums can only mail out copies of new posts to all subscribers if the cron job tells Moodle to do this.

In Mac OS X you will find the system daemon ''launchd'' for this service. This daemon offers a standardized interface to any user and all programs started automatically by the system. Please look at http://developer.apple.com/macosx/launchd.html for more information about the configurations and all parameters.

In our case the service should get the web page http://your-server-address/moodle19/admin/cron.php every 5 minutes. The configuration will be done by the file named ''moodle4mac.cron.plist'' which must be placed in the system folder ''/Library/LaunchDaemons/'' ... surely you can use any other file name but it should say something about the function of the service. The extension must be ''.plist''. After any reboot of your Mac server the cron service will start automaticly because the file is placed in the correct system folder.

===Use the graphical way===
You can use Lingon to add a new daemon plist or to edit one. It produces the same text as you can write in your text editor. http://sourceforge.net/projects/lingon/files/

[[Image:macosx-lingon.png]]

===Use a text editor===
Please use a text editor to write the needed file. You can open the Terminal and use the system editors vi or pico. But you can also write the text file with any GUI text editor ... I mostly use TextWrangler ... but do NOT take an editor for formatted texts like Microsoft Word or OpenOffice Writer. You must get pure text!

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0//EN"
"http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>KeepAlive</key><false/>
<key>Label</key><string>moodle4mac.cron</string>
<key>ProgramArguments</key>
<array>
<string>curl</string>
<string>-s</string>
<string>http://your-server-address/moodle19/admin/cron.php</string>
</array>
<key>RunAtLoad</key><true />
<key>StartInterval</key><integer>300</integer>
<key>StandardErrorPath</key><string>/dev/null</string>
<key>StandardOutPath</key><string>/dev/null</string>
</dict>
</plist>

The label string must be the same as the file name is but without the extension ''.plist''. Save the text file ''/Library/LaunchDaemons/moodle4mac.cron.plist''. The owner of the file must be set to the system user ''root''. That's all, really!

===How to start and stop the cron service===
You can start the new cron service in the Terminal.

sudo launchctl load /Library/LaunchDaemons/moodle4mac.cron.plist

The following command would stop the service. If you want to activate changes in the cron service you need to ''unload'' and then to ''load'' the daemon again.

sudo launchctl unload /Library/LaunchDaemons/moodle4mac.cron.plist

===Only one service for two servers?===
For my server I needed to have a cron service for to instances ''moodle19'' and ''moodle20'' ... no problem ... with the typo ''moodle[19-20]'' the server will get a cron service for both instances.

<nowiki>curl -s http://your-server-address/moodle[19-20]/admin/cron.php</nowiki>

To see if the cron service works correctly you should look at the ''access.log'' of your web server. The cron.php should be accessed every 5 minutes ... on my server for both Moodle instances ''moodle19'' and ''moodle20'' ... oh yes, it works!!

192.168.0.220 - - [30/Jul/2009:22:10:56 +0200] "GET /moodle19/admin/cron.php HTTP/1.1" 200 1136
192.168.0.220 - - [30/Jul/2009:22:10:57 +0200] "GET /moodle20/admin/cron.php HTTP/1.1" 200 1403
192.168.0.220 - - [30/Jul/2009:22:11:18 +0200] "OPTIONS * HTTP/1.0" 200 -
192.168.0.220 - - [30/Jul/2009:22:15:56 +0200] "GET /moodle19/admin/cron.php HTTP/1.1" 200 735
192.168.0.220 - - [30/Jul/2009:22:15:57 +0200] "GET /moodle20/admin/cron.php HTTP/1.1" 200 964
192.168.0.220 - - [30/Jul/2009:22:20:56 +0200] "GET /moodle19/admin/cron.php HTTP/1.1" 200 1136
192.168.0.220 - - [30/Jul/2009:22:20:57 +0200] "GET /moodle20/admin/cron.php HTTP/1.1" 200 1365

==How to install and update Moodle via CVS==

CVS is very simple way to install and update your Moodle.

The only software you must have installed on your Mac server is the Xcode Tools package from your system installation media. You also must have an internet connection to get the files from the update server. After you installed both script files on your server desktop it only needs a doubleclick to get the newest Moodle version without downloading the complete installation package. Please remember - before you can update your Moodle via CVS you must install Moodle via CVS at once.

That's all .... really .... it's easy!!

===Use the CVS installation script===
If your Moodle is already installed via CVS please use the CVS updater (see below). Running the CVS installer will install only the standard version of Moodle on your server.

If you already have a working Moodle on your server then this script copies the file config.php into your new installation but it does not copy your additional modules or plugins or themes. You will find your old moodle folder in same directory and it will be renamed with an additional date stamp.

<pre>
#! /bin/sh
#
# CVS installer for Moodle
# on a Mac OS X Server
#
# 20100818 - Ralf Krause
#

export CVS_RSH=ssh

### file ~/.cvspass must exist
if ! test -e ~/.cvspass ; then
touch ~/.cvspass
fi

echo
echo "+--------------------------------------------+"
echo "| CVS installer for the Moodle server "
echo "+--------------------------------------------+"
echo

cd /Library/WebServer/Documents

### get the cvs installation into a tmp folder
if ! test -e tmp ; then
sudo mkdir tmp
sudo chmod 777 tmp
fi

echo "Connecting to the CVS server. Download will take a few moments!"
echo "If the CVS update runs too long you may break with <ctrl>-C"
echo

### do the cvs installation
cd tmp
cvs -z9 -d:pserver:anonymous@uk.cvs.moodle.org:/cvsroot/moodle co -P -r MOODLE_19_WEEKLY moodle
cd ..

### copy config.php from your current moodle folder if it exists
if ! test -e moodle/config.php ; then
cp moodle19/config.php tmp/moodle/config.php
fi

### move the new moodle to the right place
DATE=`date +%Y%m%d-%H%M`
sudo mv moodle19 moodle19-$DATE
sudo mv tmp/moodle moodle19
sudo chown -R _www moodle19
</pre>

===Use the CVS update script===
To be able to update Moodle via CVS please check that your Moodle was already installed via CVS (see above).

<pre>
#! /bin/sh
#
# CVS updater for Moodle
# on a Mac OS X Server
#
# 20100818 - Ralf Krause
#

export CVS_RSH=ssh

echo
echo "+--------------------------------------------+"
echo "| CVS updater for the Moodle server "
echo "+--------------------------------------------+"
echo

cd /Library/WebServer/Documents/moodle19/

### file ~/.cvspass must exist
if ! test -e ~/.cvspass ; then
touch ~/.cvspass
fi

### login to the cvs server only for the first time
if ! grep "uk.cvs.moodle.org" ~/.cvspass > /dev/null ; then
echo "CVS password is empty ... please only press <return> to start"
sudo cvs -d :pserver:anonymous@uk.cvs.moodle.org:/cvsroot/moodle login
echo
fi

echo "Connecting to the CVS server. Download will take a few moments!"
echo "If the CVS update runs too long you may break with <ctrl>-C"
echo

### do the cvs installation
sudo cvs -q update -dP -r MOODLE_19_WEEKLY
sudo chown -R _www .
</pre>

Please look at the documentation [https://docs.moodle.org/en/CVS_for_Administrators CVS for Administrators] if you want to learn more about Moodle and CVS. There you will also find a list of different [https://docs.moodle.org/en/CVS_for_Administrators#CVS_Servers CVS servers for Moodle] which you may choose for your updates.

The shown update script should be modified in only three things ... first you need to choose the correct folder for the Moodle files, second choose a CVS server near your server place to minimate internet traffic, and third you must input the correct CVS tag for the Moodle version in the last line. The shown script is for updating the version Moodle 1.9
* Moodle 1.8 uses MOODLE_18_WEEKLY
* Moodle 1.9 uses MOODLE_19_WEEKLY
* Moodle 2.0 RC1 still uses HEAD

===Troubleshooting===

If CVS does not work on your server please check that the connection port is open. 
If you see something like this, make sure that there is no firewall blocking the port (it's port 2401):

$ cvs -d:pserver:anonymous@us.cvs.moodle.org:/cvsroot/moodle login
Logging in to :pserver:anonymous@us.cvs.moodle.org:2401/cvsroot/moodle
CVS password:
cvs [login aborted]: connect to us.cvs.moodle.org(130.212.64.111):2401 failed: Connection timed out

===Install Xcode Tools and CVS on your Mac Server===

To test if cvs is already on your Mac Server please open the Terminal and type ''cvs -v''. The output of this command should show a version notice of your Concurrent Versions System (CVS). If you get the ''command not found'' message then you must search for your Mac OS X 10.5 Server installation media. You will find the Xcode Tools on your installation CD or DVD set.

If you can't find your installation media anymore you also can download the Xcode Tools from the URL http://developer.apple.com/tools/xcode/. It is free but you have to register as a developer. Starting the download then the Xcode package copies a lot of bytes on your harddisk and will need a very few minutes to complete.

After you installed the Xcode Tools in your server system you will get the correct version answer from the Terminal command ''cvs -v''. If you only want to update your Moodle you do not need all these nice developer tools from the inside of the folder. Sorry about this but there is no separate installer for the CVS update process.
  

==User administration via LDAP==

The following settings will work on 10.5 Server running LDAP - edit them to customize to your own environment. Please note that moodle requires some fields - it is best to have these fields completed in Workgroup Manager on 10.5 Server - otherwise they'll be prompted to enter info into their moodle profile on first login, but the way we've got it set up, moodle can't modify LDAP for security and data integrity. The necessary fields are user name, first name, surname, Email address, City/Town, country, description, ID number.
<pre>
LDAP SERVER SETTINGS
Host URL = ourserver.example.com
Version = 3
LDAP encoding = utf-8

BIND SETTINGS
Hide passwords = Yes
Distinguished Name = (blank)
Password = (blank)

USER LOOKUP SETTINGS
User type = posixAccount (rfc2307)
Contexts = cn=users,dc=ourserver,dc=example,dc=com
Search subcontexts = Yes
Dereference aliases = No
User attribute = (blank)
Member attribute = (blank)
Member attribute uses dn = (blank)
Object class = (blank)

FORCE CHANGE PASSWORD
Force change password = No
Use standard Change Password Page = No
Password format = Plain text
Password change URL = (blank)

LDAP PASSWORD EXPIRATION SETTINGS
Expiration = no
Expiration warning = 10
Expiration attribute = ""
Grace logins = No
Grace login attribute = (blank)

ENABLE USER CREATION
Create users externally = No
Context for new users = (blank)

COURSE CREATOR
Creators = (blank)

CRON SYNCHRONIZATION SCRIPT
Removed ext user = Keep internal

NTLM SSO
Enable = No
Subnet = (blank)
First name = givenName (On every login, Never, Locked)
Surname = sn (On every login, Never, Locked)
Email address = mail (On every login, Never, Locked)
Phone 1 = (blank)
Phone 2 = (blank)
Department = (blank)
Address = (blank)
City/Town = l (On every login, Never, Locked)
Country = c (On every login, Never, Locked)
Description = description (On every login, Never, Locked)
ID number = uidNumber (On every login, Never, Locked)
Language = (blank)
</pre>

==See also==
* [[Complete Install Packages for Mac OS X | Complete install packages for Mac OS X Clients 10.4/10.5/10.6]]
* [[Step-by-step Guide for Installing Moodle on Mac OS X 10.4 Client|Step by step installation on a Mac OS X Client 10.4]]
* [[Cron | Installation of cron for Moodle]]
* [[CVS for Administrators]]

* [http://moodle.org/mod/forum/discuss.php?d=24632 Using Moodle: Dynamic DNS Home Server]

[[Category:Administrator]]
[[Category:Installation]]
[[Category:Mac OS X]]

Step by Step Installation on a Mac OS X Server

2010-10-21T14:40:00Z

Krause: /* Troubleshooting */

==Overview==
This guide shows all steps for the installation of Moodle on a [http://www.apple.com/server/macosx Mac OS X Server]. This server is a commercial product. You will find [http://www.apple.com/server/macosx/resources/documentation.html all documentations] about the web server on the Apple support pages.

This installation guide can't be useful for an installation on MAMP or XAMPP. If you are looking for an easy way to install Moodle on your local machine please use [[Complete Install Packages for Mac OS X | Complete install packages for Mac OS X 10.4/10.5/10.6 Clients]] that can be downloaded from http://download.moodle.org/macosx/ ... but if you are planning to set up a Moodle internet server on a Mac then you should think about some more security as the ever local package could give.

Please feel free to add your ideas and wishes to the discussion page for this article. You may also write a complete chapter if you tried the facts yourself on your own Mac Server. I am most interested to make the things better.

==System requirements==

+ Apple Computer
+ Mac mini, Mac Pro or Xserve
+ Processor: Intel Core 2 Duo, Intel Core i3/i5/i7
+ RAM: 2 GB or better
+ Hard Disk: 500 MB free
+ System Software: Mac OS X Server 10.5 or 10.6

==Configure PHP for your Moodle installation==
===Mac OS X 10.6 Server - No PHP installation needed===

The Mac OS X 10.6.4 Server (SnowLeopard) comes with PHP 5.3.2 and a lot of PHP extensions. This would be the best choice for Moodle 1.9.x and for Moodle 2.0 on a Mac OS X Server. Please forget everything you read about the missing GD Library! The PHP installation is totally complete for Moodle. You only have to switch on the PHP module and to control if the file ''/etc/php.ini'' sets the right values for Moodle.

[[Image:Server-admin-106.png]]

===Mac OS X 10.5 Server - Install PHP 5.3.0 and the GD Library===

The Mac OS X 10.5.8 Server (Leopard) comes with PHP 5.2.6 ... this is correct for Moodle 1.9.x. But you have to add the missing GD Library support to get Moodle running on your server. For Moodle 2.0 the server must have PHP 5.2.8 (or better) and some more PHP extensions ... in this case you need to get the better PHP version. These instructions are helpful in both cases.

To see which PHP version and extensions are installed on your server you should edit the file ''/Library/WebServer/Documents/info.php''. You must activate the function call phpinfo() by deleting the both slashes // at the start of the function line. After saving the file you can get all PHP informations in your browser. Please look at http://your-server-address/info.php ... you will not find any GD library support ... bad thing for Moodle!!

<?php
// You can use Server Admin to enable the Apache PHP module; it's disabled by default.
// You can uncomment the phpinfo() directive below to provide a default PHP info page
// but note that this displays information about your host's configuration.
phpinfo();
?>

The easiest way to get the GD library support and to get a better PHP version would be the installation of the complete PHP 5.3.0 package from http://www.entropy.ch/software/macosx/php/. Marc Liyanage precompiled this package to use it on Mac clients and Mac servers. Please get the package and install it by following the instructions on the download page. The installer does everything for you ... it copies PHP into the correct folder ''/usr/local/php5'' and changes its owner to ''root'' automatically. You will find the file php.ini inside the new package folder. Open the file ''/usr/local/php5/lib/php.ini'' and edit some settings for Moodle.

Note: If you want to install Moodle 1.8.x on the server you need to get the Entropy PHP-5.2.9-7.pkg instead. Moodle 1.8.x does not run with PHP 5.3.0. (MDL-20128)

Now the Apache web server must get knowledge that you want to use the new PHP library instead of the old. Open the application Server Admin to switch to the new library. Go to the web server settings and find the entry php5_module. The normal place for PHP the Mac server is ''libexec/apache2/libphp5.so''. Please change to ''/usr/local/php5/libphp5.so'' and save the settings.

[[Image:Server-admin.png]]

===PHP settings in your php.ini===
The next thing is to configure the file ''php.ini''. Most of the settings are okay but not all of them. To communicate to the MySQL database with PHP you have to set the default socket name for local MySQL connects. The default socket name for local MySQLi connects is needed for Moodle 2.0.

If you want to upload any file to your Moodle you should add a little bit more upload size in php.ini. If your server can't use more than 1 GB RAM you should set the memory_limit to a value less than 128M ... but it should have more than 48M for Moodle 1.9 and Moodle 2.0. Note that these sections are not likely to be consecutive in the php.ini file; the quickest way to find each one is search on the initial term (such as 'mysql.default_socket').

; Default socket name for local MySQL connects.
; If empty, uses the built-in MySQL defaults.
mysql.default_socket = /var/mysql/mysql.sock

; Default socket name for local MySQL connects.
; If empty, uses the built-in MySQL defaults.
mysqli.default_socket = /var/mysql/mysql.sock

; Maximum amount of memory a script may consume (128MB)
memory_limit = 128M

; Maximum allowed size for uploaded files.
upload_max_filesize = 128M

; Maximum size of POST data that PHP will accept.
post_max_size = 128M

; Defines the default timezone used by the date functions
; http://php.net/date.timezone
date.timezone = 'Europe/Berlin';

That's all ... save the file ''php.ini'' and restart the web server. Now you should look at http://your-server-address/info.php again. I hope that everything will be okay. You will find the version number PHP 5.3.x and the running GD library support. Congratulations ... the first step for Moodle on your Mac server is done!

[[Image:phpinfo.png]]

[[Image:phpinfo2.png]]

==Configure the MySQL database for your Moodle installation==

In standard case the database MySQL is installed on the Mac OS X Server but it is not running yet. Please make sure that you start the MySQL database server.

===Use the graphical way===
Sorry ... there are some more installations and a lot of clicks to configure MySQL in a graphical way.

First of all start the ''Server Admin''. You will find this program by the way ''Applications > Server > Server Admin''. Activate MySQL on the local server. You must set the password for the user ''root'' before you can start MySQL.

For the next you must download the MySQL database administration tool '''phpMyAdmin''' from http://www.phpmyadmin.net . Move the folder to the web server documents as ''/Library/WebServer/Documents/phpMyAdmin''.

Add the security phrase to the file ''config.inc.php'' in between the single quotes on the line $cfg['blowfish_secret'] = ''; /* YOU MUST FILL IN THIS FOR COOKIE AUTH! */

Now you will be able to start http://your-server-address/phpMyAdmin/ in your browser and to log into the database as the user ''root''. Add a database ''moodle19''. Add a database user ''moodle'' to the server ''localhost''. Don't forget to set a secure password. The database user ''moodle'' should be allowed to administrate the database ''moodle19'' only. It is a bad way to set ''root'' to administrate the database ''moodle19''. If you want to install also Moodle 2.0 dev please add a second database ''moodle20'' and use the same database user for it.

phpMyAdmin is a nice thing to look into the database while Moodle is running for some time. It's much easier to see in the graphical interface than in the command line tools. The image shows the database after Moodle 1.9 and Moodle 2.0 were already installed on this server.

[[Image:phpmyadmin.png]]

===Use the Terminal===

If you want a quick installation then don't fear to use the Terminal. It's easier to tell you all the commands for the right way with the Terminal than showing you all the pictures to do the same with graphical tools. There are only a few commands to do everything I told you before.

Start the Terminal. You will find this program by the way ''Applications > Tools > Terminal''. You will see that we must do the same steps as before but you can read them in a text form.

First of all you need to set the root password. If you didn't this before then use the first command line. If you want to change an existing password then use the second one.

Server:~ $ mysqladmin -u root password 'secret'
Server:~ $ mysqladmin -u root -p password 'topsecret'

The next steps are creating a new database ''moodle19'' with correct character set and setting up a database user ''moodle'', with an assigned password (IDENTIFIED BY), to administrate the new database ... and if you want, then do the same for ''moodle20''.

Server:~ $ mysqladmin -u root -p create moodle19
Server:~ $ mysql -u root -p

mysql> ALTER DATABASE moodle19 CHARSET 'utf8';
mysql> GRANT ALL PRIVILEGES ON moodle19.* TO moodle@localhost
-> IDENTIFIED BY 'moodle!';
mysql> quit

Server:~ $

That's really all with the Terminal. You are just ready!

===Use InnoDB with Moodle 2.0===

For Moodle 2.0 you should setup the support for InnoDB in your MySQL database.

Open the file /etc/my.cnf an delete every # in all lines beginning with innodb. This uncomments the InnoDB settings. Please save the file and restart your MySQL database.

# Uncomment the following if you are using InnoDB tables
innodb_data_home_dir = /var/mysql/
innodb_data_file_path = ibdata1:2000M;ibdata2:10M:autoextend
innodb_log_group_home_dir = /var/mysql/
innodb_log_arch_dir = /var/mysql/
# You can set .._buffer_pool_size up to 50 - 80 %
# of RAM but beware of setting memory usage too high
innodb_buffer_pool_size = 384M
innodb_additional_mem_pool_size = 20M
# Set .._log_file_size to 25 % of buffer pool size
innodb_log_file_size = 100M
innodb_log_buffer_size = 8M
innodb_flush_log_at_trx_commit = 1
innodb_lock_wait_timeout = 50

==Copy the Moodle files to the web server==

The documents for the web server are saved in the folder ''/Library/WebServer/Documents/''. You will place your Moodle folder here after you got it from http://download.moodle.org. Download the standard package MOODLE_19_WEEKLY because this is the best choice for new servers. Set the owner ''_www'' for the moodle folder ... this is the user for the web server. The folder permissions should be 755 before the installation and 555 after it's done ... please remember to set this later!

You also need the moodledata folder outside of the Documents folder ... so please make one. Go to the folder ''/Library/WebServer/'' and add the folder ''moodledata''. Because I want to install Moodle 1.9.x and Moodle 2.0 dev together on the same Mac server I add two folders ''moodle19'' and ''moodle20'' inside the moodledata folder. Please set the owner ''_www'' for both folders ''moodle19'' and ''moodle20'' and the folder permissions to 755.

cd /Library/WebServer/
mkdir moodledata
mkdir moodledata/moodle19
mkdir moodledata/moodle20
sudo chown -R _www moodledata
sudo chmod -R 755 moodledata

If you'd like to put the moodledata folder on another volume (not a bad idea if you think you'll have a substantial amount of data within the moodle), note that you cannot simply reference it using the /Volumes/<volume_name>/folder syntax during the moodle setup. Instead, you'll need to create the folder (assigning the user and permissions), then create a '''link''' to it within the /Library/WebServer folder. To create the link, use the following command in a terminal window, substituting your data volume and folder name:

cd /Library/WebServer
ln -s /Volumes/Data_Volume/moodledata moodledata

==Run the Moodle installation==
The installation on the Mac server is the same like the installation on every other server.
Open a web browser to http://your-server-address/moodle/install.php to begin the installation process.
On the screen picture and in the shown config.php you see the web address ''your-server-address'' ... it's only a placeholder for a real address or url ... please set yours. Also a user 'moodle' with a password 'moodle' would be very unsafe settings for your installation.

[[Image:moodle-install1.png]]

[[Image:moodle-install2.png]]

The installer generates the config.php automatically and saves it in the folder ''/Library/WebServer/Documents/moodle19''. Please edit the config.php with a text editor and add the line ''date_default_timezone_set('UTC');''. You may change ''UTC'' to your own timezone ... this is needed for PHP 5.3.0. In case you don't know all the relevant time zone identifiers by heart, there is a [http://phpbuilder.com/manual/en/timezones.php list available online].

<?php /// Moodle Configuration File

unset($CFG);

$CFG->dbtype = 'mysql';
$CFG->dbhost = 'localhost';
$CFG->dbname = 'moodle19';
$CFG->dbuser = 'moodle';
$CFG->dbpass = 'moodle';
$CFG->dbpersist = false;
$CFG->prefix = 'mdl_';

$CFG->wwwroot = 'http://your-server-address/moodle19';
$CFG->dirroot = '/Library/WebServer/Documents/moodle19';
$CFG->dataroot = '/Library/WebServer/moodledata/moodle19';
$CFG->admin = 'admin';

$CFG->directorypermissions = 00777; // try 02777 on a server in Safe Mode

date_default_timezone_set('Europe/Berlin'); // timezone for PHP 5.3.0
require_once("$CFG->dirroot/lib/setup.php");
// MAKE SURE WHEN YOU EDIT THIS FILE THAT THERE ARE NO SPACES, BLANK LINES,
// RETURNS, OR ANYTHING ELSE AFTER THE TWO CHARACTERS ON THE NEXT LINE.
?>

After this, the web-based installation component will walk you through '''several''' screens worth of database configurations and updates, for most of which you'll just click the continue button. You'll set up an admin user and give the site a basic configuration (title, description, etc). When the installation is ready you should change the folder permission for ''/Library/WebServer/Documents/moodle19'' to 555 so the web server is not able to write into this folder again.

==Download the language packages==

==Moodle is running ...==
[[Image:moodle-on-macosx-server.png]]

==How to setup the cron job with launchd==

It's really important to start the cron job every 5 minutes. The cron job assists most of Moodle's modules to perform tasks on a scheduled basis. For example, the discussion forums can only mail out copies of new posts to all subscribers if the cron job tells Moodle to do this.

In Mac OS X you will find the system daemon ''launchd'' for this service. This daemon offers a standardized interface to any user and all programs started automatically by the system. Please look at http://developer.apple.com/macosx/launchd.html for more information about the configurations and all parameters.

In our case the service should get the web page http://your-server-address/moodle19/admin/cron.php every 5 minutes. The configuration will be done by the file named ''moodle4mac.cron.plist'' which must be placed in the system folder ''/Library/LaunchDaemons/'' ... surely you can use any other file name but it should say something about the function of the service. The extension must be ''.plist''. After any reboot of your Mac server the cron service will start automaticly because the file is placed in the correct system folder.

===Use the graphical way===
You can use Lingon to add a new daemon plist or to edit one. It produces the same text as you can write in your text editor. http://sourceforge.net/projects/lingon/files/

[[Image:macosx-lingon.png]]

===Use a text editor===
Please use a text editor to write the needed file. You can open the Terminal and use the system editors vi or pico. But you can also write the text file with any GUI text editor ... I mostly use TextWrangler ... but do NOT take an editor for formatted texts like Microsoft Word or OpenOffice Writer. You must get pure text!

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0//EN"
"http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>KeepAlive</key><false/>
<key>Label</key><string>moodle4mac.cron</string>
<key>ProgramArguments</key>
<array>
<string>curl</string>
<string>-s</string>
<string>http://your-server-address/moodle19/admin/cron.php</string>
</array>
<key>RunAtLoad</key><true />
<key>StartInterval</key><integer>300</integer>
<key>StandardErrorPath</key><string>/dev/null</string>
<key>StandardOutPath</key><string>/dev/null</string>
</dict>
</plist>

The label string must be the same as the file name is but without the extension ''.plist''. Save the text file ''/Library/LaunchDaemons/moodle4mac.cron.plist''. The owner of the file must be set to the system user ''root''. That's all, really!

===How to start and stop the cron service===
You can start the new cron service in the Terminal.

sudo launchctl load /Library/LaunchDaemons/moodle4mac.cron.plist

The following command would stop the service. If you want to activate changes in the cron service you need to ''unload'' and then to ''load'' the daemon again.

sudo launchctl unload /Library/LaunchDaemons/moodle4mac.cron.plist

===Only one service for two servers?===
For my server I needed to have a cron service for to instances ''moodle19'' and ''moodle20'' ... no problem ... with the typo ''moodle[19-20]'' the server will get a cron service for both instances.

<nowiki>curl -s http://your-server-address/moodle[19-20]/admin/cron.php</nowiki>

To see if the cron service works correctly you should look at the ''access.log'' of your web server. The cron.php should be accessed every 5 minutes ... on my server for both Moodle instances ''moodle19'' and ''moodle20'' ... oh yes, it works!!

192.168.0.220 - - [30/Jul/2009:22:10:56 +0200] "GET /moodle19/admin/cron.php HTTP/1.1" 200 1136
192.168.0.220 - - [30/Jul/2009:22:10:57 +0200] "GET /moodle20/admin/cron.php HTTP/1.1" 200 1403
192.168.0.220 - - [30/Jul/2009:22:11:18 +0200] "OPTIONS * HTTP/1.0" 200 -
192.168.0.220 - - [30/Jul/2009:22:15:56 +0200] "GET /moodle19/admin/cron.php HTTP/1.1" 200 735
192.168.0.220 - - [30/Jul/2009:22:15:57 +0200] "GET /moodle20/admin/cron.php HTTP/1.1" 200 964
192.168.0.220 - - [30/Jul/2009:22:20:56 +0200] "GET /moodle19/admin/cron.php HTTP/1.1" 200 1136
192.168.0.220 - - [30/Jul/2009:22:20:57 +0200] "GET /moodle20/admin/cron.php HTTP/1.1" 200 1365

==How to install and update Moodle via CVS==

CVS is very simple way to install and update your Moodle.

The only software you must have installed on your Mac server is the Xcode Tools package from your system installation media. You also must have an internet connection to get the files from the update server. After you installed both script files on your server desktop it only needs a doubleclick to get the newest Moodle version without downloading the complete installation package. Please remember - before you can update your Moodle via CVS you must install Moodle via CVS at once.

That's all .... really .... it's easy!!

===Use the CVS installation script===
If your Moodle is already installed via CVS please use the CVS updater (see below). Running the CVS installer will install only the standard version of Moodle on your server.

If you already have a working Moodle on your server then this script copies the file config.php into your new installation but it does not copy your additional modules or plugins or themes. You will find your old moodle folder in same directory and it will be renamed with an additional date stamp.

<pre>
#! /bin/sh
#
# CVS installer for Moodle
# on a Mac OS X Server
#
# 20100818 - Ralf Krause
#

export CVS_RSH=ssh

### file ~/.cvspass must exist
if ! test -e ~/.cvspass ; then
touch ~/.cvspass
fi

echo
echo "+--------------------------------------------+"
echo "| CVS installer for the Moodle server "
echo "+--------------------------------------------+"
echo

cd /Library/WebServer/Documents

### get the cvs installation into a tmp folder
if ! test -e tmp ; then
sudo mkdir tmp
sudo chmod 777 tmp
fi

echo "Connecting to the CVS server. Download will take a few moments!"
echo "If the CVS update runs too long you may break with <ctrl>-C"
echo

### do the cvs installation
cd tmp
cvs -z9 -d:pserver:anonymous@uk.cvs.moodle.org:/cvsroot/moodle co -P -r MOODLE_19_WEEKLY moodle
cd ..

### copy config.php from your current moodle folder if it exists
if ! test -e moodle/config.php ; then
cp moodle19/config.php tmp/moodle/config.php
fi

### move the new moodle to the right place
DATE=`date +%Y%m%d-%H%M`
sudo mv moodle19 moodle19-$DATE
sudo mv tmp/moodle moodle19
sudo chown -R _www moodle19
</pre>

===Use the CVS update script===
To be able to update Moodle via CVS please check that your Moodle was already installed via CVS (see above).

<pre>
#! /bin/sh
#
# CVS updater for Moodle
# on a Mac OS X Server
#
# 20100818 - Ralf Krause
#

export CVS_RSH=ssh

echo
echo "+--------------------------------------------+"
echo "| CVS updater for the Moodle server "
echo "+--------------------------------------------+"
echo

cd /Library/WebServer/Documents/moodle19/

### file ~/.cvspass must exist
if ! test -e ~/.cvspass ; then
touch ~/.cvspass
fi

### login to the cvs server only for the first time
if ! grep "uk.cvs.moodle.org" ~/.cvspass > /dev/null ; then
echo "CVS password is empty ... please only press <return> to start"
sudo cvs -d :pserver:anonymous@uk.cvs.moodle.org:/cvsroot/moodle login
echo
fi

echo "Connecting to the CVS server. Download will take a few moments!"
echo "If the CVS update runs too long you may break with <ctrl>-C"
echo

### do the cvs installation
sudo cvs -q update -dP -r MOODLE_19_WEEKLY
sudo chown -R _www .
</pre>

Please look at the documentation [https://docs.moodle.org/en/CVS_for_Administrators CVS for Administrators] if you want to learn more about Moodle and CVS. There you will also find a list of different [https://docs.moodle.org/en/CVS_for_Administrators#CVS_Servers CVS servers for Moodle] which you may choose for your updates.

The shown update script should be modified in only three things ... first you need to choose the correct folder for the Moodle files, second choose a CVS server near your server place to minimate internet traffic, and third you must input the correct CVS tag for the Moodle version in the last line. The shown script is for updating the version Moodle 1.9
* Moodle 1.8 uses MOODLE_18_WEEKLY
* Moodle 1.9 uses MOODLE_19_WEEKLY
* Moodle 2.0 RC1 still uses HEAD

===Troubleshooting===

If CVS does not work on your server please check that the connection port is open. 
If you see something like this, make sure that there is no firewall blocking the port (it's port 2401):

$ cvs -d:pserver:anonymous@us.cvs.moodle.org:/cvsroot/moodle login
Logging in to :pserver:anonymous@us.cvs.moodle.org:2401/cvsroot/moodle
CVS password:
cvs [login aborted]: connect to us.cvs.moodle.org(130.212.64.111):2401 failed: Connection timed out

===Install Xcode Tools and CVS on your Mac Server===

To test if cvs is already on your Mac Server please open the Terminal and type ''cvs -v''. The output of this command should show a version notice of your Concurrent Versions System (CVS). If you get the ''command not found'' message then you must search for your Mac OS X 10.5 Server installation media. You will find the Xcode Tools on your installation CD or DVD set.

If you can't find your installation media anymore you also can download the Xcode Tools from the URL http://developer.apple.com/tools/xcode/. It is free but you have to register as a developer. Starting the download then the Xcode package copies a lot of bytes on your harddisk and will need a very few minutes to complete.

After you installed the Xcode Tools in your server system you will get the correct version answer from the Terminal command ''cvs -v''. If you only want to update your Moodle you do not need all these nice developer tools from the inside of the folder. Sorry about this but there is no separate installer for the CVS update process.
  

==User administration via LDAP==

The following settings will work on 10.5 Server running LDAP - edit them to customize to your own environment. Please note that moodle requires some fields - it is best to have these fields completed in Workgroup Manager on 10.5 Server - otherwise they'll be prompted to enter info into their moodle profile on first login, but the way we've got it set up, moodle can't modify LDAP for security and data integrity. The necessary fields are user name, first name, surname, Email address, City/Town, country, description, ID number.
<pre>
LDAP SERVER SETTINGS
Host URL = ourserver.example.com
Version = 3
LDAP encoding = utf-8

BIND SETTINGS
Hide passwords = Yes
Distinguished Name = (blank)
Password = (blank)

USER LOOKUP SETTINGS
User type = posixAccount (rfc2307)
Contexts = cn=users,dc=ourserver,dc=example,dc=com
Search subcontexts = Yes
Dereference aliases = No
User attribute = (blank)
Member attribute = (blank)
Member attribute uses dn = (blank)
Object class = (blank)

FORCE CHANGE PASSWORD
Force change password = No
Use standard Change Password Page = No
Password format = Plain text
Password change URL = (blank)

LDAP PASSWORD EXPIRATION SETTINGS
Expiration = no
Expiration warning = 10
Expiration attribute = ""
Grace logins = No
Grace login attribute = (blank)

ENABLE USER CREATION
Create users externally = No
Context for new users = (blank)

COURSE CREATOR
Creators = (blank)

CRON SYNCHRONIZATION SCRIPT
Removed ext user = Keep internal

NTLM SSO
Enable = No
Subnet = (blank)
First name = givenName (On every login, Never, Locked)
Surname = sn (On every login, Never, Locked)
Email address = mail (On every login, Never, Locked)
Phone 1 = (blank)
Phone 2 = (blank)
Department = (blank)
Address = (blank)
City/Town = l (On every login, Never, Locked)
Country = c (On every login, Never, Locked)
Description = description (On every login, Never, Locked)
ID number = uidNumber (On every login, Never, Locked)
Language = (blank)
</pre>

==See also==
* [[Complete Install Packages for Mac OS X | Complete install packages for Mac OS X Clients 10.4/10.5/10.6]]
* [[Step-by-step Guide for Installing Moodle on Mac OS X 10.4 Client|Step by step installation on a Mac OS X Client 10.4]]
* [[Cron | Installation of cron for Moodle]]
* [[CVS for Administrators]]

* [http://moodle.org/mod/forum/discuss.php?d=24632 Using Moodle: Dynamic DNS Home Server]

[[Category:Administrator]]
[[Category:Installation]]
[[Category:Mac OS X]]

Step by Step Installation on a Mac OS X Server

2010-10-21T14:39:32Z

Krause: /* Troubleshooting */

==Overview==
This guide shows all steps for the installation of Moodle on a [http://www.apple.com/server/macosx Mac OS X Server]. This server is a commercial product. You will find [http://www.apple.com/server/macosx/resources/documentation.html all documentations] about the web server on the Apple support pages.

This installation guide can't be useful for an installation on MAMP or XAMPP. If you are looking for an easy way to install Moodle on your local machine please use [[Complete Install Packages for Mac OS X | Complete install packages for Mac OS X 10.4/10.5/10.6 Clients]] that can be downloaded from http://download.moodle.org/macosx/ ... but if you are planning to set up a Moodle internet server on a Mac then you should think about some more security as the ever local package could give.

Please feel free to add your ideas and wishes to the discussion page for this article. You may also write a complete chapter if you tried the facts yourself on your own Mac Server. I am most interested to make the things better.

==System requirements==

+ Apple Computer
+ Mac mini, Mac Pro or Xserve
+ Processor: Intel Core 2 Duo, Intel Core i3/i5/i7
+ RAM: 2 GB or better
+ Hard Disk: 500 MB free
+ System Software: Mac OS X Server 10.5 or 10.6

==Configure PHP for your Moodle installation==
===Mac OS X 10.6 Server - No PHP installation needed===

The Mac OS X 10.6.4 Server (SnowLeopard) comes with PHP 5.3.2 and a lot of PHP extensions. This would be the best choice for Moodle 1.9.x and for Moodle 2.0 on a Mac OS X Server. Please forget everything you read about the missing GD Library! The PHP installation is totally complete for Moodle. You only have to switch on the PHP module and to control if the file ''/etc/php.ini'' sets the right values for Moodle.

[[Image:Server-admin-106.png]]

===Mac OS X 10.5 Server - Install PHP 5.3.0 and the GD Library===

The Mac OS X 10.5.8 Server (Leopard) comes with PHP 5.2.6 ... this is correct for Moodle 1.9.x. But you have to add the missing GD Library support to get Moodle running on your server. For Moodle 2.0 the server must have PHP 5.2.8 (or better) and some more PHP extensions ... in this case you need to get the better PHP version. These instructions are helpful in both cases.

To see which PHP version and extensions are installed on your server you should edit the file ''/Library/WebServer/Documents/info.php''. You must activate the function call phpinfo() by deleting the both slashes // at the start of the function line. After saving the file you can get all PHP informations in your browser. Please look at http://your-server-address/info.php ... you will not find any GD library support ... bad thing for Moodle!!

<?php
// You can use Server Admin to enable the Apache PHP module; it's disabled by default.
// You can uncomment the phpinfo() directive below to provide a default PHP info page
// but note that this displays information about your host's configuration.
phpinfo();
?>

The easiest way to get the GD library support and to get a better PHP version would be the installation of the complete PHP 5.3.0 package from http://www.entropy.ch/software/macosx/php/. Marc Liyanage precompiled this package to use it on Mac clients and Mac servers. Please get the package and install it by following the instructions on the download page. The installer does everything for you ... it copies PHP into the correct folder ''/usr/local/php5'' and changes its owner to ''root'' automatically. You will find the file php.ini inside the new package folder. Open the file ''/usr/local/php5/lib/php.ini'' and edit some settings for Moodle.

Note: If you want to install Moodle 1.8.x on the server you need to get the Entropy PHP-5.2.9-7.pkg instead. Moodle 1.8.x does not run with PHP 5.3.0. (MDL-20128)

Now the Apache web server must get knowledge that you want to use the new PHP library instead of the old. Open the application Server Admin to switch to the new library. Go to the web server settings and find the entry php5_module. The normal place for PHP the Mac server is ''libexec/apache2/libphp5.so''. Please change to ''/usr/local/php5/libphp5.so'' and save the settings.

[[Image:Server-admin.png]]

===PHP settings in your php.ini===
The next thing is to configure the file ''php.ini''. Most of the settings are okay but not all of them. To communicate to the MySQL database with PHP you have to set the default socket name for local MySQL connects. The default socket name for local MySQLi connects is needed for Moodle 2.0.

If you want to upload any file to your Moodle you should add a little bit more upload size in php.ini. If your server can't use more than 1 GB RAM you should set the memory_limit to a value less than 128M ... but it should have more than 48M for Moodle 1.9 and Moodle 2.0. Note that these sections are not likely to be consecutive in the php.ini file; the quickest way to find each one is search on the initial term (such as 'mysql.default_socket').

; Default socket name for local MySQL connects.
; If empty, uses the built-in MySQL defaults.
mysql.default_socket = /var/mysql/mysql.sock

; Default socket name for local MySQL connects.
; If empty, uses the built-in MySQL defaults.
mysqli.default_socket = /var/mysql/mysql.sock

; Maximum amount of memory a script may consume (128MB)
memory_limit = 128M

; Maximum allowed size for uploaded files.
upload_max_filesize = 128M

; Maximum size of POST data that PHP will accept.
post_max_size = 128M

; Defines the default timezone used by the date functions
; http://php.net/date.timezone
date.timezone = 'Europe/Berlin';

That's all ... save the file ''php.ini'' and restart the web server. Now you should look at http://your-server-address/info.php again. I hope that everything will be okay. You will find the version number PHP 5.3.x and the running GD library support. Congratulations ... the first step for Moodle on your Mac server is done!

[[Image:phpinfo.png]]

[[Image:phpinfo2.png]]

==Configure the MySQL database for your Moodle installation==

In standard case the database MySQL is installed on the Mac OS X Server but it is not running yet. Please make sure that you start the MySQL database server.

===Use the graphical way===
Sorry ... there are some more installations and a lot of clicks to configure MySQL in a graphical way.

First of all start the ''Server Admin''. You will find this program by the way ''Applications > Server > Server Admin''. Activate MySQL on the local server. You must set the password for the user ''root'' before you can start MySQL.

For the next you must download the MySQL database administration tool '''phpMyAdmin''' from http://www.phpmyadmin.net . Move the folder to the web server documents as ''/Library/WebServer/Documents/phpMyAdmin''.

Add the security phrase to the file ''config.inc.php'' in between the single quotes on the line $cfg['blowfish_secret'] = ''; /* YOU MUST FILL IN THIS FOR COOKIE AUTH! */

Now you will be able to start http://your-server-address/phpMyAdmin/ in your browser and to log into the database as the user ''root''. Add a database ''moodle19''. Add a database user ''moodle'' to the server ''localhost''. Don't forget to set a secure password. The database user ''moodle'' should be allowed to administrate the database ''moodle19'' only. It is a bad way to set ''root'' to administrate the database ''moodle19''. If you want to install also Moodle 2.0 dev please add a second database ''moodle20'' and use the same database user for it.

phpMyAdmin is a nice thing to look into the database while Moodle is running for some time. It's much easier to see in the graphical interface than in the command line tools. The image shows the database after Moodle 1.9 and Moodle 2.0 were already installed on this server.

[[Image:phpmyadmin.png]]

===Use the Terminal===

If you want a quick installation then don't fear to use the Terminal. It's easier to tell you all the commands for the right way with the Terminal than showing you all the pictures to do the same with graphical tools. There are only a few commands to do everything I told you before.

Start the Terminal. You will find this program by the way ''Applications > Tools > Terminal''. You will see that we must do the same steps as before but you can read them in a text form.

First of all you need to set the root password. If you didn't this before then use the first command line. If you want to change an existing password then use the second one.

Server:~ $ mysqladmin -u root password 'secret'
Server:~ $ mysqladmin -u root -p password 'topsecret'

The next steps are creating a new database ''moodle19'' with correct character set and setting up a database user ''moodle'', with an assigned password (IDENTIFIED BY), to administrate the new database ... and if you want, then do the same for ''moodle20''.

Server:~ $ mysqladmin -u root -p create moodle19
Server:~ $ mysql -u root -p

mysql> ALTER DATABASE moodle19 CHARSET 'utf8';
mysql> GRANT ALL PRIVILEGES ON moodle19.* TO moodle@localhost
-> IDENTIFIED BY 'moodle!';
mysql> quit

Server:~ $

That's really all with the Terminal. You are just ready!

===Use InnoDB with Moodle 2.0===

For Moodle 2.0 you should setup the support for InnoDB in your MySQL database.

Open the file /etc/my.cnf an delete every # in all lines beginning with innodb. This uncomments the InnoDB settings. Please save the file and restart your MySQL database.

# Uncomment the following if you are using InnoDB tables
innodb_data_home_dir = /var/mysql/
innodb_data_file_path = ibdata1:2000M;ibdata2:10M:autoextend
innodb_log_group_home_dir = /var/mysql/
innodb_log_arch_dir = /var/mysql/
# You can set .._buffer_pool_size up to 50 - 80 %
# of RAM but beware of setting memory usage too high
innodb_buffer_pool_size = 384M
innodb_additional_mem_pool_size = 20M
# Set .._log_file_size to 25 % of buffer pool size
innodb_log_file_size = 100M
innodb_log_buffer_size = 8M
innodb_flush_log_at_trx_commit = 1
innodb_lock_wait_timeout = 50

==Copy the Moodle files to the web server==

The documents for the web server are saved in the folder ''/Library/WebServer/Documents/''. You will place your Moodle folder here after you got it from http://download.moodle.org. Download the standard package MOODLE_19_WEEKLY because this is the best choice for new servers. Set the owner ''_www'' for the moodle folder ... this is the user for the web server. The folder permissions should be 755 before the installation and 555 after it's done ... please remember to set this later!

You also need the moodledata folder outside of the Documents folder ... so please make one. Go to the folder ''/Library/WebServer/'' and add the folder ''moodledata''. Because I want to install Moodle 1.9.x and Moodle 2.0 dev together on the same Mac server I add two folders ''moodle19'' and ''moodle20'' inside the moodledata folder. Please set the owner ''_www'' for both folders ''moodle19'' and ''moodle20'' and the folder permissions to 755.

cd /Library/WebServer/
mkdir moodledata
mkdir moodledata/moodle19
mkdir moodledata/moodle20
sudo chown -R _www moodledata
sudo chmod -R 755 moodledata

If you'd like to put the moodledata folder on another volume (not a bad idea if you think you'll have a substantial amount of data within the moodle), note that you cannot simply reference it using the /Volumes/<volume_name>/folder syntax during the moodle setup. Instead, you'll need to create the folder (assigning the user and permissions), then create a '''link''' to it within the /Library/WebServer folder. To create the link, use the following command in a terminal window, substituting your data volume and folder name:

cd /Library/WebServer
ln -s /Volumes/Data_Volume/moodledata moodledata

==Run the Moodle installation==
The installation on the Mac server is the same like the installation on every other server.
Open a web browser to http://your-server-address/moodle/install.php to begin the installation process.
On the screen picture and in the shown config.php you see the web address ''your-server-address'' ... it's only a placeholder for a real address or url ... please set yours. Also a user 'moodle' with a password 'moodle' would be very unsafe settings for your installation.

[[Image:moodle-install1.png]]

[[Image:moodle-install2.png]]

The installer generates the config.php automatically and saves it in the folder ''/Library/WebServer/Documents/moodle19''. Please edit the config.php with a text editor and add the line ''date_default_timezone_set('UTC');''. You may change ''UTC'' to your own timezone ... this is needed for PHP 5.3.0. In case you don't know all the relevant time zone identifiers by heart, there is a [http://phpbuilder.com/manual/en/timezones.php list available online].

<?php /// Moodle Configuration File

unset($CFG);

$CFG->dbtype = 'mysql';
$CFG->dbhost = 'localhost';
$CFG->dbname = 'moodle19';
$CFG->dbuser = 'moodle';
$CFG->dbpass = 'moodle';
$CFG->dbpersist = false;
$CFG->prefix = 'mdl_';

$CFG->wwwroot = 'http://your-server-address/moodle19';
$CFG->dirroot = '/Library/WebServer/Documents/moodle19';
$CFG->dataroot = '/Library/WebServer/moodledata/moodle19';
$CFG->admin = 'admin';

$CFG->directorypermissions = 00777; // try 02777 on a server in Safe Mode

date_default_timezone_set('Europe/Berlin'); // timezone for PHP 5.3.0
require_once("$CFG->dirroot/lib/setup.php");
// MAKE SURE WHEN YOU EDIT THIS FILE THAT THERE ARE NO SPACES, BLANK LINES,
// RETURNS, OR ANYTHING ELSE AFTER THE TWO CHARACTERS ON THE NEXT LINE.
?>

After this, the web-based installation component will walk you through '''several''' screens worth of database configurations and updates, for most of which you'll just click the continue button. You'll set up an admin user and give the site a basic configuration (title, description, etc). When the installation is ready you should change the folder permission for ''/Library/WebServer/Documents/moodle19'' to 555 so the web server is not able to write into this folder again.

==Download the language packages==

==Moodle is running ...==
[[Image:moodle-on-macosx-server.png]]

==How to setup the cron job with launchd==

It's really important to start the cron job every 5 minutes. The cron job assists most of Moodle's modules to perform tasks on a scheduled basis. For example, the discussion forums can only mail out copies of new posts to all subscribers if the cron job tells Moodle to do this.

In Mac OS X you will find the system daemon ''launchd'' for this service. This daemon offers a standardized interface to any user and all programs started automatically by the system. Please look at http://developer.apple.com/macosx/launchd.html for more information about the configurations and all parameters.

In our case the service should get the web page http://your-server-address/moodle19/admin/cron.php every 5 minutes. The configuration will be done by the file named ''moodle4mac.cron.plist'' which must be placed in the system folder ''/Library/LaunchDaemons/'' ... surely you can use any other file name but it should say something about the function of the service. The extension must be ''.plist''. After any reboot of your Mac server the cron service will start automaticly because the file is placed in the correct system folder.

===Use the graphical way===
You can use Lingon to add a new daemon plist or to edit one. It produces the same text as you can write in your text editor. http://sourceforge.net/projects/lingon/files/

[[Image:macosx-lingon.png]]

===Use a text editor===
Please use a text editor to write the needed file. You can open the Terminal and use the system editors vi or pico. But you can also write the text file with any GUI text editor ... I mostly use TextWrangler ... but do NOT take an editor for formatted texts like Microsoft Word or OpenOffice Writer. You must get pure text!

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0//EN"
"http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>KeepAlive</key><false/>
<key>Label</key><string>moodle4mac.cron</string>
<key>ProgramArguments</key>
<array>
<string>curl</string>
<string>-s</string>
<string>http://your-server-address/moodle19/admin/cron.php</string>
</array>
<key>RunAtLoad</key><true />
<key>StartInterval</key><integer>300</integer>
<key>StandardErrorPath</key><string>/dev/null</string>
<key>StandardOutPath</key><string>/dev/null</string>
</dict>
</plist>

The label string must be the same as the file name is but without the extension ''.plist''. Save the text file ''/Library/LaunchDaemons/moodle4mac.cron.plist''. The owner of the file must be set to the system user ''root''. That's all, really!

===How to start and stop the cron service===
You can start the new cron service in the Terminal.

sudo launchctl load /Library/LaunchDaemons/moodle4mac.cron.plist

The following command would stop the service. If you want to activate changes in the cron service you need to ''unload'' and then to ''load'' the daemon again.

sudo launchctl unload /Library/LaunchDaemons/moodle4mac.cron.plist

===Only one service for two servers?===
For my server I needed to have a cron service for to instances ''moodle19'' and ''moodle20'' ... no problem ... with the typo ''moodle[19-20]'' the server will get a cron service for both instances.

<nowiki>curl -s http://your-server-address/moodle[19-20]/admin/cron.php</nowiki>

To see if the cron service works correctly you should look at the ''access.log'' of your web server. The cron.php should be accessed every 5 minutes ... on my server for both Moodle instances ''moodle19'' and ''moodle20'' ... oh yes, it works!!

192.168.0.220 - - [30/Jul/2009:22:10:56 +0200] "GET /moodle19/admin/cron.php HTTP/1.1" 200 1136
192.168.0.220 - - [30/Jul/2009:22:10:57 +0200] "GET /moodle20/admin/cron.php HTTP/1.1" 200 1403
192.168.0.220 - - [30/Jul/2009:22:11:18 +0200] "OPTIONS * HTTP/1.0" 200 -
192.168.0.220 - - [30/Jul/2009:22:15:56 +0200] "GET /moodle19/admin/cron.php HTTP/1.1" 200 735
192.168.0.220 - - [30/Jul/2009:22:15:57 +0200] "GET /moodle20/admin/cron.php HTTP/1.1" 200 964
192.168.0.220 - - [30/Jul/2009:22:20:56 +0200] "GET /moodle19/admin/cron.php HTTP/1.1" 200 1136
192.168.0.220 - - [30/Jul/2009:22:20:57 +0200] "GET /moodle20/admin/cron.php HTTP/1.1" 200 1365

==How to install and update Moodle via CVS==

CVS is very simple way to install and update your Moodle.

The only software you must have installed on your Mac server is the Xcode Tools package from your system installation media. You also must have an internet connection to get the files from the update server. After you installed both script files on your server desktop it only needs a doubleclick to get the newest Moodle version without downloading the complete installation package. Please remember - before you can update your Moodle via CVS you must install Moodle via CVS at once.

That's all .... really .... it's easy!!

===Use the CVS installation script===
If your Moodle is already installed via CVS please use the CVS updater (see below). Running the CVS installer will install only the standard version of Moodle on your server.

If you already have a working Moodle on your server then this script copies the file config.php into your new installation but it does not copy your additional modules or plugins or themes. You will find your old moodle folder in same directory and it will be renamed with an additional date stamp.

<pre>
#! /bin/sh
#
# CVS installer for Moodle
# on a Mac OS X Server
#
# 20100818 - Ralf Krause
#

export CVS_RSH=ssh

### file ~/.cvspass must exist
if ! test -e ~/.cvspass ; then
touch ~/.cvspass
fi

echo
echo "+--------------------------------------------+"
echo "| CVS installer for the Moodle server "
echo "+--------------------------------------------+"
echo

cd /Library/WebServer/Documents

### get the cvs installation into a tmp folder
if ! test -e tmp ; then
sudo mkdir tmp
sudo chmod 777 tmp
fi

echo "Connecting to the CVS server. Download will take a few moments!"
echo "If the CVS update runs too long you may break with <ctrl>-C"
echo

### do the cvs installation
cd tmp
cvs -z9 -d:pserver:anonymous@uk.cvs.moodle.org:/cvsroot/moodle co -P -r MOODLE_19_WEEKLY moodle
cd ..

### copy config.php from your current moodle folder if it exists
if ! test -e moodle/config.php ; then
cp moodle19/config.php tmp/moodle/config.php
fi

### move the new moodle to the right place
DATE=`date +%Y%m%d-%H%M`
sudo mv moodle19 moodle19-$DATE
sudo mv tmp/moodle moodle19
sudo chown -R _www moodle19
</pre>

===Use the CVS update script===
To be able to update Moodle via CVS please check that your Moodle was already installed via CVS (see above).

<pre>
#! /bin/sh
#
# CVS updater for Moodle
# on a Mac OS X Server
#
# 20100818 - Ralf Krause
#

export CVS_RSH=ssh

echo
echo "+--------------------------------------------+"
echo "| CVS updater for the Moodle server "
echo "+--------------------------------------------+"
echo

cd /Library/WebServer/Documents/moodle19/

### file ~/.cvspass must exist
if ! test -e ~/.cvspass ; then
touch ~/.cvspass
fi

### login to the cvs server only for the first time
if ! grep "uk.cvs.moodle.org" ~/.cvspass > /dev/null ; then
echo "CVS password is empty ... please only press <return> to start"
sudo cvs -d :pserver:anonymous@uk.cvs.moodle.org:/cvsroot/moodle login
echo
fi

echo "Connecting to the CVS server. Download will take a few moments!"
echo "If the CVS update runs too long you may break with <ctrl>-C"
echo

### do the cvs installation
sudo cvs -q update -dP -r MOODLE_19_WEEKLY
sudo chown -R _www .
</pre>

Please look at the documentation [https://docs.moodle.org/en/CVS_for_Administrators CVS for Administrators] if you want to learn more about Moodle and CVS. There you will also find a list of different [https://docs.moodle.org/en/CVS_for_Administrators#CVS_Servers CVS servers for Moodle] which you may choose for your updates.

The shown update script should be modified in only three things ... first you need to choose the correct folder for the Moodle files, second choose a CVS server near your server place to minimate internet traffic, and third you must input the correct CVS tag for the Moodle version in the last line. The shown script is for updating the version Moodle 1.9
* Moodle 1.8 uses MOODLE_18_WEEKLY
* Moodle 1.9 uses MOODLE_19_WEEKLY
* Moodle 2.0 RC1 still uses HEAD

===Troubleshooting===

If CVS does not work on your server please check that the connection port is open.
If you see something like this, make sure that there is no firewall blocking the port (it's port 2401):

$ cvs -d:pserver:anonymous@us.cvs.moodle.org:/cvsroot/moodle login
Logging in to :pserver:anonymous@us.cvs.moodle.org:2401/cvsroot/moodle
CVS password:
cvs [login aborted]: connect to us.cvs.moodle.org(130.212.64.111):2401 failed: Connection timed out

===Install Xcode Tools and CVS on your Mac Server===

To test if cvs is already on your Mac Server please open the Terminal and type ''cvs -v''. The output of this command should show a version notice of your Concurrent Versions System (CVS). If you get the ''command not found'' message then you must search for your Mac OS X 10.5 Server installation media. You will find the Xcode Tools on your installation CD or DVD set.

If you can't find your installation media anymore you also can download the Xcode Tools from the URL http://developer.apple.com/tools/xcode/. It is free but you have to register as a developer. Starting the download then the Xcode package copies a lot of bytes on your harddisk and will need a very few minutes to complete.

After you installed the Xcode Tools in your server system you will get the correct version answer from the Terminal command ''cvs -v''. If you only want to update your Moodle you do not need all these nice developer tools from the inside of the folder. Sorry about this but there is no separate installer for the CVS update process.
  

==User administration via LDAP==

The following settings will work on 10.5 Server running LDAP - edit them to customize to your own environment. Please note that moodle requires some fields - it is best to have these fields completed in Workgroup Manager on 10.5 Server - otherwise they'll be prompted to enter info into their moodle profile on first login, but the way we've got it set up, moodle can't modify LDAP for security and data integrity. The necessary fields are user name, first name, surname, Email address, City/Town, country, description, ID number.
<pre>
LDAP SERVER SETTINGS
Host URL = ourserver.example.com
Version = 3
LDAP encoding = utf-8

BIND SETTINGS
Hide passwords = Yes
Distinguished Name = (blank)
Password = (blank)

USER LOOKUP SETTINGS
User type = posixAccount (rfc2307)
Contexts = cn=users,dc=ourserver,dc=example,dc=com
Search subcontexts = Yes
Dereference aliases = No
User attribute = (blank)
Member attribute = (blank)
Member attribute uses dn = (blank)
Object class = (blank)

FORCE CHANGE PASSWORD
Force change password = No
Use standard Change Password Page = No
Password format = Plain text
Password change URL = (blank)

LDAP PASSWORD EXPIRATION SETTINGS
Expiration = no
Expiration warning = 10
Expiration attribute = ""
Grace logins = No
Grace login attribute = (blank)

ENABLE USER CREATION
Create users externally = No
Context for new users = (blank)

COURSE CREATOR
Creators = (blank)

CRON SYNCHRONIZATION SCRIPT
Removed ext user = Keep internal

NTLM SSO
Enable = No
Subnet = (blank)
First name = givenName (On every login, Never, Locked)
Surname = sn (On every login, Never, Locked)
Email address = mail (On every login, Never, Locked)
Phone 1 = (blank)
Phone 2 = (blank)
Department = (blank)
Address = (blank)
City/Town = l (On every login, Never, Locked)
Country = c (On every login, Never, Locked)
Description = description (On every login, Never, Locked)
ID number = uidNumber (On every login, Never, Locked)
Language = (blank)
</pre>

==See also==
* [[Complete Install Packages for Mac OS X | Complete install packages for Mac OS X Clients 10.4/10.5/10.6]]
* [[Step-by-step Guide for Installing Moodle on Mac OS X 10.4 Client|Step by step installation on a Mac OS X Client 10.4]]
* [[Cron | Installation of cron for Moodle]]
* [[CVS for Administrators]]

* [http://moodle.org/mod/forum/discuss.php?d=24632 Using Moodle: Dynamic DNS Home Server]

[[Category:Administrator]]
[[Category:Installation]]
[[Category:Mac OS X]]

Step by Step Installation on a Mac OS X Server

2010-10-21T14:38:10Z

Krause: /* Install Xcode Tools and CVS on your Mac Server */

==Overview==
This guide shows all steps for the installation of Moodle on a [http://www.apple.com/server/macosx Mac OS X Server]. This server is a commercial product. You will find [http://www.apple.com/server/macosx/resources/documentation.html all documentations] about the web server on the Apple support pages.

This installation guide can't be useful for an installation on MAMP or XAMPP. If you are looking for an easy way to install Moodle on your local machine please use [[Complete Install Packages for Mac OS X | Complete install packages for Mac OS X 10.4/10.5/10.6 Clients]] that can be downloaded from http://download.moodle.org/macosx/ ... but if you are planning to set up a Moodle internet server on a Mac then you should think about some more security as the ever local package could give.

Please feel free to add your ideas and wishes to the discussion page for this article. You may also write a complete chapter if you tried the facts yourself on your own Mac Server. I am most interested to make the things better.

==System requirements==

+ Apple Computer
+ Mac mini, Mac Pro or Xserve
+ Processor: Intel Core 2 Duo, Intel Core i3/i5/i7
+ RAM: 2 GB or better
+ Hard Disk: 500 MB free
+ System Software: Mac OS X Server 10.5 or 10.6

==Configure PHP for your Moodle installation==
===Mac OS X 10.6 Server - No PHP installation needed===

The Mac OS X 10.6.4 Server (SnowLeopard) comes with PHP 5.3.2 and a lot of PHP extensions. This would be the best choice for Moodle 1.9.x and for Moodle 2.0 on a Mac OS X Server. Please forget everything you read about the missing GD Library! The PHP installation is totally complete for Moodle. You only have to switch on the PHP module and to control if the file ''/etc/php.ini'' sets the right values for Moodle.

[[Image:Server-admin-106.png]]

===Mac OS X 10.5 Server - Install PHP 5.3.0 and the GD Library===

The Mac OS X 10.5.8 Server (Leopard) comes with PHP 5.2.6 ... this is correct for Moodle 1.9.x. But you have to add the missing GD Library support to get Moodle running on your server. For Moodle 2.0 the server must have PHP 5.2.8 (or better) and some more PHP extensions ... in this case you need to get the better PHP version. These instructions are helpful in both cases.

To see which PHP version and extensions are installed on your server you should edit the file ''/Library/WebServer/Documents/info.php''. You must activate the function call phpinfo() by deleting the both slashes // at the start of the function line. After saving the file you can get all PHP informations in your browser. Please look at http://your-server-address/info.php ... you will not find any GD library support ... bad thing for Moodle!!

<?php
// You can use Server Admin to enable the Apache PHP module; it's disabled by default.
// You can uncomment the phpinfo() directive below to provide a default PHP info page
// but note that this displays information about your host's configuration.
phpinfo();
?>

The easiest way to get the GD library support and to get a better PHP version would be the installation of the complete PHP 5.3.0 package from http://www.entropy.ch/software/macosx/php/. Marc Liyanage precompiled this package to use it on Mac clients and Mac servers. Please get the package and install it by following the instructions on the download page. The installer does everything for you ... it copies PHP into the correct folder ''/usr/local/php5'' and changes its owner to ''root'' automatically. You will find the file php.ini inside the new package folder. Open the file ''/usr/local/php5/lib/php.ini'' and edit some settings for Moodle.

Note: If you want to install Moodle 1.8.x on the server you need to get the Entropy PHP-5.2.9-7.pkg instead. Moodle 1.8.x does not run with PHP 5.3.0. (MDL-20128)

Now the Apache web server must get knowledge that you want to use the new PHP library instead of the old. Open the application Server Admin to switch to the new library. Go to the web server settings and find the entry php5_module. The normal place for PHP the Mac server is ''libexec/apache2/libphp5.so''. Please change to ''/usr/local/php5/libphp5.so'' and save the settings.

[[Image:Server-admin.png]]

===PHP settings in your php.ini===
The next thing is to configure the file ''php.ini''. Most of the settings are okay but not all of them. To communicate to the MySQL database with PHP you have to set the default socket name for local MySQL connects. The default socket name for local MySQLi connects is needed for Moodle 2.0.

If you want to upload any file to your Moodle you should add a little bit more upload size in php.ini. If your server can't use more than 1 GB RAM you should set the memory_limit to a value less than 128M ... but it should have more than 48M for Moodle 1.9 and Moodle 2.0. Note that these sections are not likely to be consecutive in the php.ini file; the quickest way to find each one is search on the initial term (such as 'mysql.default_socket').

; Default socket name for local MySQL connects.
; If empty, uses the built-in MySQL defaults.
mysql.default_socket = /var/mysql/mysql.sock

; Default socket name for local MySQL connects.
; If empty, uses the built-in MySQL defaults.
mysqli.default_socket = /var/mysql/mysql.sock

; Maximum amount of memory a script may consume (128MB)
memory_limit = 128M

; Maximum allowed size for uploaded files.
upload_max_filesize = 128M

; Maximum size of POST data that PHP will accept.
post_max_size = 128M

; Defines the default timezone used by the date functions
; http://php.net/date.timezone
date.timezone = 'Europe/Berlin';

That's all ... save the file ''php.ini'' and restart the web server. Now you should look at http://your-server-address/info.php again. I hope that everything will be okay. You will find the version number PHP 5.3.x and the running GD library support. Congratulations ... the first step for Moodle on your Mac server is done!

[[Image:phpinfo.png]]

[[Image:phpinfo2.png]]

==Configure the MySQL database for your Moodle installation==

In standard case the database MySQL is installed on the Mac OS X Server but it is not running yet. Please make sure that you start the MySQL database server.

===Use the graphical way===
Sorry ... there are some more installations and a lot of clicks to configure MySQL in a graphical way.

First of all start the ''Server Admin''. You will find this program by the way ''Applications > Server > Server Admin''. Activate MySQL on the local server. You must set the password for the user ''root'' before you can start MySQL.

For the next you must download the MySQL database administration tool '''phpMyAdmin''' from http://www.phpmyadmin.net . Move the folder to the web server documents as ''/Library/WebServer/Documents/phpMyAdmin''.

Add the security phrase to the file ''config.inc.php'' in between the single quotes on the line $cfg['blowfish_secret'] = ''; /* YOU MUST FILL IN THIS FOR COOKIE AUTH! */

Now you will be able to start http://your-server-address/phpMyAdmin/ in your browser and to log into the database as the user ''root''. Add a database ''moodle19''. Add a database user ''moodle'' to the server ''localhost''. Don't forget to set a secure password. The database user ''moodle'' should be allowed to administrate the database ''moodle19'' only. It is a bad way to set ''root'' to administrate the database ''moodle19''. If you want to install also Moodle 2.0 dev please add a second database ''moodle20'' and use the same database user for it.

phpMyAdmin is a nice thing to look into the database while Moodle is running for some time. It's much easier to see in the graphical interface than in the command line tools. The image shows the database after Moodle 1.9 and Moodle 2.0 were already installed on this server.

[[Image:phpmyadmin.png]]

===Use the Terminal===

If you want a quick installation then don't fear to use the Terminal. It's easier to tell you all the commands for the right way with the Terminal than showing you all the pictures to do the same with graphical tools. There are only a few commands to do everything I told you before.

Start the Terminal. You will find this program by the way ''Applications > Tools > Terminal''. You will see that we must do the same steps as before but you can read them in a text form.

First of all you need to set the root password. If you didn't this before then use the first command line. If you want to change an existing password then use the second one.

Server:~ $ mysqladmin -u root password 'secret'
Server:~ $ mysqladmin -u root -p password 'topsecret'

The next steps are creating a new database ''moodle19'' with correct character set and setting up a database user ''moodle'', with an assigned password (IDENTIFIED BY), to administrate the new database ... and if you want, then do the same for ''moodle20''.

Server:~ $ mysqladmin -u root -p create moodle19
Server:~ $ mysql -u root -p

mysql> ALTER DATABASE moodle19 CHARSET 'utf8';
mysql> GRANT ALL PRIVILEGES ON moodle19.* TO moodle@localhost
-> IDENTIFIED BY 'moodle!';
mysql> quit

Server:~ $

That's really all with the Terminal. You are just ready!

===Use InnoDB with Moodle 2.0===

For Moodle 2.0 you should setup the support for InnoDB in your MySQL database.

Open the file /etc/my.cnf an delete every # in all lines beginning with innodb. This uncomments the InnoDB settings. Please save the file and restart your MySQL database.

# Uncomment the following if you are using InnoDB tables
innodb_data_home_dir = /var/mysql/
innodb_data_file_path = ibdata1:2000M;ibdata2:10M:autoextend
innodb_log_group_home_dir = /var/mysql/
innodb_log_arch_dir = /var/mysql/
# You can set .._buffer_pool_size up to 50 - 80 %
# of RAM but beware of setting memory usage too high
innodb_buffer_pool_size = 384M
innodb_additional_mem_pool_size = 20M
# Set .._log_file_size to 25 % of buffer pool size
innodb_log_file_size = 100M
innodb_log_buffer_size = 8M
innodb_flush_log_at_trx_commit = 1
innodb_lock_wait_timeout = 50

==Copy the Moodle files to the web server==

The documents for the web server are saved in the folder ''/Library/WebServer/Documents/''. You will place your Moodle folder here after you got it from http://download.moodle.org. Download the standard package MOODLE_19_WEEKLY because this is the best choice for new servers. Set the owner ''_www'' for the moodle folder ... this is the user for the web server. The folder permissions should be 755 before the installation and 555 after it's done ... please remember to set this later!

You also need the moodledata folder outside of the Documents folder ... so please make one. Go to the folder ''/Library/WebServer/'' and add the folder ''moodledata''. Because I want to install Moodle 1.9.x and Moodle 2.0 dev together on the same Mac server I add two folders ''moodle19'' and ''moodle20'' inside the moodledata folder. Please set the owner ''_www'' for both folders ''moodle19'' and ''moodle20'' and the folder permissions to 755.

cd /Library/WebServer/
mkdir moodledata
mkdir moodledata/moodle19
mkdir moodledata/moodle20
sudo chown -R _www moodledata
sudo chmod -R 755 moodledata

If you'd like to put the moodledata folder on another volume (not a bad idea if you think you'll have a substantial amount of data within the moodle), note that you cannot simply reference it using the /Volumes/<volume_name>/folder syntax during the moodle setup. Instead, you'll need to create the folder (assigning the user and permissions), then create a '''link''' to it within the /Library/WebServer folder. To create the link, use the following command in a terminal window, substituting your data volume and folder name:

cd /Library/WebServer
ln -s /Volumes/Data_Volume/moodledata moodledata

==Run the Moodle installation==
The installation on the Mac server is the same like the installation on every other server.
Open a web browser to http://your-server-address/moodle/install.php to begin the installation process.
On the screen picture and in the shown config.php you see the web address ''your-server-address'' ... it's only a placeholder for a real address or url ... please set yours. Also a user 'moodle' with a password 'moodle' would be very unsafe settings for your installation.

[[Image:moodle-install1.png]]

[[Image:moodle-install2.png]]

The installer generates the config.php automatically and saves it in the folder ''/Library/WebServer/Documents/moodle19''. Please edit the config.php with a text editor and add the line ''date_default_timezone_set('UTC');''. You may change ''UTC'' to your own timezone ... this is needed for PHP 5.3.0. In case you don't know all the relevant time zone identifiers by heart, there is a [http://phpbuilder.com/manual/en/timezones.php list available online].

<?php /// Moodle Configuration File

unset($CFG);

$CFG->dbtype = 'mysql';
$CFG->dbhost = 'localhost';
$CFG->dbname = 'moodle19';
$CFG->dbuser = 'moodle';
$CFG->dbpass = 'moodle';
$CFG->dbpersist = false;
$CFG->prefix = 'mdl_';

$CFG->wwwroot = 'http://your-server-address/moodle19';
$CFG->dirroot = '/Library/WebServer/Documents/moodle19';
$CFG->dataroot = '/Library/WebServer/moodledata/moodle19';
$CFG->admin = 'admin';

$CFG->directorypermissions = 00777; // try 02777 on a server in Safe Mode

date_default_timezone_set('Europe/Berlin'); // timezone for PHP 5.3.0
require_once("$CFG->dirroot/lib/setup.php");
// MAKE SURE WHEN YOU EDIT THIS FILE THAT THERE ARE NO SPACES, BLANK LINES,
// RETURNS, OR ANYTHING ELSE AFTER THE TWO CHARACTERS ON THE NEXT LINE.
?>

After this, the web-based installation component will walk you through '''several''' screens worth of database configurations and updates, for most of which you'll just click the continue button. You'll set up an admin user and give the site a basic configuration (title, description, etc). When the installation is ready you should change the folder permission for ''/Library/WebServer/Documents/moodle19'' to 555 so the web server is not able to write into this folder again.

==Download the language packages==

==Moodle is running ...==
[[Image:moodle-on-macosx-server.png]]

==How to setup the cron job with launchd==

It's really important to start the cron job every 5 minutes. The cron job assists most of Moodle's modules to perform tasks on a scheduled basis. For example, the discussion forums can only mail out copies of new posts to all subscribers if the cron job tells Moodle to do this.

In Mac OS X you will find the system daemon ''launchd'' for this service. This daemon offers a standardized interface to any user and all programs started automatically by the system. Please look at http://developer.apple.com/macosx/launchd.html for more information about the configurations and all parameters.

In our case the service should get the web page http://your-server-address/moodle19/admin/cron.php every 5 minutes. The configuration will be done by the file named ''moodle4mac.cron.plist'' which must be placed in the system folder ''/Library/LaunchDaemons/'' ... surely you can use any other file name but it should say something about the function of the service. The extension must be ''.plist''. After any reboot of your Mac server the cron service will start automaticly because the file is placed in the correct system folder.

===Use the graphical way===
You can use Lingon to add a new daemon plist or to edit one. It produces the same text as you can write in your text editor. http://sourceforge.net/projects/lingon/files/

[[Image:macosx-lingon.png]]

===Use a text editor===
Please use a text editor to write the needed file. You can open the Terminal and use the system editors vi or pico. But you can also write the text file with any GUI text editor ... I mostly use TextWrangler ... but do NOT take an editor for formatted texts like Microsoft Word or OpenOffice Writer. You must get pure text!

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0//EN"
"http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>KeepAlive</key><false/>
<key>Label</key><string>moodle4mac.cron</string>
<key>ProgramArguments</key>
<array>
<string>curl</string>
<string>-s</string>
<string>http://your-server-address/moodle19/admin/cron.php</string>
</array>
<key>RunAtLoad</key><true />
<key>StartInterval</key><integer>300</integer>
<key>StandardErrorPath</key><string>/dev/null</string>
<key>StandardOutPath</key><string>/dev/null</string>
</dict>
</plist>

The label string must be the same as the file name is but without the extension ''.plist''. Save the text file ''/Library/LaunchDaemons/moodle4mac.cron.plist''. The owner of the file must be set to the system user ''root''. That's all, really!

===How to start and stop the cron service===
You can start the new cron service in the Terminal.

sudo launchctl load /Library/LaunchDaemons/moodle4mac.cron.plist

The following command would stop the service. If you want to activate changes in the cron service you need to ''unload'' and then to ''load'' the daemon again.

sudo launchctl unload /Library/LaunchDaemons/moodle4mac.cron.plist

===Only one service for two servers?===
For my server I needed to have a cron service for to instances ''moodle19'' and ''moodle20'' ... no problem ... with the typo ''moodle[19-20]'' the server will get a cron service for both instances.

<nowiki>curl -s http://your-server-address/moodle[19-20]/admin/cron.php</nowiki>

To see if the cron service works correctly you should look at the ''access.log'' of your web server. The cron.php should be accessed every 5 minutes ... on my server for both Moodle instances ''moodle19'' and ''moodle20'' ... oh yes, it works!!

192.168.0.220 - - [30/Jul/2009:22:10:56 +0200] "GET /moodle19/admin/cron.php HTTP/1.1" 200 1136
192.168.0.220 - - [30/Jul/2009:22:10:57 +0200] "GET /moodle20/admin/cron.php HTTP/1.1" 200 1403
192.168.0.220 - - [30/Jul/2009:22:11:18 +0200] "OPTIONS * HTTP/1.0" 200 -
192.168.0.220 - - [30/Jul/2009:22:15:56 +0200] "GET /moodle19/admin/cron.php HTTP/1.1" 200 735
192.168.0.220 - - [30/Jul/2009:22:15:57 +0200] "GET /moodle20/admin/cron.php HTTP/1.1" 200 964
192.168.0.220 - - [30/Jul/2009:22:20:56 +0200] "GET /moodle19/admin/cron.php HTTP/1.1" 200 1136
192.168.0.220 - - [30/Jul/2009:22:20:57 +0200] "GET /moodle20/admin/cron.php HTTP/1.1" 200 1365

==How to install and update Moodle via CVS==

CVS is very simple way to install and update your Moodle.

The only software you must have installed on your Mac server is the Xcode Tools package from your system installation media. You also must have an internet connection to get the files from the update server. After you installed both script files on your server desktop it only needs a doubleclick to get the newest Moodle version without downloading the complete installation package. Please remember - before you can update your Moodle via CVS you must install Moodle via CVS at once.

That's all .... really .... it's easy!!

===Use the CVS installation script===
If your Moodle is already installed via CVS please use the CVS updater (see below). Running the CVS installer will install only the standard version of Moodle on your server.

If you already have a working Moodle on your server then this script copies the file config.php into your new installation but it does not copy your additional modules or plugins or themes. You will find your old moodle folder in same directory and it will be renamed with an additional date stamp.

<pre>
#! /bin/sh
#
# CVS installer for Moodle
# on a Mac OS X Server
#
# 20100818 - Ralf Krause
#

export CVS_RSH=ssh

### file ~/.cvspass must exist
if ! test -e ~/.cvspass ; then
touch ~/.cvspass
fi

echo
echo "+--------------------------------------------+"
echo "| CVS installer for the Moodle server "
echo "+--------------------------------------------+"
echo

cd /Library/WebServer/Documents

### get the cvs installation into a tmp folder
if ! test -e tmp ; then
sudo mkdir tmp
sudo chmod 777 tmp
fi

echo "Connecting to the CVS server. Download will take a few moments!"
echo "If the CVS update runs too long you may break with <ctrl>-C"
echo

### do the cvs installation
cd tmp
cvs -z9 -d:pserver:anonymous@uk.cvs.moodle.org:/cvsroot/moodle co -P -r MOODLE_19_WEEKLY moodle
cd ..

### copy config.php from your current moodle folder if it exists
if ! test -e moodle/config.php ; then
cp moodle19/config.php tmp/moodle/config.php
fi

### move the new moodle to the right place
DATE=`date +%Y%m%d-%H%M`
sudo mv moodle19 moodle19-$DATE
sudo mv tmp/moodle moodle19
sudo chown -R _www moodle19
</pre>

===Use the CVS update script===
To be able to update Moodle via CVS please check that your Moodle was already installed via CVS (see above).

<pre>
#! /bin/sh
#
# CVS updater for Moodle
# on a Mac OS X Server
#
# 20100818 - Ralf Krause
#

export CVS_RSH=ssh

echo
echo "+--------------------------------------------+"
echo "| CVS updater for the Moodle server "
echo "+--------------------------------------------+"
echo

cd /Library/WebServer/Documents/moodle19/

### file ~/.cvspass must exist
if ! test -e ~/.cvspass ; then
touch ~/.cvspass
fi

### login to the cvs server only for the first time
if ! grep "uk.cvs.moodle.org" ~/.cvspass > /dev/null ; then
echo "CVS password is empty ... please only press <return> to start"
sudo cvs -d :pserver:anonymous@uk.cvs.moodle.org:/cvsroot/moodle login
echo
fi

echo "Connecting to the CVS server. Download will take a few moments!"
echo "If the CVS update runs too long you may break with <ctrl>-C"
echo

### do the cvs installation
sudo cvs -q update -dP -r MOODLE_19_WEEKLY
sudo chown -R _www .
</pre>

Please look at the documentation [https://docs.moodle.org/en/CVS_for_Administrators CVS for Administrators] if you want to learn more about Moodle and CVS. There you will also find a list of different [https://docs.moodle.org/en/CVS_for_Administrators#CVS_Servers CVS servers for Moodle] which you may choose for your updates.

The shown update script should be modified in only three things ... first you need to choose the correct folder for the Moodle files, second choose a CVS server near your server place to minimate internet traffic, and third you must input the correct CVS tag for the Moodle version in the last line. The shown script is for updating the version Moodle 1.9
* Moodle 1.8 uses MOODLE_18_WEEKLY
* Moodle 1.9 uses MOODLE_19_WEEKLY
* Moodle 2.0 RC1 still uses HEAD

===Troubleshooting===

If you see something like this, make sure that there is not some firewall blocking the port (it's 2401):

$ cvs -d:pserver:anonymous@us.cvs.moodle.org:/cvsroot/moodle login
Logging in to :pserver:anonymous@us.cvs.moodle.org:2401/cvsroot/moodle
CVS password:
cvs [login aborted]: connect to us.cvs.moodle.org(130.212.64.111):2401 failed: Connection timed out

===Install Xcode Tools and CVS on your Mac Server===

To test if cvs is already on your Mac Server please open the Terminal and type ''cvs -v''. The output of this command should show a version notice of your Concurrent Versions System (CVS). If you get the ''command not found'' message then you must search for your Mac OS X 10.5 Server installation media. You will find the Xcode Tools on your installation CD or DVD set.

If you can't find your installation media anymore you also can download the Xcode Tools from the URL http://developer.apple.com/tools/xcode/. It is free but you have to register as a developer. Starting the download then the Xcode package copies a lot of bytes on your harddisk and will need a very few minutes to complete.

After you installed the Xcode Tools in your server system you will get the correct version answer from the Terminal command ''cvs -v''. If you only want to update your Moodle you do not need all these nice developer tools from the inside of the folder. Sorry about this but there is no separate installer for the CVS update process.
  

==User administration via LDAP==

The following settings will work on 10.5 Server running LDAP - edit them to customize to your own environment. Please note that moodle requires some fields - it is best to have these fields completed in Workgroup Manager on 10.5 Server - otherwise they'll be prompted to enter info into their moodle profile on first login, but the way we've got it set up, moodle can't modify LDAP for security and data integrity. The necessary fields are user name, first name, surname, Email address, City/Town, country, description, ID number.
<pre>
LDAP SERVER SETTINGS
Host URL = ourserver.example.com
Version = 3
LDAP encoding = utf-8

BIND SETTINGS
Hide passwords = Yes
Distinguished Name = (blank)
Password = (blank)

USER LOOKUP SETTINGS
User type = posixAccount (rfc2307)
Contexts = cn=users,dc=ourserver,dc=example,dc=com
Search subcontexts = Yes
Dereference aliases = No
User attribute = (blank)
Member attribute = (blank)
Member attribute uses dn = (blank)
Object class = (blank)

FORCE CHANGE PASSWORD
Force change password = No
Use standard Change Password Page = No
Password format = Plain text
Password change URL = (blank)

LDAP PASSWORD EXPIRATION SETTINGS
Expiration = no
Expiration warning = 10
Expiration attribute = ""
Grace logins = No
Grace login attribute = (blank)

ENABLE USER CREATION
Create users externally = No
Context for new users = (blank)

COURSE CREATOR
Creators = (blank)

CRON SYNCHRONIZATION SCRIPT
Removed ext user = Keep internal

NTLM SSO
Enable = No
Subnet = (blank)
First name = givenName (On every login, Never, Locked)
Surname = sn (On every login, Never, Locked)
Email address = mail (On every login, Never, Locked)
Phone 1 = (blank)
Phone 2 = (blank)
Department = (blank)
Address = (blank)
City/Town = l (On every login, Never, Locked)
Country = c (On every login, Never, Locked)
Description = description (On every login, Never, Locked)
ID number = uidNumber (On every login, Never, Locked)
Language = (blank)
</pre>

==See also==
* [[Complete Install Packages for Mac OS X | Complete install packages for Mac OS X Clients 10.4/10.5/10.6]]
* [[Step-by-step Guide for Installing Moodle on Mac OS X 10.4 Client|Step by step installation on a Mac OS X Client 10.4]]
* [[Cron | Installation of cron for Moodle]]
* [[CVS for Administrators]]

* [http://moodle.org/mod/forum/discuss.php?d=24632 Using Moodle: Dynamic DNS Home Server]

[[Category:Administrator]]
[[Category:Installation]]
[[Category:Mac OS X]]

Step by Step Installation on a Mac OS X Server

2010-10-21T14:36:52Z

Krause: /* Configure PHP for your Moodle installation */

==Overview==
This guide shows all steps for the installation of Moodle on a [http://www.apple.com/server/macosx Mac OS X Server]. This server is a commercial product. You will find [http://www.apple.com/server/macosx/resources/documentation.html all documentations] about the web server on the Apple support pages.

This installation guide can't be useful for an installation on MAMP or XAMPP. If you are looking for an easy way to install Moodle on your local machine please use [[Complete Install Packages for Mac OS X | Complete install packages for Mac OS X 10.4/10.5/10.6 Clients]] that can be downloaded from http://download.moodle.org/macosx/ ... but if you are planning to set up a Moodle internet server on a Mac then you should think about some more security as the ever local package could give.

Please feel free to add your ideas and wishes to the discussion page for this article. You may also write a complete chapter if you tried the facts yourself on your own Mac Server. I am most interested to make the things better.

==System requirements==

+ Apple Computer
+ Mac mini, Mac Pro or Xserve
+ Processor: Intel Core 2 Duo, Intel Core i3/i5/i7
+ RAM: 2 GB or better
+ Hard Disk: 500 MB free
+ System Software: Mac OS X Server 10.5 or 10.6

==Configure PHP for your Moodle installation==
===Mac OS X 10.6 Server - No PHP installation needed===

The Mac OS X 10.6.4 Server (SnowLeopard) comes with PHP 5.3.2 and a lot of PHP extensions. This would be the best choice for Moodle 1.9.x and for Moodle 2.0 on a Mac OS X Server. Please forget everything you read about the missing GD Library! The PHP installation is totally complete for Moodle. You only have to switch on the PHP module and to control if the file ''/etc/php.ini'' sets the right values for Moodle.

[[Image:Server-admin-106.png]]

===Mac OS X 10.5 Server - Install PHP 5.3.0 and the GD Library===

The Mac OS X 10.5.8 Server (Leopard) comes with PHP 5.2.6 ... this is correct for Moodle 1.9.x. But you have to add the missing GD Library support to get Moodle running on your server. For Moodle 2.0 the server must have PHP 5.2.8 (or better) and some more PHP extensions ... in this case you need to get the better PHP version. These instructions are helpful in both cases.

To see which PHP version and extensions are installed on your server you should edit the file ''/Library/WebServer/Documents/info.php''. You must activate the function call phpinfo() by deleting the both slashes // at the start of the function line. After saving the file you can get all PHP informations in your browser. Please look at http://your-server-address/info.php ... you will not find any GD library support ... bad thing for Moodle!!

<?php
// You can use Server Admin to enable the Apache PHP module; it's disabled by default.
// You can uncomment the phpinfo() directive below to provide a default PHP info page
// but note that this displays information about your host's configuration.
phpinfo();
?>

The easiest way to get the GD library support and to get a better PHP version would be the installation of the complete PHP 5.3.0 package from http://www.entropy.ch/software/macosx/php/. Marc Liyanage precompiled this package to use it on Mac clients and Mac servers. Please get the package and install it by following the instructions on the download page. The installer does everything for you ... it copies PHP into the correct folder ''/usr/local/php5'' and changes its owner to ''root'' automatically. You will find the file php.ini inside the new package folder. Open the file ''/usr/local/php5/lib/php.ini'' and edit some settings for Moodle.

Note: If you want to install Moodle 1.8.x on the server you need to get the Entropy PHP-5.2.9-7.pkg instead. Moodle 1.8.x does not run with PHP 5.3.0. (MDL-20128)

Now the Apache web server must get knowledge that you want to use the new PHP library instead of the old. Open the application Server Admin to switch to the new library. Go to the web server settings and find the entry php5_module. The normal place for PHP the Mac server is ''libexec/apache2/libphp5.so''. Please change to ''/usr/local/php5/libphp5.so'' and save the settings.

[[Image:Server-admin.png]]

===PHP settings in your php.ini===
The next thing is to configure the file ''php.ini''. Most of the settings are okay but not all of them. To communicate to the MySQL database with PHP you have to set the default socket name for local MySQL connects. The default socket name for local MySQLi connects is needed for Moodle 2.0.

If you want to upload any file to your Moodle you should add a little bit more upload size in php.ini. If your server can't use more than 1 GB RAM you should set the memory_limit to a value less than 128M ... but it should have more than 48M for Moodle 1.9 and Moodle 2.0. Note that these sections are not likely to be consecutive in the php.ini file; the quickest way to find each one is search on the initial term (such as 'mysql.default_socket').

; Default socket name for local MySQL connects.
; If empty, uses the built-in MySQL defaults.
mysql.default_socket = /var/mysql/mysql.sock

; Default socket name for local MySQL connects.
; If empty, uses the built-in MySQL defaults.
mysqli.default_socket = /var/mysql/mysql.sock

; Maximum amount of memory a script may consume (128MB)
memory_limit = 128M

; Maximum allowed size for uploaded files.
upload_max_filesize = 128M

; Maximum size of POST data that PHP will accept.
post_max_size = 128M

; Defines the default timezone used by the date functions
; http://php.net/date.timezone
date.timezone = 'Europe/Berlin';

That's all ... save the file ''php.ini'' and restart the web server. Now you should look at http://your-server-address/info.php again. I hope that everything will be okay. You will find the version number PHP 5.3.x and the running GD library support. Congratulations ... the first step for Moodle on your Mac server is done!

[[Image:phpinfo.png]]

[[Image:phpinfo2.png]]

==Configure the MySQL database for your Moodle installation==

In standard case the database MySQL is installed on the Mac OS X Server but it is not running yet. Please make sure that you start the MySQL database server.

===Use the graphical way===
Sorry ... there are some more installations and a lot of clicks to configure MySQL in a graphical way.

First of all start the ''Server Admin''. You will find this program by the way ''Applications > Server > Server Admin''. Activate MySQL on the local server. You must set the password for the user ''root'' before you can start MySQL.

For the next you must download the MySQL database administration tool '''phpMyAdmin''' from http://www.phpmyadmin.net . Move the folder to the web server documents as ''/Library/WebServer/Documents/phpMyAdmin''.

Add the security phrase to the file ''config.inc.php'' in between the single quotes on the line $cfg['blowfish_secret'] = ''; /* YOU MUST FILL IN THIS FOR COOKIE AUTH! */

Now you will be able to start http://your-server-address/phpMyAdmin/ in your browser and to log into the database as the user ''root''. Add a database ''moodle19''. Add a database user ''moodle'' to the server ''localhost''. Don't forget to set a secure password. The database user ''moodle'' should be allowed to administrate the database ''moodle19'' only. It is a bad way to set ''root'' to administrate the database ''moodle19''. If you want to install also Moodle 2.0 dev please add a second database ''moodle20'' and use the same database user for it.

phpMyAdmin is a nice thing to look into the database while Moodle is running for some time. It's much easier to see in the graphical interface than in the command line tools. The image shows the database after Moodle 1.9 and Moodle 2.0 were already installed on this server.

[[Image:phpmyadmin.png]]

===Use the Terminal===

If you want a quick installation then don't fear to use the Terminal. It's easier to tell you all the commands for the right way with the Terminal than showing you all the pictures to do the same with graphical tools. There are only a few commands to do everything I told you before.

Start the Terminal. You will find this program by the way ''Applications > Tools > Terminal''. You will see that we must do the same steps as before but you can read them in a text form.

First of all you need to set the root password. If you didn't this before then use the first command line. If you want to change an existing password then use the second one.

Server:~ $ mysqladmin -u root password 'secret'
Server:~ $ mysqladmin -u root -p password 'topsecret'

The next steps are creating a new database ''moodle19'' with correct character set and setting up a database user ''moodle'', with an assigned password (IDENTIFIED BY), to administrate the new database ... and if you want, then do the same for ''moodle20''.

Server:~ $ mysqladmin -u root -p create moodle19
Server:~ $ mysql -u root -p

mysql> ALTER DATABASE moodle19 CHARSET 'utf8';
mysql> GRANT ALL PRIVILEGES ON moodle19.* TO moodle@localhost
-> IDENTIFIED BY 'moodle!';
mysql> quit

Server:~ $

That's really all with the Terminal. You are just ready!

===Use InnoDB with Moodle 2.0===

For Moodle 2.0 you should setup the support for InnoDB in your MySQL database.

Open the file /etc/my.cnf an delete every # in all lines beginning with innodb. This uncomments the InnoDB settings. Please save the file and restart your MySQL database.

# Uncomment the following if you are using InnoDB tables
innodb_data_home_dir = /var/mysql/
innodb_data_file_path = ibdata1:2000M;ibdata2:10M:autoextend
innodb_log_group_home_dir = /var/mysql/
innodb_log_arch_dir = /var/mysql/
# You can set .._buffer_pool_size up to 50 - 80 %
# of RAM but beware of setting memory usage too high
innodb_buffer_pool_size = 384M
innodb_additional_mem_pool_size = 20M
# Set .._log_file_size to 25 % of buffer pool size
innodb_log_file_size = 100M
innodb_log_buffer_size = 8M
innodb_flush_log_at_trx_commit = 1
innodb_lock_wait_timeout = 50

==Copy the Moodle files to the web server==

The documents for the web server are saved in the folder ''/Library/WebServer/Documents/''. You will place your Moodle folder here after you got it from http://download.moodle.org. Download the standard package MOODLE_19_WEEKLY because this is the best choice for new servers. Set the owner ''_www'' for the moodle folder ... this is the user for the web server. The folder permissions should be 755 before the installation and 555 after it's done ... please remember to set this later!

You also need the moodledata folder outside of the Documents folder ... so please make one. Go to the folder ''/Library/WebServer/'' and add the folder ''moodledata''. Because I want to install Moodle 1.9.x and Moodle 2.0 dev together on the same Mac server I add two folders ''moodle19'' and ''moodle20'' inside the moodledata folder. Please set the owner ''_www'' for both folders ''moodle19'' and ''moodle20'' and the folder permissions to 755.

cd /Library/WebServer/
mkdir moodledata
mkdir moodledata/moodle19
mkdir moodledata/moodle20
sudo chown -R _www moodledata
sudo chmod -R 755 moodledata

If you'd like to put the moodledata folder on another volume (not a bad idea if you think you'll have a substantial amount of data within the moodle), note that you cannot simply reference it using the /Volumes/<volume_name>/folder syntax during the moodle setup. Instead, you'll need to create the folder (assigning the user and permissions), then create a '''link''' to it within the /Library/WebServer folder. To create the link, use the following command in a terminal window, substituting your data volume and folder name:

cd /Library/WebServer
ln -s /Volumes/Data_Volume/moodledata moodledata

==Run the Moodle installation==
The installation on the Mac server is the same like the installation on every other server.
Open a web browser to http://your-server-address/moodle/install.php to begin the installation process.
On the screen picture and in the shown config.php you see the web address ''your-server-address'' ... it's only a placeholder for a real address or url ... please set yours. Also a user 'moodle' with a password 'moodle' would be very unsafe settings for your installation.

[[Image:moodle-install1.png]]

[[Image:moodle-install2.png]]

The installer generates the config.php automatically and saves it in the folder ''/Library/WebServer/Documents/moodle19''. Please edit the config.php with a text editor and add the line ''date_default_timezone_set('UTC');''. You may change ''UTC'' to your own timezone ... this is needed for PHP 5.3.0. In case you don't know all the relevant time zone identifiers by heart, there is a [http://phpbuilder.com/manual/en/timezones.php list available online].

<?php /// Moodle Configuration File

unset($CFG);

$CFG->dbtype = 'mysql';
$CFG->dbhost = 'localhost';
$CFG->dbname = 'moodle19';
$CFG->dbuser = 'moodle';
$CFG->dbpass = 'moodle';
$CFG->dbpersist = false;
$CFG->prefix = 'mdl_';

$CFG->wwwroot = 'http://your-server-address/moodle19';
$CFG->dirroot = '/Library/WebServer/Documents/moodle19';
$CFG->dataroot = '/Library/WebServer/moodledata/moodle19';
$CFG->admin = 'admin';

$CFG->directorypermissions = 00777; // try 02777 on a server in Safe Mode

date_default_timezone_set('Europe/Berlin'); // timezone for PHP 5.3.0
require_once("$CFG->dirroot/lib/setup.php");
// MAKE SURE WHEN YOU EDIT THIS FILE THAT THERE ARE NO SPACES, BLANK LINES,
// RETURNS, OR ANYTHING ELSE AFTER THE TWO CHARACTERS ON THE NEXT LINE.
?>

After this, the web-based installation component will walk you through '''several''' screens worth of database configurations and updates, for most of which you'll just click the continue button. You'll set up an admin user and give the site a basic configuration (title, description, etc). When the installation is ready you should change the folder permission for ''/Library/WebServer/Documents/moodle19'' to 555 so the web server is not able to write into this folder again.

==Download the language packages==

==Moodle is running ...==
[[Image:moodle-on-macosx-server.png]]

==How to setup the cron job with launchd==

It's really important to start the cron job every 5 minutes. The cron job assists most of Moodle's modules to perform tasks on a scheduled basis. For example, the discussion forums can only mail out copies of new posts to all subscribers if the cron job tells Moodle to do this.

In Mac OS X you will find the system daemon ''launchd'' for this service. This daemon offers a standardized interface to any user and all programs started automatically by the system. Please look at http://developer.apple.com/macosx/launchd.html for more information about the configurations and all parameters.

In our case the service should get the web page http://your-server-address/moodle19/admin/cron.php every 5 minutes. The configuration will be done by the file named ''moodle4mac.cron.plist'' which must be placed in the system folder ''/Library/LaunchDaemons/'' ... surely you can use any other file name but it should say something about the function of the service. The extension must be ''.plist''. After any reboot of your Mac server the cron service will start automaticly because the file is placed in the correct system folder.

===Use the graphical way===
You can use Lingon to add a new daemon plist or to edit one. It produces the same text as you can write in your text editor. http://sourceforge.net/projects/lingon/files/

[[Image:macosx-lingon.png]]

===Use a text editor===
Please use a text editor to write the needed file. You can open the Terminal and use the system editors vi or pico. But you can also write the text file with any GUI text editor ... I mostly use TextWrangler ... but do NOT take an editor for formatted texts like Microsoft Word or OpenOffice Writer. You must get pure text!

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0//EN"
"http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>KeepAlive</key><false/>
<key>Label</key><string>moodle4mac.cron</string>
<key>ProgramArguments</key>
<array>
<string>curl</string>
<string>-s</string>
<string>http://your-server-address/moodle19/admin/cron.php</string>
</array>
<key>RunAtLoad</key><true />
<key>StartInterval</key><integer>300</integer>
<key>StandardErrorPath</key><string>/dev/null</string>
<key>StandardOutPath</key><string>/dev/null</string>
</dict>
</plist>

The label string must be the same as the file name is but without the extension ''.plist''. Save the text file ''/Library/LaunchDaemons/moodle4mac.cron.plist''. The owner of the file must be set to the system user ''root''. That's all, really!

===How to start and stop the cron service===
You can start the new cron service in the Terminal.

sudo launchctl load /Library/LaunchDaemons/moodle4mac.cron.plist

The following command would stop the service. If you want to activate changes in the cron service you need to ''unload'' and then to ''load'' the daemon again.

sudo launchctl unload /Library/LaunchDaemons/moodle4mac.cron.plist

===Only one service for two servers?===
For my server I needed to have a cron service for to instances ''moodle19'' and ''moodle20'' ... no problem ... with the typo ''moodle[19-20]'' the server will get a cron service for both instances.

<nowiki>curl -s http://your-server-address/moodle[19-20]/admin/cron.php</nowiki>

To see if the cron service works correctly you should look at the ''access.log'' of your web server. The cron.php should be accessed every 5 minutes ... on my server for both Moodle instances ''moodle19'' and ''moodle20'' ... oh yes, it works!!

192.168.0.220 - - [30/Jul/2009:22:10:56 +0200] "GET /moodle19/admin/cron.php HTTP/1.1" 200 1136
192.168.0.220 - - [30/Jul/2009:22:10:57 +0200] "GET /moodle20/admin/cron.php HTTP/1.1" 200 1403
192.168.0.220 - - [30/Jul/2009:22:11:18 +0200] "OPTIONS * HTTP/1.0" 200 -
192.168.0.220 - - [30/Jul/2009:22:15:56 +0200] "GET /moodle19/admin/cron.php HTTP/1.1" 200 735
192.168.0.220 - - [30/Jul/2009:22:15:57 +0200] "GET /moodle20/admin/cron.php HTTP/1.1" 200 964
192.168.0.220 - - [30/Jul/2009:22:20:56 +0200] "GET /moodle19/admin/cron.php HTTP/1.1" 200 1136
192.168.0.220 - - [30/Jul/2009:22:20:57 +0200] "GET /moodle20/admin/cron.php HTTP/1.1" 200 1365

==How to install and update Moodle via CVS==

CVS is very simple way to install and update your Moodle.

The only software you must have installed on your Mac server is the Xcode Tools package from your system installation media. You also must have an internet connection to get the files from the update server. After you installed both script files on your server desktop it only needs a doubleclick to get the newest Moodle version without downloading the complete installation package. Please remember - before you can update your Moodle via CVS you must install Moodle via CVS at once.

That's all .... really .... it's easy!!

===Use the CVS installation script===
If your Moodle is already installed via CVS please use the CVS updater (see below). Running the CVS installer will install only the standard version of Moodle on your server.

If you already have a working Moodle on your server then this script copies the file config.php into your new installation but it does not copy your additional modules or plugins or themes. You will find your old moodle folder in same directory and it will be renamed with an additional date stamp.

<pre>
#! /bin/sh
#
# CVS installer for Moodle
# on a Mac OS X Server
#
# 20100818 - Ralf Krause
#

export CVS_RSH=ssh

### file ~/.cvspass must exist
if ! test -e ~/.cvspass ; then
touch ~/.cvspass
fi

echo
echo "+--------------------------------------------+"
echo "| CVS installer for the Moodle server "
echo "+--------------------------------------------+"
echo

cd /Library/WebServer/Documents

### get the cvs installation into a tmp folder
if ! test -e tmp ; then
sudo mkdir tmp
sudo chmod 777 tmp
fi

echo "Connecting to the CVS server. Download will take a few moments!"
echo "If the CVS update runs too long you may break with <ctrl>-C"
echo

### do the cvs installation
cd tmp
cvs -z9 -d:pserver:anonymous@uk.cvs.moodle.org:/cvsroot/moodle co -P -r MOODLE_19_WEEKLY moodle
cd ..

### copy config.php from your current moodle folder if it exists
if ! test -e moodle/config.php ; then
cp moodle19/config.php tmp/moodle/config.php
fi

### move the new moodle to the right place
DATE=`date +%Y%m%d-%H%M`
sudo mv moodle19 moodle19-$DATE
sudo mv tmp/moodle moodle19
sudo chown -R _www moodle19
</pre>

===Use the CVS update script===
To be able to update Moodle via CVS please check that your Moodle was already installed via CVS (see above).

<pre>
#! /bin/sh
#
# CVS updater for Moodle
# on a Mac OS X Server
#
# 20100818 - Ralf Krause
#

export CVS_RSH=ssh

echo
echo "+--------------------------------------------+"
echo "| CVS updater for the Moodle server "
echo "+--------------------------------------------+"
echo

cd /Library/WebServer/Documents/moodle19/

### file ~/.cvspass must exist
if ! test -e ~/.cvspass ; then
touch ~/.cvspass
fi

### login to the cvs server only for the first time
if ! grep "uk.cvs.moodle.org" ~/.cvspass > /dev/null ; then
echo "CVS password is empty ... please only press <return> to start"
sudo cvs -d :pserver:anonymous@uk.cvs.moodle.org:/cvsroot/moodle login
echo
fi

echo "Connecting to the CVS server. Download will take a few moments!"
echo "If the CVS update runs too long you may break with <ctrl>-C"
echo

### do the cvs installation
sudo cvs -q update -dP -r MOODLE_19_WEEKLY
sudo chown -R _www .
</pre>

Please look at the documentation [https://docs.moodle.org/en/CVS_for_Administrators CVS for Administrators] if you want to learn more about Moodle and CVS. There you will also find a list of different [https://docs.moodle.org/en/CVS_for_Administrators#CVS_Servers CVS servers for Moodle] which you may choose for your updates.

The shown update script should be modified in only three things ... first you need to choose the correct folder for the Moodle files, second choose a CVS server near your server place to minimate internet traffic, and third you must input the correct CVS tag for the Moodle version in the last line. The shown script is for updating the version Moodle 1.9
* Moodle 1.8 uses MOODLE_18_WEEKLY
* Moodle 1.9 uses MOODLE_19_WEEKLY
* Moodle 2.0 RC1 still uses HEAD

===Troubleshooting===

If you see something like this, make sure that there is not some firewall blocking the port (it's 2401):

$ cvs -d:pserver:anonymous@us.cvs.moodle.org:/cvsroot/moodle login
Logging in to :pserver:anonymous@us.cvs.moodle.org:2401/cvsroot/moodle
CVS password:
cvs [login aborted]: connect to us.cvs.moodle.org(130.212.64.111):2401 failed: Connection timed out

===Install Xcode Tools and CVS on your Mac Server===

To test if cvs is already on your Mac Server please open the Terminal and type ''cvs -v''. The output of this command should show a version notice of your Concurrent Versions System (CVS). If you get the ''command not found'' message then you must search for your Mac OS X 10.5 Server installation media. You will find the Xcode Tools on your installation CD or DVD set.

If you can't find your installation media anymore you also can download the Xcode Tools from the URL http://developer.apple.com/tools/xcode/. It is free but you have to register as a developer. Starting the download then the Xcode package copies a lot of bytes on your harddisk and will need a very few minutes to complete.

After you installed the Xcode Tools in your server system you will get the correct version answer from the Terminal command ''cvs -v''. If you only want to update your Moodle you do not need all these nice developer tools from the inside of the folder. Sorry about this but there is no separate installer for the CVS update process.

If cvs does not work on your server please check that the port 2401 is open.
  

==User administration via LDAP==

The following settings will work on 10.5 Server running LDAP - edit them to customize to your own environment. Please note that moodle requires some fields - it is best to have these fields completed in Workgroup Manager on 10.5 Server - otherwise they'll be prompted to enter info into their moodle profile on first login, but the way we've got it set up, moodle can't modify LDAP for security and data integrity. The necessary fields are user name, first name, surname, Email address, City/Town, country, description, ID number.
<pre>
LDAP SERVER SETTINGS
Host URL = ourserver.example.com
Version = 3
LDAP encoding = utf-8

BIND SETTINGS
Hide passwords = Yes
Distinguished Name = (blank)
Password = (blank)

USER LOOKUP SETTINGS
User type = posixAccount (rfc2307)
Contexts = cn=users,dc=ourserver,dc=example,dc=com
Search subcontexts = Yes
Dereference aliases = No
User attribute = (blank)
Member attribute = (blank)
Member attribute uses dn = (blank)
Object class = (blank)

FORCE CHANGE PASSWORD
Force change password = No
Use standard Change Password Page = No
Password format = Plain text
Password change URL = (blank)

LDAP PASSWORD EXPIRATION SETTINGS
Expiration = no
Expiration warning = 10
Expiration attribute = ""
Grace logins = No
Grace login attribute = (blank)

ENABLE USER CREATION
Create users externally = No
Context for new users = (blank)

COURSE CREATOR
Creators = (blank)

CRON SYNCHRONIZATION SCRIPT
Removed ext user = Keep internal

NTLM SSO
Enable = No
Subnet = (blank)
First name = givenName (On every login, Never, Locked)
Surname = sn (On every login, Never, Locked)
Email address = mail (On every login, Never, Locked)
Phone 1 = (blank)
Phone 2 = (blank)
Department = (blank)
Address = (blank)
City/Town = l (On every login, Never, Locked)
Country = c (On every login, Never, Locked)
Description = description (On every login, Never, Locked)
ID number = uidNumber (On every login, Never, Locked)
Language = (blank)
</pre>

==See also==
* [[Complete Install Packages for Mac OS X | Complete install packages for Mac OS X Clients 10.4/10.5/10.6]]
* [[Step-by-step Guide for Installing Moodle on Mac OS X 10.4 Client|Step by step installation on a Mac OS X Client 10.4]]
* [[Cron | Installation of cron for Moodle]]
* [[CVS for Administrators]]

* [http://moodle.org/mod/forum/discuss.php?d=24632 Using Moodle: Dynamic DNS Home Server]

[[Category:Administrator]]
[[Category:Installation]]
[[Category:Mac OS X]]

File:Server-admin-106.png

2010-10-21T14:33:58Z

Krause:

Step by Step Installation on a Mac OS X Server

2010-10-21T14:33:30Z

Krause: /* Configure PHP for your Moodle installation */

==Overview==
This guide shows all steps for the installation of Moodle on a [http://www.apple.com/server/macosx Mac OS X Server]. This server is a commercial product. You will find [http://www.apple.com/server/macosx/resources/documentation.html all documentations] about the web server on the Apple support pages.

This installation guide can't be useful for an installation on MAMP or XAMPP. If you are looking for an easy way to install Moodle on your local machine please use [[Complete Install Packages for Mac OS X | Complete install packages for Mac OS X 10.4/10.5/10.6 Clients]] that can be downloaded from http://download.moodle.org/macosx/ ... but if you are planning to set up a Moodle internet server on a Mac then you should think about some more security as the ever local package could give.

Please feel free to add your ideas and wishes to the discussion page for this article. You may also write a complete chapter if you tried the facts yourself on your own Mac Server. I am most interested to make the things better.

==System requirements==

+ Apple Computer
+ Mac mini, Mac Pro or Xserve
+ Processor: Intel Core 2 Duo, Intel Core i3/i5/i7
+ RAM: 2 GB or better
+ Hard Disk: 500 MB free
+ System Software: Mac OS X Server 10.5 or 10.6

==Configure PHP for your Moodle installation==
===Mac OS X 10.6 Server - No PHP installation needed===

The Mac OS X 10.6.4 Server (SnowLeopard) comes with PHP 5.3.2 and a lot of PHP extensions. This would be the best choice for Moodle 1.9.x and for Moodle 2.0 on a Mac OS X Server. Please forget everything you read about the missing GD Library! The PHP installation is totally complete for Moodle. You only have to switch on the PHP module and to control if the file /etc/php.ini sets the right values for Moodle.

[[Image:Server-admin-106.png]]

===Mac OS X 10.5 Server - Install PHP 5.3.0 and the GD Library===

The Mac OS X 10.5.8 Server (Leopard) comes with PHP 5.2.6 ... this is correct for Moodle 1.9.x. But you have to add the missing GD Library support to get Moodle running on your server. For Moodle 2.0 the server must have PHP 5.2.8 (or better) and some more PHP extensions ... in this case you need to get the better PHP version. These instructions are helpful in both cases.

To see which PHP version and extensions are installed on your server you should edit the file ''/Library/WebServer/Documents/info.php''. You must activate the function call phpinfo() by deleting the both slashes // at the start of the function line. After saving the file you can get all PHP informations in your browser. Please look at http://your-server-address/info.php ... you will not find any GD library support ... bad thing for Moodle!!

<?php
// You can use Server Admin to enable the Apache PHP module; it's disabled by default.
// You can uncomment the phpinfo() directive below to provide a default PHP info page
// but note that this displays information about your host's configuration.
phpinfo();
?>

The easiest way to get the GD library support and to get a better PHP version would be the installation of the complete PHP 5.3.0 package from http://www.entropy.ch/software/macosx/php/. Marc Liyanage precompiled this package to use it on Mac clients and Mac servers. Please get the package and install it by following the instructions on the download page. The installer does everything for you ... it copies PHP into the correct folder ''/usr/local/php5'' and changes its owner to ''root'' automatically. You will find the file php.ini inside the new package folder. Open the file ''/usr/local/php5/lib/php.ini'' and edit some settings for Moodle.

Note: If you want to install Moodle 1.8.x on the server you need to get the Entropy PHP-5.2.9-7.pkg instead. Moodle 1.8.x does not run with PHP 5.3.0. (MDL-20128)

Now the Apache web server must get knowledge that you want to use the new PHP library instead of the old. Open the application Server Admin to switch to the new library. Go to the web server settings and find the entry php5_module. The normal place for PHP the Mac server is ''libexec/apache2/libphp5.so''. Please change to ''/usr/local/php5/libphp5.so'' and save the settings.

[[Image:Server-admin.png]]

===PHP settings in your php.ini===
The second thing to configure is the file php.ini. Most of the settings are okay but not all of them. To communicate to the MySQL database with PHP you have to set the default socket name for local MySQL connects. The default socket name for local MySQLi connects is needed for Moodle 2.0.

If you want to upload any file to your Moodle you should add a little bit more upload size in php.ini. If your server can't use more than 1 GB RAM you should set the memory_limit to a value less than 128M ... but it should have more than 48M for Moodle 1.9 and Moodle 2.0. Note that these sections are not likely to be consecutive in the php.ini file; the quickest way to find each one is search on the initial term (such as 'mysql.default_socket').

; Default socket name for local MySQL connects.
; If empty, uses the built-in MySQL defaults.
mysql.default_socket = /var/mysql/mysql.sock

; Default socket name for local MySQL connects.
; If empty, uses the built-in MySQL defaults.
mysqli.default_socket = /var/mysql/mysql.sock

; Maximum amount of memory a script may consume (128MB)
memory_limit = 128M

; Maximum allowed size for uploaded files.
upload_max_filesize = 128M

; Maximum size of POST data that PHP will accept.
post_max_size = 128M

; Defines the default timezone used by the date functions
; http://php.net/date.timezone
date.timezone = 'Europe/Berlin';

That's all ... save the file php.ini and restart the web server. Now you should look at http://your-server-address/info.php again. I hope that everything will be okay. You will find the version number PHP 5.3.0 and the running GD library support. Congratulations ... the first step for Moodle on your Mac server is done!

[[Image:phpinfo.png]]

[[Image:phpinfo2.png]]

==Configure the MySQL database for your Moodle installation==

In standard case the database MySQL is installed on the Mac OS X Server but it is not running yet. Please make sure that you start the MySQL database server.

===Use the graphical way===
Sorry ... there are some more installations and a lot of clicks to configure MySQL in a graphical way.

First of all start the ''Server Admin''. You will find this program by the way ''Applications > Server > Server Admin''. Activate MySQL on the local server. You must set the password for the user ''root'' before you can start MySQL.

For the next you must download the MySQL database administration tool '''phpMyAdmin''' from http://www.phpmyadmin.net . Move the folder to the web server documents as ''/Library/WebServer/Documents/phpMyAdmin''.

Add the security phrase to the file ''config.inc.php'' in between the single quotes on the line $cfg['blowfish_secret'] = ''; /* YOU MUST FILL IN THIS FOR COOKIE AUTH! */

Now you will be able to start http://your-server-address/phpMyAdmin/ in your browser and to log into the database as the user ''root''. Add a database ''moodle19''. Add a database user ''moodle'' to the server ''localhost''. Don't forget to set a secure password. The database user ''moodle'' should be allowed to administrate the database ''moodle19'' only. It is a bad way to set ''root'' to administrate the database ''moodle19''. If you want to install also Moodle 2.0 dev please add a second database ''moodle20'' and use the same database user for it.

phpMyAdmin is a nice thing to look into the database while Moodle is running for some time. It's much easier to see in the graphical interface than in the command line tools. The image shows the database after Moodle 1.9 and Moodle 2.0 were already installed on this server.

[[Image:phpmyadmin.png]]

===Use the Terminal===

If you want a quick installation then don't fear to use the Terminal. It's easier to tell you all the commands for the right way with the Terminal than showing you all the pictures to do the same with graphical tools. There are only a few commands to do everything I told you before.

Start the Terminal. You will find this program by the way ''Applications > Tools > Terminal''. You will see that we must do the same steps as before but you can read them in a text form.

First of all you need to set the root password. If you didn't this before then use the first command line. If you want to change an existing password then use the second one.

Server:~ $ mysqladmin -u root password 'secret'
Server:~ $ mysqladmin -u root -p password 'topsecret'

The next steps are creating a new database ''moodle19'' with correct character set and setting up a database user ''moodle'', with an assigned password (IDENTIFIED BY), to administrate the new database ... and if you want, then do the same for ''moodle20''.

Server:~ $ mysqladmin -u root -p create moodle19
Server:~ $ mysql -u root -p

mysql> ALTER DATABASE moodle19 CHARSET 'utf8';
mysql> GRANT ALL PRIVILEGES ON moodle19.* TO moodle@localhost
-> IDENTIFIED BY 'moodle!';
mysql> quit

Server:~ $

That's really all with the Terminal. You are just ready!

===Use InnoDB with Moodle 2.0===

For Moodle 2.0 you should setup the support for InnoDB in your MySQL database.

Open the file /etc/my.cnf an delete every # in all lines beginning with innodb. This uncomments the InnoDB settings. Please save the file and restart your MySQL database.

# Uncomment the following if you are using InnoDB tables
innodb_data_home_dir = /var/mysql/
innodb_data_file_path = ibdata1:2000M;ibdata2:10M:autoextend
innodb_log_group_home_dir = /var/mysql/
innodb_log_arch_dir = /var/mysql/
# You can set .._buffer_pool_size up to 50 - 80 %
# of RAM but beware of setting memory usage too high
innodb_buffer_pool_size = 384M
innodb_additional_mem_pool_size = 20M
# Set .._log_file_size to 25 % of buffer pool size
innodb_log_file_size = 100M
innodb_log_buffer_size = 8M
innodb_flush_log_at_trx_commit = 1
innodb_lock_wait_timeout = 50

==Copy the Moodle files to the web server==

The documents for the web server are saved in the folder ''/Library/WebServer/Documents/''. You will place your Moodle folder here after you got it from http://download.moodle.org. Download the standard package MOODLE_19_WEEKLY because this is the best choice for new servers. Set the owner ''_www'' for the moodle folder ... this is the user for the web server. The folder permissions should be 755 before the installation and 555 after it's done ... please remember to set this later!

You also need the moodledata folder outside of the Documents folder ... so please make one. Go to the folder ''/Library/WebServer/'' and add the folder ''moodledata''. Because I want to install Moodle 1.9.x and Moodle 2.0 dev together on the same Mac server I add two folders ''moodle19'' and ''moodle20'' inside the moodledata folder. Please set the owner ''_www'' for both folders ''moodle19'' and ''moodle20'' and the folder permissions to 755.

cd /Library/WebServer/
mkdir moodledata
mkdir moodledata/moodle19
mkdir moodledata/moodle20
sudo chown -R _www moodledata
sudo chmod -R 755 moodledata

If you'd like to put the moodledata folder on another volume (not a bad idea if you think you'll have a substantial amount of data within the moodle), note that you cannot simply reference it using the /Volumes/<volume_name>/folder syntax during the moodle setup. Instead, you'll need to create the folder (assigning the user and permissions), then create a '''link''' to it within the /Library/WebServer folder. To create the link, use the following command in a terminal window, substituting your data volume and folder name:

cd /Library/WebServer
ln -s /Volumes/Data_Volume/moodledata moodledata

==Run the Moodle installation==
The installation on the Mac server is the same like the installation on every other server.
Open a web browser to http://your-server-address/moodle/install.php to begin the installation process.
On the screen picture and in the shown config.php you see the web address ''your-server-address'' ... it's only a placeholder for a real address or url ... please set yours. Also a user 'moodle' with a password 'moodle' would be very unsafe settings for your installation.

[[Image:moodle-install1.png]]

[[Image:moodle-install2.png]]

The installer generates the config.php automatically and saves it in the folder ''/Library/WebServer/Documents/moodle19''. Please edit the config.php with a text editor and add the line ''date_default_timezone_set('UTC');''. You may change ''UTC'' to your own timezone ... this is needed for PHP 5.3.0. In case you don't know all the relevant time zone identifiers by heart, there is a [http://phpbuilder.com/manual/en/timezones.php list available online].

<?php /// Moodle Configuration File

unset($CFG);

$CFG->dbtype = 'mysql';
$CFG->dbhost = 'localhost';
$CFG->dbname = 'moodle19';
$CFG->dbuser = 'moodle';
$CFG->dbpass = 'moodle';
$CFG->dbpersist = false;
$CFG->prefix = 'mdl_';

$CFG->wwwroot = 'http://your-server-address/moodle19';
$CFG->dirroot = '/Library/WebServer/Documents/moodle19';
$CFG->dataroot = '/Library/WebServer/moodledata/moodle19';
$CFG->admin = 'admin';

$CFG->directorypermissions = 00777; // try 02777 on a server in Safe Mode

date_default_timezone_set('Europe/Berlin'); // timezone for PHP 5.3.0
require_once("$CFG->dirroot/lib/setup.php");
// MAKE SURE WHEN YOU EDIT THIS FILE THAT THERE ARE NO SPACES, BLANK LINES,
// RETURNS, OR ANYTHING ELSE AFTER THE TWO CHARACTERS ON THE NEXT LINE.
?>

After this, the web-based installation component will walk you through '''several''' screens worth of database configurations and updates, for most of which you'll just click the continue button. You'll set up an admin user and give the site a basic configuration (title, description, etc). When the installation is ready you should change the folder permission for ''/Library/WebServer/Documents/moodle19'' to 555 so the web server is not able to write into this folder again.

==Download the language packages==

==Moodle is running ...==
[[Image:moodle-on-macosx-server.png]]

==How to setup the cron job with launchd==

It's really important to start the cron job every 5 minutes. The cron job assists most of Moodle's modules to perform tasks on a scheduled basis. For example, the discussion forums can only mail out copies of new posts to all subscribers if the cron job tells Moodle to do this.

In Mac OS X you will find the system daemon ''launchd'' for this service. This daemon offers a standardized interface to any user and all programs started automatically by the system. Please look at http://developer.apple.com/macosx/launchd.html for more information about the configurations and all parameters.

In our case the service should get the web page http://your-server-address/moodle19/admin/cron.php every 5 minutes. The configuration will be done by the file named ''moodle4mac.cron.plist'' which must be placed in the system folder ''/Library/LaunchDaemons/'' ... surely you can use any other file name but it should say something about the function of the service. The extension must be ''.plist''. After any reboot of your Mac server the cron service will start automaticly because the file is placed in the correct system folder.

===Use the graphical way===
You can use Lingon to add a new daemon plist or to edit one. It produces the same text as you can write in your text editor. http://sourceforge.net/projects/lingon/files/

[[Image:macosx-lingon.png]]

===Use a text editor===
Please use a text editor to write the needed file. You can open the Terminal and use the system editors vi or pico. But you can also write the text file with any GUI text editor ... I mostly use TextWrangler ... but do NOT take an editor for formatted texts like Microsoft Word or OpenOffice Writer. You must get pure text!

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0//EN"
"http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>KeepAlive</key><false/>
<key>Label</key><string>moodle4mac.cron</string>
<key>ProgramArguments</key>
<array>
<string>curl</string>
<string>-s</string>
<string>http://your-server-address/moodle19/admin/cron.php</string>
</array>
<key>RunAtLoad</key><true />
<key>StartInterval</key><integer>300</integer>
<key>StandardErrorPath</key><string>/dev/null</string>
<key>StandardOutPath</key><string>/dev/null</string>
</dict>
</plist>

The label string must be the same as the file name is but without the extension ''.plist''. Save the text file ''/Library/LaunchDaemons/moodle4mac.cron.plist''. The owner of the file must be set to the system user ''root''. That's all, really!

===How to start and stop the cron service===
You can start the new cron service in the Terminal.

sudo launchctl load /Library/LaunchDaemons/moodle4mac.cron.plist

The following command would stop the service. If you want to activate changes in the cron service you need to ''unload'' and then to ''load'' the daemon again.

sudo launchctl unload /Library/LaunchDaemons/moodle4mac.cron.plist

===Only one service for two servers?===
For my server I needed to have a cron service for to instances ''moodle19'' and ''moodle20'' ... no problem ... with the typo ''moodle[19-20]'' the server will get a cron service for both instances.

<nowiki>curl -s http://your-server-address/moodle[19-20]/admin/cron.php</nowiki>

To see if the cron service works correctly you should look at the ''access.log'' of your web server. The cron.php should be accessed every 5 minutes ... on my server for both Moodle instances ''moodle19'' and ''moodle20'' ... oh yes, it works!!

192.168.0.220 - - [30/Jul/2009:22:10:56 +0200] "GET /moodle19/admin/cron.php HTTP/1.1" 200 1136
192.168.0.220 - - [30/Jul/2009:22:10:57 +0200] "GET /moodle20/admin/cron.php HTTP/1.1" 200 1403
192.168.0.220 - - [30/Jul/2009:22:11:18 +0200] "OPTIONS * HTTP/1.0" 200 -
192.168.0.220 - - [30/Jul/2009:22:15:56 +0200] "GET /moodle19/admin/cron.php HTTP/1.1" 200 735
192.168.0.220 - - [30/Jul/2009:22:15:57 +0200] "GET /moodle20/admin/cron.php HTTP/1.1" 200 964
192.168.0.220 - - [30/Jul/2009:22:20:56 +0200] "GET /moodle19/admin/cron.php HTTP/1.1" 200 1136
192.168.0.220 - - [30/Jul/2009:22:20:57 +0200] "GET /moodle20/admin/cron.php HTTP/1.1" 200 1365

==How to install and update Moodle via CVS==

CVS is very simple way to install and update your Moodle.

The only software you must have installed on your Mac server is the Xcode Tools package from your system installation media. You also must have an internet connection to get the files from the update server. After you installed both script files on your server desktop it only needs a doubleclick to get the newest Moodle version without downloading the complete installation package. Please remember - before you can update your Moodle via CVS you must install Moodle via CVS at once.

That's all .... really .... it's easy!!

===Use the CVS installation script===
If your Moodle is already installed via CVS please use the CVS updater (see below). Running the CVS installer will install only the standard version of Moodle on your server.

If you already have a working Moodle on your server then this script copies the file config.php into your new installation but it does not copy your additional modules or plugins or themes. You will find your old moodle folder in same directory and it will be renamed with an additional date stamp.

<pre>
#! /bin/sh
#
# CVS installer for Moodle
# on a Mac OS X Server
#
# 20100818 - Ralf Krause
#

export CVS_RSH=ssh

### file ~/.cvspass must exist
if ! test -e ~/.cvspass ; then
touch ~/.cvspass
fi

echo
echo "+--------------------------------------------+"
echo "| CVS installer for the Moodle server "
echo "+--------------------------------------------+"
echo

cd /Library/WebServer/Documents

### get the cvs installation into a tmp folder
if ! test -e tmp ; then
sudo mkdir tmp
sudo chmod 777 tmp
fi

echo "Connecting to the CVS server. Download will take a few moments!"
echo "If the CVS update runs too long you may break with <ctrl>-C"
echo

### do the cvs installation
cd tmp
cvs -z9 -d:pserver:anonymous@uk.cvs.moodle.org:/cvsroot/moodle co -P -r MOODLE_19_WEEKLY moodle
cd ..

### copy config.php from your current moodle folder if it exists
if ! test -e moodle/config.php ; then
cp moodle19/config.php tmp/moodle/config.php
fi

### move the new moodle to the right place
DATE=`date +%Y%m%d-%H%M`
sudo mv moodle19 moodle19-$DATE
sudo mv tmp/moodle moodle19
sudo chown -R _www moodle19
</pre>

===Use the CVS update script===
To be able to update Moodle via CVS please check that your Moodle was already installed via CVS (see above).

<pre>
#! /bin/sh
#
# CVS updater for Moodle
# on a Mac OS X Server
#
# 20100818 - Ralf Krause
#

export CVS_RSH=ssh

echo
echo "+--------------------------------------------+"
echo "| CVS updater for the Moodle server "
echo "+--------------------------------------------+"
echo

cd /Library/WebServer/Documents/moodle19/

### file ~/.cvspass must exist
if ! test -e ~/.cvspass ; then
touch ~/.cvspass
fi

### login to the cvs server only for the first time
if ! grep "uk.cvs.moodle.org" ~/.cvspass > /dev/null ; then
echo "CVS password is empty ... please only press <return> to start"
sudo cvs -d :pserver:anonymous@uk.cvs.moodle.org:/cvsroot/moodle login
echo
fi

echo "Connecting to the CVS server. Download will take a few moments!"
echo "If the CVS update runs too long you may break with <ctrl>-C"
echo

### do the cvs installation
sudo cvs -q update -dP -r MOODLE_19_WEEKLY
sudo chown -R _www .
</pre>

Please look at the documentation [https://docs.moodle.org/en/CVS_for_Administrators CVS for Administrators] if you want to learn more about Moodle and CVS. There you will also find a list of different [https://docs.moodle.org/en/CVS_for_Administrators#CVS_Servers CVS servers for Moodle] which you may choose for your updates.

The shown update script should be modified in only three things ... first you need to choose the correct folder for the Moodle files, second choose a CVS server near your server place to minimate internet traffic, and third you must input the correct CVS tag for the Moodle version in the last line. The shown script is for updating the version Moodle 1.9
* Moodle 1.8 uses MOODLE_18_WEEKLY
* Moodle 1.9 uses MOODLE_19_WEEKLY
* Moodle 2.0 RC1 still uses HEAD

===Troubleshooting===

If you see something like this, make sure that there is not some firewall blocking the port (it's 2401):

$ cvs -d:pserver:anonymous@us.cvs.moodle.org:/cvsroot/moodle login
Logging in to :pserver:anonymous@us.cvs.moodle.org:2401/cvsroot/moodle
CVS password:
cvs [login aborted]: connect to us.cvs.moodle.org(130.212.64.111):2401 failed: Connection timed out

===Install Xcode Tools and CVS on your Mac Server===

To test if cvs is already on your Mac Server please open the Terminal and type ''cvs -v''. The output of this command should show a version notice of your Concurrent Versions System (CVS). If you get the ''command not found'' message then you must search for your Mac OS X 10.5 Server installation media. You will find the Xcode Tools on your installation CD or DVD set.

If you can't find your installation media anymore you also can download the Xcode Tools from the URL http://developer.apple.com/tools/xcode/. It is free but you have to register as a developer. Starting the download then the Xcode package copies a lot of bytes on your harddisk and will need a very few minutes to complete.

After you installed the Xcode Tools in your server system you will get the correct version answer from the Terminal command ''cvs -v''. If you only want to update your Moodle you do not need all these nice developer tools from the inside of the folder. Sorry about this but there is no separate installer for the CVS update process.

If cvs does not work on your server please check that the port 2401 is open.
  

==User administration via LDAP==

The following settings will work on 10.5 Server running LDAP - edit them to customize to your own environment. Please note that moodle requires some fields - it is best to have these fields completed in Workgroup Manager on 10.5 Server - otherwise they'll be prompted to enter info into their moodle profile on first login, but the way we've got it set up, moodle can't modify LDAP for security and data integrity. The necessary fields are user name, first name, surname, Email address, City/Town, country, description, ID number.
<pre>
LDAP SERVER SETTINGS
Host URL = ourserver.example.com
Version = 3
LDAP encoding = utf-8

BIND SETTINGS
Hide passwords = Yes
Distinguished Name = (blank)
Password = (blank)

USER LOOKUP SETTINGS
User type = posixAccount (rfc2307)
Contexts = cn=users,dc=ourserver,dc=example,dc=com
Search subcontexts = Yes
Dereference aliases = No
User attribute = (blank)
Member attribute = (blank)
Member attribute uses dn = (blank)
Object class = (blank)

FORCE CHANGE PASSWORD
Force change password = No
Use standard Change Password Page = No
Password format = Plain text
Password change URL = (blank)

LDAP PASSWORD EXPIRATION SETTINGS
Expiration = no
Expiration warning = 10
Expiration attribute = ""
Grace logins = No
Grace login attribute = (blank)

ENABLE USER CREATION
Create users externally = No
Context for new users = (blank)

COURSE CREATOR
Creators = (blank)

CRON SYNCHRONIZATION SCRIPT
Removed ext user = Keep internal

NTLM SSO
Enable = No
Subnet = (blank)
First name = givenName (On every login, Never, Locked)
Surname = sn (On every login, Never, Locked)
Email address = mail (On every login, Never, Locked)
Phone 1 = (blank)
Phone 2 = (blank)
Department = (blank)
Address = (blank)
City/Town = l (On every login, Never, Locked)
Country = c (On every login, Never, Locked)
Description = description (On every login, Never, Locked)
ID number = uidNumber (On every login, Never, Locked)
Language = (blank)
</pre>

==See also==
* [[Complete Install Packages for Mac OS X | Complete install packages for Mac OS X Clients 10.4/10.5/10.6]]
* [[Step-by-step Guide for Installing Moodle on Mac OS X 10.4 Client|Step by step installation on a Mac OS X Client 10.4]]
* [[Cron | Installation of cron for Moodle]]
* [[CVS for Administrators]]

* [http://moodle.org/mod/forum/discuss.php?d=24632 Using Moodle: Dynamic DNS Home Server]

[[Category:Administrator]]
[[Category:Installation]]
[[Category:Mac OS X]]

Step by Step Installation on a Mac OS X Server

2010-10-21T14:13:22Z

Krause: /* System requirements */

==Overview==
This guide shows all steps for the installation of Moodle on a [http://www.apple.com/server/macosx Mac OS X Server]. This server is a commercial product. You will find [http://www.apple.com/server/macosx/resources/documentation.html all documentations] about the web server on the Apple support pages.

This installation guide can't be useful for an installation on MAMP or XAMPP. If you are looking for an easy way to install Moodle on your local machine please use [[Complete Install Packages for Mac OS X | Complete install packages for Mac OS X 10.4/10.5/10.6 Clients]] that can be downloaded from http://download.moodle.org/macosx/ ... but if you are planning to set up a Moodle internet server on a Mac then you should think about some more security as the ever local package could give.

Please feel free to add your ideas and wishes to the discussion page for this article. You may also write a complete chapter if you tried the facts yourself on your own Mac Server. I am most interested to make the things better.

==System requirements==

+ Apple Computer
+ Mac mini, Mac Pro or Xserve
+ Processor: Intel Core 2 Duo, Intel Core i3/i5/i7
+ RAM: 2 GB or better
+ Hard Disk: 500 MB free
+ System Software: Mac OS X Server 10.5 or 10.6

==Configure PHP for your Moodle installation==
===Mac OS X 10.6 Server - No PHP installation needed===

The Mac OS X 10.6.4 Server (SnowLeopard) comes with PHP 5.3.2 and a lot of PHP extensions. This would be the best choice for Moodle 1.9.x and for Moodle 2.0 on a Mac OS X Server. Please forget everything you read about the missing GD Library! The PHP installation is totally complete for Moodle. You only have to control if the PHP module is switched on and if the php.ini does the right settings. You should open the file /etc/php.ini and control the settings for Moodle.

===Mac OS X 10.5 Server - Install PHP 5.3.0 and the GD Library===

The Mac OS X 10.5.8 Server (Leopard) comes with PHP 5.2.6 ... this is correct for Moodle 1.9.x. But you have to add the missing GD Library support to get Moodle running on your server. For Moodle 2.0 the server must have PHP 5.2.8 (or better) and some more PHP extensions ... in this case you need to get the better PHP version. These instructions are helpful in both cases.

To see which PHP version and extensions are installed on your server you should edit the file ''/Library/WebServer/Documents/info.php''. You must activate the function call phpinfo() by deleting the both slashes // at the start of the function line. After saving the file you can get all PHP informations in your browser. Please look at http://your-server-address/info.php ... you will not find any GD library support ... bad thing for Moodle!!

<?php
// You can use Server Admin to enable the Apache PHP module; it's disabled by default.
// You can uncomment the phpinfo() directive below to provide a default PHP info page
// but note that this displays information about your host's configuration.
phpinfo();
?>

The easiest way to get the GD library support and to get a better PHP version would be the installation of the complete PHP 5.3.0 package from http://www.entropy.ch/software/macosx/php/. Marc Liyanage precompiled this package to use it on Mac clients and Mac servers. Please get the package and install it by following the instructions on the download page. The installer does everything for you ... it copies PHP into the correct folder ''/usr/local/php5'' and changes its owner to ''root'' automatically. You will find the file php.ini inside the new package folder. Open the file ''/usr/local/php5/lib/php.ini'' and edit some settings for Moodle.

Note: If you want to install Moodle 1.8.x on the server you need to get the Entropy PHP-5.2.9-7.pkg instead. Moodle 1.8.x does not run with PHP 5.3.0. (MDL-20128)

Now the Apache web server must get knowledge that you want to use the new PHP library instead of the old. Open the application Server Admin to switch to the new library. Go to the web server settings and find the entry php5_module. The normal place for PHP the Mac server is ''libexec/apache2/libphp5.so''. Please change to ''/usr/local/php5/libphp5.so'' and save the settings.

[[Image:Server-admin.png]]

===PHP settings in your php.ini===
The second thing to configure is the file php.ini. Most of the settings are okay but not all of them. To communicate to the MySQL database with PHP you have to set the default socket name for local MySQL connects. The default socket name for local MySQLi connects is needed for Moodle 2.0.

If you want to upload any file to your Moodle you should add a little bit more upload size in php.ini. If your server can't use more than 1 GB RAM you should set the memory_limit to a value less than 128M ... but it should have more than 48M for Moodle 1.9 and Moodle 2.0. Note that these sections are not likely to be consecutive in the php.ini file; the quickest way to find each one is search on the initial term (such as 'mysql.default_socket').

; Default socket name for local MySQL connects.
; If empty, uses the built-in MySQL defaults.
mysql.default_socket = /var/mysql/mysql.sock

; Default socket name for local MySQL connects.
; If empty, uses the built-in MySQL defaults.
mysqli.default_socket = /var/mysql/mysql.sock

; Maximum amount of memory a script may consume (128MB)
memory_limit = 128M

; Maximum allowed size for uploaded files.
upload_max_filesize = 128M

; Maximum size of POST data that PHP will accept.
post_max_size = 128M

; Defines the default timezone used by the date functions
; http://php.net/date.timezone
date.timezone = 'Europe/Berlin';

That's all ... save the file php.ini and restart the web server. Now you should look at http://your-server-address/info.php again. I hope that everything will be okay. You will find the version number PHP 5.3.0 and the running GD library support. Congratulations ... the first step for Moodle on your Mac server is done!

[[Image:phpinfo.png]]

[[Image:phpinfo2.png]]

==Configure the MySQL database for your Moodle installation==

In standard case the database MySQL is installed on the Mac OS X Server but it is not running yet. Please make sure that you start the MySQL database server.

===Use the graphical way===
Sorry ... there are some more installations and a lot of clicks to configure MySQL in a graphical way.

First of all start the ''Server Admin''. You will find this program by the way ''Applications > Server > Server Admin''. Activate MySQL on the local server. You must set the password for the user ''root'' before you can start MySQL.

For the next you must download the MySQL database administration tool '''phpMyAdmin''' from http://www.phpmyadmin.net . Move the folder to the web server documents as ''/Library/WebServer/Documents/phpMyAdmin''.

Add the security phrase to the file ''config.inc.php'' in between the single quotes on the line $cfg['blowfish_secret'] = ''; /* YOU MUST FILL IN THIS FOR COOKIE AUTH! */

Now you will be able to start http://your-server-address/phpMyAdmin/ in your browser and to log into the database as the user ''root''. Add a database ''moodle19''. Add a database user ''moodle'' to the server ''localhost''. Don't forget to set a secure password. The database user ''moodle'' should be allowed to administrate the database ''moodle19'' only. It is a bad way to set ''root'' to administrate the database ''moodle19''. If you want to install also Moodle 2.0 dev please add a second database ''moodle20'' and use the same database user for it.

phpMyAdmin is a nice thing to look into the database while Moodle is running for some time. It's much easier to see in the graphical interface than in the command line tools. The image shows the database after Moodle 1.9 and Moodle 2.0 were already installed on this server.

[[Image:phpmyadmin.png]]

===Use the Terminal===

If you want a quick installation then don't fear to use the Terminal. It's easier to tell you all the commands for the right way with the Terminal than showing you all the pictures to do the same with graphical tools. There are only a few commands to do everything I told you before.

Start the Terminal. You will find this program by the way ''Applications > Tools > Terminal''. You will see that we must do the same steps as before but you can read them in a text form.

First of all you need to set the root password. If you didn't this before then use the first command line. If you want to change an existing password then use the second one.

Server:~ $ mysqladmin -u root password 'secret'
Server:~ $ mysqladmin -u root -p password 'topsecret'

The next steps are creating a new database ''moodle19'' with correct character set and setting up a database user ''moodle'', with an assigned password (IDENTIFIED BY), to administrate the new database ... and if you want, then do the same for ''moodle20''.

Server:~ $ mysqladmin -u root -p create moodle19
Server:~ $ mysql -u root -p

mysql> ALTER DATABASE moodle19 CHARSET 'utf8';
mysql> GRANT ALL PRIVILEGES ON moodle19.* TO moodle@localhost
-> IDENTIFIED BY 'moodle!';
mysql> quit

Server:~ $

That's really all with the Terminal. You are just ready!

===Use InnoDB with Moodle 2.0===

For Moodle 2.0 you should setup the support for InnoDB in your MySQL database.

Open the file /etc/my.cnf an delete every # in all lines beginning with innodb. This uncomments the InnoDB settings. Please save the file and restart your MySQL database.

# Uncomment the following if you are using InnoDB tables
innodb_data_home_dir = /var/mysql/
innodb_data_file_path = ibdata1:2000M;ibdata2:10M:autoextend
innodb_log_group_home_dir = /var/mysql/
innodb_log_arch_dir = /var/mysql/
# You can set .._buffer_pool_size up to 50 - 80 %
# of RAM but beware of setting memory usage too high
innodb_buffer_pool_size = 384M
innodb_additional_mem_pool_size = 20M
# Set .._log_file_size to 25 % of buffer pool size
innodb_log_file_size = 100M
innodb_log_buffer_size = 8M
innodb_flush_log_at_trx_commit = 1
innodb_lock_wait_timeout = 50

==Copy the Moodle files to the web server==

The documents for the web server are saved in the folder ''/Library/WebServer/Documents/''. You will place your Moodle folder here after you got it from http://download.moodle.org. Download the standard package MOODLE_19_WEEKLY because this is the best choice for new servers. Set the owner ''_www'' for the moodle folder ... this is the user for the web server. The folder permissions should be 755 before the installation and 555 after it's done ... please remember to set this later!

You also need the moodledata folder outside of the Documents folder ... so please make one. Go to the folder ''/Library/WebServer/'' and add the folder ''moodledata''. Because I want to install Moodle 1.9.x and Moodle 2.0 dev together on the same Mac server I add two folders ''moodle19'' and ''moodle20'' inside the moodledata folder. Please set the owner ''_www'' for both folders ''moodle19'' and ''moodle20'' and the folder permissions to 755.

cd /Library/WebServer/
mkdir moodledata
mkdir moodledata/moodle19
mkdir moodledata/moodle20
sudo chown -R _www moodledata
sudo chmod -R 755 moodledata

If you'd like to put the moodledata folder on another volume (not a bad idea if you think you'll have a substantial amount of data within the moodle), note that you cannot simply reference it using the /Volumes/<volume_name>/folder syntax during the moodle setup. Instead, you'll need to create the folder (assigning the user and permissions), then create a '''link''' to it within the /Library/WebServer folder. To create the link, use the following command in a terminal window, substituting your data volume and folder name:

cd /Library/WebServer
ln -s /Volumes/Data_Volume/moodledata moodledata

==Run the Moodle installation==
The installation on the Mac server is the same like the installation on every other server.
Open a web browser to http://your-server-address/moodle/install.php to begin the installation process.
On the screen picture and in the shown config.php you see the web address ''your-server-address'' ... it's only a placeholder for a real address or url ... please set yours. Also a user 'moodle' with a password 'moodle' would be very unsafe settings for your installation.

[[Image:moodle-install1.png]]

[[Image:moodle-install2.png]]

The installer generates the config.php automatically and saves it in the folder ''/Library/WebServer/Documents/moodle19''. Please edit the config.php with a text editor and add the line ''date_default_timezone_set('UTC');''. You may change ''UTC'' to your own timezone ... this is needed for PHP 5.3.0. In case you don't know all the relevant time zone identifiers by heart, there is a [http://phpbuilder.com/manual/en/timezones.php list available online].

<?php /// Moodle Configuration File

unset($CFG);

$CFG->dbtype = 'mysql';
$CFG->dbhost = 'localhost';
$CFG->dbname = 'moodle19';
$CFG->dbuser = 'moodle';
$CFG->dbpass = 'moodle';
$CFG->dbpersist = false;
$CFG->prefix = 'mdl_';

$CFG->wwwroot = 'http://your-server-address/moodle19';
$CFG->dirroot = '/Library/WebServer/Documents/moodle19';
$CFG->dataroot = '/Library/WebServer/moodledata/moodle19';
$CFG->admin = 'admin';

$CFG->directorypermissions = 00777; // try 02777 on a server in Safe Mode

date_default_timezone_set('Europe/Berlin'); // timezone for PHP 5.3.0
require_once("$CFG->dirroot/lib/setup.php");
// MAKE SURE WHEN YOU EDIT THIS FILE THAT THERE ARE NO SPACES, BLANK LINES,
// RETURNS, OR ANYTHING ELSE AFTER THE TWO CHARACTERS ON THE NEXT LINE.
?>

After this, the web-based installation component will walk you through '''several''' screens worth of database configurations and updates, for most of which you'll just click the continue button. You'll set up an admin user and give the site a basic configuration (title, description, etc). When the installation is ready you should change the folder permission for ''/Library/WebServer/Documents/moodle19'' to 555 so the web server is not able to write into this folder again.

==Download the language packages==

==Moodle is running ...==
[[Image:moodle-on-macosx-server.png]]

==How to setup the cron job with launchd==

It's really important to start the cron job every 5 minutes. The cron job assists most of Moodle's modules to perform tasks on a scheduled basis. For example, the discussion forums can only mail out copies of new posts to all subscribers if the cron job tells Moodle to do this.

In Mac OS X you will find the system daemon ''launchd'' for this service. This daemon offers a standardized interface to any user and all programs started automatically by the system. Please look at http://developer.apple.com/macosx/launchd.html for more information about the configurations and all parameters.

In our case the service should get the web page http://your-server-address/moodle19/admin/cron.php every 5 minutes. The configuration will be done by the file named ''moodle4mac.cron.plist'' which must be placed in the system folder ''/Library/LaunchDaemons/'' ... surely you can use any other file name but it should say something about the function of the service. The extension must be ''.plist''. After any reboot of your Mac server the cron service will start automaticly because the file is placed in the correct system folder.

===Use the graphical way===
You can use Lingon to add a new daemon plist or to edit one. It produces the same text as you can write in your text editor. http://sourceforge.net/projects/lingon/files/

[[Image:macosx-lingon.png]]

===Use a text editor===
Please use a text editor to write the needed file. You can open the Terminal and use the system editors vi or pico. But you can also write the text file with any GUI text editor ... I mostly use TextWrangler ... but do NOT take an editor for formatted texts like Microsoft Word or OpenOffice Writer. You must get pure text!

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0//EN"
"http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>KeepAlive</key><false/>
<key>Label</key><string>moodle4mac.cron</string>
<key>ProgramArguments</key>
<array>
<string>curl</string>
<string>-s</string>
<string>http://your-server-address/moodle19/admin/cron.php</string>
</array>
<key>RunAtLoad</key><true />
<key>StartInterval</key><integer>300</integer>
<key>StandardErrorPath</key><string>/dev/null</string>
<key>StandardOutPath</key><string>/dev/null</string>
</dict>
</plist>

The label string must be the same as the file name is but without the extension ''.plist''. Save the text file ''/Library/LaunchDaemons/moodle4mac.cron.plist''. The owner of the file must be set to the system user ''root''. That's all, really!

===How to start and stop the cron service===
You can start the new cron service in the Terminal.

sudo launchctl load /Library/LaunchDaemons/moodle4mac.cron.plist

The following command would stop the service. If you want to activate changes in the cron service you need to ''unload'' and then to ''load'' the daemon again.

sudo launchctl unload /Library/LaunchDaemons/moodle4mac.cron.plist

===Only one service for two servers?===
For my server I needed to have a cron service for to instances ''moodle19'' and ''moodle20'' ... no problem ... with the typo ''moodle[19-20]'' the server will get a cron service for both instances.

<nowiki>curl -s http://your-server-address/moodle[19-20]/admin/cron.php</nowiki>

To see if the cron service works correctly you should look at the ''access.log'' of your web server. The cron.php should be accessed every 5 minutes ... on my server for both Moodle instances ''moodle19'' and ''moodle20'' ... oh yes, it works!!

192.168.0.220 - - [30/Jul/2009:22:10:56 +0200] "GET /moodle19/admin/cron.php HTTP/1.1" 200 1136
192.168.0.220 - - [30/Jul/2009:22:10:57 +0200] "GET /moodle20/admin/cron.php HTTP/1.1" 200 1403
192.168.0.220 - - [30/Jul/2009:22:11:18 +0200] "OPTIONS * HTTP/1.0" 200 -
192.168.0.220 - - [30/Jul/2009:22:15:56 +0200] "GET /moodle19/admin/cron.php HTTP/1.1" 200 735
192.168.0.220 - - [30/Jul/2009:22:15:57 +0200] "GET /moodle20/admin/cron.php HTTP/1.1" 200 964
192.168.0.220 - - [30/Jul/2009:22:20:56 +0200] "GET /moodle19/admin/cron.php HTTP/1.1" 200 1136
192.168.0.220 - - [30/Jul/2009:22:20:57 +0200] "GET /moodle20/admin/cron.php HTTP/1.1" 200 1365

==How to install and update Moodle via CVS==

CVS is very simple way to install and update your Moodle.

The only software you must have installed on your Mac server is the Xcode Tools package from your system installation media. You also must have an internet connection to get the files from the update server. After you installed both script files on your server desktop it only needs a doubleclick to get the newest Moodle version without downloading the complete installation package. Please remember - before you can update your Moodle via CVS you must install Moodle via CVS at once.

That's all .... really .... it's easy!!

===Use the CVS installation script===
If your Moodle is already installed via CVS please use the CVS updater (see below). Running the CVS installer will install only the standard version of Moodle on your server.

If you already have a working Moodle on your server then this script copies the file config.php into your new installation but it does not copy your additional modules or plugins or themes. You will find your old moodle folder in same directory and it will be renamed with an additional date stamp.

<pre>
#! /bin/sh
#
# CVS installer for Moodle
# on a Mac OS X Server
#
# 20100818 - Ralf Krause
#

export CVS_RSH=ssh

### file ~/.cvspass must exist
if ! test -e ~/.cvspass ; then
touch ~/.cvspass
fi

echo
echo "+--------------------------------------------+"
echo "| CVS installer for the Moodle server "
echo "+--------------------------------------------+"
echo

cd /Library/WebServer/Documents

### get the cvs installation into a tmp folder
if ! test -e tmp ; then
sudo mkdir tmp
sudo chmod 777 tmp
fi

echo "Connecting to the CVS server. Download will take a few moments!"
echo "If the CVS update runs too long you may break with <ctrl>-C"
echo

### do the cvs installation
cd tmp
cvs -z9 -d:pserver:anonymous@uk.cvs.moodle.org:/cvsroot/moodle co -P -r MOODLE_19_WEEKLY moodle
cd ..

### copy config.php from your current moodle folder if it exists
if ! test -e moodle/config.php ; then
cp moodle19/config.php tmp/moodle/config.php
fi

### move the new moodle to the right place
DATE=`date +%Y%m%d-%H%M`
sudo mv moodle19 moodle19-$DATE
sudo mv tmp/moodle moodle19
sudo chown -R _www moodle19
</pre>

===Use the CVS update script===
To be able to update Moodle via CVS please check that your Moodle was already installed via CVS (see above).

<pre>
#! /bin/sh
#
# CVS updater for Moodle
# on a Mac OS X Server
#
# 20100818 - Ralf Krause
#

export CVS_RSH=ssh

echo
echo "+--------------------------------------------+"
echo "| CVS updater for the Moodle server "
echo "+--------------------------------------------+"
echo

cd /Library/WebServer/Documents/moodle19/

### file ~/.cvspass must exist
if ! test -e ~/.cvspass ; then
touch ~/.cvspass
fi

### login to the cvs server only for the first time
if ! grep "uk.cvs.moodle.org" ~/.cvspass > /dev/null ; then
echo "CVS password is empty ... please only press <return> to start"
sudo cvs -d :pserver:anonymous@uk.cvs.moodle.org:/cvsroot/moodle login
echo
fi

echo "Connecting to the CVS server. Download will take a few moments!"
echo "If the CVS update runs too long you may break with <ctrl>-C"
echo

### do the cvs installation
sudo cvs -q update -dP -r MOODLE_19_WEEKLY
sudo chown -R _www .
</pre>

Please look at the documentation [https://docs.moodle.org/en/CVS_for_Administrators CVS for Administrators] if you want to learn more about Moodle and CVS. There you will also find a list of different [https://docs.moodle.org/en/CVS_for_Administrators#CVS_Servers CVS servers for Moodle] which you may choose for your updates.

The shown update script should be modified in only three things ... first you need to choose the correct folder for the Moodle files, second choose a CVS server near your server place to minimate internet traffic, and third you must input the correct CVS tag for the Moodle version in the last line. The shown script is for updating the version Moodle 1.9
* Moodle 1.8 uses MOODLE_18_WEEKLY
* Moodle 1.9 uses MOODLE_19_WEEKLY
* Moodle 2.0 RC1 still uses HEAD

===Troubleshooting===

If you see something like this, make sure that there is not some firewall blocking the port (it's 2401):

$ cvs -d:pserver:anonymous@us.cvs.moodle.org:/cvsroot/moodle login
Logging in to :pserver:anonymous@us.cvs.moodle.org:2401/cvsroot/moodle
CVS password:
cvs [login aborted]: connect to us.cvs.moodle.org(130.212.64.111):2401 failed: Connection timed out

===Install Xcode Tools and CVS on your Mac Server===

To test if cvs is already on your Mac Server please open the Terminal and type ''cvs -v''. The output of this command should show a version notice of your Concurrent Versions System (CVS). If you get the ''command not found'' message then you must search for your Mac OS X 10.5 Server installation media. You will find the Xcode Tools on your installation CD or DVD set.

If you can't find your installation media anymore you also can download the Xcode Tools from the URL http://developer.apple.com/tools/xcode/. It is free but you have to register as a developer. Starting the download then the Xcode package copies a lot of bytes on your harddisk and will need a very few minutes to complete.

After you installed the Xcode Tools in your server system you will get the correct version answer from the Terminal command ''cvs -v''. If you only want to update your Moodle you do not need all these nice developer tools from the inside of the folder. Sorry about this but there is no separate installer for the CVS update process.

If cvs does not work on your server please check that the port 2401 is open.
  

==User administration via LDAP==

The following settings will work on 10.5 Server running LDAP - edit them to customize to your own environment. Please note that moodle requires some fields - it is best to have these fields completed in Workgroup Manager on 10.5 Server - otherwise they'll be prompted to enter info into their moodle profile on first login, but the way we've got it set up, moodle can't modify LDAP for security and data integrity. The necessary fields are user name, first name, surname, Email address, City/Town, country, description, ID number.
<pre>
LDAP SERVER SETTINGS
Host URL = ourserver.example.com
Version = 3
LDAP encoding = utf-8

BIND SETTINGS
Hide passwords = Yes
Distinguished Name = (blank)
Password = (blank)

USER LOOKUP SETTINGS
User type = posixAccount (rfc2307)
Contexts = cn=users,dc=ourserver,dc=example,dc=com
Search subcontexts = Yes
Dereference aliases = No
User attribute = (blank)
Member attribute = (blank)
Member attribute uses dn = (blank)
Object class = (blank)

FORCE CHANGE PASSWORD
Force change password = No
Use standard Change Password Page = No
Password format = Plain text
Password change URL = (blank)

LDAP PASSWORD EXPIRATION SETTINGS
Expiration = no
Expiration warning = 10
Expiration attribute = ""
Grace logins = No
Grace login attribute = (blank)

ENABLE USER CREATION
Create users externally = No
Context for new users = (blank)

COURSE CREATOR
Creators = (blank)

CRON SYNCHRONIZATION SCRIPT
Removed ext user = Keep internal

NTLM SSO
Enable = No
Subnet = (blank)
First name = givenName (On every login, Never, Locked)
Surname = sn (On every login, Never, Locked)
Email address = mail (On every login, Never, Locked)
Phone 1 = (blank)
Phone 2 = (blank)
Department = (blank)
Address = (blank)
City/Town = l (On every login, Never, Locked)
Country = c (On every login, Never, Locked)
Description = description (On every login, Never, Locked)
ID number = uidNumber (On every login, Never, Locked)
Language = (blank)
</pre>

==See also==
* [[Complete Install Packages for Mac OS X | Complete install packages for Mac OS X Clients 10.4/10.5/10.6]]
* [[Step-by-step Guide for Installing Moodle on Mac OS X 10.4 Client|Step by step installation on a Mac OS X Client 10.4]]
* [[Cron | Installation of cron for Moodle]]
* [[CVS for Administrators]]

* [http://moodle.org/mod/forum/discuss.php?d=24632 Using Moodle: Dynamic DNS Home Server]

[[Category:Administrator]]
[[Category:Installation]]
[[Category:Mac OS X]]

Step by Step Installation on a Mac OS X Server

2010-10-21T14:06:51Z

Krause: /* Use the Terminal */

==Overview==
This guide shows all steps for the installation of Moodle on a [http://www.apple.com/server/macosx Mac OS X Server]. This server is a commercial product. You will find [http://www.apple.com/server/macosx/resources/documentation.html all documentations] about the web server on the Apple support pages.

This installation guide can't be useful for an installation on MAMP or XAMPP. If you are looking for an easy way to install Moodle on your local machine please use [[Complete Install Packages for Mac OS X | Complete install packages for Mac OS X 10.4/10.5/10.6 Clients]] that can be downloaded from http://download.moodle.org/macosx/ ... but if you are planning to set up a Moodle internet server on a Mac then you should think about some more security as the ever local package could give.

Please feel free to add your ideas and wishes to the discussion page for this article. You may also write a complete chapter if you tried the facts yourself on your own Mac Server. I am most interested to make the things better.

==System requirements==

+ Apple Computer
+ Mac mini, Mac Pro or Xserve
+ Processor: Intel Core 2 Duo, i5, i7
+ RAM: 2 GB or better
+ Hard Disk: 500 MB free
+ System Software: Mac OS X Server 10.5 or 10.6

==Configure PHP for your Moodle installation==
===Mac OS X 10.6 Server - No PHP installation needed===

The Mac OS X 10.6.4 Server (SnowLeopard) comes with PHP 5.3.2 and a lot of PHP extensions. This would be the best choice for Moodle 1.9.x and for Moodle 2.0 on a Mac OS X Server. Please forget everything you read about the missing GD Library! The PHP installation is totally complete for Moodle. You only have to control if the PHP module is switched on and if the php.ini does the right settings. You should open the file /etc/php.ini and control the settings for Moodle.

===Mac OS X 10.5 Server - Install PHP 5.3.0 and the GD Library===

The Mac OS X 10.5.8 Server (Leopard) comes with PHP 5.2.6 ... this is correct for Moodle 1.9.x. But you have to add the missing GD Library support to get Moodle running on your server. For Moodle 2.0 the server must have PHP 5.2.8 (or better) and some more PHP extensions ... in this case you need to get the better PHP version. These instructions are helpful in both cases.

To see which PHP version and extensions are installed on your server you should edit the file ''/Library/WebServer/Documents/info.php''. You must activate the function call phpinfo() by deleting the both slashes // at the start of the function line. After saving the file you can get all PHP informations in your browser. Please look at http://your-server-address/info.php ... you will not find any GD library support ... bad thing for Moodle!!

<?php
// You can use Server Admin to enable the Apache PHP module; it's disabled by default.
// You can uncomment the phpinfo() directive below to provide a default PHP info page
// but note that this displays information about your host's configuration.
phpinfo();
?>

The easiest way to get the GD library support and to get a better PHP version would be the installation of the complete PHP 5.3.0 package from http://www.entropy.ch/software/macosx/php/. Marc Liyanage precompiled this package to use it on Mac clients and Mac servers. Please get the package and install it by following the instructions on the download page. The installer does everything for you ... it copies PHP into the correct folder ''/usr/local/php5'' and changes its owner to ''root'' automatically. You will find the file php.ini inside the new package folder. Open the file ''/usr/local/php5/lib/php.ini'' and edit some settings for Moodle.

Note: If you want to install Moodle 1.8.x on the server you need to get the Entropy PHP-5.2.9-7.pkg instead. Moodle 1.8.x does not run with PHP 5.3.0. (MDL-20128)

Now the Apache web server must get knowledge that you want to use the new PHP library instead of the old. Open the application Server Admin to switch to the new library. Go to the web server settings and find the entry php5_module. The normal place for PHP the Mac server is ''libexec/apache2/libphp5.so''. Please change to ''/usr/local/php5/libphp5.so'' and save the settings.

[[Image:Server-admin.png]]

===PHP settings in your php.ini===
The second thing to configure is the file php.ini. Most of the settings are okay but not all of them. To communicate to the MySQL database with PHP you have to set the default socket name for local MySQL connects. The default socket name for local MySQLi connects is needed for Moodle 2.0.

If you want to upload any file to your Moodle you should add a little bit more upload size in php.ini. If your server can't use more than 1 GB RAM you should set the memory_limit to a value less than 128M ... but it should have more than 48M for Moodle 1.9 and Moodle 2.0. Note that these sections are not likely to be consecutive in the php.ini file; the quickest way to find each one is search on the initial term (such as 'mysql.default_socket').

; Default socket name for local MySQL connects.
; If empty, uses the built-in MySQL defaults.
mysql.default_socket = /var/mysql/mysql.sock

; Default socket name for local MySQL connects.
; If empty, uses the built-in MySQL defaults.
mysqli.default_socket = /var/mysql/mysql.sock

; Maximum amount of memory a script may consume (128MB)
memory_limit = 128M

; Maximum allowed size for uploaded files.
upload_max_filesize = 128M

; Maximum size of POST data that PHP will accept.
post_max_size = 128M

; Defines the default timezone used by the date functions
; http://php.net/date.timezone
date.timezone = 'Europe/Berlin';

That's all ... save the file php.ini and restart the web server. Now you should look at http://your-server-address/info.php again. I hope that everything will be okay. You will find the version number PHP 5.3.0 and the running GD library support. Congratulations ... the first step for Moodle on your Mac server is done!

[[Image:phpinfo.png]]

[[Image:phpinfo2.png]]

==Configure the MySQL database for your Moodle installation==

In standard case the database MySQL is installed on the Mac OS X Server but it is not running yet. Please make sure that you start the MySQL database server.

===Use the graphical way===
Sorry ... there are some more installations and a lot of clicks to configure MySQL in a graphical way.

First of all start the ''Server Admin''. You will find this program by the way ''Applications > Server > Server Admin''. Activate MySQL on the local server. You must set the password for the user ''root'' before you can start MySQL.

For the next you must download the MySQL database administration tool '''phpMyAdmin''' from http://www.phpmyadmin.net . Move the folder to the web server documents as ''/Library/WebServer/Documents/phpMyAdmin''.

Add the security phrase to the file ''config.inc.php'' in between the single quotes on the line $cfg['blowfish_secret'] = ''; /* YOU MUST FILL IN THIS FOR COOKIE AUTH! */

Now you will be able to start http://your-server-address/phpMyAdmin/ in your browser and to log into the database as the user ''root''. Add a database ''moodle19''. Add a database user ''moodle'' to the server ''localhost''. Don't forget to set a secure password. The database user ''moodle'' should be allowed to administrate the database ''moodle19'' only. It is a bad way to set ''root'' to administrate the database ''moodle19''. If you want to install also Moodle 2.0 dev please add a second database ''moodle20'' and use the same database user for it.

phpMyAdmin is a nice thing to look into the database while Moodle is running for some time. It's much easier to see in the graphical interface than in the command line tools. The image shows the database after Moodle 1.9 and Moodle 2.0 were already installed on this server.

[[Image:phpmyadmin.png]]

===Use the Terminal===

If you want a quick installation then don't fear to use the Terminal. It's easier to tell you all the commands for the right way with the Terminal than showing you all the pictures to do the same with graphical tools. There are only a few commands to do everything I told you before.

Start the Terminal. You will find this program by the way ''Applications > Tools > Terminal''. You will see that we must do the same steps as before but you can read them in a text form.

First of all you need to set the root password. If you didn't this before then use the first command line. If you want to change an existing password then use the second one.

Server:~ $ mysqladmin -u root password 'secret'
Server:~ $ mysqladmin -u root -p password 'topsecret'

The next steps are creating a new database ''moodle19'' with correct character set and setting up a database user ''moodle'', with an assigned password (IDENTIFIED BY), to administrate the new database ... and if you want, then do the same for ''moodle20''.

Server:~ $ mysqladmin -u root -p create moodle19
Server:~ $ mysql -u root -p

mysql> ALTER DATABASE moodle19 CHARSET 'utf8';
mysql> GRANT ALL PRIVILEGES ON moodle19.* TO moodle@localhost
-> IDENTIFIED BY 'moodle!';
mysql> quit

Server:~ $

That's really all with the Terminal. You are just ready!

===Use InnoDB with Moodle 2.0===

For Moodle 2.0 you should setup the support for InnoDB in your MySQL database.

Open the file /etc/my.cnf an delete every # in all lines beginning with innodb. This uncomments the InnoDB settings. Please save the file and restart your MySQL database.

# Uncomment the following if you are using InnoDB tables
innodb_data_home_dir = /var/mysql/
innodb_data_file_path = ibdata1:2000M;ibdata2:10M:autoextend
innodb_log_group_home_dir = /var/mysql/
innodb_log_arch_dir = /var/mysql/
# You can set .._buffer_pool_size up to 50 - 80 %
# of RAM but beware of setting memory usage too high
innodb_buffer_pool_size = 384M
innodb_additional_mem_pool_size = 20M
# Set .._log_file_size to 25 % of buffer pool size
innodb_log_file_size = 100M
innodb_log_buffer_size = 8M
innodb_flush_log_at_trx_commit = 1
innodb_lock_wait_timeout = 50

==Copy the Moodle files to the web server==

The documents for the web server are saved in the folder ''/Library/WebServer/Documents/''. You will place your Moodle folder here after you got it from http://download.moodle.org. Download the standard package MOODLE_19_WEEKLY because this is the best choice for new servers. Set the owner ''_www'' for the moodle folder ... this is the user for the web server. The folder permissions should be 755 before the installation and 555 after it's done ... please remember to set this later!

You also need the moodledata folder outside of the Documents folder ... so please make one. Go to the folder ''/Library/WebServer/'' and add the folder ''moodledata''. Because I want to install Moodle 1.9.x and Moodle 2.0 dev together on the same Mac server I add two folders ''moodle19'' and ''moodle20'' inside the moodledata folder. Please set the owner ''_www'' for both folders ''moodle19'' and ''moodle20'' and the folder permissions to 755.

cd /Library/WebServer/
mkdir moodledata
mkdir moodledata/moodle19
mkdir moodledata/moodle20
sudo chown -R _www moodledata
sudo chmod -R 755 moodledata

If you'd like to put the moodledata folder on another volume (not a bad idea if you think you'll have a substantial amount of data within the moodle), note that you cannot simply reference it using the /Volumes/<volume_name>/folder syntax during the moodle setup. Instead, you'll need to create the folder (assigning the user and permissions), then create a '''link''' to it within the /Library/WebServer folder. To create the link, use the following command in a terminal window, substituting your data volume and folder name:

cd /Library/WebServer
ln -s /Volumes/Data_Volume/moodledata moodledata

==Run the Moodle installation==
The installation on the Mac server is the same like the installation on every other server.
Open a web browser to http://your-server-address/moodle/install.php to begin the installation process.
On the screen picture and in the shown config.php you see the web address ''your-server-address'' ... it's only a placeholder for a real address or url ... please set yours. Also a user 'moodle' with a password 'moodle' would be very unsafe settings for your installation.

[[Image:moodle-install1.png]]

[[Image:moodle-install2.png]]

The installer generates the config.php automatically and saves it in the folder ''/Library/WebServer/Documents/moodle19''. Please edit the config.php with a text editor and add the line ''date_default_timezone_set('UTC');''. You may change ''UTC'' to your own timezone ... this is needed for PHP 5.3.0. In case you don't know all the relevant time zone identifiers by heart, there is a [http://phpbuilder.com/manual/en/timezones.php list available online].

<?php /// Moodle Configuration File

unset($CFG);

$CFG->dbtype = 'mysql';
$CFG->dbhost = 'localhost';
$CFG->dbname = 'moodle19';
$CFG->dbuser = 'moodle';
$CFG->dbpass = 'moodle';
$CFG->dbpersist = false;
$CFG->prefix = 'mdl_';

$CFG->wwwroot = 'http://your-server-address/moodle19';
$CFG->dirroot = '/Library/WebServer/Documents/moodle19';
$CFG->dataroot = '/Library/WebServer/moodledata/moodle19';
$CFG->admin = 'admin';

$CFG->directorypermissions = 00777; // try 02777 on a server in Safe Mode

date_default_timezone_set('Europe/Berlin'); // timezone for PHP 5.3.0
require_once("$CFG->dirroot/lib/setup.php");
// MAKE SURE WHEN YOU EDIT THIS FILE THAT THERE ARE NO SPACES, BLANK LINES,
// RETURNS, OR ANYTHING ELSE AFTER THE TWO CHARACTERS ON THE NEXT LINE.
?>

After this, the web-based installation component will walk you through '''several''' screens worth of database configurations and updates, for most of which you'll just click the continue button. You'll set up an admin user and give the site a basic configuration (title, description, etc). When the installation is ready you should change the folder permission for ''/Library/WebServer/Documents/moodle19'' to 555 so the web server is not able to write into this folder again.

==Download the language packages==

==Moodle is running ...==
[[Image:moodle-on-macosx-server.png]]

==How to setup the cron job with launchd==

It's really important to start the cron job every 5 minutes. The cron job assists most of Moodle's modules to perform tasks on a scheduled basis. For example, the discussion forums can only mail out copies of new posts to all subscribers if the cron job tells Moodle to do this.

In Mac OS X you will find the system daemon ''launchd'' for this service. This daemon offers a standardized interface to any user and all programs started automatically by the system. Please look at http://developer.apple.com/macosx/launchd.html for more information about the configurations and all parameters.

In our case the service should get the web page http://your-server-address/moodle19/admin/cron.php every 5 minutes. The configuration will be done by the file named ''moodle4mac.cron.plist'' which must be placed in the system folder ''/Library/LaunchDaemons/'' ... surely you can use any other file name but it should say something about the function of the service. The extension must be ''.plist''. After any reboot of your Mac server the cron service will start automaticly because the file is placed in the correct system folder.

===Use the graphical way===
You can use Lingon to add a new daemon plist or to edit one. It produces the same text as you can write in your text editor. http://sourceforge.net/projects/lingon/files/

[[Image:macosx-lingon.png]]

===Use a text editor===
Please use a text editor to write the needed file. You can open the Terminal and use the system editors vi or pico. But you can also write the text file with any GUI text editor ... I mostly use TextWrangler ... but do NOT take an editor for formatted texts like Microsoft Word or OpenOffice Writer. You must get pure text!

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0//EN"
"http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>KeepAlive</key><false/>
<key>Label</key><string>moodle4mac.cron</string>
<key>ProgramArguments</key>
<array>
<string>curl</string>
<string>-s</string>
<string>http://your-server-address/moodle19/admin/cron.php</string>
</array>
<key>RunAtLoad</key><true />
<key>StartInterval</key><integer>300</integer>
<key>StandardErrorPath</key><string>/dev/null</string>
<key>StandardOutPath</key><string>/dev/null</string>
</dict>
</plist>

The label string must be the same as the file name is but without the extension ''.plist''. Save the text file ''/Library/LaunchDaemons/moodle4mac.cron.plist''. The owner of the file must be set to the system user ''root''. That's all, really!

===How to start and stop the cron service===
You can start the new cron service in the Terminal.

sudo launchctl load /Library/LaunchDaemons/moodle4mac.cron.plist

The following command would stop the service. If you want to activate changes in the cron service you need to ''unload'' and then to ''load'' the daemon again.

sudo launchctl unload /Library/LaunchDaemons/moodle4mac.cron.plist

===Only one service for two servers?===
For my server I needed to have a cron service for to instances ''moodle19'' and ''moodle20'' ... no problem ... with the typo ''moodle[19-20]'' the server will get a cron service for both instances.

<nowiki>curl -s http://your-server-address/moodle[19-20]/admin/cron.php</nowiki>

To see if the cron service works correctly you should look at the ''access.log'' of your web server. The cron.php should be accessed every 5 minutes ... on my server for both Moodle instances ''moodle19'' and ''moodle20'' ... oh yes, it works!!

192.168.0.220 - - [30/Jul/2009:22:10:56 +0200] "GET /moodle19/admin/cron.php HTTP/1.1" 200 1136
192.168.0.220 - - [30/Jul/2009:22:10:57 +0200] "GET /moodle20/admin/cron.php HTTP/1.1" 200 1403
192.168.0.220 - - [30/Jul/2009:22:11:18 +0200] "OPTIONS * HTTP/1.0" 200 -
192.168.0.220 - - [30/Jul/2009:22:15:56 +0200] "GET /moodle19/admin/cron.php HTTP/1.1" 200 735
192.168.0.220 - - [30/Jul/2009:22:15:57 +0200] "GET /moodle20/admin/cron.php HTTP/1.1" 200 964
192.168.0.220 - - [30/Jul/2009:22:20:56 +0200] "GET /moodle19/admin/cron.php HTTP/1.1" 200 1136
192.168.0.220 - - [30/Jul/2009:22:20:57 +0200] "GET /moodle20/admin/cron.php HTTP/1.1" 200 1365

==How to install and update Moodle via CVS==

CVS is very simple way to install and update your Moodle.

The only software you must have installed on your Mac server is the Xcode Tools package from your system installation media. You also must have an internet connection to get the files from the update server. After you installed both script files on your server desktop it only needs a doubleclick to get the newest Moodle version without downloading the complete installation package. Please remember - before you can update your Moodle via CVS you must install Moodle via CVS at once.

That's all .... really .... it's easy!!

===Use the CVS installation script===
If your Moodle is already installed via CVS please use the CVS updater (see below). Running the CVS installer will install only the standard version of Moodle on your server.

If you already have a working Moodle on your server then this script copies the file config.php into your new installation but it does not copy your additional modules or plugins or themes. You will find your old moodle folder in same directory and it will be renamed with an additional date stamp.

<pre>
#! /bin/sh
#
# CVS installer for Moodle
# on a Mac OS X Server
#
# 20100818 - Ralf Krause
#

export CVS_RSH=ssh

### file ~/.cvspass must exist
if ! test -e ~/.cvspass ; then
touch ~/.cvspass
fi

echo
echo "+--------------------------------------------+"
echo "| CVS installer for the Moodle server "
echo "+--------------------------------------------+"
echo

cd /Library/WebServer/Documents

### get the cvs installation into a tmp folder
if ! test -e tmp ; then
sudo mkdir tmp
sudo chmod 777 tmp
fi

echo "Connecting to the CVS server. Download will take a few moments!"
echo "If the CVS update runs too long you may break with <ctrl>-C"
echo

### do the cvs installation
cd tmp
cvs -z9 -d:pserver:anonymous@uk.cvs.moodle.org:/cvsroot/moodle co -P -r MOODLE_19_WEEKLY moodle
cd ..

### copy config.php from your current moodle folder if it exists
if ! test -e moodle/config.php ; then
cp moodle19/config.php tmp/moodle/config.php
fi

### move the new moodle to the right place
DATE=`date +%Y%m%d-%H%M`
sudo mv moodle19 moodle19-$DATE
sudo mv tmp/moodle moodle19
sudo chown -R _www moodle19
</pre>

===Use the CVS update script===
To be able to update Moodle via CVS please check that your Moodle was already installed via CVS (see above).

<pre>
#! /bin/sh
#
# CVS updater for Moodle
# on a Mac OS X Server
#
# 20100818 - Ralf Krause
#

export CVS_RSH=ssh

echo
echo "+--------------------------------------------+"
echo "| CVS updater for the Moodle server "
echo "+--------------------------------------------+"
echo

cd /Library/WebServer/Documents/moodle19/

### file ~/.cvspass must exist
if ! test -e ~/.cvspass ; then
touch ~/.cvspass
fi

### login to the cvs server only for the first time
if ! grep "uk.cvs.moodle.org" ~/.cvspass > /dev/null ; then
echo "CVS password is empty ... please only press <return> to start"
sudo cvs -d :pserver:anonymous@uk.cvs.moodle.org:/cvsroot/moodle login
echo
fi

echo "Connecting to the CVS server. Download will take a few moments!"
echo "If the CVS update runs too long you may break with <ctrl>-C"
echo

### do the cvs installation
sudo cvs -q update -dP -r MOODLE_19_WEEKLY
sudo chown -R _www .
</pre>

Please look at the documentation [https://docs.moodle.org/en/CVS_for_Administrators CVS for Administrators] if you want to learn more about Moodle and CVS. There you will also find a list of different [https://docs.moodle.org/en/CVS_for_Administrators#CVS_Servers CVS servers for Moodle] which you may choose for your updates.

The shown update script should be modified in only three things ... first you need to choose the correct folder for the Moodle files, second choose a CVS server near your server place to minimate internet traffic, and third you must input the correct CVS tag for the Moodle version in the last line. The shown script is for updating the version Moodle 1.9
* Moodle 1.8 uses MOODLE_18_WEEKLY
* Moodle 1.9 uses MOODLE_19_WEEKLY
* Moodle 2.0 RC1 still uses HEAD

===Troubleshooting===

If you see something like this, make sure that there is not some firewall blocking the port (it's 2401):

$ cvs -d:pserver:anonymous@us.cvs.moodle.org:/cvsroot/moodle login
Logging in to :pserver:anonymous@us.cvs.moodle.org:2401/cvsroot/moodle
CVS password:
cvs [login aborted]: connect to us.cvs.moodle.org(130.212.64.111):2401 failed: Connection timed out

===Install Xcode Tools and CVS on your Mac Server===

To test if cvs is already on your Mac Server please open the Terminal and type ''cvs -v''. The output of this command should show a version notice of your Concurrent Versions System (CVS). If you get the ''command not found'' message then you must search for your Mac OS X 10.5 Server installation media. You will find the Xcode Tools on your installation CD or DVD set.

If you can't find your installation media anymore you also can download the Xcode Tools from the URL http://developer.apple.com/tools/xcode/. It is free but you have to register as a developer. Starting the download then the Xcode package copies a lot of bytes on your harddisk and will need a very few minutes to complete.

After you installed the Xcode Tools in your server system you will get the correct version answer from the Terminal command ''cvs -v''. If you only want to update your Moodle you do not need all these nice developer tools from the inside of the folder. Sorry about this but there is no separate installer for the CVS update process.

If cvs does not work on your server please check that the port 2401 is open.
  

==User administration via LDAP==

The following settings will work on 10.5 Server running LDAP - edit them to customize to your own environment. Please note that moodle requires some fields - it is best to have these fields completed in Workgroup Manager on 10.5 Server - otherwise they'll be prompted to enter info into their moodle profile on first login, but the way we've got it set up, moodle can't modify LDAP for security and data integrity. The necessary fields are user name, first name, surname, Email address, City/Town, country, description, ID number.
<pre>
LDAP SERVER SETTINGS
Host URL = ourserver.example.com
Version = 3
LDAP encoding = utf-8

BIND SETTINGS
Hide passwords = Yes
Distinguished Name = (blank)
Password = (blank)

USER LOOKUP SETTINGS
User type = posixAccount (rfc2307)
Contexts = cn=users,dc=ourserver,dc=example,dc=com
Search subcontexts = Yes
Dereference aliases = No
User attribute = (blank)
Member attribute = (blank)
Member attribute uses dn = (blank)
Object class = (blank)

FORCE CHANGE PASSWORD
Force change password = No
Use standard Change Password Page = No
Password format = Plain text
Password change URL = (blank)

LDAP PASSWORD EXPIRATION SETTINGS
Expiration = no
Expiration warning = 10
Expiration attribute = ""
Grace logins = No
Grace login attribute = (blank)

ENABLE USER CREATION
Create users externally = No
Context for new users = (blank)

COURSE CREATOR
Creators = (blank)

CRON SYNCHRONIZATION SCRIPT
Removed ext user = Keep internal

NTLM SSO
Enable = No
Subnet = (blank)
First name = givenName (On every login, Never, Locked)
Surname = sn (On every login, Never, Locked)
Email address = mail (On every login, Never, Locked)
Phone 1 = (blank)
Phone 2 = (blank)
Department = (blank)
Address = (blank)
City/Town = l (On every login, Never, Locked)
Country = c (On every login, Never, Locked)
Description = description (On every login, Never, Locked)
ID number = uidNumber (On every login, Never, Locked)
Language = (blank)
</pre>

==See also==
* [[Complete Install Packages for Mac OS X | Complete install packages for Mac OS X Clients 10.4/10.5/10.6]]
* [[Step-by-step Guide for Installing Moodle on Mac OS X 10.4 Client|Step by step installation on a Mac OS X Client 10.4]]
* [[Cron | Installation of cron for Moodle]]
* [[CVS for Administrators]]

* [http://moodle.org/mod/forum/discuss.php?d=24632 Using Moodle: Dynamic DNS Home Server]

[[Category:Administrator]]
[[Category:Installation]]
[[Category:Mac OS X]]

Step by Step Installation on a Mac OS X Server

2010-10-21T14:06:09Z

Krause: /* Use the Terminal */

==Overview==
This guide shows all steps for the installation of Moodle on a [http://www.apple.com/server/macosx Mac OS X Server]. This server is a commercial product. You will find [http://www.apple.com/server/macosx/resources/documentation.html all documentations] about the web server on the Apple support pages.

This installation guide can't be useful for an installation on MAMP or XAMPP. If you are looking for an easy way to install Moodle on your local machine please use [[Complete Install Packages for Mac OS X | Complete install packages for Mac OS X 10.4/10.5/10.6 Clients]] that can be downloaded from http://download.moodle.org/macosx/ ... but if you are planning to set up a Moodle internet server on a Mac then you should think about some more security as the ever local package could give.

Please feel free to add your ideas and wishes to the discussion page for this article. You may also write a complete chapter if you tried the facts yourself on your own Mac Server. I am most interested to make the things better.

==System requirements==

+ Apple Computer
+ Mac mini, Mac Pro or Xserve
+ Processor: Intel Core 2 Duo, i5, i7
+ RAM: 2 GB or better
+ Hard Disk: 500 MB free
+ System Software: Mac OS X Server 10.5 or 10.6

==Configure PHP for your Moodle installation==
===Mac OS X 10.6 Server - No PHP installation needed===

The Mac OS X 10.6.4 Server (SnowLeopard) comes with PHP 5.3.2 and a lot of PHP extensions. This would be the best choice for Moodle 1.9.x and for Moodle 2.0 on a Mac OS X Server. Please forget everything you read about the missing GD Library! The PHP installation is totally complete for Moodle. You only have to control if the PHP module is switched on and if the php.ini does the right settings. You should open the file /etc/php.ini and control the settings for Moodle.

===Mac OS X 10.5 Server - Install PHP 5.3.0 and the GD Library===

The Mac OS X 10.5.8 Server (Leopard) comes with PHP 5.2.6 ... this is correct for Moodle 1.9.x. But you have to add the missing GD Library support to get Moodle running on your server. For Moodle 2.0 the server must have PHP 5.2.8 (or better) and some more PHP extensions ... in this case you need to get the better PHP version. These instructions are helpful in both cases.

To see which PHP version and extensions are installed on your server you should edit the file ''/Library/WebServer/Documents/info.php''. You must activate the function call phpinfo() by deleting the both slashes // at the start of the function line. After saving the file you can get all PHP informations in your browser. Please look at http://your-server-address/info.php ... you will not find any GD library support ... bad thing for Moodle!!

<?php
// You can use Server Admin to enable the Apache PHP module; it's disabled by default.
// You can uncomment the phpinfo() directive below to provide a default PHP info page
// but note that this displays information about your host's configuration.
phpinfo();
?>

The easiest way to get the GD library support and to get a better PHP version would be the installation of the complete PHP 5.3.0 package from http://www.entropy.ch/software/macosx/php/. Marc Liyanage precompiled this package to use it on Mac clients and Mac servers. Please get the package and install it by following the instructions on the download page. The installer does everything for you ... it copies PHP into the correct folder ''/usr/local/php5'' and changes its owner to ''root'' automatically. You will find the file php.ini inside the new package folder. Open the file ''/usr/local/php5/lib/php.ini'' and edit some settings for Moodle.

Note: If you want to install Moodle 1.8.x on the server you need to get the Entropy PHP-5.2.9-7.pkg instead. Moodle 1.8.x does not run with PHP 5.3.0. (MDL-20128)

Now the Apache web server must get knowledge that you want to use the new PHP library instead of the old. Open the application Server Admin to switch to the new library. Go to the web server settings and find the entry php5_module. The normal place for PHP the Mac server is ''libexec/apache2/libphp5.so''. Please change to ''/usr/local/php5/libphp5.so'' and save the settings.

[[Image:Server-admin.png]]

===PHP settings in your php.ini===
The second thing to configure is the file php.ini. Most of the settings are okay but not all of them. To communicate to the MySQL database with PHP you have to set the default socket name for local MySQL connects. The default socket name for local MySQLi connects is needed for Moodle 2.0.

If you want to upload any file to your Moodle you should add a little bit more upload size in php.ini. If your server can't use more than 1 GB RAM you should set the memory_limit to a value less than 128M ... but it should have more than 48M for Moodle 1.9 and Moodle 2.0. Note that these sections are not likely to be consecutive in the php.ini file; the quickest way to find each one is search on the initial term (such as 'mysql.default_socket').

; Default socket name for local MySQL connects.
; If empty, uses the built-in MySQL defaults.
mysql.default_socket = /var/mysql/mysql.sock

; Default socket name for local MySQL connects.
; If empty, uses the built-in MySQL defaults.
mysqli.default_socket = /var/mysql/mysql.sock

; Maximum amount of memory a script may consume (128MB)
memory_limit = 128M

; Maximum allowed size for uploaded files.
upload_max_filesize = 128M

; Maximum size of POST data that PHP will accept.
post_max_size = 128M

; Defines the default timezone used by the date functions
; http://php.net/date.timezone
date.timezone = 'Europe/Berlin';

That's all ... save the file php.ini and restart the web server. Now you should look at http://your-server-address/info.php again. I hope that everything will be okay. You will find the version number PHP 5.3.0 and the running GD library support. Congratulations ... the first step for Moodle on your Mac server is done!

[[Image:phpinfo.png]]

[[Image:phpinfo2.png]]

==Configure the MySQL database for your Moodle installation==

In standard case the database MySQL is installed on the Mac OS X Server but it is not running yet. Please make sure that you start the MySQL database server.

===Use the graphical way===
Sorry ... there are some more installations and a lot of clicks to configure MySQL in a graphical way.

First of all start the ''Server Admin''. You will find this program by the way ''Applications > Server > Server Admin''. Activate MySQL on the local server. You must set the password for the user ''root'' before you can start MySQL.

For the next you must download the MySQL database administration tool '''phpMyAdmin''' from http://www.phpmyadmin.net . Move the folder to the web server documents as ''/Library/WebServer/Documents/phpMyAdmin''.

Add the security phrase to the file ''config.inc.php'' in between the single quotes on the line $cfg['blowfish_secret'] = ''; /* YOU MUST FILL IN THIS FOR COOKIE AUTH! */

Now you will be able to start http://your-server-address/phpMyAdmin/ in your browser and to log into the database as the user ''root''. Add a database ''moodle19''. Add a database user ''moodle'' to the server ''localhost''. Don't forget to set a secure password. The database user ''moodle'' should be allowed to administrate the database ''moodle19'' only. It is a bad way to set ''root'' to administrate the database ''moodle19''. If you want to install also Moodle 2.0 dev please add a second database ''moodle20'' and use the same database user for it.

phpMyAdmin is a nice thing to look into the database while Moodle is running for some time. It's much easier to see in the graphical interface than in the command line tools. The image shows the database after Moodle 1.9 and Moodle 2.0 were already installed on this server.

[[Image:phpmyadmin.png]]

===Use the Terminal===

If you want a quick installation then don't fear to use the Terminal. It's easier to tell you all the commands for the right way with the Terminal than showing you all the pictures to do the same with graphical tools. There are only a few commands to do everything I told you before.

Start the Terminal. You will find this program by the way ''Applications > Tools > Terminal''. You will see that we must do the same steps as before but you can read them in a text form.

First of all you need to set the root password. If you didn't this before then use the first command line. If you want to change an existing password then use the second one.

Server:~ $ mysqladmin -u root password 'secret'
Server:~ $ mysqladmin -u root -p password 'topsecret'

The next steps are creating a new database ''moodle19'' with correct character set and setting up a database user ''moodle'', with an assigned password (IDENTIFIED BY), to administrate the new database ... and if you want, then do the same for ''moodle20''.

Server:~ $ mysqladmin -u root -p create moodle19
Server:~ $ mysql -u root -p

mysql> ALTER DATABASE moodle19 CHARSET 'utf8';
mysql> GRANT ALL PRIVILEGES ON moodle19.* TO moodle@localhost
-> IDENTIFIED BY 'moodle!';
mysql> quit

Server:~ $

That's really all with the Terminal. You are just ready!

===Use InnoDB with Moodle 2.0===

For Moodle 2.0 you should setup the support for InnoDB in your MySQL database.

Open the file /etc/my.cnf an delete every # in all lines beginning with innodb. This uncomments the InnoDB settings. Please save the file and restart your MySQL database.

# Uncomment the following if you are using InnoDB tables
innodb_data_home_dir = /var/mysql/
innodb_data_file_path = ibdata1:2000M;ibdata2:10M:autoextend
innodb_log_group_home_dir = /var/mysql/
innodb_log_arch_dir = /var/mysql/
# You can set .._buffer_pool_size up to 50 - 80 %
# of RAM but beware of setting memory usage too high
innodb_buffer_pool_size = 384M
innodb_additional_mem_pool_size = 20M
# Set .._log_file_size to 25 % of buffer pool size
innodb_log_file_size = 100M
innodb_log_buffer_size = 8M
innodb_flush_log_at_trx_commit = 1
innodb_lock_wait_timeout = 50

==Copy the Moodle files to the web server==

The documents for the web server are saved in the folder ''/Library/WebServer/Documents/''. You will place your Moodle folder here after you got it from http://download.moodle.org. Download the standard package MOODLE_19_WEEKLY because this is the best choice for new servers. Set the owner ''_www'' for the moodle folder ... this is the user for the web server. The folder permissions should be 755 before the installation and 555 after it's done ... please remember to set this later!

You also need the moodledata folder outside of the Documents folder ... so please make one. Go to the folder ''/Library/WebServer/'' and add the folder ''moodledata''. Because I want to install Moodle 1.9.x and Moodle 2.0 dev together on the same Mac server I add two folders ''moodle19'' and ''moodle20'' inside the moodledata folder. Please set the owner ''_www'' for both folders ''moodle19'' and ''moodle20'' and the folder permissions to 755.

cd /Library/WebServer/
mkdir moodledata
mkdir moodledata/moodle19
mkdir moodledata/moodle20
sudo chown -R _www moodledata
sudo chmod -R 755 moodledata

If you'd like to put the moodledata folder on another volume (not a bad idea if you think you'll have a substantial amount of data within the moodle), note that you cannot simply reference it using the /Volumes/<volume_name>/folder syntax during the moodle setup. Instead, you'll need to create the folder (assigning the user and permissions), then create a '''link''' to it within the /Library/WebServer folder. To create the link, use the following command in a terminal window, substituting your data volume and folder name:

cd /Library/WebServer
ln -s /Volumes/Data_Volume/moodledata moodledata

==Run the Moodle installation==
The installation on the Mac server is the same like the installation on every other server.
Open a web browser to http://your-server-address/moodle/install.php to begin the installation process.
On the screen picture and in the shown config.php you see the web address ''your-server-address'' ... it's only a placeholder for a real address or url ... please set yours. Also a user 'moodle' with a password 'moodle' would be very unsafe settings for your installation.

[[Image:moodle-install1.png]]

[[Image:moodle-install2.png]]

The installer generates the config.php automatically and saves it in the folder ''/Library/WebServer/Documents/moodle19''. Please edit the config.php with a text editor and add the line ''date_default_timezone_set('UTC');''. You may change ''UTC'' to your own timezone ... this is needed for PHP 5.3.0. In case you don't know all the relevant time zone identifiers by heart, there is a [http://phpbuilder.com/manual/en/timezones.php list available online].

<?php /// Moodle Configuration File

unset($CFG);

$CFG->dbtype = 'mysql';
$CFG->dbhost = 'localhost';
$CFG->dbname = 'moodle19';
$CFG->dbuser = 'moodle';
$CFG->dbpass = 'moodle';
$CFG->dbpersist = false;
$CFG->prefix = 'mdl_';

$CFG->wwwroot = 'http://your-server-address/moodle19';
$CFG->dirroot = '/Library/WebServer/Documents/moodle19';
$CFG->dataroot = '/Library/WebServer/moodledata/moodle19';
$CFG->admin = 'admin';

$CFG->directorypermissions = 00777; // try 02777 on a server in Safe Mode

date_default_timezone_set('Europe/Berlin'); // timezone for PHP 5.3.0
require_once("$CFG->dirroot/lib/setup.php");
// MAKE SURE WHEN YOU EDIT THIS FILE THAT THERE ARE NO SPACES, BLANK LINES,
// RETURNS, OR ANYTHING ELSE AFTER THE TWO CHARACTERS ON THE NEXT LINE.
?>

After this, the web-based installation component will walk you through '''several''' screens worth of database configurations and updates, for most of which you'll just click the continue button. You'll set up an admin user and give the site a basic configuration (title, description, etc). When the installation is ready you should change the folder permission for ''/Library/WebServer/Documents/moodle19'' to 555 so the web server is not able to write into this folder again.

==Download the language packages==

==Moodle is running ...==
[[Image:moodle-on-macosx-server.png]]

==How to setup the cron job with launchd==

It's really important to start the cron job every 5 minutes. The cron job assists most of Moodle's modules to perform tasks on a scheduled basis. For example, the discussion forums can only mail out copies of new posts to all subscribers if the cron job tells Moodle to do this.

In Mac OS X you will find the system daemon ''launchd'' for this service. This daemon offers a standardized interface to any user and all programs started automatically by the system. Please look at http://developer.apple.com/macosx/launchd.html for more information about the configurations and all parameters.

In our case the service should get the web page http://your-server-address/moodle19/admin/cron.php every 5 minutes. The configuration will be done by the file named ''moodle4mac.cron.plist'' which must be placed in the system folder ''/Library/LaunchDaemons/'' ... surely you can use any other file name but it should say something about the function of the service. The extension must be ''.plist''. After any reboot of your Mac server the cron service will start automaticly because the file is placed in the correct system folder.

===Use the graphical way===
You can use Lingon to add a new daemon plist or to edit one. It produces the same text as you can write in your text editor. http://sourceforge.net/projects/lingon/files/

[[Image:macosx-lingon.png]]

===Use a text editor===
Please use a text editor to write the needed file. You can open the Terminal and use the system editors vi or pico. But you can also write the text file with any GUI text editor ... I mostly use TextWrangler ... but do NOT take an editor for formatted texts like Microsoft Word or OpenOffice Writer. You must get pure text!

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0//EN"
"http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>KeepAlive</key><false/>
<key>Label</key><string>moodle4mac.cron</string>
<key>ProgramArguments</key>
<array>
<string>curl</string>
<string>-s</string>
<string>http://your-server-address/moodle19/admin/cron.php</string>
</array>
<key>RunAtLoad</key><true />
<key>StartInterval</key><integer>300</integer>
<key>StandardErrorPath</key><string>/dev/null</string>
<key>StandardOutPath</key><string>/dev/null</string>
</dict>
</plist>

The label string must be the same as the file name is but without the extension ''.plist''. Save the text file ''/Library/LaunchDaemons/moodle4mac.cron.plist''. The owner of the file must be set to the system user ''root''. That's all, really!

===How to start and stop the cron service===
You can start the new cron service in the Terminal.

sudo launchctl load /Library/LaunchDaemons/moodle4mac.cron.plist

The following command would stop the service. If you want to activate changes in the cron service you need to ''unload'' and then to ''load'' the daemon again.

sudo launchctl unload /Library/LaunchDaemons/moodle4mac.cron.plist

===Only one service for two servers?===
For my server I needed to have a cron service for to instances ''moodle19'' and ''moodle20'' ... no problem ... with the typo ''moodle[19-20]'' the server will get a cron service for both instances.

<nowiki>curl -s http://your-server-address/moodle[19-20]/admin/cron.php</nowiki>

To see if the cron service works correctly you should look at the ''access.log'' of your web server. The cron.php should be accessed every 5 minutes ... on my server for both Moodle instances ''moodle19'' and ''moodle20'' ... oh yes, it works!!

192.168.0.220 - - [30/Jul/2009:22:10:56 +0200] "GET /moodle19/admin/cron.php HTTP/1.1" 200 1136
192.168.0.220 - - [30/Jul/2009:22:10:57 +0200] "GET /moodle20/admin/cron.php HTTP/1.1" 200 1403
192.168.0.220 - - [30/Jul/2009:22:11:18 +0200] "OPTIONS * HTTP/1.0" 200 -
192.168.0.220 - - [30/Jul/2009:22:15:56 +0200] "GET /moodle19/admin/cron.php HTTP/1.1" 200 735
192.168.0.220 - - [30/Jul/2009:22:15:57 +0200] "GET /moodle20/admin/cron.php HTTP/1.1" 200 964
192.168.0.220 - - [30/Jul/2009:22:20:56 +0200] "GET /moodle19/admin/cron.php HTTP/1.1" 200 1136
192.168.0.220 - - [30/Jul/2009:22:20:57 +0200] "GET /moodle20/admin/cron.php HTTP/1.1" 200 1365

==How to install and update Moodle via CVS==

CVS is very simple way to install and update your Moodle.

The only software you must have installed on your Mac server is the Xcode Tools package from your system installation media. You also must have an internet connection to get the files from the update server. After you installed both script files on your server desktop it only needs a doubleclick to get the newest Moodle version without downloading the complete installation package. Please remember - before you can update your Moodle via CVS you must install Moodle via CVS at once.

That's all .... really .... it's easy!!

===Use the CVS installation script===
If your Moodle is already installed via CVS please use the CVS updater (see below). Running the CVS installer will install only the standard version of Moodle on your server.

If you already have a working Moodle on your server then this script copies the file config.php into your new installation but it does not copy your additional modules or plugins or themes. You will find your old moodle folder in same directory and it will be renamed with an additional date stamp.

<pre>
#! /bin/sh
#
# CVS installer for Moodle
# on a Mac OS X Server
#
# 20100818 - Ralf Krause
#

export CVS_RSH=ssh

### file ~/.cvspass must exist
if ! test -e ~/.cvspass ; then
touch ~/.cvspass
fi

echo
echo "+--------------------------------------------+"
echo "| CVS installer for the Moodle server "
echo "+--------------------------------------------+"
echo

cd /Library/WebServer/Documents

### get the cvs installation into a tmp folder
if ! test -e tmp ; then
sudo mkdir tmp
sudo chmod 777 tmp
fi

echo "Connecting to the CVS server. Download will take a few moments!"
echo "If the CVS update runs too long you may break with <ctrl>-C"
echo

### do the cvs installation
cd tmp
cvs -z9 -d:pserver:anonymous@uk.cvs.moodle.org:/cvsroot/moodle co -P -r MOODLE_19_WEEKLY moodle
cd ..

### copy config.php from your current moodle folder if it exists
if ! test -e moodle/config.php ; then
cp moodle19/config.php tmp/moodle/config.php
fi

### move the new moodle to the right place
DATE=`date +%Y%m%d-%H%M`
sudo mv moodle19 moodle19-$DATE
sudo mv tmp/moodle moodle19
sudo chown -R _www moodle19
</pre>

===Use the CVS update script===
To be able to update Moodle via CVS please check that your Moodle was already installed via CVS (see above).

<pre>
#! /bin/sh
#
# CVS updater for Moodle
# on a Mac OS X Server
#
# 20100818 - Ralf Krause
#

export CVS_RSH=ssh

echo
echo "+--------------------------------------------+"
echo "| CVS updater for the Moodle server "
echo "+--------------------------------------------+"
echo

cd /Library/WebServer/Documents/moodle19/

### file ~/.cvspass must exist
if ! test -e ~/.cvspass ; then
touch ~/.cvspass
fi

### login to the cvs server only for the first time
if ! grep "uk.cvs.moodle.org" ~/.cvspass > /dev/null ; then
echo "CVS password is empty ... please only press <return> to start"
sudo cvs -d :pserver:anonymous@uk.cvs.moodle.org:/cvsroot/moodle login
echo
fi

echo "Connecting to the CVS server. Download will take a few moments!"
echo "If the CVS update runs too long you may break with <ctrl>-C"
echo

### do the cvs installation
sudo cvs -q update -dP -r MOODLE_19_WEEKLY
sudo chown -R _www .
</pre>

Please look at the documentation [https://docs.moodle.org/en/CVS_for_Administrators CVS for Administrators] if you want to learn more about Moodle and CVS. There you will also find a list of different [https://docs.moodle.org/en/CVS_for_Administrators#CVS_Servers CVS servers for Moodle] which you may choose for your updates.

The shown update script should be modified in only three things ... first you need to choose the correct folder for the Moodle files, second choose a CVS server near your server place to minimate internet traffic, and third you must input the correct CVS tag for the Moodle version in the last line. The shown script is for updating the version Moodle 1.9
* Moodle 1.8 uses MOODLE_18_WEEKLY
* Moodle 1.9 uses MOODLE_19_WEEKLY
* Moodle 2.0 RC1 still uses HEAD

===Troubleshooting===

If you see something like this, make sure that there is not some firewall blocking the port (it's 2401):

$ cvs -d:pserver:anonymous@us.cvs.moodle.org:/cvsroot/moodle login
Logging in to :pserver:anonymous@us.cvs.moodle.org:2401/cvsroot/moodle
CVS password:
cvs [login aborted]: connect to us.cvs.moodle.org(130.212.64.111):2401 failed: Connection timed out

===Install Xcode Tools and CVS on your Mac Server===

To test if cvs is already on your Mac Server please open the Terminal and type ''cvs -v''. The output of this command should show a version notice of your Concurrent Versions System (CVS). If you get the ''command not found'' message then you must search for your Mac OS X 10.5 Server installation media. You will find the Xcode Tools on your installation CD or DVD set.

If you can't find your installation media anymore you also can download the Xcode Tools from the URL http://developer.apple.com/tools/xcode/. It is free but you have to register as a developer. Starting the download then the Xcode package copies a lot of bytes on your harddisk and will need a very few minutes to complete.

After you installed the Xcode Tools in your server system you will get the correct version answer from the Terminal command ''cvs -v''. If you only want to update your Moodle you do not need all these nice developer tools from the inside of the folder. Sorry about this but there is no separate installer for the CVS update process.

If cvs does not work on your server please check that the port 2401 is open.
  

==User administration via LDAP==

The following settings will work on 10.5 Server running LDAP - edit them to customize to your own environment. Please note that moodle requires some fields - it is best to have these fields completed in Workgroup Manager on 10.5 Server - otherwise they'll be prompted to enter info into their moodle profile on first login, but the way we've got it set up, moodle can't modify LDAP for security and data integrity. The necessary fields are user name, first name, surname, Email address, City/Town, country, description, ID number.
<pre>
LDAP SERVER SETTINGS
Host URL = ourserver.example.com
Version = 3
LDAP encoding = utf-8

BIND SETTINGS
Hide passwords = Yes
Distinguished Name = (blank)
Password = (blank)

USER LOOKUP SETTINGS
User type = posixAccount (rfc2307)
Contexts = cn=users,dc=ourserver,dc=example,dc=com
Search subcontexts = Yes
Dereference aliases = No
User attribute = (blank)
Member attribute = (blank)
Member attribute uses dn = (blank)
Object class = (blank)

FORCE CHANGE PASSWORD
Force change password = No
Use standard Change Password Page = No
Password format = Plain text
Password change URL = (blank)

LDAP PASSWORD EXPIRATION SETTINGS
Expiration = no
Expiration warning = 10
Expiration attribute = ""
Grace logins = No
Grace login attribute = (blank)

ENABLE USER CREATION
Create users externally = No
Context for new users = (blank)

COURSE CREATOR
Creators = (blank)

CRON SYNCHRONIZATION SCRIPT
Removed ext user = Keep internal

NTLM SSO
Enable = No
Subnet = (blank)
First name = givenName (On every login, Never, Locked)
Surname = sn (On every login, Never, Locked)
Email address = mail (On every login, Never, Locked)
Phone 1 = (blank)
Phone 2 = (blank)
Department = (blank)
Address = (blank)
City/Town = l (On every login, Never, Locked)
Country = c (On every login, Never, Locked)
Description = description (On every login, Never, Locked)
ID number = uidNumber (On every login, Never, Locked)
Language = (blank)
</pre>

==See also==
* [[Complete Install Packages for Mac OS X | Complete install packages for Mac OS X Clients 10.4/10.5/10.6]]
* [[Step-by-step Guide for Installing Moodle on Mac OS X 10.4 Client|Step by step installation on a Mac OS X Client 10.4]]
* [[Cron | Installation of cron for Moodle]]
* [[CVS for Administrators]]

* [http://moodle.org/mod/forum/discuss.php?d=24632 Using Moodle: Dynamic DNS Home Server]

[[Category:Administrator]]
[[Category:Installation]]
[[Category:Mac OS X]]

Step by Step Installation on a Mac OS X Server

2010-10-21T13:43:40Z

Krause: /* Troubleshooting */

==Overview==
This guide shows all steps for the installation of Moodle on a [http://www.apple.com/server/macosx Mac OS X Server]. This server is a commercial product. You will find [http://www.apple.com/server/macosx/resources/documentation.html all documentations] about the web server on the Apple support pages.

This installation guide can't be useful for an installation on MAMP or XAMPP. If you are looking for an easy way to install Moodle on your local machine please use [[Complete Install Packages for Mac OS X | Complete install packages for Mac OS X 10.4/10.5/10.6 Clients]] that can be downloaded from http://download.moodle.org/macosx/ ... but if you are planning to set up a Moodle internet server on a Mac then you should think about some more security as the ever local package could give.

Please feel free to add your ideas and wishes to the discussion page for this article. You may also write a complete chapter if you tried the facts yourself on your own Mac Server. I am most interested to make the things better.

==System requirements==

+ Apple Computer
+ Mac mini, Mac Pro or Xserve
+ Processor: Intel Core 2 Duo, i5, i7
+ RAM: 2 GB or better
+ Hard Disk: 500 MB free
+ System Software: Mac OS X Server 10.5 or 10.6

==Configure PHP for your Moodle installation==
===Mac OS X 10.6 Server - No PHP installation needed===

The Mac OS X 10.6.4 Server (SnowLeopard) comes with PHP 5.3.2 and a lot of PHP extensions. This would be the best choice for Moodle 1.9.x and for Moodle 2.0 on a Mac OS X Server. Please forget everything you read about the missing GD Library! The PHP installation is totally complete for Moodle. You only have to control if the PHP module is switched on and if the php.ini does the right settings. You should open the file /etc/php.ini and control the settings for Moodle.

===Mac OS X 10.5 Server - Install PHP 5.3.0 and the GD Library===

The Mac OS X 10.5.8 Server (Leopard) comes with PHP 5.2.6 ... this is correct for Moodle 1.9.x. But you have to add the missing GD Library support to get Moodle running on your server. For Moodle 2.0 the server must have PHP 5.2.8 (or better) and some more PHP extensions ... in this case you need to get the better PHP version. These instructions are helpful in both cases.

To see which PHP version and extensions are installed on your server you should edit the file ''/Library/WebServer/Documents/info.php''. You must activate the function call phpinfo() by deleting the both slashes // at the start of the function line. After saving the file you can get all PHP informations in your browser. Please look at http://your-server-address/info.php ... you will not find any GD library support ... bad thing for Moodle!!

<?php
// You can use Server Admin to enable the Apache PHP module; it's disabled by default.
// You can uncomment the phpinfo() directive below to provide a default PHP info page
// but note that this displays information about your host's configuration.
phpinfo();
?>

The easiest way to get the GD library support and to get a better PHP version would be the installation of the complete PHP 5.3.0 package from http://www.entropy.ch/software/macosx/php/. Marc Liyanage precompiled this package to use it on Mac clients and Mac servers. Please get the package and install it by following the instructions on the download page. The installer does everything for you ... it copies PHP into the correct folder ''/usr/local/php5'' and changes its owner to ''root'' automatically. You will find the file php.ini inside the new package folder. Open the file ''/usr/local/php5/lib/php.ini'' and edit some settings for Moodle.

Note: If you want to install Moodle 1.8.x on the server you need to get the Entropy PHP-5.2.9-7.pkg instead. Moodle 1.8.x does not run with PHP 5.3.0. (MDL-20128)

Now the Apache web server must get knowledge that you want to use the new PHP library instead of the old. Open the application Server Admin to switch to the new library. Go to the web server settings and find the entry php5_module. The normal place for PHP the Mac server is ''libexec/apache2/libphp5.so''. Please change to ''/usr/local/php5/libphp5.so'' and save the settings.

[[Image:Server-admin.png]]

===PHP settings in your php.ini===
The second thing to configure is the file php.ini. Most of the settings are okay but not all of them. To communicate to the MySQL database with PHP you have to set the default socket name for local MySQL connects. The default socket name for local MySQLi connects is needed for Moodle 2.0.

If you want to upload any file to your Moodle you should add a little bit more upload size in php.ini. If your server can't use more than 1 GB RAM you should set the memory_limit to a value less than 128M ... but it should have more than 48M for Moodle 1.9 and Moodle 2.0. Note that these sections are not likely to be consecutive in the php.ini file; the quickest way to find each one is search on the initial term (such as 'mysql.default_socket').

; Default socket name for local MySQL connects.
; If empty, uses the built-in MySQL defaults.
mysql.default_socket = /var/mysql/mysql.sock

; Default socket name for local MySQL connects.
; If empty, uses the built-in MySQL defaults.
mysqli.default_socket = /var/mysql/mysql.sock

; Maximum amount of memory a script may consume (128MB)
memory_limit = 128M

; Maximum allowed size for uploaded files.
upload_max_filesize = 128M

; Maximum size of POST data that PHP will accept.
post_max_size = 128M

; Defines the default timezone used by the date functions
; http://php.net/date.timezone
date.timezone = 'Europe/Berlin';

That's all ... save the file php.ini and restart the web server. Now you should look at http://your-server-address/info.php again. I hope that everything will be okay. You will find the version number PHP 5.3.0 and the running GD library support. Congratulations ... the first step for Moodle on your Mac server is done!

[[Image:phpinfo.png]]

[[Image:phpinfo2.png]]

==Configure the MySQL database for your Moodle installation==

In standard case the database MySQL is installed on the Mac OS X Server but it is not running yet. Please make sure that you start the MySQL database server.

===Use the graphical way===
Sorry ... there are some more installations and a lot of clicks to configure MySQL in a graphical way.

First of all start the ''Server Admin''. You will find this program by the way ''Applications > Server > Server Admin''. Activate MySQL on the local server. You must set the password for the user ''root'' before you can start MySQL.

For the next you must download the MySQL database administration tool '''phpMyAdmin''' from http://www.phpmyadmin.net . Move the folder to the web server documents as ''/Library/WebServer/Documents/phpMyAdmin''.

Add the security phrase to the file ''config.inc.php'' in between the single quotes on the line $cfg['blowfish_secret'] = ''; /* YOU MUST FILL IN THIS FOR COOKIE AUTH! */

Now you will be able to start http://your-server-address/phpMyAdmin/ in your browser and to log into the database as the user ''root''. Add a database ''moodle19''. Add a database user ''moodle'' to the server ''localhost''. Don't forget to set a secure password. The database user ''moodle'' should be allowed to administrate the database ''moodle19'' only. It is a bad way to set ''root'' to administrate the database ''moodle19''. If you want to install also Moodle 2.0 dev please add a second database ''moodle20'' and use the same database user for it.

phpMyAdmin is a nice thing to look into the database while Moodle is running for some time. It's much easier to see in the graphical interface than in the command line tools. The image shows the database after Moodle 1.9 and Moodle 2.0 were already installed on this server.

[[Image:phpmyadmin.png]]

===Use the Terminal===
If you want a quick installation then don't fear to use the Terminal. It's easier to tell you all the commands for the right way with the Terminal than showing you all the pictures to do the same with graphical tools. There are only a few commands to do everything I told you before.

Start the Terminal. You will find this program by the way ''Applications > Tools > Terminal''. You will see that we must do the same steps as before but you can read them in a text form.

First of all you need to set the root password. If you didn't this before then use the first command line. If you want to change an existing password then use the second one.

Server:~ $ mysqladmin -u root password 'secret'
Server:~ $ mysqladmin -u root -p password 'topsecret'

The next steps are creating a new database ''moodle19'' with correct character set and setting up a database user ''moodle'', with an assigned password (IDENTIFIED BY), to administrate the new database ... and if you want, then do the same for ''moodle20''.

Server:~ $ mysqladmin -u root -p create moodle19
Server:~ $ mysql -u root -p

mysql> ALTER DATABASE moodle19 CHARSET 'utf8';
mysql> GRANT ALL PRIVILEGES ON moodle19.* TO moodle@localhost
-> IDENTIFIED BY 'moodle!';
mysql> quit

Server:~ $

That's really all with the Terminal. You are just ready!

==Copy the Moodle files to the web server==

The documents for the web server are saved in the folder ''/Library/WebServer/Documents/''. You will place your Moodle folder here after you got it from http://download.moodle.org. Download the standard package MOODLE_19_WEEKLY because this is the best choice for new servers. Set the owner ''_www'' for the moodle folder ... this is the user for the web server. The folder permissions should be 755 before the installation and 555 after it's done ... please remember to set this later!

You also need the moodledata folder outside of the Documents folder ... so please make one. Go to the folder ''/Library/WebServer/'' and add the folder ''moodledata''. Because I want to install Moodle 1.9.x and Moodle 2.0 dev together on the same Mac server I add two folders ''moodle19'' and ''moodle20'' inside the moodledata folder. Please set the owner ''_www'' for both folders ''moodle19'' and ''moodle20'' and the folder permissions to 755.

cd /Library/WebServer/
mkdir moodledata
mkdir moodledata/moodle19
mkdir moodledata/moodle20
sudo chown -R _www moodledata
sudo chmod -R 755 moodledata

If you'd like to put the moodledata folder on another volume (not a bad idea if you think you'll have a substantial amount of data within the moodle), note that you cannot simply reference it using the /Volumes/<volume_name>/folder syntax during the moodle setup. Instead, you'll need to create the folder (assigning the user and permissions), then create a '''link''' to it within the /Library/WebServer folder. To create the link, use the following command in a terminal window, substituting your data volume and folder name:

cd /Library/WebServer
ln -s /Volumes/Data_Volume/moodledata moodledata

==Run the Moodle installation==
The installation on the Mac server is the same like the installation on every other server.
Open a web browser to http://your-server-address/moodle/install.php to begin the installation process.
On the screen picture and in the shown config.php you see the web address ''your-server-address'' ... it's only a placeholder for a real address or url ... please set yours. Also a user 'moodle' with a password 'moodle' would be very unsafe settings for your installation.

[[Image:moodle-install1.png]]

[[Image:moodle-install2.png]]

The installer generates the config.php automatically and saves it in the folder ''/Library/WebServer/Documents/moodle19''. Please edit the config.php with a text editor and add the line ''date_default_timezone_set('UTC');''. You may change ''UTC'' to your own timezone ... this is needed for PHP 5.3.0. In case you don't know all the relevant time zone identifiers by heart, there is a [http://phpbuilder.com/manual/en/timezones.php list available online].

<?php /// Moodle Configuration File

unset($CFG);

$CFG->dbtype = 'mysql';
$CFG->dbhost = 'localhost';
$CFG->dbname = 'moodle19';
$CFG->dbuser = 'moodle';
$CFG->dbpass = 'moodle';
$CFG->dbpersist = false;
$CFG->prefix = 'mdl_';

$CFG->wwwroot = 'http://your-server-address/moodle19';
$CFG->dirroot = '/Library/WebServer/Documents/moodle19';
$CFG->dataroot = '/Library/WebServer/moodledata/moodle19';
$CFG->admin = 'admin';

$CFG->directorypermissions = 00777; // try 02777 on a server in Safe Mode

date_default_timezone_set('Europe/Berlin'); // timezone for PHP 5.3.0
require_once("$CFG->dirroot/lib/setup.php");
// MAKE SURE WHEN YOU EDIT THIS FILE THAT THERE ARE NO SPACES, BLANK LINES,
// RETURNS, OR ANYTHING ELSE AFTER THE TWO CHARACTERS ON THE NEXT LINE.
?>

After this, the web-based installation component will walk you through '''several''' screens worth of database configurations and updates, for most of which you'll just click the continue button. You'll set up an admin user and give the site a basic configuration (title, description, etc). When the installation is ready you should change the folder permission for ''/Library/WebServer/Documents/moodle19'' to 555 so the web server is not able to write into this folder again.

==Download the language packages==

==Moodle is running ...==
[[Image:moodle-on-macosx-server.png]]

==How to setup the cron job with launchd==

It's really important to start the cron job every 5 minutes. The cron job assists most of Moodle's modules to perform tasks on a scheduled basis. For example, the discussion forums can only mail out copies of new posts to all subscribers if the cron job tells Moodle to do this.

In Mac OS X you will find the system daemon ''launchd'' for this service. This daemon offers a standardized interface to any user and all programs started automatically by the system. Please look at http://developer.apple.com/macosx/launchd.html for more information about the configurations and all parameters.

In our case the service should get the web page http://your-server-address/moodle19/admin/cron.php every 5 minutes. The configuration will be done by the file named ''moodle4mac.cron.plist'' which must be placed in the system folder ''/Library/LaunchDaemons/'' ... surely you can use any other file name but it should say something about the function of the service. The extension must be ''.plist''. After any reboot of your Mac server the cron service will start automaticly because the file is placed in the correct system folder.

===Use the graphical way===
You can use Lingon to add a new daemon plist or to edit one. It produces the same text as you can write in your text editor. http://sourceforge.net/projects/lingon/files/

[[Image:macosx-lingon.png]]

===Use a text editor===
Please use a text editor to write the needed file. You can open the Terminal and use the system editors vi or pico. But you can also write the text file with any GUI text editor ... I mostly use TextWrangler ... but do NOT take an editor for formatted texts like Microsoft Word or OpenOffice Writer. You must get pure text!

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0//EN"
"http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>KeepAlive</key><false/>
<key>Label</key><string>moodle4mac.cron</string>
<key>ProgramArguments</key>
<array>
<string>curl</string>
<string>-s</string>
<string>http://your-server-address/moodle19/admin/cron.php</string>
</array>
<key>RunAtLoad</key><true />
<key>StartInterval</key><integer>300</integer>
<key>StandardErrorPath</key><string>/dev/null</string>
<key>StandardOutPath</key><string>/dev/null</string>
</dict>
</plist>

The label string must be the same as the file name is but without the extension ''.plist''. Save the text file ''/Library/LaunchDaemons/moodle4mac.cron.plist''. The owner of the file must be set to the system user ''root''. That's all, really!

===How to start and stop the cron service===
You can start the new cron service in the Terminal.

sudo launchctl load /Library/LaunchDaemons/moodle4mac.cron.plist

The following command would stop the service. If you want to activate changes in the cron service you need to ''unload'' and then to ''load'' the daemon again.

sudo launchctl unload /Library/LaunchDaemons/moodle4mac.cron.plist

===Only one service for two servers?===
For my server I needed to have a cron service for to instances ''moodle19'' and ''moodle20'' ... no problem ... with the typo ''moodle[19-20]'' the server will get a cron service for both instances.

<nowiki>curl -s http://your-server-address/moodle[19-20]/admin/cron.php</nowiki>

To see if the cron service works correctly you should look at the ''access.log'' of your web server. The cron.php should be accessed every 5 minutes ... on my server for both Moodle instances ''moodle19'' and ''moodle20'' ... oh yes, it works!!

192.168.0.220 - - [30/Jul/2009:22:10:56 +0200] "GET /moodle19/admin/cron.php HTTP/1.1" 200 1136
192.168.0.220 - - [30/Jul/2009:22:10:57 +0200] "GET /moodle20/admin/cron.php HTTP/1.1" 200 1403
192.168.0.220 - - [30/Jul/2009:22:11:18 +0200] "OPTIONS * HTTP/1.0" 200 -
192.168.0.220 - - [30/Jul/2009:22:15:56 +0200] "GET /moodle19/admin/cron.php HTTP/1.1" 200 735
192.168.0.220 - - [30/Jul/2009:22:15:57 +0200] "GET /moodle20/admin/cron.php HTTP/1.1" 200 964
192.168.0.220 - - [30/Jul/2009:22:20:56 +0200] "GET /moodle19/admin/cron.php HTTP/1.1" 200 1136
192.168.0.220 - - [30/Jul/2009:22:20:57 +0200] "GET /moodle20/admin/cron.php HTTP/1.1" 200 1365

==How to install and update Moodle via CVS==

CVS is very simple way to install and update your Moodle.

The only software you must have installed on your Mac server is the Xcode Tools package from your system installation media. You also must have an internet connection to get the files from the update server. After you installed both script files on your server desktop it only needs a doubleclick to get the newest Moodle version without downloading the complete installation package. Please remember - before you can update your Moodle via CVS you must install Moodle via CVS at once.

That's all .... really .... it's easy!!

===Use the CVS installation script===
If your Moodle is already installed via CVS please use the CVS updater (see below). Running the CVS installer will install only the standard version of Moodle on your server.

If you already have a working Moodle on your server then this script copies the file config.php into your new installation but it does not copy your additional modules or plugins or themes. You will find your old moodle folder in same directory and it will be renamed with an additional date stamp.

<pre>
#! /bin/sh
#
# CVS installer for Moodle
# on a Mac OS X Server
#
# 20100818 - Ralf Krause
#

export CVS_RSH=ssh

### file ~/.cvspass must exist
if ! test -e ~/.cvspass ; then
touch ~/.cvspass
fi

echo
echo "+--------------------------------------------+"
echo "| CVS installer for the Moodle server "
echo "+--------------------------------------------+"
echo

cd /Library/WebServer/Documents

### get the cvs installation into a tmp folder
if ! test -e tmp ; then
sudo mkdir tmp
sudo chmod 777 tmp
fi

echo "Connecting to the CVS server. Download will take a few moments!"
echo "If the CVS update runs too long you may break with <ctrl>-C"
echo

### do the cvs installation
cd tmp
cvs -z9 -d:pserver:anonymous@uk.cvs.moodle.org:/cvsroot/moodle co -P -r MOODLE_19_WEEKLY moodle
cd ..

### copy config.php from your current moodle folder if it exists
if ! test -e moodle/config.php ; then
cp moodle19/config.php tmp/moodle/config.php
fi

### move the new moodle to the right place
DATE=`date +%Y%m%d-%H%M`
sudo mv moodle19 moodle19-$DATE
sudo mv tmp/moodle moodle19
sudo chown -R _www moodle19
</pre>

===Use the CVS update script===
To be able to update Moodle via CVS please check that your Moodle was already installed via CVS (see above).

<pre>
#! /bin/sh
#
# CVS updater for Moodle
# on a Mac OS X Server
#
# 20100818 - Ralf Krause
#

export CVS_RSH=ssh

echo
echo "+--------------------------------------------+"
echo "| CVS updater for the Moodle server "
echo "+--------------------------------------------+"
echo

cd /Library/WebServer/Documents/moodle19/

### file ~/.cvspass must exist
if ! test -e ~/.cvspass ; then
touch ~/.cvspass
fi

### login to the cvs server only for the first time
if ! grep "uk.cvs.moodle.org" ~/.cvspass > /dev/null ; then
echo "CVS password is empty ... please only press <return> to start"
sudo cvs -d :pserver:anonymous@uk.cvs.moodle.org:/cvsroot/moodle login
echo
fi

echo "Connecting to the CVS server. Download will take a few moments!"
echo "If the CVS update runs too long you may break with <ctrl>-C"
echo

### do the cvs installation
sudo cvs -q update -dP -r MOODLE_19_WEEKLY
sudo chown -R _www .
</pre>

Please look at the documentation [https://docs.moodle.org/en/CVS_for_Administrators CVS for Administrators] if you want to learn more about Moodle and CVS. There you will also find a list of different [https://docs.moodle.org/en/CVS_for_Administrators#CVS_Servers CVS servers for Moodle] which you may choose for your updates.

The shown update script should be modified in only three things ... first you need to choose the correct folder for the Moodle files, second choose a CVS server near your server place to minimate internet traffic, and third you must input the correct CVS tag for the Moodle version in the last line. The shown script is for updating the version Moodle 1.9
* Moodle 1.8 uses MOODLE_18_WEEKLY
* Moodle 1.9 uses MOODLE_19_WEEKLY
* Moodle 2.0 RC1 still uses HEAD

===Troubleshooting===

If you see something like this, make sure that there is not some firewall blocking the port (it's 2401):

$ cvs -d:pserver:anonymous@us.cvs.moodle.org:/cvsroot/moodle login
Logging in to :pserver:anonymous@us.cvs.moodle.org:2401/cvsroot/moodle
CVS password:
cvs [login aborted]: connect to us.cvs.moodle.org(130.212.64.111):2401 failed: Connection timed out

===Install Xcode Tools and CVS on your Mac Server===

To test if cvs is already on your Mac Server please open the Terminal and type ''cvs -v''. The output of this command should show a version notice of your Concurrent Versions System (CVS). If you get the ''command not found'' message then you must search for your Mac OS X 10.5 Server installation media. You will find the Xcode Tools on your installation CD or DVD set.

If you can't find your installation media anymore you also can download the Xcode Tools from the URL http://developer.apple.com/tools/xcode/. It is free but you have to register as a developer. Starting the download then the Xcode package copies a lot of bytes on your harddisk and will need a very few minutes to complete.

After you installed the Xcode Tools in your server system you will get the correct version answer from the Terminal command ''cvs -v''. If you only want to update your Moodle you do not need all these nice developer tools from the inside of the folder. Sorry about this but there is no separate installer for the CVS update process.

If cvs does not work on your server please check that the port 2401 is open.
  

==User administration via LDAP==

The following settings will work on 10.5 Server running LDAP - edit them to customize to your own environment. Please note that moodle requires some fields - it is best to have these fields completed in Workgroup Manager on 10.5 Server - otherwise they'll be prompted to enter info into their moodle profile on first login, but the way we've got it set up, moodle can't modify LDAP for security and data integrity. The necessary fields are user name, first name, surname, Email address, City/Town, country, description, ID number.
<pre>
LDAP SERVER SETTINGS
Host URL = ourserver.example.com
Version = 3
LDAP encoding = utf-8

BIND SETTINGS
Hide passwords = Yes
Distinguished Name = (blank)
Password = (blank)

USER LOOKUP SETTINGS
User type = posixAccount (rfc2307)
Contexts = cn=users,dc=ourserver,dc=example,dc=com
Search subcontexts = Yes
Dereference aliases = No
User attribute = (blank)
Member attribute = (blank)
Member attribute uses dn = (blank)
Object class = (blank)

FORCE CHANGE PASSWORD
Force change password = No
Use standard Change Password Page = No
Password format = Plain text
Password change URL = (blank)

LDAP PASSWORD EXPIRATION SETTINGS
Expiration = no
Expiration warning = 10
Expiration attribute = ""
Grace logins = No
Grace login attribute = (blank)

ENABLE USER CREATION
Create users externally = No
Context for new users = (blank)

COURSE CREATOR
Creators = (blank)

CRON SYNCHRONIZATION SCRIPT
Removed ext user = Keep internal

NTLM SSO
Enable = No
Subnet = (blank)
First name = givenName (On every login, Never, Locked)
Surname = sn (On every login, Never, Locked)
Email address = mail (On every login, Never, Locked)
Phone 1 = (blank)
Phone 2 = (blank)
Department = (blank)
Address = (blank)
City/Town = l (On every login, Never, Locked)
Country = c (On every login, Never, Locked)
Description = description (On every login, Never, Locked)
ID number = uidNumber (On every login, Never, Locked)
Language = (blank)
</pre>

==See also==
* [[Complete Install Packages for Mac OS X | Complete install packages for Mac OS X Clients 10.4/10.5/10.6]]
* [[Step-by-step Guide for Installing Moodle on Mac OS X 10.4 Client|Step by step installation on a Mac OS X Client 10.4]]
* [[Cron | Installation of cron for Moodle]]
* [[CVS for Administrators]]

* [http://moodle.org/mod/forum/discuss.php?d=24632 Using Moodle: Dynamic DNS Home Server]

[[Category:Administrator]]
[[Category:Installation]]
[[Category:Mac OS X]]

Step by Step Installation on a Mac OS X Server

2010-10-21T13:43:00Z

Krause: /* Install Xcode Tools and CVS on your Mac Server */

==Overview==
This guide shows all steps for the installation of Moodle on a [http://www.apple.com/server/macosx Mac OS X Server]. This server is a commercial product. You will find [http://www.apple.com/server/macosx/resources/documentation.html all documentations] about the web server on the Apple support pages.

This installation guide can't be useful for an installation on MAMP or XAMPP. If you are looking for an easy way to install Moodle on your local machine please use [[Complete Install Packages for Mac OS X | Complete install packages for Mac OS X 10.4/10.5/10.6 Clients]] that can be downloaded from http://download.moodle.org/macosx/ ... but if you are planning to set up a Moodle internet server on a Mac then you should think about some more security as the ever local package could give.

Please feel free to add your ideas and wishes to the discussion page for this article. You may also write a complete chapter if you tried the facts yourself on your own Mac Server. I am most interested to make the things better.

==System requirements==

+ Apple Computer
+ Mac mini, Mac Pro or Xserve
+ Processor: Intel Core 2 Duo, i5, i7
+ RAM: 2 GB or better
+ Hard Disk: 500 MB free
+ System Software: Mac OS X Server 10.5 or 10.6

==Configure PHP for your Moodle installation==
===Mac OS X 10.6 Server - No PHP installation needed===

The Mac OS X 10.6.4 Server (SnowLeopard) comes with PHP 5.3.2 and a lot of PHP extensions. This would be the best choice for Moodle 1.9.x and for Moodle 2.0 on a Mac OS X Server. Please forget everything you read about the missing GD Library! The PHP installation is totally complete for Moodle. You only have to control if the PHP module is switched on and if the php.ini does the right settings. You should open the file /etc/php.ini and control the settings for Moodle.

===Mac OS X 10.5 Server - Install PHP 5.3.0 and the GD Library===

The Mac OS X 10.5.8 Server (Leopard) comes with PHP 5.2.6 ... this is correct for Moodle 1.9.x. But you have to add the missing GD Library support to get Moodle running on your server. For Moodle 2.0 the server must have PHP 5.2.8 (or better) and some more PHP extensions ... in this case you need to get the better PHP version. These instructions are helpful in both cases.

To see which PHP version and extensions are installed on your server you should edit the file ''/Library/WebServer/Documents/info.php''. You must activate the function call phpinfo() by deleting the both slashes // at the start of the function line. After saving the file you can get all PHP informations in your browser. Please look at http://your-server-address/info.php ... you will not find any GD library support ... bad thing for Moodle!!

<?php
// You can use Server Admin to enable the Apache PHP module; it's disabled by default.
// You can uncomment the phpinfo() directive below to provide a default PHP info page
// but note that this displays information about your host's configuration.
phpinfo();
?>

The easiest way to get the GD library support and to get a better PHP version would be the installation of the complete PHP 5.3.0 package from http://www.entropy.ch/software/macosx/php/. Marc Liyanage precompiled this package to use it on Mac clients and Mac servers. Please get the package and install it by following the instructions on the download page. The installer does everything for you ... it copies PHP into the correct folder ''/usr/local/php5'' and changes its owner to ''root'' automatically. You will find the file php.ini inside the new package folder. Open the file ''/usr/local/php5/lib/php.ini'' and edit some settings for Moodle.

Note: If you want to install Moodle 1.8.x on the server you need to get the Entropy PHP-5.2.9-7.pkg instead. Moodle 1.8.x does not run with PHP 5.3.0. (MDL-20128)

Now the Apache web server must get knowledge that you want to use the new PHP library instead of the old. Open the application Server Admin to switch to the new library. Go to the web server settings and find the entry php5_module. The normal place for PHP the Mac server is ''libexec/apache2/libphp5.so''. Please change to ''/usr/local/php5/libphp5.so'' and save the settings.

[[Image:Server-admin.png]]

===PHP settings in your php.ini===
The second thing to configure is the file php.ini. Most of the settings are okay but not all of them. To communicate to the MySQL database with PHP you have to set the default socket name for local MySQL connects. The default socket name for local MySQLi connects is needed for Moodle 2.0.

If you want to upload any file to your Moodle you should add a little bit more upload size in php.ini. If your server can't use more than 1 GB RAM you should set the memory_limit to a value less than 128M ... but it should have more than 48M for Moodle 1.9 and Moodle 2.0. Note that these sections are not likely to be consecutive in the php.ini file; the quickest way to find each one is search on the initial term (such as 'mysql.default_socket').

; Default socket name for local MySQL connects.
; If empty, uses the built-in MySQL defaults.
mysql.default_socket = /var/mysql/mysql.sock

; Default socket name for local MySQL connects.
; If empty, uses the built-in MySQL defaults.
mysqli.default_socket = /var/mysql/mysql.sock

; Maximum amount of memory a script may consume (128MB)
memory_limit = 128M

; Maximum allowed size for uploaded files.
upload_max_filesize = 128M

; Maximum size of POST data that PHP will accept.
post_max_size = 128M

; Defines the default timezone used by the date functions
; http://php.net/date.timezone
date.timezone = 'Europe/Berlin';

That's all ... save the file php.ini and restart the web server. Now you should look at http://your-server-address/info.php again. I hope that everything will be okay. You will find the version number PHP 5.3.0 and the running GD library support. Congratulations ... the first step for Moodle on your Mac server is done!

[[Image:phpinfo.png]]

[[Image:phpinfo2.png]]

==Configure the MySQL database for your Moodle installation==

In standard case the database MySQL is installed on the Mac OS X Server but it is not running yet. Please make sure that you start the MySQL database server.

===Use the graphical way===
Sorry ... there are some more installations and a lot of clicks to configure MySQL in a graphical way.

First of all start the ''Server Admin''. You will find this program by the way ''Applications > Server > Server Admin''. Activate MySQL on the local server. You must set the password for the user ''root'' before you can start MySQL.

For the next you must download the MySQL database administration tool '''phpMyAdmin''' from http://www.phpmyadmin.net . Move the folder to the web server documents as ''/Library/WebServer/Documents/phpMyAdmin''.

Add the security phrase to the file ''config.inc.php'' in between the single quotes on the line $cfg['blowfish_secret'] = ''; /* YOU MUST FILL IN THIS FOR COOKIE AUTH! */

Now you will be able to start http://your-server-address/phpMyAdmin/ in your browser and to log into the database as the user ''root''. Add a database ''moodle19''. Add a database user ''moodle'' to the server ''localhost''. Don't forget to set a secure password. The database user ''moodle'' should be allowed to administrate the database ''moodle19'' only. It is a bad way to set ''root'' to administrate the database ''moodle19''. If you want to install also Moodle 2.0 dev please add a second database ''moodle20'' and use the same database user for it.

phpMyAdmin is a nice thing to look into the database while Moodle is running for some time. It's much easier to see in the graphical interface than in the command line tools. The image shows the database after Moodle 1.9 and Moodle 2.0 were already installed on this server.

[[Image:phpmyadmin.png]]

===Use the Terminal===
If you want a quick installation then don't fear to use the Terminal. It's easier to tell you all the commands for the right way with the Terminal than showing you all the pictures to do the same with graphical tools. There are only a few commands to do everything I told you before.

Start the Terminal. You will find this program by the way ''Applications > Tools > Terminal''. You will see that we must do the same steps as before but you can read them in a text form.

First of all you need to set the root password. If you didn't this before then use the first command line. If you want to change an existing password then use the second one.

Server:~ $ mysqladmin -u root password 'secret'
Server:~ $ mysqladmin -u root -p password 'topsecret'

The next steps are creating a new database ''moodle19'' with correct character set and setting up a database user ''moodle'', with an assigned password (IDENTIFIED BY), to administrate the new database ... and if you want, then do the same for ''moodle20''.

Server:~ $ mysqladmin -u root -p create moodle19
Server:~ $ mysql -u root -p

mysql> ALTER DATABASE moodle19 CHARSET 'utf8';
mysql> GRANT ALL PRIVILEGES ON moodle19.* TO moodle@localhost
-> IDENTIFIED BY 'moodle!';
mysql> quit

Server:~ $

That's really all with the Terminal. You are just ready!

==Copy the Moodle files to the web server==

The documents for the web server are saved in the folder ''/Library/WebServer/Documents/''. You will place your Moodle folder here after you got it from http://download.moodle.org. Download the standard package MOODLE_19_WEEKLY because this is the best choice for new servers. Set the owner ''_www'' for the moodle folder ... this is the user for the web server. The folder permissions should be 755 before the installation and 555 after it's done ... please remember to set this later!

You also need the moodledata folder outside of the Documents folder ... so please make one. Go to the folder ''/Library/WebServer/'' and add the folder ''moodledata''. Because I want to install Moodle 1.9.x and Moodle 2.0 dev together on the same Mac server I add two folders ''moodle19'' and ''moodle20'' inside the moodledata folder. Please set the owner ''_www'' for both folders ''moodle19'' and ''moodle20'' and the folder permissions to 755.

cd /Library/WebServer/
mkdir moodledata
mkdir moodledata/moodle19
mkdir moodledata/moodle20
sudo chown -R _www moodledata
sudo chmod -R 755 moodledata

If you'd like to put the moodledata folder on another volume (not a bad idea if you think you'll have a substantial amount of data within the moodle), note that you cannot simply reference it using the /Volumes/<volume_name>/folder syntax during the moodle setup. Instead, you'll need to create the folder (assigning the user and permissions), then create a '''link''' to it within the /Library/WebServer folder. To create the link, use the following command in a terminal window, substituting your data volume and folder name:

cd /Library/WebServer
ln -s /Volumes/Data_Volume/moodledata moodledata

==Run the Moodle installation==
The installation on the Mac server is the same like the installation on every other server.
Open a web browser to http://your-server-address/moodle/install.php to begin the installation process.
On the screen picture and in the shown config.php you see the web address ''your-server-address'' ... it's only a placeholder for a real address or url ... please set yours. Also a user 'moodle' with a password 'moodle' would be very unsafe settings for your installation.

[[Image:moodle-install1.png]]

[[Image:moodle-install2.png]]

The installer generates the config.php automatically and saves it in the folder ''/Library/WebServer/Documents/moodle19''. Please edit the config.php with a text editor and add the line ''date_default_timezone_set('UTC');''. You may change ''UTC'' to your own timezone ... this is needed for PHP 5.3.0. In case you don't know all the relevant time zone identifiers by heart, there is a [http://phpbuilder.com/manual/en/timezones.php list available online].

<?php /// Moodle Configuration File

unset($CFG);

$CFG->dbtype = 'mysql';
$CFG->dbhost = 'localhost';
$CFG->dbname = 'moodle19';
$CFG->dbuser = 'moodle';
$CFG->dbpass = 'moodle';
$CFG->dbpersist = false;
$CFG->prefix = 'mdl_';

$CFG->wwwroot = 'http://your-server-address/moodle19';
$CFG->dirroot = '/Library/WebServer/Documents/moodle19';
$CFG->dataroot = '/Library/WebServer/moodledata/moodle19';
$CFG->admin = 'admin';

$CFG->directorypermissions = 00777; // try 02777 on a server in Safe Mode

date_default_timezone_set('Europe/Berlin'); // timezone for PHP 5.3.0
require_once("$CFG->dirroot/lib/setup.php");
// MAKE SURE WHEN YOU EDIT THIS FILE THAT THERE ARE NO SPACES, BLANK LINES,
// RETURNS, OR ANYTHING ELSE AFTER THE TWO CHARACTERS ON THE NEXT LINE.
?>

After this, the web-based installation component will walk you through '''several''' screens worth of database configurations and updates, for most of which you'll just click the continue button. You'll set up an admin user and give the site a basic configuration (title, description, etc). When the installation is ready you should change the folder permission for ''/Library/WebServer/Documents/moodle19'' to 555 so the web server is not able to write into this folder again.

==Download the language packages==

==Moodle is running ...==
[[Image:moodle-on-macosx-server.png]]

==How to setup the cron job with launchd==

It's really important to start the cron job every 5 minutes. The cron job assists most of Moodle's modules to perform tasks on a scheduled basis. For example, the discussion forums can only mail out copies of new posts to all subscribers if the cron job tells Moodle to do this.

In Mac OS X you will find the system daemon ''launchd'' for this service. This daemon offers a standardized interface to any user and all programs started automatically by the system. Please look at http://developer.apple.com/macosx/launchd.html for more information about the configurations and all parameters.

In our case the service should get the web page http://your-server-address/moodle19/admin/cron.php every 5 minutes. The configuration will be done by the file named ''moodle4mac.cron.plist'' which must be placed in the system folder ''/Library/LaunchDaemons/'' ... surely you can use any other file name but it should say something about the function of the service. The extension must be ''.plist''. After any reboot of your Mac server the cron service will start automaticly because the file is placed in the correct system folder.

===Use the graphical way===
You can use Lingon to add a new daemon plist or to edit one. It produces the same text as you can write in your text editor. http://sourceforge.net/projects/lingon/files/

[[Image:macosx-lingon.png]]

===Use a text editor===
Please use a text editor to write the needed file. You can open the Terminal and use the system editors vi or pico. But you can also write the text file with any GUI text editor ... I mostly use TextWrangler ... but do NOT take an editor for formatted texts like Microsoft Word or OpenOffice Writer. You must get pure text!

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0//EN"
"http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>KeepAlive</key><false/>
<key>Label</key><string>moodle4mac.cron</string>
<key>ProgramArguments</key>
<array>
<string>curl</string>
<string>-s</string>
<string>http://your-server-address/moodle19/admin/cron.php</string>
</array>
<key>RunAtLoad</key><true />
<key>StartInterval</key><integer>300</integer>
<key>StandardErrorPath</key><string>/dev/null</string>
<key>StandardOutPath</key><string>/dev/null</string>
</dict>
</plist>

The label string must be the same as the file name is but without the extension ''.plist''. Save the text file ''/Library/LaunchDaemons/moodle4mac.cron.plist''. The owner of the file must be set to the system user ''root''. That's all, really!

===How to start and stop the cron service===
You can start the new cron service in the Terminal.

sudo launchctl load /Library/LaunchDaemons/moodle4mac.cron.plist

The following command would stop the service. If you want to activate changes in the cron service you need to ''unload'' and then to ''load'' the daemon again.

sudo launchctl unload /Library/LaunchDaemons/moodle4mac.cron.plist

===Only one service for two servers?===
For my server I needed to have a cron service for to instances ''moodle19'' and ''moodle20'' ... no problem ... with the typo ''moodle[19-20]'' the server will get a cron service for both instances.

<nowiki>curl -s http://your-server-address/moodle[19-20]/admin/cron.php</nowiki>

To see if the cron service works correctly you should look at the ''access.log'' of your web server. The cron.php should be accessed every 5 minutes ... on my server for both Moodle instances ''moodle19'' and ''moodle20'' ... oh yes, it works!!

192.168.0.220 - - [30/Jul/2009:22:10:56 +0200] "GET /moodle19/admin/cron.php HTTP/1.1" 200 1136
192.168.0.220 - - [30/Jul/2009:22:10:57 +0200] "GET /moodle20/admin/cron.php HTTP/1.1" 200 1403
192.168.0.220 - - [30/Jul/2009:22:11:18 +0200] "OPTIONS * HTTP/1.0" 200 -
192.168.0.220 - - [30/Jul/2009:22:15:56 +0200] "GET /moodle19/admin/cron.php HTTP/1.1" 200 735
192.168.0.220 - - [30/Jul/2009:22:15:57 +0200] "GET /moodle20/admin/cron.php HTTP/1.1" 200 964
192.168.0.220 - - [30/Jul/2009:22:20:56 +0200] "GET /moodle19/admin/cron.php HTTP/1.1" 200 1136
192.168.0.220 - - [30/Jul/2009:22:20:57 +0200] "GET /moodle20/admin/cron.php HTTP/1.1" 200 1365

==How to install and update Moodle via CVS==

CVS is very simple way to install and update your Moodle.

The only software you must have installed on your Mac server is the Xcode Tools package from your system installation media. You also must have an internet connection to get the files from the update server. After you installed both script files on your server desktop it only needs a doubleclick to get the newest Moodle version without downloading the complete installation package. Please remember - before you can update your Moodle via CVS you must install Moodle via CVS at once.

That's all .... really .... it's easy!!

===Use the CVS installation script===
If your Moodle is already installed via CVS please use the CVS updater (see below). Running the CVS installer will install only the standard version of Moodle on your server.

If you already have a working Moodle on your server then this script copies the file config.php into your new installation but it does not copy your additional modules or plugins or themes. You will find your old moodle folder in same directory and it will be renamed with an additional date stamp.

<pre>
#! /bin/sh
#
# CVS installer for Moodle
# on a Mac OS X Server
#
# 20100818 - Ralf Krause
#

export CVS_RSH=ssh

### file ~/.cvspass must exist
if ! test -e ~/.cvspass ; then
touch ~/.cvspass
fi

echo
echo "+--------------------------------------------+"
echo "| CVS installer for the Moodle server "
echo "+--------------------------------------------+"
echo

cd /Library/WebServer/Documents

### get the cvs installation into a tmp folder
if ! test -e tmp ; then
sudo mkdir tmp
sudo chmod 777 tmp
fi

echo "Connecting to the CVS server. Download will take a few moments!"
echo "If the CVS update runs too long you may break with <ctrl>-C"
echo

### do the cvs installation
cd tmp
cvs -z9 -d:pserver:anonymous@uk.cvs.moodle.org:/cvsroot/moodle co -P -r MOODLE_19_WEEKLY moodle
cd ..

### copy config.php from your current moodle folder if it exists
if ! test -e moodle/config.php ; then
cp moodle19/config.php tmp/moodle/config.php
fi

### move the new moodle to the right place
DATE=`date +%Y%m%d-%H%M`
sudo mv moodle19 moodle19-$DATE
sudo mv tmp/moodle moodle19
sudo chown -R _www moodle19
</pre>

===Use the CVS update script===
To be able to update Moodle via CVS please check that your Moodle was already installed via CVS (see above).

<pre>
#! /bin/sh
#
# CVS updater for Moodle
# on a Mac OS X Server
#
# 20100818 - Ralf Krause
#

export CVS_RSH=ssh

echo
echo "+--------------------------------------------+"
echo "| CVS updater for the Moodle server "
echo "+--------------------------------------------+"
echo

cd /Library/WebServer/Documents/moodle19/

### file ~/.cvspass must exist
if ! test -e ~/.cvspass ; then
touch ~/.cvspass
fi

### login to the cvs server only for the first time
if ! grep "uk.cvs.moodle.org" ~/.cvspass > /dev/null ; then
echo "CVS password is empty ... please only press <return> to start"
sudo cvs -d :pserver:anonymous@uk.cvs.moodle.org:/cvsroot/moodle login
echo
fi

echo "Connecting to the CVS server. Download will take a few moments!"
echo "If the CVS update runs too long you may break with <ctrl>-C"
echo

### do the cvs installation
sudo cvs -q update -dP -r MOODLE_19_WEEKLY
sudo chown -R _www .
</pre>

Please look at the documentation [https://docs.moodle.org/en/CVS_for_Administrators CVS for Administrators] if you want to learn more about Moodle and CVS. There you will also find a list of different [https://docs.moodle.org/en/CVS_for_Administrators#CVS_Servers CVS servers for Moodle] which you may choose for your updates.

The shown update script should be modified in only three things ... first you need to choose the correct folder for the Moodle files, second choose a CVS server near your server place to minimate internet traffic, and third you must input the correct CVS tag for the Moodle version in the last line. The shown script is for updating the version Moodle 1.9
* Moodle 1.8 uses MOODLE_18_WEEKLY
* Moodle 1.9 uses MOODLE_19_WEEKLY
* Moodle 2.0 RC1 still uses HEAD

===Troubleshooting===

If you see something like this, make sure that there is not some firewall blocking the port (it's 2401):

$ cvs -d:pserver:anonymous@us.cvs.moodle.org:/cvsroot/moodle login
Logging in to :pserver:anonymous@us.cvs.moodle.org:2401/cvsroot/moodle
CVS password:
cvs [login aborted]: connect to us.cvs.moodle.org(130.212.64.111):2401 failed: Connection timed out

===Install Xcode Tools and CVS on your Mac Server===

To test if cvs is already on your Mac Server please open the Terminal and type ''cvs -v''. The output of this command should show a version notice of your Concurrent Versions System (CVS). If you get the ''command not found'' message then you must search for your Mac OS X 10.5 Server installation media. You will find the Xcode Tools on your installation CD or DVD set.

If you can't find your installation media anymore you also can download the Xcode Tools from the URL http://developer.apple.com/tools/xcode/. It is free but you have to register as a developer. Starting the download then the Xcode package copies a lot of bytes on your harddisk and will need a very few minutes to complete.

After you installed the Xcode Tools in your server system you will get the correct version answer from the Terminal command ''cvs -v''. If you only want to update your Moodle you do not need all these nice developer tools from the inside of the folder. Sorry about this but there is no separate installer for the CVS update process.

If cvs does not work on your server please check that the port 2401 is open.
  

==User administration via LDAP==

The following settings will work on 10.5 Server running LDAP - edit them to customize to your own environment. Please note that moodle requires some fields - it is best to have these fields completed in Workgroup Manager on 10.5 Server - otherwise they'll be prompted to enter info into their moodle profile on first login, but the way we've got it set up, moodle can't modify LDAP for security and data integrity. The necessary fields are user name, first name, surname, Email address, City/Town, country, description, ID number.
<pre>
LDAP SERVER SETTINGS
Host URL = ourserver.example.com
Version = 3
LDAP encoding = utf-8

BIND SETTINGS
Hide passwords = Yes
Distinguished Name = (blank)
Password = (blank)

USER LOOKUP SETTINGS
User type = posixAccount (rfc2307)
Contexts = cn=users,dc=ourserver,dc=example,dc=com
Search subcontexts = Yes
Dereference aliases = No
User attribute = (blank)
Member attribute = (blank)
Member attribute uses dn = (blank)
Object class = (blank)

FORCE CHANGE PASSWORD
Force change password = No
Use standard Change Password Page = No
Password format = Plain text
Password change URL = (blank)

LDAP PASSWORD EXPIRATION SETTINGS
Expiration = no
Expiration warning = 10
Expiration attribute = ""
Grace logins = No
Grace login attribute = (blank)

ENABLE USER CREATION
Create users externally = No
Context for new users = (blank)

COURSE CREATOR
Creators = (blank)

CRON SYNCHRONIZATION SCRIPT
Removed ext user = Keep internal

NTLM SSO
Enable = No
Subnet = (blank)
First name = givenName (On every login, Never, Locked)
Surname = sn (On every login, Never, Locked)
Email address = mail (On every login, Never, Locked)
Phone 1 = (blank)
Phone 2 = (blank)
Department = (blank)
Address = (blank)
City/Town = l (On every login, Never, Locked)
Country = c (On every login, Never, Locked)
Description = description (On every login, Never, Locked)
ID number = uidNumber (On every login, Never, Locked)
Language = (blank)
</pre>

==See also==
* [[Complete Install Packages for Mac OS X | Complete install packages for Mac OS X Clients 10.4/10.5/10.6]]
* [[Step-by-step Guide for Installing Moodle on Mac OS X 10.4 Client|Step by step installation on a Mac OS X Client 10.4]]
* [[Cron | Installation of cron for Moodle]]
* [[CVS for Administrators]]

* [http://moodle.org/mod/forum/discuss.php?d=24632 Using Moodle: Dynamic DNS Home Server]

[[Category:Administrator]]
[[Category:Installation]]
[[Category:Mac OS X]]

CVS for Administrators

2010-10-21T13:41:41Z

Krause: /* From a Mac OS X computer */

The [http://cvs.moodle.org/ CVS archive] contains all the source code for Moodle. You can use a CVS program to extract versions ranging from the most stable release to the most cutting-edge development version. CVS can be an extremely convenient way of maintaining a Moodle server.

[[Image:Cvstree.png|CVS tree]]

Developers may have selective write access to the Moodle CVS archive (see [[CVS for Developers]] for details about how to do this). However, most people only need read-only access, so they can just connect to one of the mirrors using '''anonymous CVS''' as described below. There can however currently be a delay of up to 1 hour between the time a developer commits changes to developer CVS and the time it becomes available on anonymous CVS.

==CVS Servers==

Please choose the closest CVS mirror server to you from this list:

{| border="1" cellpadding="4" cellspacing="0"
|'''Country'''
|'''Server'''
|'''Provided by'''
|-
|EU
|'''eu.cvs.moodle.org'''
|[http://www.open.ac.uk/ The Open University] In case of trouble, contact [mailto:r.t.c.norfor@open.ac.uk Rod Norfor] or [mailto:d.a.woolhead@open.ac.uk Derek Woolhead]
|-
|ES
|'''es.cvs.moodle.org'''
|[http://www.mondragon.edu/ Mondragon Unibertsitatea] In case of trouble, contact [mailto:iarenuno@eteo.mondragon.edu iarenuno@eteo.mondragon.edu] or [mailto:iarenaza@escomposlinux.org iarenaza@escomposlinux.org]
|-
|UK
|'''uk.cvs.moodle.org'''
|Cumbria and Lancashire Education Online ([http://www.cleo.net.uk/ CLEO]) in collaboration with Lancaster University Network Services ([http://www.luns.net.uk/ LUNS])
|-
|US
|'''us.cvs.moodle.org'''
|San Francisco State University, Academic Technology ([http://www.sfsu.edu/ SFSU]). In case of trouble, contact [mailto:ilearn@sfsu.edu iLearn support]
|-
|US
|'''us2.cvs.moodle.org'''
|[http://www.contractorsinstitute.com The Contractors Institute] pserver and viewvc. In case of trouble contact [mailto:cvs@contractorsinstitute.com network support].
|}

Replace the SERVER.cvs.moodle.org in the instructions below with the server you chose above!

For up-to-date alerts about planned or unplanned outages on any of these servers subscribe to the [http://lists.moodle.org/info/outages Moodle Outage mailing list]. See [http://moodle.org/stats/network.php moodle.org/stats/network.php] for server availability.

(If you would like to contribute to the project by running a mirror, please see [[How to set up a CVS mirror]])

==Moodle versions and CVS branches==

CVS stores every version of Moodle there has ever been. Versions are organised into branches as in the diagram at the top of this page. There is one branch for each series of stable releases, so the 1.9.x releases all come from the MOODLE_19_STABLE branch.

Along that branch, each actual release is marked with a tag. For example the Moodle 1.9 release is tagged MOODLE_19, and the 1.9.1 release is MOODLE_191. The latest 1.9.x+ weekly build is always tagged MOODLE_19_WEEKLY.

The latest development version is what all the stable branches branch away from. It is sometimes called HEAD or TRUNK. At the moment (mid 2009) this is the development version of Moodle 2.0, but around the time we get to the Moodle 2.0 beta release we will create the MOODLE_20_STABLE branch, and HEAD will become 2.1 dev.

As explained below you when you do a CVS checkout, you choose which version you want.

==Installing and maintaining Moodle via CVS==

===From a Unix computer===

To connect and login for the first time to the CVS server, you can use this command (remember to replace '''SERVER.cvs.moodle.org''' in the instructions below with the mirror server you chose above):

cvs -d:pserver:anonymous@SERVER.cvs.moodle.org:/cvsroot/moodle login

There is no password - when asked for one, just hit Enter.

To checkout (download) the entire Moodle code for the first time, use this command to get the latest WEEKLY version (generally the latest, most bug free version):

cvs -z3 -d:pserver:anonymous@SERVER.cvs.moodle.org:/cvsroot/moodle co -P -r MOODLE_19_WEEKLY moodle

Or the latest development version - sometimes called HEAD - (not for production use):

cvs -z3 -d:pserver:anonymous@SERVER.cvs.moodle.org:/cvsroot/moodle co -P moodle

Or the modules in Contrib

cvs -z3 -d:pserver:anonymous@SERVER.cvs.moodle.org:/cvsroot/moodle co contrib

Later, to update your local copy of Moodle to the current version in CVS you just need to go into your local Moodle directory and type:

cvs update -dP

To update your local copy of Moodle to a new version (e.g. from 1.8+ to 1.9), go into your local Moodle directory and type:

cvs update -dP -r MOODLE_19_STABLE

To update your local copy of Moodle to a version from a specific date (e.g. 4th February 2009), go into your local Moodle directory and type:

cvs -q update -dP -r MOODLE_19_STABLE -D "4 Feb 2009"

To update your local copy and to save the log of the process, use the following command instead the previous one:

cvs update -dP -r MOODLE_19_STABLE | tee upgrade.log

Then look at the upgrade.log, notably look for lines starting with "C" (conflict):

grep '^C' upgrade.log

Conflicts may appear in case you have manually modified your source files. You have to resolve conflicts before using the site. See [[CVS for Developers]] for more details.

===Changing the directory name===

By default, the CVS checkout creates a directory on your webserver called 'moodle'. If you want your Moodle installation in a different directory, you can change the name of the directory that it will checkout the files to, by typing the following. This would download the MOODLE_19_STABLE branch into a directory called "mydirectory" (-d mydirectory).

cvs -z3 -d:pserver:anonymous@SERVER.cvs.moodle.org:/cvsroot/moodle co -P '''-d mydirectory''' -r MOODLE_19_STABLE moodle

Or the latest development version to a directory called 'moodle-dev':

cvs -z3 -d:pserver:anonymous@SERVER.cvs.moodle.org:/cvsroot/moodle co -P '''-d moodle-dev''' moodle

You can also change the name of the directory after the files are downloaded, and before you go through the Moodle install process. If you change the name of the directory before install, it will not affect anything during the install or during a CVS update. If you change the name of the directory after an install, you will need to change the config.php to reflect the name change ([[Moodle_migration#Migrating_a_complete_Moodle_site|guidance here]]). It won't affect the CVS update though.

===Change directory owner===

Depending on your webserver setup, you may well need to change the owner of the directory to the webserver user. Follow this step if you get permissions error when you try to access the page. For apache:

chown -R www-data:www-data moodle

===From a Windows computer===

To get started with a fresh copy of Moodle, follow the following steps (remember to replace '''SERVER.cvs.moodle.org''' in the instructions below with the mirror server you chose above):[[Image:CVS moodle settings for tortoise CVS.jpg|thumb|Tortoise CVS Screen capture]]
[[Image:Ecran cvs.jpg|thumb|Tortoise CVS (real name) Screen capture]]
# Get TortoiseCVS from [http://www.tortoisecvs.org/ tortoisecvs.org] and install it, then reboot.
# Find or create a new folder somewhere where you want Moodle to be downloaded to.
# Right-mouse-click that folder and choose "CVS Checkout" from the menu. You should see a dialog box.
# Copy this text into the CVSROOT field: <code>:pserver:anonymous@SERVER.cvs.moodle.org:/cvsroot/moodle</code>
#* NOTE - replace "SERVER" with "eu", "es", "uk" or "us" depending on your location.
# Under the "Module" field, type "moodle" to get moodle. (Other options here include"contrib" to get the contrib directory of hacks and addons, or "mysql" to get the optional MySQL Admin module).
#* For the latest STABLE version, click on the "Revision" tab and then check the radio button labelled "Choose branch or tag". From the drop-down menu select MOODLE_18_STABLE.
#* If you don't see the very latest version in the long drop-down list under Branch or tag name, click the Update List button next to it and wait for the list to be updated.
#* For the latest UNSTABLE development version, the radio-button "Use HEAD branch" in the Revision tab should be checked.
# Press the button: "OK" and everything should be downloaded.

Later, to update your local copy of Moodle to the current version in CVS, just right-mouse-click the folder and choose "CVS Update".

Note that the enclosing moodle folder is self-contained - you can move it anywhere you like or even rename it.

'''NOTE.-''' Admins with a developer account on cvs.moodle.org can connect with their account name, see attached screen shot.

===From a Mac OS X computer===
You will find useful informations about CVS and Mac OS X in the documentation for the complete installation package Moodle4Mac and for the Mac OS X Server installation.

Please read [[Complete_Install_Packages_for_Mac_OS_X#How_To_Update_Your_Moodle4Mac | How to update your Moodle4Mac]] or [[Step_by_Step_Installation_on_a_Mac_OS_X_Server#How_to_install_and_update_Moodle_via_CVS | How to install and to update Moodle via CVS]]. It works fine with the Moodle CVS servers.

===Troubleshooting===

If you see something like this, make sure that there is not some firewall blocking the port (it's 2401):

$ cvs -d:pserver:anonymous@us.cvs.moodle.org:/cvsroot/moodle login
Logging in to :pserver:anonymous@us.cvs.moodle.org:2401/cvsroot/moodle
CVS password:
cvs [login aborted]: connect to us.cvs.moodle.org(130.212.64.111):2401 failed: Connection timed out

==Switching to a new CVS server==

If you were ''already'' using CVS and want to switch to a different server, you'll probably need to make a small change so that the control files in your working copy will point to the new mirrors.

===Switching to a new server on Unix===

Use a shell command like this to change existing installations to point to the new mirror (UK mirror used in this example):

'''find . -type f -name Root -print0 | xargs -0 perl -pi -e 's/\@moodle\.cvs\.sourceforge\.net/\@uk\.cvs\.moodle\.org/''''

It can be run from /home, say, to fix multiple sites at once.

===Switching to a new server with TortoiseCVS===

If you were ''already'' using Tortoise CVS on Windows it's tricky, because Tortoise doesn't have any interface for changing the server. http://www.tortoisecvs.org/faq.html#changecvsroot explains it. But basically,

1) Install WinCVS and launch it.
2) Navigate to and select your Moodle folder.
3) Choose 'Macros'->CVS->Change Root from the menu.
4) Accept (or change) the default for the 'old' server.
5) Type the new server name. OK!

It takes a few seconds to go through all of the '''cvs''' folders and update the '''root''' files.

By the way, if you don't want to install WinCVS, another way of doing this is to uninstall your TortoiseCVS client on Windows, then do a regedit to clean up all the tortoisecvs related entries (might not be necessary), then reinstall TortoiseCVS client again (a good reason to upgrade to the most recent version of TortoiseCVS!). I have tested this and it cleared up the original setting of the original anonymous CVS server setting.

==See also==

*[[Talk:CVS for Administrators]]
*[[Development:CVS_for_developers|CVS for developers]]
*[[Development:Setting up Eclipse]] for step by step instructions for setting up the [http://www.eclipse.org/ Eclipse IDE] for Moodle development, which including how to do the necessary CVS operations
*[[Development:Setting up Netbeans]] step by step instructions for those who prefer the [http://netbeans.org/ NetBeans IDE]. NetBeans comes with integrated CVS support.
* [[Development:Tracking Moodle CVS with git]]
Using Moodle forum discussions:
*[http://moodle.org/mod/forum/discuss.php?d=26731&parent=125858 Using cvs]
*[http://moodle.org/mod/forum/discuss.php?d=91891 CVS Updating of 3rd-Party Plug-ins in the Moodle folder itself]
*[http://moodle.org/mod/forum/discuss.php?d=108196 simple question for cvs]

[[Category:Administrator]]
[[Category:Developer]]
[[Category:Developer tools]]

[[de:CVS für Administratoren]]
[[fr:CVS pour administrateurs]]
[[ja:管理者用CVS]]
[[ru:CVS для администраторов]]

CVS for Administrators

2010-10-21T13:40:53Z

Krause: /* From a Mac OS X computer */

The [http://cvs.moodle.org/ CVS archive] contains all the source code for Moodle. You can use a CVS program to extract versions ranging from the most stable release to the most cutting-edge development version. CVS can be an extremely convenient way of maintaining a Moodle server.

[[Image:Cvstree.png|CVS tree]]

Developers may have selective write access to the Moodle CVS archive (see [[CVS for Developers]] for details about how to do this). However, most people only need read-only access, so they can just connect to one of the mirrors using '''anonymous CVS''' as described below. There can however currently be a delay of up to 1 hour between the time a developer commits changes to developer CVS and the time it becomes available on anonymous CVS.

==CVS Servers==

Please choose the closest CVS mirror server to you from this list:

{| border="1" cellpadding="4" cellspacing="0"
|'''Country'''
|'''Server'''
|'''Provided by'''
|-
|EU
|'''eu.cvs.moodle.org'''
|[http://www.open.ac.uk/ The Open University] In case of trouble, contact [mailto:r.t.c.norfor@open.ac.uk Rod Norfor] or [mailto:d.a.woolhead@open.ac.uk Derek Woolhead]
|-
|ES
|'''es.cvs.moodle.org'''
|[http://www.mondragon.edu/ Mondragon Unibertsitatea] In case of trouble, contact [mailto:iarenuno@eteo.mondragon.edu iarenuno@eteo.mondragon.edu] or [mailto:iarenaza@escomposlinux.org iarenaza@escomposlinux.org]
|-
|UK
|'''uk.cvs.moodle.org'''
|Cumbria and Lancashire Education Online ([http://www.cleo.net.uk/ CLEO]) in collaboration with Lancaster University Network Services ([http://www.luns.net.uk/ LUNS])
|-
|US
|'''us.cvs.moodle.org'''
|San Francisco State University, Academic Technology ([http://www.sfsu.edu/ SFSU]). In case of trouble, contact [mailto:ilearn@sfsu.edu iLearn support]
|-
|US
|'''us2.cvs.moodle.org'''
|[http://www.contractorsinstitute.com The Contractors Institute] pserver and viewvc. In case of trouble contact [mailto:cvs@contractorsinstitute.com network support].
|}

Replace the SERVER.cvs.moodle.org in the instructions below with the server you chose above!

For up-to-date alerts about planned or unplanned outages on any of these servers subscribe to the [http://lists.moodle.org/info/outages Moodle Outage mailing list]. See [http://moodle.org/stats/network.php moodle.org/stats/network.php] for server availability.

(If you would like to contribute to the project by running a mirror, please see [[How to set up a CVS mirror]])

==Moodle versions and CVS branches==

CVS stores every version of Moodle there has ever been. Versions are organised into branches as in the diagram at the top of this page. There is one branch for each series of stable releases, so the 1.9.x releases all come from the MOODLE_19_STABLE branch.

Along that branch, each actual release is marked with a tag. For example the Moodle 1.9 release is tagged MOODLE_19, and the 1.9.1 release is MOODLE_191. The latest 1.9.x+ weekly build is always tagged MOODLE_19_WEEKLY.

The latest development version is what all the stable branches branch away from. It is sometimes called HEAD or TRUNK. At the moment (mid 2009) this is the development version of Moodle 2.0, but around the time we get to the Moodle 2.0 beta release we will create the MOODLE_20_STABLE branch, and HEAD will become 2.1 dev.

As explained below you when you do a CVS checkout, you choose which version you want.

==Installing and maintaining Moodle via CVS==

===From a Unix computer===

To connect and login for the first time to the CVS server, you can use this command (remember to replace '''SERVER.cvs.moodle.org''' in the instructions below with the mirror server you chose above):

cvs -d:pserver:anonymous@SERVER.cvs.moodle.org:/cvsroot/moodle login

There is no password - when asked for one, just hit Enter.

To checkout (download) the entire Moodle code for the first time, use this command to get the latest WEEKLY version (generally the latest, most bug free version):

cvs -z3 -d:pserver:anonymous@SERVER.cvs.moodle.org:/cvsroot/moodle co -P -r MOODLE_19_WEEKLY moodle

Or the latest development version - sometimes called HEAD - (not for production use):

cvs -z3 -d:pserver:anonymous@SERVER.cvs.moodle.org:/cvsroot/moodle co -P moodle

Or the modules in Contrib

cvs -z3 -d:pserver:anonymous@SERVER.cvs.moodle.org:/cvsroot/moodle co contrib

Later, to update your local copy of Moodle to the current version in CVS you just need to go into your local Moodle directory and type:

cvs update -dP

To update your local copy of Moodle to a new version (e.g. from 1.8+ to 1.9), go into your local Moodle directory and type:

cvs update -dP -r MOODLE_19_STABLE

To update your local copy of Moodle to a version from a specific date (e.g. 4th February 2009), go into your local Moodle directory and type:

cvs -q update -dP -r MOODLE_19_STABLE -D "4 Feb 2009"

To update your local copy and to save the log of the process, use the following command instead the previous one:

cvs update -dP -r MOODLE_19_STABLE | tee upgrade.log

Then look at the upgrade.log, notably look for lines starting with "C" (conflict):

grep '^C' upgrade.log

Conflicts may appear in case you have manually modified your source files. You have to resolve conflicts before using the site. See [[CVS for Developers]] for more details.

===Changing the directory name===

By default, the CVS checkout creates a directory on your webserver called 'moodle'. If you want your Moodle installation in a different directory, you can change the name of the directory that it will checkout the files to, by typing the following. This would download the MOODLE_19_STABLE branch into a directory called "mydirectory" (-d mydirectory).

cvs -z3 -d:pserver:anonymous@SERVER.cvs.moodle.org:/cvsroot/moodle co -P '''-d mydirectory''' -r MOODLE_19_STABLE moodle

Or the latest development version to a directory called 'moodle-dev':

cvs -z3 -d:pserver:anonymous@SERVER.cvs.moodle.org:/cvsroot/moodle co -P '''-d moodle-dev''' moodle

You can also change the name of the directory after the files are downloaded, and before you go through the Moodle install process. If you change the name of the directory before install, it will not affect anything during the install or during a CVS update. If you change the name of the directory after an install, you will need to change the config.php to reflect the name change ([[Moodle_migration#Migrating_a_complete_Moodle_site|guidance here]]). It won't affect the CVS update though.

===Change directory owner===

Depending on your webserver setup, you may well need to change the owner of the directory to the webserver user. Follow this step if you get permissions error when you try to access the page. For apache:

chown -R www-data:www-data moodle

===From a Windows computer===

To get started with a fresh copy of Moodle, follow the following steps (remember to replace '''SERVER.cvs.moodle.org''' in the instructions below with the mirror server you chose above):[[Image:CVS moodle settings for tortoise CVS.jpg|thumb|Tortoise CVS Screen capture]]
[[Image:Ecran cvs.jpg|thumb|Tortoise CVS (real name) Screen capture]]
# Get TortoiseCVS from [http://www.tortoisecvs.org/ tortoisecvs.org] and install it, then reboot.
# Find or create a new folder somewhere where you want Moodle to be downloaded to.
# Right-mouse-click that folder and choose "CVS Checkout" from the menu. You should see a dialog box.
# Copy this text into the CVSROOT field: <code>:pserver:anonymous@SERVER.cvs.moodle.org:/cvsroot/moodle</code>
#* NOTE - replace "SERVER" with "eu", "es", "uk" or "us" depending on your location.
# Under the "Module" field, type "moodle" to get moodle. (Other options here include"contrib" to get the contrib directory of hacks and addons, or "mysql" to get the optional MySQL Admin module).
#* For the latest STABLE version, click on the "Revision" tab and then check the radio button labelled "Choose branch or tag". From the drop-down menu select MOODLE_18_STABLE.
#* If you don't see the very latest version in the long drop-down list under Branch or tag name, click the Update List button next to it and wait for the list to be updated.
#* For the latest UNSTABLE development version, the radio-button "Use HEAD branch" in the Revision tab should be checked.
# Press the button: "OK" and everything should be downloaded.

Later, to update your local copy of Moodle to the current version in CVS, just right-mouse-click the folder and choose "CVS Update".

Note that the enclosing moodle folder is self-contained - you can move it anywhere you like or even rename it.

'''NOTE.-''' Admins with a developer account on cvs.moodle.org can connect with their account name, see attached screen shot.

===From a Mac OS X computer===
You will find useful informations about CVS and Mac OS X in the documentation for the complete installation package Moodle4Mac and for the Mac OS X Server installation.

Please read [[Complete_Install_Packages_for_Mac_OS_X#How_To_Update_Your_Moodle4Mac | How to update your Moodle4Mac]] or [[Step_by_Step_Installation_on_a_Mac_OS_X_Server#How_to_install_and_update_Moodle_via_CVS | How ti install and to update Moodle via CVS]]. It works fine with the Moodle CVS servers.

===Troubleshooting===

If you see something like this, make sure that there is not some firewall blocking the port (it's 2401):

$ cvs -d:pserver:anonymous@us.cvs.moodle.org:/cvsroot/moodle login
Logging in to :pserver:anonymous@us.cvs.moodle.org:2401/cvsroot/moodle
CVS password:
cvs [login aborted]: connect to us.cvs.moodle.org(130.212.64.111):2401 failed: Connection timed out

==Switching to a new CVS server==

If you were ''already'' using CVS and want to switch to a different server, you'll probably need to make a small change so that the control files in your working copy will point to the new mirrors.

===Switching to a new server on Unix===

Use a shell command like this to change existing installations to point to the new mirror (UK mirror used in this example):

'''find . -type f -name Root -print0 | xargs -0 perl -pi -e 's/\@moodle\.cvs\.sourceforge\.net/\@uk\.cvs\.moodle\.org/''''

It can be run from /home, say, to fix multiple sites at once.

===Switching to a new server with TortoiseCVS===

If you were ''already'' using Tortoise CVS on Windows it's tricky, because Tortoise doesn't have any interface for changing the server. http://www.tortoisecvs.org/faq.html#changecvsroot explains it. But basically,

1) Install WinCVS and launch it.
2) Navigate to and select your Moodle folder.
3) Choose 'Macros'->CVS->Change Root from the menu.
4) Accept (or change) the default for the 'old' server.
5) Type the new server name. OK!

It takes a few seconds to go through all of the '''cvs''' folders and update the '''root''' files.

By the way, if you don't want to install WinCVS, another way of doing this is to uninstall your TortoiseCVS client on Windows, then do a regedit to clean up all the tortoisecvs related entries (might not be necessary), then reinstall TortoiseCVS client again (a good reason to upgrade to the most recent version of TortoiseCVS!). I have tested this and it cleared up the original setting of the original anonymous CVS server setting.

==See also==

*[[Talk:CVS for Administrators]]
*[[Development:CVS_for_developers|CVS for developers]]
*[[Development:Setting up Eclipse]] for step by step instructions for setting up the [http://www.eclipse.org/ Eclipse IDE] for Moodle development, which including how to do the necessary CVS operations
*[[Development:Setting up Netbeans]] step by step instructions for those who prefer the [http://netbeans.org/ NetBeans IDE]. NetBeans comes with integrated CVS support.
* [[Development:Tracking Moodle CVS with git]]
Using Moodle forum discussions:
*[http://moodle.org/mod/forum/discuss.php?d=26731&parent=125858 Using cvs]
*[http://moodle.org/mod/forum/discuss.php?d=91891 CVS Updating of 3rd-Party Plug-ins in the Moodle folder itself]
*[http://moodle.org/mod/forum/discuss.php?d=108196 simple question for cvs]

[[Category:Administrator]]
[[Category:Developer]]
[[Category:Developer tools]]

[[de:CVS für Administratoren]]
[[fr:CVS pour administrateurs]]
[[ja:管理者用CVS]]
[[ru:CVS для администраторов]]

CVS for Administrators

2010-10-21T13:39:44Z

Krause: /* From a Mac OS X computer */

The [http://cvs.moodle.org/ CVS archive] contains all the source code for Moodle. You can use a CVS program to extract versions ranging from the most stable release to the most cutting-edge development version. CVS can be an extremely convenient way of maintaining a Moodle server.

[[Image:Cvstree.png|CVS tree]]

Developers may have selective write access to the Moodle CVS archive (see [[CVS for Developers]] for details about how to do this). However, most people only need read-only access, so they can just connect to one of the mirrors using '''anonymous CVS''' as described below. There can however currently be a delay of up to 1 hour between the time a developer commits changes to developer CVS and the time it becomes available on anonymous CVS.

==CVS Servers==

Please choose the closest CVS mirror server to you from this list:

{| border="1" cellpadding="4" cellspacing="0"
|'''Country'''
|'''Server'''
|'''Provided by'''
|-
|EU
|'''eu.cvs.moodle.org'''
|[http://www.open.ac.uk/ The Open University] In case of trouble, contact [mailto:r.t.c.norfor@open.ac.uk Rod Norfor] or [mailto:d.a.woolhead@open.ac.uk Derek Woolhead]
|-
|ES
|'''es.cvs.moodle.org'''
|[http://www.mondragon.edu/ Mondragon Unibertsitatea] In case of trouble, contact [mailto:iarenuno@eteo.mondragon.edu iarenuno@eteo.mondragon.edu] or [mailto:iarenaza@escomposlinux.org iarenaza@escomposlinux.org]
|-
|UK
|'''uk.cvs.moodle.org'''
|Cumbria and Lancashire Education Online ([http://www.cleo.net.uk/ CLEO]) in collaboration with Lancaster University Network Services ([http://www.luns.net.uk/ LUNS])
|-
|US
|'''us.cvs.moodle.org'''
|San Francisco State University, Academic Technology ([http://www.sfsu.edu/ SFSU]). In case of trouble, contact [mailto:ilearn@sfsu.edu iLearn support]
|-
|US
|'''us2.cvs.moodle.org'''
|[http://www.contractorsinstitute.com The Contractors Institute] pserver and viewvc. In case of trouble contact [mailto:cvs@contractorsinstitute.com network support].
|}

Replace the SERVER.cvs.moodle.org in the instructions below with the server you chose above!

For up-to-date alerts about planned or unplanned outages on any of these servers subscribe to the [http://lists.moodle.org/info/outages Moodle Outage mailing list]. See [http://moodle.org/stats/network.php moodle.org/stats/network.php] for server availability.

(If you would like to contribute to the project by running a mirror, please see [[How to set up a CVS mirror]])

==Moodle versions and CVS branches==

CVS stores every version of Moodle there has ever been. Versions are organised into branches as in the diagram at the top of this page. There is one branch for each series of stable releases, so the 1.9.x releases all come from the MOODLE_19_STABLE branch.

Along that branch, each actual release is marked with a tag. For example the Moodle 1.9 release is tagged MOODLE_19, and the 1.9.1 release is MOODLE_191. The latest 1.9.x+ weekly build is always tagged MOODLE_19_WEEKLY.

The latest development version is what all the stable branches branch away from. It is sometimes called HEAD or TRUNK. At the moment (mid 2009) this is the development version of Moodle 2.0, but around the time we get to the Moodle 2.0 beta release we will create the MOODLE_20_STABLE branch, and HEAD will become 2.1 dev.

As explained below you when you do a CVS checkout, you choose which version you want.

==Installing and maintaining Moodle via CVS==

===From a Unix computer===

To connect and login for the first time to the CVS server, you can use this command (remember to replace '''SERVER.cvs.moodle.org''' in the instructions below with the mirror server you chose above):

cvs -d:pserver:anonymous@SERVER.cvs.moodle.org:/cvsroot/moodle login

There is no password - when asked for one, just hit Enter.

To checkout (download) the entire Moodle code for the first time, use this command to get the latest WEEKLY version (generally the latest, most bug free version):

cvs -z3 -d:pserver:anonymous@SERVER.cvs.moodle.org:/cvsroot/moodle co -P -r MOODLE_19_WEEKLY moodle

Or the latest development version - sometimes called HEAD - (not for production use):

cvs -z3 -d:pserver:anonymous@SERVER.cvs.moodle.org:/cvsroot/moodle co -P moodle

Or the modules in Contrib

cvs -z3 -d:pserver:anonymous@SERVER.cvs.moodle.org:/cvsroot/moodle co contrib

Later, to update your local copy of Moodle to the current version in CVS you just need to go into your local Moodle directory and type:

cvs update -dP

To update your local copy of Moodle to a new version (e.g. from 1.8+ to 1.9), go into your local Moodle directory and type:

cvs update -dP -r MOODLE_19_STABLE

To update your local copy of Moodle to a version from a specific date (e.g. 4th February 2009), go into your local Moodle directory and type:

cvs -q update -dP -r MOODLE_19_STABLE -D "4 Feb 2009"

To update your local copy and to save the log of the process, use the following command instead the previous one:

cvs update -dP -r MOODLE_19_STABLE | tee upgrade.log

Then look at the upgrade.log, notably look for lines starting with "C" (conflict):

grep '^C' upgrade.log

Conflicts may appear in case you have manually modified your source files. You have to resolve conflicts before using the site. See [[CVS for Developers]] for more details.

===Changing the directory name===

By default, the CVS checkout creates a directory on your webserver called 'moodle'. If you want your Moodle installation in a different directory, you can change the name of the directory that it will checkout the files to, by typing the following. This would download the MOODLE_19_STABLE branch into a directory called "mydirectory" (-d mydirectory).

cvs -z3 -d:pserver:anonymous@SERVER.cvs.moodle.org:/cvsroot/moodle co -P '''-d mydirectory''' -r MOODLE_19_STABLE moodle

Or the latest development version to a directory called 'moodle-dev':

cvs -z3 -d:pserver:anonymous@SERVER.cvs.moodle.org:/cvsroot/moodle co -P '''-d moodle-dev''' moodle

You can also change the name of the directory after the files are downloaded, and before you go through the Moodle install process. If you change the name of the directory before install, it will not affect anything during the install or during a CVS update. If you change the name of the directory after an install, you will need to change the config.php to reflect the name change ([[Moodle_migration#Migrating_a_complete_Moodle_site|guidance here]]). It won't affect the CVS update though.

===Change directory owner===

Depending on your webserver setup, you may well need to change the owner of the directory to the webserver user. Follow this step if you get permissions error when you try to access the page. For apache:

chown -R www-data:www-data moodle

===From a Windows computer===

To get started with a fresh copy of Moodle, follow the following steps (remember to replace '''SERVER.cvs.moodle.org''' in the instructions below with the mirror server you chose above):[[Image:CVS moodle settings for tortoise CVS.jpg|thumb|Tortoise CVS Screen capture]]
[[Image:Ecran cvs.jpg|thumb|Tortoise CVS (real name) Screen capture]]
# Get TortoiseCVS from [http://www.tortoisecvs.org/ tortoisecvs.org] and install it, then reboot.
# Find or create a new folder somewhere where you want Moodle to be downloaded to.
# Right-mouse-click that folder and choose "CVS Checkout" from the menu. You should see a dialog box.
# Copy this text into the CVSROOT field: <code>:pserver:anonymous@SERVER.cvs.moodle.org:/cvsroot/moodle</code>
#* NOTE - replace "SERVER" with "eu", "es", "uk" or "us" depending on your location.
# Under the "Module" field, type "moodle" to get moodle. (Other options here include"contrib" to get the contrib directory of hacks and addons, or "mysql" to get the optional MySQL Admin module).
#* For the latest STABLE version, click on the "Revision" tab and then check the radio button labelled "Choose branch or tag". From the drop-down menu select MOODLE_18_STABLE.
#* If you don't see the very latest version in the long drop-down list under Branch or tag name, click the Update List button next to it and wait for the list to be updated.
#* For the latest UNSTABLE development version, the radio-button "Use HEAD branch" in the Revision tab should be checked.
# Press the button: "OK" and everything should be downloaded.

Later, to update your local copy of Moodle to the current version in CVS, just right-mouse-click the folder and choose "CVS Update".

Note that the enclosing moodle folder is self-contained - you can move it anywhere you like or even rename it.

'''NOTE.-''' Admins with a developer account on cvs.moodle.org can connect with their account name, see attached screen shot.

===From a Mac OS X computer===
You will find some information about CVS and Mac OS X in the documentation for the complete installation package Moodle4Mac and for the Mac OS X Server installation.
Please read [[Complete_Install_Packages_for_Mac_OS_X#How_To_Update_Your_Moodle4Mac | How to update your Moodle4Mac]] or [[Step_by_Step_Installation_on_a_Mac_OS_X_Server#How_to_install_and_update_Moodle_via_CVS | How ti install and to update Moodle via CVS]]. It works fine with the Moodle CVS servers.

===Troubleshooting===

If you see something like this, make sure that there is not some firewall blocking the port (it's 2401):

$ cvs -d:pserver:anonymous@us.cvs.moodle.org:/cvsroot/moodle login
Logging in to :pserver:anonymous@us.cvs.moodle.org:2401/cvsroot/moodle
CVS password:
cvs [login aborted]: connect to us.cvs.moodle.org(130.212.64.111):2401 failed: Connection timed out

==Switching to a new CVS server==

If you were ''already'' using CVS and want to switch to a different server, you'll probably need to make a small change so that the control files in your working copy will point to the new mirrors.

===Switching to a new server on Unix===

Use a shell command like this to change existing installations to point to the new mirror (UK mirror used in this example):

'''find . -type f -name Root -print0 | xargs -0 perl -pi -e 's/\@moodle\.cvs\.sourceforge\.net/\@uk\.cvs\.moodle\.org/''''

It can be run from /home, say, to fix multiple sites at once.

===Switching to a new server with TortoiseCVS===

If you were ''already'' using Tortoise CVS on Windows it's tricky, because Tortoise doesn't have any interface for changing the server. http://www.tortoisecvs.org/faq.html#changecvsroot explains it. But basically,

1) Install WinCVS and launch it.
2) Navigate to and select your Moodle folder.
3) Choose 'Macros'->CVS->Change Root from the menu.
4) Accept (or change) the default for the 'old' server.
5) Type the new server name. OK!

It takes a few seconds to go through all of the '''cvs''' folders and update the '''root''' files.

By the way, if you don't want to install WinCVS, another way of doing this is to uninstall your TortoiseCVS client on Windows, then do a regedit to clean up all the tortoisecvs related entries (might not be necessary), then reinstall TortoiseCVS client again (a good reason to upgrade to the most recent version of TortoiseCVS!). I have tested this and it cleared up the original setting of the original anonymous CVS server setting.

==See also==

*[[Talk:CVS for Administrators]]
*[[Development:CVS_for_developers|CVS for developers]]
*[[Development:Setting up Eclipse]] for step by step instructions for setting up the [http://www.eclipse.org/ Eclipse IDE] for Moodle development, which including how to do the necessary CVS operations
*[[Development:Setting up Netbeans]] step by step instructions for those who prefer the [http://netbeans.org/ NetBeans IDE]. NetBeans comes with integrated CVS support.
* [[Development:Tracking Moodle CVS with git]]
Using Moodle forum discussions:
*[http://moodle.org/mod/forum/discuss.php?d=26731&parent=125858 Using cvs]
*[http://moodle.org/mod/forum/discuss.php?d=91891 CVS Updating of 3rd-Party Plug-ins in the Moodle folder itself]
*[http://moodle.org/mod/forum/discuss.php?d=108196 simple question for cvs]

[[Category:Administrator]]
[[Category:Developer]]
[[Category:Developer tools]]

[[de:CVS für Administratoren]]
[[fr:CVS pour administrateurs]]
[[ja:管理者用CVS]]
[[ru:CVS для администраторов]]

Step by Step Installation on a Mac OS X Server

2010-10-21T13:33:13Z

Krause: /* See also */

==Overview==
This guide shows all steps for the installation of Moodle on a [http://www.apple.com/server/macosx Mac OS X Server]. This server is a commercial product. You will find [http://www.apple.com/server/macosx/resources/documentation.html all documentations] about the web server on the Apple support pages.

This installation guide can't be useful for an installation on MAMP or XAMPP. If you are looking for an easy way to install Moodle on your local machine please use [[Complete Install Packages for Mac OS X | Complete install packages for Mac OS X 10.4/10.5/10.6 Clients]] that can be downloaded from http://download.moodle.org/macosx/ ... but if you are planning to set up a Moodle internet server on a Mac then you should think about some more security as the ever local package could give.

Please feel free to add your ideas and wishes to the discussion page for this article. You may also write a complete chapter if you tried the facts yourself on your own Mac Server. I am most interested to make the things better.

==System requirements==

+ Apple Computer
+ Mac mini, Mac Pro or Xserve
+ Processor: Intel Core 2 Duo, i5, i7
+ RAM: 2 GB or better
+ Hard Disk: 500 MB free
+ System Software: Mac OS X Server 10.5 or 10.6

==Configure PHP for your Moodle installation==
===Mac OS X 10.6 Server - No PHP installation needed===

The Mac OS X 10.6.4 Server (SnowLeopard) comes with PHP 5.3.2 and a lot of PHP extensions. This would be the best choice for Moodle 1.9.x and for Moodle 2.0 on a Mac OS X Server. Please forget everything you read about the missing GD Library! The PHP installation is totally complete for Moodle. You only have to control if the PHP module is switched on and if the php.ini does the right settings. You should open the file /etc/php.ini and control the settings for Moodle.

===Mac OS X 10.5 Server - Install PHP 5.3.0 and the GD Library===

The Mac OS X 10.5.8 Server (Leopard) comes with PHP 5.2.6 ... this is correct for Moodle 1.9.x. But you have to add the missing GD Library support to get Moodle running on your server. For Moodle 2.0 the server must have PHP 5.2.8 (or better) and some more PHP extensions ... in this case you need to get the better PHP version. These instructions are helpful in both cases.

To see which PHP version and extensions are installed on your server you should edit the file ''/Library/WebServer/Documents/info.php''. You must activate the function call phpinfo() by deleting the both slashes // at the start of the function line. After saving the file you can get all PHP informations in your browser. Please look at http://your-server-address/info.php ... you will not find any GD library support ... bad thing for Moodle!!

<?php
// You can use Server Admin to enable the Apache PHP module; it's disabled by default.
// You can uncomment the phpinfo() directive below to provide a default PHP info page
// but note that this displays information about your host's configuration.
phpinfo();
?>

The easiest way to get the GD library support and to get a better PHP version would be the installation of the complete PHP 5.3.0 package from http://www.entropy.ch/software/macosx/php/. Marc Liyanage precompiled this package to use it on Mac clients and Mac servers. Please get the package and install it by following the instructions on the download page. The installer does everything for you ... it copies PHP into the correct folder ''/usr/local/php5'' and changes its owner to ''root'' automatically. You will find the file php.ini inside the new package folder. Open the file ''/usr/local/php5/lib/php.ini'' and edit some settings for Moodle.

Note: If you want to install Moodle 1.8.x on the server you need to get the Entropy PHP-5.2.9-7.pkg instead. Moodle 1.8.x does not run with PHP 5.3.0. (MDL-20128)

Now the Apache web server must get knowledge that you want to use the new PHP library instead of the old. Open the application Server Admin to switch to the new library. Go to the web server settings and find the entry php5_module. The normal place for PHP the Mac server is ''libexec/apache2/libphp5.so''. Please change to ''/usr/local/php5/libphp5.so'' and save the settings.

[[Image:Server-admin.png]]

===PHP settings in your php.ini===
The second thing to configure is the file php.ini. Most of the settings are okay but not all of them. To communicate to the MySQL database with PHP you have to set the default socket name for local MySQL connects. The default socket name for local MySQLi connects is needed for Moodle 2.0.

If you want to upload any file to your Moodle you should add a little bit more upload size in php.ini. If your server can't use more than 1 GB RAM you should set the memory_limit to a value less than 128M ... but it should have more than 48M for Moodle 1.9 and Moodle 2.0. Note that these sections are not likely to be consecutive in the php.ini file; the quickest way to find each one is search on the initial term (such as 'mysql.default_socket').

; Default socket name for local MySQL connects.
; If empty, uses the built-in MySQL defaults.
mysql.default_socket = /var/mysql/mysql.sock

; Default socket name for local MySQL connects.
; If empty, uses the built-in MySQL defaults.
mysqli.default_socket = /var/mysql/mysql.sock

; Maximum amount of memory a script may consume (128MB)
memory_limit = 128M

; Maximum allowed size for uploaded files.
upload_max_filesize = 128M

; Maximum size of POST data that PHP will accept.
post_max_size = 128M

; Defines the default timezone used by the date functions
; http://php.net/date.timezone
date.timezone = 'Europe/Berlin';

That's all ... save the file php.ini and restart the web server. Now you should look at http://your-server-address/info.php again. I hope that everything will be okay. You will find the version number PHP 5.3.0 and the running GD library support. Congratulations ... the first step for Moodle on your Mac server is done!

[[Image:phpinfo.png]]

[[Image:phpinfo2.png]]

==Configure the MySQL database for your Moodle installation==

In standard case the database MySQL is installed on the Mac OS X Server but it is not running yet. Please make sure that you start the MySQL database server.

===Use the graphical way===
Sorry ... there are some more installations and a lot of clicks to configure MySQL in a graphical way.

First of all start the ''Server Admin''. You will find this program by the way ''Applications > Server > Server Admin''. Activate MySQL on the local server. You must set the password for the user ''root'' before you can start MySQL.

For the next you must download the MySQL database administration tool '''phpMyAdmin''' from http://www.phpmyadmin.net . Move the folder to the web server documents as ''/Library/WebServer/Documents/phpMyAdmin''.

Add the security phrase to the file ''config.inc.php'' in between the single quotes on the line $cfg['blowfish_secret'] = ''; /* YOU MUST FILL IN THIS FOR COOKIE AUTH! */

Now you will be able to start http://your-server-address/phpMyAdmin/ in your browser and to log into the database as the user ''root''. Add a database ''moodle19''. Add a database user ''moodle'' to the server ''localhost''. Don't forget to set a secure password. The database user ''moodle'' should be allowed to administrate the database ''moodle19'' only. It is a bad way to set ''root'' to administrate the database ''moodle19''. If you want to install also Moodle 2.0 dev please add a second database ''moodle20'' and use the same database user for it.

phpMyAdmin is a nice thing to look into the database while Moodle is running for some time. It's much easier to see in the graphical interface than in the command line tools. The image shows the database after Moodle 1.9 and Moodle 2.0 were already installed on this server.

[[Image:phpmyadmin.png]]

===Use the Terminal===
If you want a quick installation then don't fear to use the Terminal. It's easier to tell you all the commands for the right way with the Terminal than showing you all the pictures to do the same with graphical tools. There are only a few commands to do everything I told you before.

Start the Terminal. You will find this program by the way ''Applications > Tools > Terminal''. You will see that we must do the same steps as before but you can read them in a text form.

First of all you need to set the root password. If you didn't this before then use the first command line. If you want to change an existing password then use the second one.

Server:~ $ mysqladmin -u root password 'secret'
Server:~ $ mysqladmin -u root -p password 'topsecret'

The next steps are creating a new database ''moodle19'' with correct character set and setting up a database user ''moodle'', with an assigned password (IDENTIFIED BY), to administrate the new database ... and if you want, then do the same for ''moodle20''.

Server:~ $ mysqladmin -u root -p create moodle19
Server:~ $ mysql -u root -p

mysql> ALTER DATABASE moodle19 CHARSET 'utf8';
mysql> GRANT ALL PRIVILEGES ON moodle19.* TO moodle@localhost
-> IDENTIFIED BY 'moodle!';
mysql> quit

Server:~ $

That's really all with the Terminal. You are just ready!

==Copy the Moodle files to the web server==

The documents for the web server are saved in the folder ''/Library/WebServer/Documents/''. You will place your Moodle folder here after you got it from http://download.moodle.org. Download the standard package MOODLE_19_WEEKLY because this is the best choice for new servers. Set the owner ''_www'' for the moodle folder ... this is the user for the web server. The folder permissions should be 755 before the installation and 555 after it's done ... please remember to set this later!

You also need the moodledata folder outside of the Documents folder ... so please make one. Go to the folder ''/Library/WebServer/'' and add the folder ''moodledata''. Because I want to install Moodle 1.9.x and Moodle 2.0 dev together on the same Mac server I add two folders ''moodle19'' and ''moodle20'' inside the moodledata folder. Please set the owner ''_www'' for both folders ''moodle19'' and ''moodle20'' and the folder permissions to 755.

cd /Library/WebServer/
mkdir moodledata
mkdir moodledata/moodle19
mkdir moodledata/moodle20
sudo chown -R _www moodledata
sudo chmod -R 755 moodledata

If you'd like to put the moodledata folder on another volume (not a bad idea if you think you'll have a substantial amount of data within the moodle), note that you cannot simply reference it using the /Volumes/<volume_name>/folder syntax during the moodle setup. Instead, you'll need to create the folder (assigning the user and permissions), then create a '''link''' to it within the /Library/WebServer folder. To create the link, use the following command in a terminal window, substituting your data volume and folder name:

cd /Library/WebServer
ln -s /Volumes/Data_Volume/moodledata moodledata

==Run the Moodle installation==
The installation on the Mac server is the same like the installation on every other server.
Open a web browser to http://your-server-address/moodle/install.php to begin the installation process.
On the screen picture and in the shown config.php you see the web address ''your-server-address'' ... it's only a placeholder for a real address or url ... please set yours. Also a user 'moodle' with a password 'moodle' would be very unsafe settings for your installation.

[[Image:moodle-install1.png]]

[[Image:moodle-install2.png]]

The installer generates the config.php automatically and saves it in the folder ''/Library/WebServer/Documents/moodle19''. Please edit the config.php with a text editor and add the line ''date_default_timezone_set('UTC');''. You may change ''UTC'' to your own timezone ... this is needed for PHP 5.3.0. In case you don't know all the relevant time zone identifiers by heart, there is a [http://phpbuilder.com/manual/en/timezones.php list available online].

<?php /// Moodle Configuration File

unset($CFG);

$CFG->dbtype = 'mysql';
$CFG->dbhost = 'localhost';
$CFG->dbname = 'moodle19';
$CFG->dbuser = 'moodle';
$CFG->dbpass = 'moodle';
$CFG->dbpersist = false;
$CFG->prefix = 'mdl_';

$CFG->wwwroot = 'http://your-server-address/moodle19';
$CFG->dirroot = '/Library/WebServer/Documents/moodle19';
$CFG->dataroot = '/Library/WebServer/moodledata/moodle19';
$CFG->admin = 'admin';

$CFG->directorypermissions = 00777; // try 02777 on a server in Safe Mode

date_default_timezone_set('Europe/Berlin'); // timezone for PHP 5.3.0
require_once("$CFG->dirroot/lib/setup.php");
// MAKE SURE WHEN YOU EDIT THIS FILE THAT THERE ARE NO SPACES, BLANK LINES,
// RETURNS, OR ANYTHING ELSE AFTER THE TWO CHARACTERS ON THE NEXT LINE.
?>

After this, the web-based installation component will walk you through '''several''' screens worth of database configurations and updates, for most of which you'll just click the continue button. You'll set up an admin user and give the site a basic configuration (title, description, etc). When the installation is ready you should change the folder permission for ''/Library/WebServer/Documents/moodle19'' to 555 so the web server is not able to write into this folder again.

==Download the language packages==

==Moodle is running ...==
[[Image:moodle-on-macosx-server.png]]

==How to setup the cron job with launchd==

It's really important to start the cron job every 5 minutes. The cron job assists most of Moodle's modules to perform tasks on a scheduled basis. For example, the discussion forums can only mail out copies of new posts to all subscribers if the cron job tells Moodle to do this.

In Mac OS X you will find the system daemon ''launchd'' for this service. This daemon offers a standardized interface to any user and all programs started automatically by the system. Please look at http://developer.apple.com/macosx/launchd.html for more information about the configurations and all parameters.

In our case the service should get the web page http://your-server-address/moodle19/admin/cron.php every 5 minutes. The configuration will be done by the file named ''moodle4mac.cron.plist'' which must be placed in the system folder ''/Library/LaunchDaemons/'' ... surely you can use any other file name but it should say something about the function of the service. The extension must be ''.plist''. After any reboot of your Mac server the cron service will start automaticly because the file is placed in the correct system folder.

===Use the graphical way===
You can use Lingon to add a new daemon plist or to edit one. It produces the same text as you can write in your text editor. http://sourceforge.net/projects/lingon/files/

[[Image:macosx-lingon.png]]

===Use a text editor===
Please use a text editor to write the needed file. You can open the Terminal and use the system editors vi or pico. But you can also write the text file with any GUI text editor ... I mostly use TextWrangler ... but do NOT take an editor for formatted texts like Microsoft Word or OpenOffice Writer. You must get pure text!

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0//EN"
"http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>KeepAlive</key><false/>
<key>Label</key><string>moodle4mac.cron</string>
<key>ProgramArguments</key>
<array>
<string>curl</string>
<string>-s</string>
<string>http://your-server-address/moodle19/admin/cron.php</string>
</array>
<key>RunAtLoad</key><true />
<key>StartInterval</key><integer>300</integer>
<key>StandardErrorPath</key><string>/dev/null</string>
<key>StandardOutPath</key><string>/dev/null</string>
</dict>
</plist>

The label string must be the same as the file name is but without the extension ''.plist''. Save the text file ''/Library/LaunchDaemons/moodle4mac.cron.plist''. The owner of the file must be set to the system user ''root''. That's all, really!

===How to start and stop the cron service===
You can start the new cron service in the Terminal.

sudo launchctl load /Library/LaunchDaemons/moodle4mac.cron.plist

The following command would stop the service. If you want to activate changes in the cron service you need to ''unload'' and then to ''load'' the daemon again.

sudo launchctl unload /Library/LaunchDaemons/moodle4mac.cron.plist

===Only one service for two servers?===
For my server I needed to have a cron service for to instances ''moodle19'' and ''moodle20'' ... no problem ... with the typo ''moodle[19-20]'' the server will get a cron service for both instances.

<nowiki>curl -s http://your-server-address/moodle[19-20]/admin/cron.php</nowiki>

To see if the cron service works correctly you should look at the ''access.log'' of your web server. The cron.php should be accessed every 5 minutes ... on my server for both Moodle instances ''moodle19'' and ''moodle20'' ... oh yes, it works!!

192.168.0.220 - - [30/Jul/2009:22:10:56 +0200] "GET /moodle19/admin/cron.php HTTP/1.1" 200 1136
192.168.0.220 - - [30/Jul/2009:22:10:57 +0200] "GET /moodle20/admin/cron.php HTTP/1.1" 200 1403
192.168.0.220 - - [30/Jul/2009:22:11:18 +0200] "OPTIONS * HTTP/1.0" 200 -
192.168.0.220 - - [30/Jul/2009:22:15:56 +0200] "GET /moodle19/admin/cron.php HTTP/1.1" 200 735
192.168.0.220 - - [30/Jul/2009:22:15:57 +0200] "GET /moodle20/admin/cron.php HTTP/1.1" 200 964
192.168.0.220 - - [30/Jul/2009:22:20:56 +0200] "GET /moodle19/admin/cron.php HTTP/1.1" 200 1136
192.168.0.220 - - [30/Jul/2009:22:20:57 +0200] "GET /moodle20/admin/cron.php HTTP/1.1" 200 1365

==How to install and update Moodle via CVS==

CVS is very simple way to install and update your Moodle.

The only software you must have installed on your Mac server is the Xcode Tools package from your system installation media. You also must have an internet connection to get the files from the update server. After you installed both script files on your server desktop it only needs a doubleclick to get the newest Moodle version without downloading the complete installation package. Please remember - before you can update your Moodle via CVS you must install Moodle via CVS at once.

That's all .... really .... it's easy!!

===Use the CVS installation script===
If your Moodle is already installed via CVS please use the CVS updater (see below). Running the CVS installer will install only the standard version of Moodle on your server.

If you already have a working Moodle on your server then this script copies the file config.php into your new installation but it does not copy your additional modules or plugins or themes. You will find your old moodle folder in same directory and it will be renamed with an additional date stamp.

<pre>
#! /bin/sh
#
# CVS installer for Moodle
# on a Mac OS X Server
#
# 20100818 - Ralf Krause
#

export CVS_RSH=ssh

### file ~/.cvspass must exist
if ! test -e ~/.cvspass ; then
touch ~/.cvspass
fi

echo
echo "+--------------------------------------------+"
echo "| CVS installer for the Moodle server "
echo "+--------------------------------------------+"
echo

cd /Library/WebServer/Documents

### get the cvs installation into a tmp folder
if ! test -e tmp ; then
sudo mkdir tmp
sudo chmod 777 tmp
fi

echo "Connecting to the CVS server. Download will take a few moments!"
echo "If the CVS update runs too long you may break with <ctrl>-C"
echo

### do the cvs installation
cd tmp
cvs -z9 -d:pserver:anonymous@uk.cvs.moodle.org:/cvsroot/moodle co -P -r MOODLE_19_WEEKLY moodle
cd ..

### copy config.php from your current moodle folder if it exists
if ! test -e moodle/config.php ; then
cp moodle19/config.php tmp/moodle/config.php
fi

### move the new moodle to the right place
DATE=`date +%Y%m%d-%H%M`
sudo mv moodle19 moodle19-$DATE
sudo mv tmp/moodle moodle19
sudo chown -R _www moodle19
</pre>

===Use the CVS update script===
To be able to update Moodle via CVS please check that your Moodle was already installed via CVS (see above).

<pre>
#! /bin/sh
#
# CVS updater for Moodle
# on a Mac OS X Server
#
# 20100818 - Ralf Krause
#

export CVS_RSH=ssh

echo
echo "+--------------------------------------------+"
echo "| CVS updater for the Moodle server "
echo "+--------------------------------------------+"
echo

cd /Library/WebServer/Documents/moodle19/

### file ~/.cvspass must exist
if ! test -e ~/.cvspass ; then
touch ~/.cvspass
fi

### login to the cvs server only for the first time
if ! grep "uk.cvs.moodle.org" ~/.cvspass > /dev/null ; then
echo "CVS password is empty ... please only press <return> to start"
sudo cvs -d :pserver:anonymous@uk.cvs.moodle.org:/cvsroot/moodle login
echo
fi

echo "Connecting to the CVS server. Download will take a few moments!"
echo "If the CVS update runs too long you may break with <ctrl>-C"
echo

### do the cvs installation
sudo cvs -q update -dP -r MOODLE_19_WEEKLY
sudo chown -R _www .
</pre>

Please look at the documentation [https://docs.moodle.org/en/CVS_for_Administrators CVS for Administrators] if you want to learn more about Moodle and CVS. There you will also find a list of different [https://docs.moodle.org/en/CVS_for_Administrators#CVS_Servers CVS servers for Moodle] which you may choose for your updates.

The shown update script should be modified in only three things ... first you need to choose the correct folder for the Moodle files, second choose a CVS server near your server place to minimate internet traffic, and third you must input the correct CVS tag for the Moodle version in the last line. The shown script is for updating the version Moodle 1.9
* Moodle 1.8 uses MOODLE_18_WEEKLY
* Moodle 1.9 uses MOODLE_19_WEEKLY
* Moodle 2.0 RC1 still uses HEAD

===Install Xcode Tools and CVS on your Mac Server===

To test if cvs is already on your Mac Server please open the Terminal and type ''cvs -v''. The output of this command should show a version notice of your Concurrent Versions System (CVS). If you get the ''command not found'' message then you must search for your Mac OS X 10.5 Server installation media. You will find the Xcode Tools on your installation CD or DVD set.

If you can't find your installation media anymore you also can download the Xcode Tools from the URL http://developer.apple.com/tools/xcode/. It is free but you have to register as a developer. Starting the download then the Xcode package copies a lot of bytes on your harddisk and will need a very few minutes to complete.

After you installed the Xcode Tools in your server system you will get the correct version answer from the Terminal command ''cvs -v''. If you only want to update your Moodle you do not need all these nice developer tools from the inside of the folder. Sorry about this but there is no separate installer for the CVS update process.

If cvs does not work on your server please check that the port 2401 is open.
  

==User administration via LDAP==

The following settings will work on 10.5 Server running LDAP - edit them to customize to your own environment. Please note that moodle requires some fields - it is best to have these fields completed in Workgroup Manager on 10.5 Server - otherwise they'll be prompted to enter info into their moodle profile on first login, but the way we've got it set up, moodle can't modify LDAP for security and data integrity. The necessary fields are user name, first name, surname, Email address, City/Town, country, description, ID number.
<pre>
LDAP SERVER SETTINGS
Host URL = ourserver.example.com
Version = 3
LDAP encoding = utf-8

BIND SETTINGS
Hide passwords = Yes
Distinguished Name = (blank)
Password = (blank)

USER LOOKUP SETTINGS
User type = posixAccount (rfc2307)
Contexts = cn=users,dc=ourserver,dc=example,dc=com
Search subcontexts = Yes
Dereference aliases = No
User attribute = (blank)
Member attribute = (blank)
Member attribute uses dn = (blank)
Object class = (blank)

FORCE CHANGE PASSWORD
Force change password = No
Use standard Change Password Page = No
Password format = Plain text
Password change URL = (blank)

LDAP PASSWORD EXPIRATION SETTINGS
Expiration = no
Expiration warning = 10
Expiration attribute = ""
Grace logins = No
Grace login attribute = (blank)

ENABLE USER CREATION
Create users externally = No
Context for new users = (blank)

COURSE CREATOR
Creators = (blank)

CRON SYNCHRONIZATION SCRIPT
Removed ext user = Keep internal

NTLM SSO
Enable = No
Subnet = (blank)
First name = givenName (On every login, Never, Locked)
Surname = sn (On every login, Never, Locked)
Email address = mail (On every login, Never, Locked)
Phone 1 = (blank)
Phone 2 = (blank)
Department = (blank)
Address = (blank)
City/Town = l (On every login, Never, Locked)
Country = c (On every login, Never, Locked)
Description = description (On every login, Never, Locked)
ID number = uidNumber (On every login, Never, Locked)
Language = (blank)
</pre>

==See also==
* [[Complete Install Packages for Mac OS X | Complete install packages for Mac OS X Clients 10.4/10.5/10.6]]
* [[Step-by-step Guide for Installing Moodle on Mac OS X 10.4 Client|Step by step installation on a Mac OS X Client 10.4]]
* [[Cron | Installation of cron for Moodle]]
* [[CVS for Administrators]]

* [http://moodle.org/mod/forum/discuss.php?d=24632 Using Moodle: Dynamic DNS Home Server]

[[Category:Administrator]]
[[Category:Installation]]
[[Category:Mac OS X]]

Step by Step Installation on a Mac OS X Server

2010-10-21T13:32:42Z

Krause: /* See also */

==Overview==
This guide shows all steps for the installation of Moodle on a [http://www.apple.com/server/macosx Mac OS X Server]. This server is a commercial product. You will find [http://www.apple.com/server/macosx/resources/documentation.html all documentations] about the web server on the Apple support pages.

This installation guide can't be useful for an installation on MAMP or XAMPP. If you are looking for an easy way to install Moodle on your local machine please use [[Complete Install Packages for Mac OS X | Complete install packages for Mac OS X 10.4/10.5/10.6 Clients]] that can be downloaded from http://download.moodle.org/macosx/ ... but if you are planning to set up a Moodle internet server on a Mac then you should think about some more security as the ever local package could give.

Please feel free to add your ideas and wishes to the discussion page for this article. You may also write a complete chapter if you tried the facts yourself on your own Mac Server. I am most interested to make the things better.

==System requirements==

+ Apple Computer
+ Mac mini, Mac Pro or Xserve
+ Processor: Intel Core 2 Duo, i5, i7
+ RAM: 2 GB or better
+ Hard Disk: 500 MB free
+ System Software: Mac OS X Server 10.5 or 10.6

==Configure PHP for your Moodle installation==
===Mac OS X 10.6 Server - No PHP installation needed===

The Mac OS X 10.6.4 Server (SnowLeopard) comes with PHP 5.3.2 and a lot of PHP extensions. This would be the best choice for Moodle 1.9.x and for Moodle 2.0 on a Mac OS X Server. Please forget everything you read about the missing GD Library! The PHP installation is totally complete for Moodle. You only have to control if the PHP module is switched on and if the php.ini does the right settings. You should open the file /etc/php.ini and control the settings for Moodle.

===Mac OS X 10.5 Server - Install PHP 5.3.0 and the GD Library===

The Mac OS X 10.5.8 Server (Leopard) comes with PHP 5.2.6 ... this is correct for Moodle 1.9.x. But you have to add the missing GD Library support to get Moodle running on your server. For Moodle 2.0 the server must have PHP 5.2.8 (or better) and some more PHP extensions ... in this case you need to get the better PHP version. These instructions are helpful in both cases.

To see which PHP version and extensions are installed on your server you should edit the file ''/Library/WebServer/Documents/info.php''. You must activate the function call phpinfo() by deleting the both slashes // at the start of the function line. After saving the file you can get all PHP informations in your browser. Please look at http://your-server-address/info.php ... you will not find any GD library support ... bad thing for Moodle!!

<?php
// You can use Server Admin to enable the Apache PHP module; it's disabled by default.
// You can uncomment the phpinfo() directive below to provide a default PHP info page
// but note that this displays information about your host's configuration.
phpinfo();
?>

The easiest way to get the GD library support and to get a better PHP version would be the installation of the complete PHP 5.3.0 package from http://www.entropy.ch/software/macosx/php/. Marc Liyanage precompiled this package to use it on Mac clients and Mac servers. Please get the package and install it by following the instructions on the download page. The installer does everything for you ... it copies PHP into the correct folder ''/usr/local/php5'' and changes its owner to ''root'' automatically. You will find the file php.ini inside the new package folder. Open the file ''/usr/local/php5/lib/php.ini'' and edit some settings for Moodle.

Note: If you want to install Moodle 1.8.x on the server you need to get the Entropy PHP-5.2.9-7.pkg instead. Moodle 1.8.x does not run with PHP 5.3.0. (MDL-20128)

Now the Apache web server must get knowledge that you want to use the new PHP library instead of the old. Open the application Server Admin to switch to the new library. Go to the web server settings and find the entry php5_module. The normal place for PHP the Mac server is ''libexec/apache2/libphp5.so''. Please change to ''/usr/local/php5/libphp5.so'' and save the settings.

[[Image:Server-admin.png]]

===PHP settings in your php.ini===
The second thing to configure is the file php.ini. Most of the settings are okay but not all of them. To communicate to the MySQL database with PHP you have to set the default socket name for local MySQL connects. The default socket name for local MySQLi connects is needed for Moodle 2.0.

If you want to upload any file to your Moodle you should add a little bit more upload size in php.ini. If your server can't use more than 1 GB RAM you should set the memory_limit to a value less than 128M ... but it should have more than 48M for Moodle 1.9 and Moodle 2.0. Note that these sections are not likely to be consecutive in the php.ini file; the quickest way to find each one is search on the initial term (such as 'mysql.default_socket').

; Default socket name for local MySQL connects.
; If empty, uses the built-in MySQL defaults.
mysql.default_socket = /var/mysql/mysql.sock

; Default socket name for local MySQL connects.
; If empty, uses the built-in MySQL defaults.
mysqli.default_socket = /var/mysql/mysql.sock

; Maximum amount of memory a script may consume (128MB)
memory_limit = 128M

; Maximum allowed size for uploaded files.
upload_max_filesize = 128M

; Maximum size of POST data that PHP will accept.
post_max_size = 128M

; Defines the default timezone used by the date functions
; http://php.net/date.timezone
date.timezone = 'Europe/Berlin';

That's all ... save the file php.ini and restart the web server. Now you should look at http://your-server-address/info.php again. I hope that everything will be okay. You will find the version number PHP 5.3.0 and the running GD library support. Congratulations ... the first step for Moodle on your Mac server is done!

[[Image:phpinfo.png]]

[[Image:phpinfo2.png]]

==Configure the MySQL database for your Moodle installation==

In standard case the database MySQL is installed on the Mac OS X Server but it is not running yet. Please make sure that you start the MySQL database server.

===Use the graphical way===
Sorry ... there are some more installations and a lot of clicks to configure MySQL in a graphical way.

First of all start the ''Server Admin''. You will find this program by the way ''Applications > Server > Server Admin''. Activate MySQL on the local server. You must set the password for the user ''root'' before you can start MySQL.

For the next you must download the MySQL database administration tool '''phpMyAdmin''' from http://www.phpmyadmin.net . Move the folder to the web server documents as ''/Library/WebServer/Documents/phpMyAdmin''.

Add the security phrase to the file ''config.inc.php'' in between the single quotes on the line $cfg['blowfish_secret'] = ''; /* YOU MUST FILL IN THIS FOR COOKIE AUTH! */

Now you will be able to start http://your-server-address/phpMyAdmin/ in your browser and to log into the database as the user ''root''. Add a database ''moodle19''. Add a database user ''moodle'' to the server ''localhost''. Don't forget to set a secure password. The database user ''moodle'' should be allowed to administrate the database ''moodle19'' only. It is a bad way to set ''root'' to administrate the database ''moodle19''. If you want to install also Moodle 2.0 dev please add a second database ''moodle20'' and use the same database user for it.

phpMyAdmin is a nice thing to look into the database while Moodle is running for some time. It's much easier to see in the graphical interface than in the command line tools. The image shows the database after Moodle 1.9 and Moodle 2.0 were already installed on this server.

[[Image:phpmyadmin.png]]

===Use the Terminal===
If you want a quick installation then don't fear to use the Terminal. It's easier to tell you all the commands for the right way with the Terminal than showing you all the pictures to do the same with graphical tools. There are only a few commands to do everything I told you before.

Start the Terminal. You will find this program by the way ''Applications > Tools > Terminal''. You will see that we must do the same steps as before but you can read them in a text form.

First of all you need to set the root password. If you didn't this before then use the first command line. If you want to change an existing password then use the second one.

Server:~ $ mysqladmin -u root password 'secret'
Server:~ $ mysqladmin -u root -p password 'topsecret'

The next steps are creating a new database ''moodle19'' with correct character set and setting up a database user ''moodle'', with an assigned password (IDENTIFIED BY), to administrate the new database ... and if you want, then do the same for ''moodle20''.

Server:~ $ mysqladmin -u root -p create moodle19
Server:~ $ mysql -u root -p

mysql> ALTER DATABASE moodle19 CHARSET 'utf8';
mysql> GRANT ALL PRIVILEGES ON moodle19.* TO moodle@localhost
-> IDENTIFIED BY 'moodle!';
mysql> quit

Server:~ $

That's really all with the Terminal. You are just ready!

==Copy the Moodle files to the web server==

The documents for the web server are saved in the folder ''/Library/WebServer/Documents/''. You will place your Moodle folder here after you got it from http://download.moodle.org. Download the standard package MOODLE_19_WEEKLY because this is the best choice for new servers. Set the owner ''_www'' for the moodle folder ... this is the user for the web server. The folder permissions should be 755 before the installation and 555 after it's done ... please remember to set this later!

You also need the moodledata folder outside of the Documents folder ... so please make one. Go to the folder ''/Library/WebServer/'' and add the folder ''moodledata''. Because I want to install Moodle 1.9.x and Moodle 2.0 dev together on the same Mac server I add two folders ''moodle19'' and ''moodle20'' inside the moodledata folder. Please set the owner ''_www'' for both folders ''moodle19'' and ''moodle20'' and the folder permissions to 755.

cd /Library/WebServer/
mkdir moodledata
mkdir moodledata/moodle19
mkdir moodledata/moodle20
sudo chown -R _www moodledata
sudo chmod -R 755 moodledata

If you'd like to put the moodledata folder on another volume (not a bad idea if you think you'll have a substantial amount of data within the moodle), note that you cannot simply reference it using the /Volumes/<volume_name>/folder syntax during the moodle setup. Instead, you'll need to create the folder (assigning the user and permissions), then create a '''link''' to it within the /Library/WebServer folder. To create the link, use the following command in a terminal window, substituting your data volume and folder name:

cd /Library/WebServer
ln -s /Volumes/Data_Volume/moodledata moodledata

==Run the Moodle installation==
The installation on the Mac server is the same like the installation on every other server.
Open a web browser to http://your-server-address/moodle/install.php to begin the installation process.
On the screen picture and in the shown config.php you see the web address ''your-server-address'' ... it's only a placeholder for a real address or url ... please set yours. Also a user 'moodle' with a password 'moodle' would be very unsafe settings for your installation.

[[Image:moodle-install1.png]]

[[Image:moodle-install2.png]]

The installer generates the config.php automatically and saves it in the folder ''/Library/WebServer/Documents/moodle19''. Please edit the config.php with a text editor and add the line ''date_default_timezone_set('UTC');''. You may change ''UTC'' to your own timezone ... this is needed for PHP 5.3.0. In case you don't know all the relevant time zone identifiers by heart, there is a [http://phpbuilder.com/manual/en/timezones.php list available online].

<?php /// Moodle Configuration File

unset($CFG);

$CFG->dbtype = 'mysql';
$CFG->dbhost = 'localhost';
$CFG->dbname = 'moodle19';
$CFG->dbuser = 'moodle';
$CFG->dbpass = 'moodle';
$CFG->dbpersist = false;
$CFG->prefix = 'mdl_';

$CFG->wwwroot = 'http://your-server-address/moodle19';
$CFG->dirroot = '/Library/WebServer/Documents/moodle19';
$CFG->dataroot = '/Library/WebServer/moodledata/moodle19';
$CFG->admin = 'admin';

$CFG->directorypermissions = 00777; // try 02777 on a server in Safe Mode

date_default_timezone_set('Europe/Berlin'); // timezone for PHP 5.3.0
require_once("$CFG->dirroot/lib/setup.php");
// MAKE SURE WHEN YOU EDIT THIS FILE THAT THERE ARE NO SPACES, BLANK LINES,
// RETURNS, OR ANYTHING ELSE AFTER THE TWO CHARACTERS ON THE NEXT LINE.
?>

After this, the web-based installation component will walk you through '''several''' screens worth of database configurations and updates, for most of which you'll just click the continue button. You'll set up an admin user and give the site a basic configuration (title, description, etc). When the installation is ready you should change the folder permission for ''/Library/WebServer/Documents/moodle19'' to 555 so the web server is not able to write into this folder again.

==Download the language packages==

==Moodle is running ...==
[[Image:moodle-on-macosx-server.png]]

==How to setup the cron job with launchd==

It's really important to start the cron job every 5 minutes. The cron job assists most of Moodle's modules to perform tasks on a scheduled basis. For example, the discussion forums can only mail out copies of new posts to all subscribers if the cron job tells Moodle to do this.

In Mac OS X you will find the system daemon ''launchd'' for this service. This daemon offers a standardized interface to any user and all programs started automatically by the system. Please look at http://developer.apple.com/macosx/launchd.html for more information about the configurations and all parameters.

In our case the service should get the web page http://your-server-address/moodle19/admin/cron.php every 5 minutes. The configuration will be done by the file named ''moodle4mac.cron.plist'' which must be placed in the system folder ''/Library/LaunchDaemons/'' ... surely you can use any other file name but it should say something about the function of the service. The extension must be ''.plist''. After any reboot of your Mac server the cron service will start automaticly because the file is placed in the correct system folder.

===Use the graphical way===
You can use Lingon to add a new daemon plist or to edit one. It produces the same text as you can write in your text editor. http://sourceforge.net/projects/lingon/files/

[[Image:macosx-lingon.png]]

===Use a text editor===
Please use a text editor to write the needed file. You can open the Terminal and use the system editors vi or pico. But you can also write the text file with any GUI text editor ... I mostly use TextWrangler ... but do NOT take an editor for formatted texts like Microsoft Word or OpenOffice Writer. You must get pure text!

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0//EN"
"http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>KeepAlive</key><false/>
<key>Label</key><string>moodle4mac.cron</string>
<key>ProgramArguments</key>
<array>
<string>curl</string>
<string>-s</string>
<string>http://your-server-address/moodle19/admin/cron.php</string>
</array>
<key>RunAtLoad</key><true />
<key>StartInterval</key><integer>300</integer>
<key>StandardErrorPath</key><string>/dev/null</string>
<key>StandardOutPath</key><string>/dev/null</string>
</dict>
</plist>

The label string must be the same as the file name is but without the extension ''.plist''. Save the text file ''/Library/LaunchDaemons/moodle4mac.cron.plist''. The owner of the file must be set to the system user ''root''. That's all, really!

===How to start and stop the cron service===
You can start the new cron service in the Terminal.

sudo launchctl load /Library/LaunchDaemons/moodle4mac.cron.plist

The following command would stop the service. If you want to activate changes in the cron service you need to ''unload'' and then to ''load'' the daemon again.

sudo launchctl unload /Library/LaunchDaemons/moodle4mac.cron.plist

===Only one service for two servers?===
For my server I needed to have a cron service for to instances ''moodle19'' and ''moodle20'' ... no problem ... with the typo ''moodle[19-20]'' the server will get a cron service for both instances.

<nowiki>curl -s http://your-server-address/moodle[19-20]/admin/cron.php</nowiki>

To see if the cron service works correctly you should look at the ''access.log'' of your web server. The cron.php should be accessed every 5 minutes ... on my server for both Moodle instances ''moodle19'' and ''moodle20'' ... oh yes, it works!!

192.168.0.220 - - [30/Jul/2009:22:10:56 +0200] "GET /moodle19/admin/cron.php HTTP/1.1" 200 1136
192.168.0.220 - - [30/Jul/2009:22:10:57 +0200] "GET /moodle20/admin/cron.php HTTP/1.1" 200 1403
192.168.0.220 - - [30/Jul/2009:22:11:18 +0200] "OPTIONS * HTTP/1.0" 200 -
192.168.0.220 - - [30/Jul/2009:22:15:56 +0200] "GET /moodle19/admin/cron.php HTTP/1.1" 200 735
192.168.0.220 - - [30/Jul/2009:22:15:57 +0200] "GET /moodle20/admin/cron.php HTTP/1.1" 200 964
192.168.0.220 - - [30/Jul/2009:22:20:56 +0200] "GET /moodle19/admin/cron.php HTTP/1.1" 200 1136
192.168.0.220 - - [30/Jul/2009:22:20:57 +0200] "GET /moodle20/admin/cron.php HTTP/1.1" 200 1365

==How to install and update Moodle via CVS==

CVS is very simple way to install and update your Moodle.

The only software you must have installed on your Mac server is the Xcode Tools package from your system installation media. You also must have an internet connection to get the files from the update server. After you installed both script files on your server desktop it only needs a doubleclick to get the newest Moodle version without downloading the complete installation package. Please remember - before you can update your Moodle via CVS you must install Moodle via CVS at once.

That's all .... really .... it's easy!!

===Use the CVS installation script===
If your Moodle is already installed via CVS please use the CVS updater (see below). Running the CVS installer will install only the standard version of Moodle on your server.

If you already have a working Moodle on your server then this script copies the file config.php into your new installation but it does not copy your additional modules or plugins or themes. You will find your old moodle folder in same directory and it will be renamed with an additional date stamp.

<pre>
#! /bin/sh
#
# CVS installer for Moodle
# on a Mac OS X Server
#
# 20100818 - Ralf Krause
#

export CVS_RSH=ssh

### file ~/.cvspass must exist
if ! test -e ~/.cvspass ; then
touch ~/.cvspass
fi

echo
echo "+--------------------------------------------+"
echo "| CVS installer for the Moodle server "
echo "+--------------------------------------------+"
echo

cd /Library/WebServer/Documents

### get the cvs installation into a tmp folder
if ! test -e tmp ; then
sudo mkdir tmp
sudo chmod 777 tmp
fi

echo "Connecting to the CVS server. Download will take a few moments!"
echo "If the CVS update runs too long you may break with <ctrl>-C"
echo

### do the cvs installation
cd tmp
cvs -z9 -d:pserver:anonymous@uk.cvs.moodle.org:/cvsroot/moodle co -P -r MOODLE_19_WEEKLY moodle
cd ..

### copy config.php from your current moodle folder if it exists
if ! test -e moodle/config.php ; then
cp moodle19/config.php tmp/moodle/config.php
fi

### move the new moodle to the right place
DATE=`date +%Y%m%d-%H%M`
sudo mv moodle19 moodle19-$DATE
sudo mv tmp/moodle moodle19
sudo chown -R _www moodle19
</pre>

===Use the CVS update script===
To be able to update Moodle via CVS please check that your Moodle was already installed via CVS (see above).

<pre>
#! /bin/sh
#
# CVS updater for Moodle
# on a Mac OS X Server
#
# 20100818 - Ralf Krause
#

export CVS_RSH=ssh

echo
echo "+--------------------------------------------+"
echo "| CVS updater for the Moodle server "
echo "+--------------------------------------------+"
echo

cd /Library/WebServer/Documents/moodle19/

### file ~/.cvspass must exist
if ! test -e ~/.cvspass ; then
touch ~/.cvspass
fi

### login to the cvs server only for the first time
if ! grep "uk.cvs.moodle.org" ~/.cvspass > /dev/null ; then
echo "CVS password is empty ... please only press <return> to start"
sudo cvs -d :pserver:anonymous@uk.cvs.moodle.org:/cvsroot/moodle login
echo
fi

echo "Connecting to the CVS server. Download will take a few moments!"
echo "If the CVS update runs too long you may break with <ctrl>-C"
echo

### do the cvs installation
sudo cvs -q update -dP -r MOODLE_19_WEEKLY
sudo chown -R _www .
</pre>

Please look at the documentation [https://docs.moodle.org/en/CVS_for_Administrators CVS for Administrators] if you want to learn more about Moodle and CVS. There you will also find a list of different [https://docs.moodle.org/en/CVS_for_Administrators#CVS_Servers CVS servers for Moodle] which you may choose for your updates.

The shown update script should be modified in only three things ... first you need to choose the correct folder for the Moodle files, second choose a CVS server near your server place to minimate internet traffic, and third you must input the correct CVS tag for the Moodle version in the last line. The shown script is for updating the version Moodle 1.9
* Moodle 1.8 uses MOODLE_18_WEEKLY
* Moodle 1.9 uses MOODLE_19_WEEKLY
* Moodle 2.0 RC1 still uses HEAD

===Install Xcode Tools and CVS on your Mac Server===

To test if cvs is already on your Mac Server please open the Terminal and type ''cvs -v''. The output of this command should show a version notice of your Concurrent Versions System (CVS). If you get the ''command not found'' message then you must search for your Mac OS X 10.5 Server installation media. You will find the Xcode Tools on your installation CD or DVD set.

If you can't find your installation media anymore you also can download the Xcode Tools from the URL http://developer.apple.com/tools/xcode/. It is free but you have to register as a developer. Starting the download then the Xcode package copies a lot of bytes on your harddisk and will need a very few minutes to complete.

After you installed the Xcode Tools in your server system you will get the correct version answer from the Terminal command ''cvs -v''. If you only want to update your Moodle you do not need all these nice developer tools from the inside of the folder. Sorry about this but there is no separate installer for the CVS update process.

If cvs does not work on your server please check that the port 2401 is open.
  

==User administration via LDAP==

The following settings will work on 10.5 Server running LDAP - edit them to customize to your own environment. Please note that moodle requires some fields - it is best to have these fields completed in Workgroup Manager on 10.5 Server - otherwise they'll be prompted to enter info into their moodle profile on first login, but the way we've got it set up, moodle can't modify LDAP for security and data integrity. The necessary fields are user name, first name, surname, Email address, City/Town, country, description, ID number.
<pre>
LDAP SERVER SETTINGS
Host URL = ourserver.example.com
Version = 3
LDAP encoding = utf-8

BIND SETTINGS
Hide passwords = Yes
Distinguished Name = (blank)
Password = (blank)

USER LOOKUP SETTINGS
User type = posixAccount (rfc2307)
Contexts = cn=users,dc=ourserver,dc=example,dc=com
Search subcontexts = Yes
Dereference aliases = No
User attribute = (blank)
Member attribute = (blank)
Member attribute uses dn = (blank)
Object class = (blank)

FORCE CHANGE PASSWORD
Force change password = No
Use standard Change Password Page = No
Password format = Plain text
Password change URL = (blank)

LDAP PASSWORD EXPIRATION SETTINGS
Expiration = no
Expiration warning = 10
Expiration attribute = ""
Grace logins = No
Grace login attribute = (blank)

ENABLE USER CREATION
Create users externally = No
Context for new users = (blank)

COURSE CREATOR
Creators = (blank)

CRON SYNCHRONIZATION SCRIPT
Removed ext user = Keep internal

NTLM SSO
Enable = No
Subnet = (blank)
First name = givenName (On every login, Never, Locked)
Surname = sn (On every login, Never, Locked)
Email address = mail (On every login, Never, Locked)
Phone 1 = (blank)
Phone 2 = (blank)
Department = (blank)
Address = (blank)
City/Town = l (On every login, Never, Locked)
Country = c (On every login, Never, Locked)
Description = description (On every login, Never, Locked)
ID number = uidNumber (On every login, Never, Locked)
Language = (blank)
</pre>

==See also==
* [[Complete Install Packages for Mac OS X | Complete install packages for Mac OS X Clients 10.4/10.5/10.6]]
* [[Step-by-step Guide for Installing Moodle on Mac OS X 10.4 Client|Step by step installation for Mac OS X Clients 10.4]]
* [[Cron | Installation of cron for Moodle]]
* [[CVS for Administrators]]

* [http://moodle.org/mod/forum/discuss.php?d=24632 Using Moodle: Dynamic DNS Home Server]

[[Category:Administrator]]
[[Category:Installation]]
[[Category:Mac OS X]]

Step by Step Installation on a Mac OS X Server

2010-10-21T13:31:37Z

Krause: /* Use the CVS update script */

==Overview==
This guide shows all steps for the installation of Moodle on a [http://www.apple.com/server/macosx Mac OS X Server]. This server is a commercial product. You will find [http://www.apple.com/server/macosx/resources/documentation.html all documentations] about the web server on the Apple support pages.

This installation guide can't be useful for an installation on MAMP or XAMPP. If you are looking for an easy way to install Moodle on your local machine please use [[Complete Install Packages for Mac OS X | Complete install packages for Mac OS X 10.4/10.5/10.6 Clients]] that can be downloaded from http://download.moodle.org/macosx/ ... but if you are planning to set up a Moodle internet server on a Mac then you should think about some more security as the ever local package could give.

Please feel free to add your ideas and wishes to the discussion page for this article. You may also write a complete chapter if you tried the facts yourself on your own Mac Server. I am most interested to make the things better.

==System requirements==

+ Apple Computer
+ Mac mini, Mac Pro or Xserve
+ Processor: Intel Core 2 Duo, i5, i7
+ RAM: 2 GB or better
+ Hard Disk: 500 MB free
+ System Software: Mac OS X Server 10.5 or 10.6

==Configure PHP for your Moodle installation==
===Mac OS X 10.6 Server - No PHP installation needed===

The Mac OS X 10.6.4 Server (SnowLeopard) comes with PHP 5.3.2 and a lot of PHP extensions. This would be the best choice for Moodle 1.9.x and for Moodle 2.0 on a Mac OS X Server. Please forget everything you read about the missing GD Library! The PHP installation is totally complete for Moodle. You only have to control if the PHP module is switched on and if the php.ini does the right settings. You should open the file /etc/php.ini and control the settings for Moodle.

===Mac OS X 10.5 Server - Install PHP 5.3.0 and the GD Library===

The Mac OS X 10.5.8 Server (Leopard) comes with PHP 5.2.6 ... this is correct for Moodle 1.9.x. But you have to add the missing GD Library support to get Moodle running on your server. For Moodle 2.0 the server must have PHP 5.2.8 (or better) and some more PHP extensions ... in this case you need to get the better PHP version. These instructions are helpful in both cases.

To see which PHP version and extensions are installed on your server you should edit the file ''/Library/WebServer/Documents/info.php''. You must activate the function call phpinfo() by deleting the both slashes // at the start of the function line. After saving the file you can get all PHP informations in your browser. Please look at http://your-server-address/info.php ... you will not find any GD library support ... bad thing for Moodle!!

<?php
// You can use Server Admin to enable the Apache PHP module; it's disabled by default.
// You can uncomment the phpinfo() directive below to provide a default PHP info page
// but note that this displays information about your host's configuration.
phpinfo();
?>

The easiest way to get the GD library support and to get a better PHP version would be the installation of the complete PHP 5.3.0 package from http://www.entropy.ch/software/macosx/php/. Marc Liyanage precompiled this package to use it on Mac clients and Mac servers. Please get the package and install it by following the instructions on the download page. The installer does everything for you ... it copies PHP into the correct folder ''/usr/local/php5'' and changes its owner to ''root'' automatically. You will find the file php.ini inside the new package folder. Open the file ''/usr/local/php5/lib/php.ini'' and edit some settings for Moodle.

Note: If you want to install Moodle 1.8.x on the server you need to get the Entropy PHP-5.2.9-7.pkg instead. Moodle 1.8.x does not run with PHP 5.3.0. (MDL-20128)

Now the Apache web server must get knowledge that you want to use the new PHP library instead of the old. Open the application Server Admin to switch to the new library. Go to the web server settings and find the entry php5_module. The normal place for PHP the Mac server is ''libexec/apache2/libphp5.so''. Please change to ''/usr/local/php5/libphp5.so'' and save the settings.

[[Image:Server-admin.png]]

===PHP settings in your php.ini===
The second thing to configure is the file php.ini. Most of the settings are okay but not all of them. To communicate to the MySQL database with PHP you have to set the default socket name for local MySQL connects. The default socket name for local MySQLi connects is needed for Moodle 2.0.

If you want to upload any file to your Moodle you should add a little bit more upload size in php.ini. If your server can't use more than 1 GB RAM you should set the memory_limit to a value less than 128M ... but it should have more than 48M for Moodle 1.9 and Moodle 2.0. Note that these sections are not likely to be consecutive in the php.ini file; the quickest way to find each one is search on the initial term (such as 'mysql.default_socket').

; Default socket name for local MySQL connects.
; If empty, uses the built-in MySQL defaults.
mysql.default_socket = /var/mysql/mysql.sock

; Default socket name for local MySQL connects.
; If empty, uses the built-in MySQL defaults.
mysqli.default_socket = /var/mysql/mysql.sock

; Maximum amount of memory a script may consume (128MB)
memory_limit = 128M

; Maximum allowed size for uploaded files.
upload_max_filesize = 128M

; Maximum size of POST data that PHP will accept.
post_max_size = 128M

; Defines the default timezone used by the date functions
; http://php.net/date.timezone
date.timezone = 'Europe/Berlin';

That's all ... save the file php.ini and restart the web server. Now you should look at http://your-server-address/info.php again. I hope that everything will be okay. You will find the version number PHP 5.3.0 and the running GD library support. Congratulations ... the first step for Moodle on your Mac server is done!

[[Image:phpinfo.png]]

[[Image:phpinfo2.png]]

==Configure the MySQL database for your Moodle installation==

In standard case the database MySQL is installed on the Mac OS X Server but it is not running yet. Please make sure that you start the MySQL database server.

===Use the graphical way===
Sorry ... there are some more installations and a lot of clicks to configure MySQL in a graphical way.

First of all start the ''Server Admin''. You will find this program by the way ''Applications > Server > Server Admin''. Activate MySQL on the local server. You must set the password for the user ''root'' before you can start MySQL.

For the next you must download the MySQL database administration tool '''phpMyAdmin''' from http://www.phpmyadmin.net . Move the folder to the web server documents as ''/Library/WebServer/Documents/phpMyAdmin''.

Add the security phrase to the file ''config.inc.php'' in between the single quotes on the line $cfg['blowfish_secret'] = ''; /* YOU MUST FILL IN THIS FOR COOKIE AUTH! */

Now you will be able to start http://your-server-address/phpMyAdmin/ in your browser and to log into the database as the user ''root''. Add a database ''moodle19''. Add a database user ''moodle'' to the server ''localhost''. Don't forget to set a secure password. The database user ''moodle'' should be allowed to administrate the database ''moodle19'' only. It is a bad way to set ''root'' to administrate the database ''moodle19''. If you want to install also Moodle 2.0 dev please add a second database ''moodle20'' and use the same database user for it.

phpMyAdmin is a nice thing to look into the database while Moodle is running for some time. It's much easier to see in the graphical interface than in the command line tools. The image shows the database after Moodle 1.9 and Moodle 2.0 were already installed on this server.

[[Image:phpmyadmin.png]]

===Use the Terminal===
If you want a quick installation then don't fear to use the Terminal. It's easier to tell you all the commands for the right way with the Terminal than showing you all the pictures to do the same with graphical tools. There are only a few commands to do everything I told you before.

Start the Terminal. You will find this program by the way ''Applications > Tools > Terminal''. You will see that we must do the same steps as before but you can read them in a text form.

First of all you need to set the root password. If you didn't this before then use the first command line. If you want to change an existing password then use the second one.

Server:~ $ mysqladmin -u root password 'secret'
Server:~ $ mysqladmin -u root -p password 'topsecret'

The next steps are creating a new database ''moodle19'' with correct character set and setting up a database user ''moodle'', with an assigned password (IDENTIFIED BY), to administrate the new database ... and if you want, then do the same for ''moodle20''.

Server:~ $ mysqladmin -u root -p create moodle19
Server:~ $ mysql -u root -p

mysql> ALTER DATABASE moodle19 CHARSET 'utf8';
mysql> GRANT ALL PRIVILEGES ON moodle19.* TO moodle@localhost
-> IDENTIFIED BY 'moodle!';
mysql> quit

Server:~ $

That's really all with the Terminal. You are just ready!

==Copy the Moodle files to the web server==

The documents for the web server are saved in the folder ''/Library/WebServer/Documents/''. You will place your Moodle folder here after you got it from http://download.moodle.org. Download the standard package MOODLE_19_WEEKLY because this is the best choice for new servers. Set the owner ''_www'' for the moodle folder ... this is the user for the web server. The folder permissions should be 755 before the installation and 555 after it's done ... please remember to set this later!

You also need the moodledata folder outside of the Documents folder ... so please make one. Go to the folder ''/Library/WebServer/'' and add the folder ''moodledata''. Because I want to install Moodle 1.9.x and Moodle 2.0 dev together on the same Mac server I add two folders ''moodle19'' and ''moodle20'' inside the moodledata folder. Please set the owner ''_www'' for both folders ''moodle19'' and ''moodle20'' and the folder permissions to 755.

cd /Library/WebServer/
mkdir moodledata
mkdir moodledata/moodle19
mkdir moodledata/moodle20
sudo chown -R _www moodledata
sudo chmod -R 755 moodledata

If you'd like to put the moodledata folder on another volume (not a bad idea if you think you'll have a substantial amount of data within the moodle), note that you cannot simply reference it using the /Volumes/<volume_name>/folder syntax during the moodle setup. Instead, you'll need to create the folder (assigning the user and permissions), then create a '''link''' to it within the /Library/WebServer folder. To create the link, use the following command in a terminal window, substituting your data volume and folder name:

cd /Library/WebServer
ln -s /Volumes/Data_Volume/moodledata moodledata

==Run the Moodle installation==
The installation on the Mac server is the same like the installation on every other server.
Open a web browser to http://your-server-address/moodle/install.php to begin the installation process.
On the screen picture and in the shown config.php you see the web address ''your-server-address'' ... it's only a placeholder for a real address or url ... please set yours. Also a user 'moodle' with a password 'moodle' would be very unsafe settings for your installation.

[[Image:moodle-install1.png]]

[[Image:moodle-install2.png]]

The installer generates the config.php automatically and saves it in the folder ''/Library/WebServer/Documents/moodle19''. Please edit the config.php with a text editor and add the line ''date_default_timezone_set('UTC');''. You may change ''UTC'' to your own timezone ... this is needed for PHP 5.3.0. In case you don't know all the relevant time zone identifiers by heart, there is a [http://phpbuilder.com/manual/en/timezones.php list available online].

<?php /// Moodle Configuration File

unset($CFG);

$CFG->dbtype = 'mysql';
$CFG->dbhost = 'localhost';
$CFG->dbname = 'moodle19';
$CFG->dbuser = 'moodle';
$CFG->dbpass = 'moodle';
$CFG->dbpersist = false;
$CFG->prefix = 'mdl_';

$CFG->wwwroot = 'http://your-server-address/moodle19';
$CFG->dirroot = '/Library/WebServer/Documents/moodle19';
$CFG->dataroot = '/Library/WebServer/moodledata/moodle19';
$CFG->admin = 'admin';

$CFG->directorypermissions = 00777; // try 02777 on a server in Safe Mode

date_default_timezone_set('Europe/Berlin'); // timezone for PHP 5.3.0
require_once("$CFG->dirroot/lib/setup.php");
// MAKE SURE WHEN YOU EDIT THIS FILE THAT THERE ARE NO SPACES, BLANK LINES,
// RETURNS, OR ANYTHING ELSE AFTER THE TWO CHARACTERS ON THE NEXT LINE.
?>

After this, the web-based installation component will walk you through '''several''' screens worth of database configurations and updates, for most of which you'll just click the continue button. You'll set up an admin user and give the site a basic configuration (title, description, etc). When the installation is ready you should change the folder permission for ''/Library/WebServer/Documents/moodle19'' to 555 so the web server is not able to write into this folder again.

==Download the language packages==

==Moodle is running ...==
[[Image:moodle-on-macosx-server.png]]

==How to setup the cron job with launchd==

It's really important to start the cron job every 5 minutes. The cron job assists most of Moodle's modules to perform tasks on a scheduled basis. For example, the discussion forums can only mail out copies of new posts to all subscribers if the cron job tells Moodle to do this.

In Mac OS X you will find the system daemon ''launchd'' for this service. This daemon offers a standardized interface to any user and all programs started automatically by the system. Please look at http://developer.apple.com/macosx/launchd.html for more information about the configurations and all parameters.

In our case the service should get the web page http://your-server-address/moodle19/admin/cron.php every 5 minutes. The configuration will be done by the file named ''moodle4mac.cron.plist'' which must be placed in the system folder ''/Library/LaunchDaemons/'' ... surely you can use any other file name but it should say something about the function of the service. The extension must be ''.plist''. After any reboot of your Mac server the cron service will start automaticly because the file is placed in the correct system folder.

===Use the graphical way===
You can use Lingon to add a new daemon plist or to edit one. It produces the same text as you can write in your text editor. http://sourceforge.net/projects/lingon/files/

[[Image:macosx-lingon.png]]

===Use a text editor===
Please use a text editor to write the needed file. You can open the Terminal and use the system editors vi or pico. But you can also write the text file with any GUI text editor ... I mostly use TextWrangler ... but do NOT take an editor for formatted texts like Microsoft Word or OpenOffice Writer. You must get pure text!

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0//EN"
"http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>KeepAlive</key><false/>
<key>Label</key><string>moodle4mac.cron</string>
<key>ProgramArguments</key>
<array>
<string>curl</string>
<string>-s</string>
<string>http://your-server-address/moodle19/admin/cron.php</string>
</array>
<key>RunAtLoad</key><true />
<key>StartInterval</key><integer>300</integer>
<key>StandardErrorPath</key><string>/dev/null</string>
<key>StandardOutPath</key><string>/dev/null</string>
</dict>
</plist>

The label string must be the same as the file name is but without the extension ''.plist''. Save the text file ''/Library/LaunchDaemons/moodle4mac.cron.plist''. The owner of the file must be set to the system user ''root''. That's all, really!

===How to start and stop the cron service===
You can start the new cron service in the Terminal.

sudo launchctl load /Library/LaunchDaemons/moodle4mac.cron.plist

The following command would stop the service. If you want to activate changes in the cron service you need to ''unload'' and then to ''load'' the daemon again.

sudo launchctl unload /Library/LaunchDaemons/moodle4mac.cron.plist

===Only one service for two servers?===
For my server I needed to have a cron service for to instances ''moodle19'' and ''moodle20'' ... no problem ... with the typo ''moodle[19-20]'' the server will get a cron service for both instances.

<nowiki>curl -s http://your-server-address/moodle[19-20]/admin/cron.php</nowiki>

To see if the cron service works correctly you should look at the ''access.log'' of your web server. The cron.php should be accessed every 5 minutes ... on my server for both Moodle instances ''moodle19'' and ''moodle20'' ... oh yes, it works!!

192.168.0.220 - - [30/Jul/2009:22:10:56 +0200] "GET /moodle19/admin/cron.php HTTP/1.1" 200 1136
192.168.0.220 - - [30/Jul/2009:22:10:57 +0200] "GET /moodle20/admin/cron.php HTTP/1.1" 200 1403
192.168.0.220 - - [30/Jul/2009:22:11:18 +0200] "OPTIONS * HTTP/1.0" 200 -
192.168.0.220 - - [30/Jul/2009:22:15:56 +0200] "GET /moodle19/admin/cron.php HTTP/1.1" 200 735
192.168.0.220 - - [30/Jul/2009:22:15:57 +0200] "GET /moodle20/admin/cron.php HTTP/1.1" 200 964
192.168.0.220 - - [30/Jul/2009:22:20:56 +0200] "GET /moodle19/admin/cron.php HTTP/1.1" 200 1136
192.168.0.220 - - [30/Jul/2009:22:20:57 +0200] "GET /moodle20/admin/cron.php HTTP/1.1" 200 1365

==How to install and update Moodle via CVS==

CVS is very simple way to install and update your Moodle.

The only software you must have installed on your Mac server is the Xcode Tools package from your system installation media. You also must have an internet connection to get the files from the update server. After you installed both script files on your server desktop it only needs a doubleclick to get the newest Moodle version without downloading the complete installation package. Please remember - before you can update your Moodle via CVS you must install Moodle via CVS at once.

That's all .... really .... it's easy!!

===Use the CVS installation script===
If your Moodle is already installed via CVS please use the CVS updater (see below). Running the CVS installer will install only the standard version of Moodle on your server.

If you already have a working Moodle on your server then this script copies the file config.php into your new installation but it does not copy your additional modules or plugins or themes. You will find your old moodle folder in same directory and it will be renamed with an additional date stamp.

<pre>
#! /bin/sh
#
# CVS installer for Moodle
# on a Mac OS X Server
#
# 20100818 - Ralf Krause
#

export CVS_RSH=ssh

### file ~/.cvspass must exist
if ! test -e ~/.cvspass ; then
touch ~/.cvspass
fi

echo
echo "+--------------------------------------------+"
echo "| CVS installer for the Moodle server "
echo "+--------------------------------------------+"
echo

cd /Library/WebServer/Documents

### get the cvs installation into a tmp folder
if ! test -e tmp ; then
sudo mkdir tmp
sudo chmod 777 tmp
fi

echo "Connecting to the CVS server. Download will take a few moments!"
echo "If the CVS update runs too long you may break with <ctrl>-C"
echo

### do the cvs installation
cd tmp
cvs -z9 -d:pserver:anonymous@uk.cvs.moodle.org:/cvsroot/moodle co -P -r MOODLE_19_WEEKLY moodle
cd ..

### copy config.php from your current moodle folder if it exists
if ! test -e moodle/config.php ; then
cp moodle19/config.php tmp/moodle/config.php
fi

### move the new moodle to the right place
DATE=`date +%Y%m%d-%H%M`
sudo mv moodle19 moodle19-$DATE
sudo mv tmp/moodle moodle19
sudo chown -R _www moodle19
</pre>

===Use the CVS update script===
To be able to update Moodle via CVS please check that your Moodle was already installed via CVS (see above).

<pre>
#! /bin/sh
#
# CVS updater for Moodle
# on a Mac OS X Server
#
# 20100818 - Ralf Krause
#

export CVS_RSH=ssh

echo
echo "+--------------------------------------------+"
echo "| CVS updater for the Moodle server "
echo "+--------------------------------------------+"
echo

cd /Library/WebServer/Documents/moodle19/

### file ~/.cvspass must exist
if ! test -e ~/.cvspass ; then
touch ~/.cvspass
fi

### login to the cvs server only for the first time
if ! grep "uk.cvs.moodle.org" ~/.cvspass > /dev/null ; then
echo "CVS password is empty ... please only press <return> to start"
sudo cvs -d :pserver:anonymous@uk.cvs.moodle.org:/cvsroot/moodle login
echo
fi

echo "Connecting to the CVS server. Download will take a few moments!"
echo "If the CVS update runs too long you may break with <ctrl>-C"
echo

### do the cvs installation
sudo cvs -q update -dP -r MOODLE_19_WEEKLY
sudo chown -R _www .
</pre>

Please look at the documentation [https://docs.moodle.org/en/CVS_for_Administrators CVS for Administrators] if you want to learn more about Moodle and CVS. There you will also find a list of different [https://docs.moodle.org/en/CVS_for_Administrators#CVS_Servers CVS servers for Moodle] which you may choose for your updates.

The shown update script should be modified in only three things ... first you need to choose the correct folder for the Moodle files, second choose a CVS server near your server place to minimate internet traffic, and third you must input the correct CVS tag for the Moodle version in the last line. The shown script is for updating the version Moodle 1.9
* Moodle 1.8 uses MOODLE_18_WEEKLY
* Moodle 1.9 uses MOODLE_19_WEEKLY
* Moodle 2.0 RC1 still uses HEAD

===Install Xcode Tools and CVS on your Mac Server===

To test if cvs is already on your Mac Server please open the Terminal and type ''cvs -v''. The output of this command should show a version notice of your Concurrent Versions System (CVS). If you get the ''command not found'' message then you must search for your Mac OS X 10.5 Server installation media. You will find the Xcode Tools on your installation CD or DVD set.

If you can't find your installation media anymore you also can download the Xcode Tools from the URL http://developer.apple.com/tools/xcode/. It is free but you have to register as a developer. Starting the download then the Xcode package copies a lot of bytes on your harddisk and will need a very few minutes to complete.

After you installed the Xcode Tools in your server system you will get the correct version answer from the Terminal command ''cvs -v''. If you only want to update your Moodle you do not need all these nice developer tools from the inside of the folder. Sorry about this but there is no separate installer for the CVS update process.

If cvs does not work on your server please check that the port 2401 is open.
  

==User administration via LDAP==

The following settings will work on 10.5 Server running LDAP - edit them to customize to your own environment. Please note that moodle requires some fields - it is best to have these fields completed in Workgroup Manager on 10.5 Server - otherwise they'll be prompted to enter info into their moodle profile on first login, but the way we've got it set up, moodle can't modify LDAP for security and data integrity. The necessary fields are user name, first name, surname, Email address, City/Town, country, description, ID number.
<pre>
LDAP SERVER SETTINGS
Host URL = ourserver.example.com
Version = 3
LDAP encoding = utf-8

BIND SETTINGS
Hide passwords = Yes
Distinguished Name = (blank)
Password = (blank)

USER LOOKUP SETTINGS
User type = posixAccount (rfc2307)
Contexts = cn=users,dc=ourserver,dc=example,dc=com
Search subcontexts = Yes
Dereference aliases = No
User attribute = (blank)
Member attribute = (blank)
Member attribute uses dn = (blank)
Object class = (blank)

FORCE CHANGE PASSWORD
Force change password = No
Use standard Change Password Page = No
Password format = Plain text
Password change URL = (blank)

LDAP PASSWORD EXPIRATION SETTINGS
Expiration = no
Expiration warning = 10
Expiration attribute = ""
Grace logins = No
Grace login attribute = (blank)

ENABLE USER CREATION
Create users externally = No
Context for new users = (blank)

COURSE CREATOR
Creators = (blank)

CRON SYNCHRONIZATION SCRIPT
Removed ext user = Keep internal

NTLM SSO
Enable = No
Subnet = (blank)
First name = givenName (On every login, Never, Locked)
Surname = sn (On every login, Never, Locked)
Email address = mail (On every login, Never, Locked)
Phone 1 = (blank)
Phone 2 = (blank)
Department = (blank)
Address = (blank)
City/Town = l (On every login, Never, Locked)
Country = c (On every login, Never, Locked)
Description = description (On every login, Never, Locked)
ID number = uidNumber (On every login, Never, Locked)
Language = (blank)
</pre>

==See also==
* [[Complete Install Packages for Mac OS X | Complete install packages for Mac OS X 10.4/10.5/10.6 Clients]]
* [[Step-by-step Guide for Installing Moodle on Mac OS X 10.4 Client|Step by step installation on a Mac OS X 10.4 Client]]
* [[Cron | Installation of cron for Moodle]]
* [[CVS for Administrators]]

* [http://moodle.org/mod/forum/discuss.php?d=24632 Using Moodle: Dynamic DNS Home Server]

[[Category:Administrator]]
[[Category:Installation]]
[[Category:Mac OS X]]

Step by Step Installation on a Mac OS X Server

2010-10-21T13:31:01Z

Krause: /* Use the CVS update script */

==Overview==
This guide shows all steps for the installation of Moodle on a [http://www.apple.com/server/macosx Mac OS X Server]. This server is a commercial product. You will find [http://www.apple.com/server/macosx/resources/documentation.html all documentations] about the web server on the Apple support pages.

This installation guide can't be useful for an installation on MAMP or XAMPP. If you are looking for an easy way to install Moodle on your local machine please use [[Complete Install Packages for Mac OS X | Complete install packages for Mac OS X 10.4/10.5/10.6 Clients]] that can be downloaded from http://download.moodle.org/macosx/ ... but if you are planning to set up a Moodle internet server on a Mac then you should think about some more security as the ever local package could give.

Please feel free to add your ideas and wishes to the discussion page for this article. You may also write a complete chapter if you tried the facts yourself on your own Mac Server. I am most interested to make the things better.

==System requirements==

+ Apple Computer
+ Mac mini, Mac Pro or Xserve
+ Processor: Intel Core 2 Duo, i5, i7
+ RAM: 2 GB or better
+ Hard Disk: 500 MB free
+ System Software: Mac OS X Server 10.5 or 10.6

==Configure PHP for your Moodle installation==
===Mac OS X 10.6 Server - No PHP installation needed===

The Mac OS X 10.6.4 Server (SnowLeopard) comes with PHP 5.3.2 and a lot of PHP extensions. This would be the best choice for Moodle 1.9.x and for Moodle 2.0 on a Mac OS X Server. Please forget everything you read about the missing GD Library! The PHP installation is totally complete for Moodle. You only have to control if the PHP module is switched on and if the php.ini does the right settings. You should open the file /etc/php.ini and control the settings for Moodle.

===Mac OS X 10.5 Server - Install PHP 5.3.0 and the GD Library===

The Mac OS X 10.5.8 Server (Leopard) comes with PHP 5.2.6 ... this is correct for Moodle 1.9.x. But you have to add the missing GD Library support to get Moodle running on your server. For Moodle 2.0 the server must have PHP 5.2.8 (or better) and some more PHP extensions ... in this case you need to get the better PHP version. These instructions are helpful in both cases.

To see which PHP version and extensions are installed on your server you should edit the file ''/Library/WebServer/Documents/info.php''. You must activate the function call phpinfo() by deleting the both slashes // at the start of the function line. After saving the file you can get all PHP informations in your browser. Please look at http://your-server-address/info.php ... you will not find any GD library support ... bad thing for Moodle!!

<?php
// You can use Server Admin to enable the Apache PHP module; it's disabled by default.
// You can uncomment the phpinfo() directive below to provide a default PHP info page
// but note that this displays information about your host's configuration.
phpinfo();
?>

The easiest way to get the GD library support and to get a better PHP version would be the installation of the complete PHP 5.3.0 package from http://www.entropy.ch/software/macosx/php/. Marc Liyanage precompiled this package to use it on Mac clients and Mac servers. Please get the package and install it by following the instructions on the download page. The installer does everything for you ... it copies PHP into the correct folder ''/usr/local/php5'' and changes its owner to ''root'' automatically. You will find the file php.ini inside the new package folder. Open the file ''/usr/local/php5/lib/php.ini'' and edit some settings for Moodle.

Note: If you want to install Moodle 1.8.x on the server you need to get the Entropy PHP-5.2.9-7.pkg instead. Moodle 1.8.x does not run with PHP 5.3.0. (MDL-20128)

Now the Apache web server must get knowledge that you want to use the new PHP library instead of the old. Open the application Server Admin to switch to the new library. Go to the web server settings and find the entry php5_module. The normal place for PHP the Mac server is ''libexec/apache2/libphp5.so''. Please change to ''/usr/local/php5/libphp5.so'' and save the settings.

[[Image:Server-admin.png]]

===PHP settings in your php.ini===
The second thing to configure is the file php.ini. Most of the settings are okay but not all of them. To communicate to the MySQL database with PHP you have to set the default socket name for local MySQL connects. The default socket name for local MySQLi connects is needed for Moodle 2.0.

If you want to upload any file to your Moodle you should add a little bit more upload size in php.ini. If your server can't use more than 1 GB RAM you should set the memory_limit to a value less than 128M ... but it should have more than 48M for Moodle 1.9 and Moodle 2.0. Note that these sections are not likely to be consecutive in the php.ini file; the quickest way to find each one is search on the initial term (such as 'mysql.default_socket').

; Default socket name for local MySQL connects.
; If empty, uses the built-in MySQL defaults.
mysql.default_socket = /var/mysql/mysql.sock

; Default socket name for local MySQL connects.
; If empty, uses the built-in MySQL defaults.
mysqli.default_socket = /var/mysql/mysql.sock

; Maximum amount of memory a script may consume (128MB)
memory_limit = 128M

; Maximum allowed size for uploaded files.
upload_max_filesize = 128M

; Maximum size of POST data that PHP will accept.
post_max_size = 128M

; Defines the default timezone used by the date functions
; http://php.net/date.timezone
date.timezone = 'Europe/Berlin';

That's all ... save the file php.ini and restart the web server. Now you should look at http://your-server-address/info.php again. I hope that everything will be okay. You will find the version number PHP 5.3.0 and the running GD library support. Congratulations ... the first step for Moodle on your Mac server is done!

[[Image:phpinfo.png]]

[[Image:phpinfo2.png]]

==Configure the MySQL database for your Moodle installation==

In standard case the database MySQL is installed on the Mac OS X Server but it is not running yet. Please make sure that you start the MySQL database server.

===Use the graphical way===
Sorry ... there are some more installations and a lot of clicks to configure MySQL in a graphical way.

First of all start the ''Server Admin''. You will find this program by the way ''Applications > Server > Server Admin''. Activate MySQL on the local server. You must set the password for the user ''root'' before you can start MySQL.

For the next you must download the MySQL database administration tool '''phpMyAdmin''' from http://www.phpmyadmin.net . Move the folder to the web server documents as ''/Library/WebServer/Documents/phpMyAdmin''.

Add the security phrase to the file ''config.inc.php'' in between the single quotes on the line $cfg['blowfish_secret'] = ''; /* YOU MUST FILL IN THIS FOR COOKIE AUTH! */

Now you will be able to start http://your-server-address/phpMyAdmin/ in your browser and to log into the database as the user ''root''. Add a database ''moodle19''. Add a database user ''moodle'' to the server ''localhost''. Don't forget to set a secure password. The database user ''moodle'' should be allowed to administrate the database ''moodle19'' only. It is a bad way to set ''root'' to administrate the database ''moodle19''. If you want to install also Moodle 2.0 dev please add a second database ''moodle20'' and use the same database user for it.

phpMyAdmin is a nice thing to look into the database while Moodle is running for some time. It's much easier to see in the graphical interface than in the command line tools. The image shows the database after Moodle 1.9 and Moodle 2.0 were already installed on this server.

[[Image:phpmyadmin.png]]

===Use the Terminal===
If you want a quick installation then don't fear to use the Terminal. It's easier to tell you all the commands for the right way with the Terminal than showing you all the pictures to do the same with graphical tools. There are only a few commands to do everything I told you before.

Start the Terminal. You will find this program by the way ''Applications > Tools > Terminal''. You will see that we must do the same steps as before but you can read them in a text form.

First of all you need to set the root password. If you didn't this before then use the first command line. If you want to change an existing password then use the second one.

Server:~ $ mysqladmin -u root password 'secret'
Server:~ $ mysqladmin -u root -p password 'topsecret'

The next steps are creating a new database ''moodle19'' with correct character set and setting up a database user ''moodle'', with an assigned password (IDENTIFIED BY), to administrate the new database ... and if you want, then do the same for ''moodle20''.

Server:~ $ mysqladmin -u root -p create moodle19
Server:~ $ mysql -u root -p

mysql> ALTER DATABASE moodle19 CHARSET 'utf8';
mysql> GRANT ALL PRIVILEGES ON moodle19.* TO moodle@localhost
-> IDENTIFIED BY 'moodle!';
mysql> quit

Server:~ $

That's really all with the Terminal. You are just ready!

==Copy the Moodle files to the web server==

The documents for the web server are saved in the folder ''/Library/WebServer/Documents/''. You will place your Moodle folder here after you got it from http://download.moodle.org. Download the standard package MOODLE_19_WEEKLY because this is the best choice for new servers. Set the owner ''_www'' for the moodle folder ... this is the user for the web server. The folder permissions should be 755 before the installation and 555 after it's done ... please remember to set this later!

You also need the moodledata folder outside of the Documents folder ... so please make one. Go to the folder ''/Library/WebServer/'' and add the folder ''moodledata''. Because I want to install Moodle 1.9.x and Moodle 2.0 dev together on the same Mac server I add two folders ''moodle19'' and ''moodle20'' inside the moodledata folder. Please set the owner ''_www'' for both folders ''moodle19'' and ''moodle20'' and the folder permissions to 755.

cd /Library/WebServer/
mkdir moodledata
mkdir moodledata/moodle19
mkdir moodledata/moodle20
sudo chown -R _www moodledata
sudo chmod -R 755 moodledata

If you'd like to put the moodledata folder on another volume (not a bad idea if you think you'll have a substantial amount of data within the moodle), note that you cannot simply reference it using the /Volumes/<volume_name>/folder syntax during the moodle setup. Instead, you'll need to create the folder (assigning the user and permissions), then create a '''link''' to it within the /Library/WebServer folder. To create the link, use the following command in a terminal window, substituting your data volume and folder name:

cd /Library/WebServer
ln -s /Volumes/Data_Volume/moodledata moodledata

==Run the Moodle installation==
The installation on the Mac server is the same like the installation on every other server.
Open a web browser to http://your-server-address/moodle/install.php to begin the installation process.
On the screen picture and in the shown config.php you see the web address ''your-server-address'' ... it's only a placeholder for a real address or url ... please set yours. Also a user 'moodle' with a password 'moodle' would be very unsafe settings for your installation.

[[Image:moodle-install1.png]]

[[Image:moodle-install2.png]]

The installer generates the config.php automatically and saves it in the folder ''/Library/WebServer/Documents/moodle19''. Please edit the config.php with a text editor and add the line ''date_default_timezone_set('UTC');''. You may change ''UTC'' to your own timezone ... this is needed for PHP 5.3.0. In case you don't know all the relevant time zone identifiers by heart, there is a [http://phpbuilder.com/manual/en/timezones.php list available online].

<?php /// Moodle Configuration File

unset($CFG);

$CFG->dbtype = 'mysql';
$CFG->dbhost = 'localhost';
$CFG->dbname = 'moodle19';
$CFG->dbuser = 'moodle';
$CFG->dbpass = 'moodle';
$CFG->dbpersist = false;
$CFG->prefix = 'mdl_';

$CFG->wwwroot = 'http://your-server-address/moodle19';
$CFG->dirroot = '/Library/WebServer/Documents/moodle19';
$CFG->dataroot = '/Library/WebServer/moodledata/moodle19';
$CFG->admin = 'admin';

$CFG->directorypermissions = 00777; // try 02777 on a server in Safe Mode

date_default_timezone_set('Europe/Berlin'); // timezone for PHP 5.3.0
require_once("$CFG->dirroot/lib/setup.php");
// MAKE SURE WHEN YOU EDIT THIS FILE THAT THERE ARE NO SPACES, BLANK LINES,
// RETURNS, OR ANYTHING ELSE AFTER THE TWO CHARACTERS ON THE NEXT LINE.
?>

After this, the web-based installation component will walk you through '''several''' screens worth of database configurations and updates, for most of which you'll just click the continue button. You'll set up an admin user and give the site a basic configuration (title, description, etc). When the installation is ready you should change the folder permission for ''/Library/WebServer/Documents/moodle19'' to 555 so the web server is not able to write into this folder again.

==Download the language packages==

==Moodle is running ...==
[[Image:moodle-on-macosx-server.png]]

==How to setup the cron job with launchd==

It's really important to start the cron job every 5 minutes. The cron job assists most of Moodle's modules to perform tasks on a scheduled basis. For example, the discussion forums can only mail out copies of new posts to all subscribers if the cron job tells Moodle to do this.

In Mac OS X you will find the system daemon ''launchd'' for this service. This daemon offers a standardized interface to any user and all programs started automatically by the system. Please look at http://developer.apple.com/macosx/launchd.html for more information about the configurations and all parameters.

In our case the service should get the web page http://your-server-address/moodle19/admin/cron.php every 5 minutes. The configuration will be done by the file named ''moodle4mac.cron.plist'' which must be placed in the system folder ''/Library/LaunchDaemons/'' ... surely you can use any other file name but it should say something about the function of the service. The extension must be ''.plist''. After any reboot of your Mac server the cron service will start automaticly because the file is placed in the correct system folder.

===Use the graphical way===
You can use Lingon to add a new daemon plist or to edit one. It produces the same text as you can write in your text editor. http://sourceforge.net/projects/lingon/files/

[[Image:macosx-lingon.png]]

===Use a text editor===
Please use a text editor to write the needed file. You can open the Terminal and use the system editors vi or pico. But you can also write the text file with any GUI text editor ... I mostly use TextWrangler ... but do NOT take an editor for formatted texts like Microsoft Word or OpenOffice Writer. You must get pure text!

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0//EN"
"http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>KeepAlive</key><false/>
<key>Label</key><string>moodle4mac.cron</string>
<key>ProgramArguments</key>
<array>
<string>curl</string>
<string>-s</string>
<string>http://your-server-address/moodle19/admin/cron.php</string>
</array>
<key>RunAtLoad</key><true />
<key>StartInterval</key><integer>300</integer>
<key>StandardErrorPath</key><string>/dev/null</string>
<key>StandardOutPath</key><string>/dev/null</string>
</dict>
</plist>

The label string must be the same as the file name is but without the extension ''.plist''. Save the text file ''/Library/LaunchDaemons/moodle4mac.cron.plist''. The owner of the file must be set to the system user ''root''. That's all, really!

===How to start and stop the cron service===
You can start the new cron service in the Terminal.

sudo launchctl load /Library/LaunchDaemons/moodle4mac.cron.plist

The following command would stop the service. If you want to activate changes in the cron service you need to ''unload'' and then to ''load'' the daemon again.

sudo launchctl unload /Library/LaunchDaemons/moodle4mac.cron.plist

===Only one service for two servers?===
For my server I needed to have a cron service for to instances ''moodle19'' and ''moodle20'' ... no problem ... with the typo ''moodle[19-20]'' the server will get a cron service for both instances.

<nowiki>curl -s http://your-server-address/moodle[19-20]/admin/cron.php</nowiki>

To see if the cron service works correctly you should look at the ''access.log'' of your web server. The cron.php should be accessed every 5 minutes ... on my server for both Moodle instances ''moodle19'' and ''moodle20'' ... oh yes, it works!!

192.168.0.220 - - [30/Jul/2009:22:10:56 +0200] "GET /moodle19/admin/cron.php HTTP/1.1" 200 1136
192.168.0.220 - - [30/Jul/2009:22:10:57 +0200] "GET /moodle20/admin/cron.php HTTP/1.1" 200 1403
192.168.0.220 - - [30/Jul/2009:22:11:18 +0200] "OPTIONS * HTTP/1.0" 200 -
192.168.0.220 - - [30/Jul/2009:22:15:56 +0200] "GET /moodle19/admin/cron.php HTTP/1.1" 200 735
192.168.0.220 - - [30/Jul/2009:22:15:57 +0200] "GET /moodle20/admin/cron.php HTTP/1.1" 200 964
192.168.0.220 - - [30/Jul/2009:22:20:56 +0200] "GET /moodle19/admin/cron.php HTTP/1.1" 200 1136
192.168.0.220 - - [30/Jul/2009:22:20:57 +0200] "GET /moodle20/admin/cron.php HTTP/1.1" 200 1365

==How to install and update Moodle via CVS==

CVS is very simple way to install and update your Moodle.

The only software you must have installed on your Mac server is the Xcode Tools package from your system installation media. You also must have an internet connection to get the files from the update server. After you installed both script files on your server desktop it only needs a doubleclick to get the newest Moodle version without downloading the complete installation package. Please remember - before you can update your Moodle via CVS you must install Moodle via CVS at once.

That's all .... really .... it's easy!!

===Use the CVS installation script===
If your Moodle is already installed via CVS please use the CVS updater (see below). Running the CVS installer will install only the standard version of Moodle on your server.

If you already have a working Moodle on your server then this script copies the file config.php into your new installation but it does not copy your additional modules or plugins or themes. You will find your old moodle folder in same directory and it will be renamed with an additional date stamp.

<pre>
#! /bin/sh
#
# CVS installer for Moodle
# on a Mac OS X Server
#
# 20100818 - Ralf Krause
#

export CVS_RSH=ssh

### file ~/.cvspass must exist
if ! test -e ~/.cvspass ; then
touch ~/.cvspass
fi

echo
echo "+--------------------------------------------+"
echo "| CVS installer for the Moodle server "
echo "+--------------------------------------------+"
echo

cd /Library/WebServer/Documents

### get the cvs installation into a tmp folder
if ! test -e tmp ; then
sudo mkdir tmp
sudo chmod 777 tmp
fi

echo "Connecting to the CVS server. Download will take a few moments!"
echo "If the CVS update runs too long you may break with <ctrl>-C"
echo

### do the cvs installation
cd tmp
cvs -z9 -d:pserver:anonymous@uk.cvs.moodle.org:/cvsroot/moodle co -P -r MOODLE_19_WEEKLY moodle
cd ..

### copy config.php from your current moodle folder if it exists
if ! test -e moodle/config.php ; then
cp moodle19/config.php tmp/moodle/config.php
fi

### move the new moodle to the right place
DATE=`date +%Y%m%d-%H%M`
sudo mv moodle19 moodle19-$DATE
sudo mv tmp/moodle moodle19
sudo chown -R _www moodle19
</pre>

===Use the CVS update script===
To be able to update Moodle via CVS please check that your Moodle was already installed via CVS (see above).

<pre>
#! /bin/sh
#
# CVS updater for Moodle
# on a Mac OS X Server
#
# 20100818 - Ralf Krause
#

export CVS_RSH=ssh

echo
echo "+--------------------------------------------+"
echo "| CVS updater for the Moodle server "
echo "+--------------------------------------------+"
echo

cd /Library/WebServer/Documents/moodle19/

### file ~/.cvspass must exist
if ! test -e ~/.cvspass ; then
touch ~/.cvspass
fi

### login to the cvs server only for the first time
if ! grep "uk.cvs.moodle.org" ~/.cvspass > /dev/null ; then
echo "CVS password is empty ... please only press <return> to start"
sudo cvs -d :pserver:anonymous@uk.cvs.moodle.org:/cvsroot/moodle login
echo
fi

echo "Connecting to the CVS server. Download will take a few moments!"
echo "If the CVS update runs too long you may break with <ctrl>-C"
echo

### do the cvs installation
sudo cvs -q update -dP -r MOODLE_19_WEEKLY
sudo chown -R _www .
</pre>

Please look at the documentation [https://docs.moodle.org/en/CVS_for_Administrators CVS for Administrators] if you want to learn more about Moodle and CVS. There you will also find a list of different [https://docs.moodle.org/en/CVS_for_Administrators#CVS_Servers CVS servers for Moodle] which you may choose for your updates.

The shown update script should be modified in only three things ... first you need to choose the correct folder for the Moodle files, second choose a CVS server near your server place to minimate internet traffic, and third you must input the correct CVS tag for the Moodle version in the last line. The shown script is for updating the version Moodle 1.9
* Moodle 1.8 uses MOODLE_18_WEEKLY
* Moodle 1.9 uses MOODLE_19_WEEKLY
* Moodle 2.0 Preview uses HEAD

===Install Xcode Tools and CVS on your Mac Server===

To test if cvs is already on your Mac Server please open the Terminal and type ''cvs -v''. The output of this command should show a version notice of your Concurrent Versions System (CVS). If you get the ''command not found'' message then you must search for your Mac OS X 10.5 Server installation media. You will find the Xcode Tools on your installation CD or DVD set.

If you can't find your installation media anymore you also can download the Xcode Tools from the URL http://developer.apple.com/tools/xcode/. It is free but you have to register as a developer. Starting the download then the Xcode package copies a lot of bytes on your harddisk and will need a very few minutes to complete.

After you installed the Xcode Tools in your server system you will get the correct version answer from the Terminal command ''cvs -v''. If you only want to update your Moodle you do not need all these nice developer tools from the inside of the folder. Sorry about this but there is no separate installer for the CVS update process.

If cvs does not work on your server please check that the port 2401 is open.
  

==User administration via LDAP==

The following settings will work on 10.5 Server running LDAP - edit them to customize to your own environment. Please note that moodle requires some fields - it is best to have these fields completed in Workgroup Manager on 10.5 Server - otherwise they'll be prompted to enter info into their moodle profile on first login, but the way we've got it set up, moodle can't modify LDAP for security and data integrity. The necessary fields are user name, first name, surname, Email address, City/Town, country, description, ID number.
<pre>
LDAP SERVER SETTINGS
Host URL = ourserver.example.com
Version = 3
LDAP encoding = utf-8

BIND SETTINGS
Hide passwords = Yes
Distinguished Name = (blank)
Password = (blank)

USER LOOKUP SETTINGS
User type = posixAccount (rfc2307)
Contexts = cn=users,dc=ourserver,dc=example,dc=com
Search subcontexts = Yes
Dereference aliases = No
User attribute = (blank)
Member attribute = (blank)
Member attribute uses dn = (blank)
Object class = (blank)

FORCE CHANGE PASSWORD
Force change password = No
Use standard Change Password Page = No
Password format = Plain text
Password change URL = (blank)

LDAP PASSWORD EXPIRATION SETTINGS
Expiration = no
Expiration warning = 10
Expiration attribute = ""
Grace logins = No
Grace login attribute = (blank)

ENABLE USER CREATION
Create users externally = No
Context for new users = (blank)

COURSE CREATOR
Creators = (blank)

CRON SYNCHRONIZATION SCRIPT
Removed ext user = Keep internal

NTLM SSO
Enable = No
Subnet = (blank)
First name = givenName (On every login, Never, Locked)
Surname = sn (On every login, Never, Locked)
Email address = mail (On every login, Never, Locked)
Phone 1 = (blank)
Phone 2 = (blank)
Department = (blank)
Address = (blank)
City/Town = l (On every login, Never, Locked)
Country = c (On every login, Never, Locked)
Description = description (On every login, Never, Locked)
ID number = uidNumber (On every login, Never, Locked)
Language = (blank)
</pre>

==See also==
* [[Complete Install Packages for Mac OS X | Complete install packages for Mac OS X 10.4/10.5/10.6 Clients]]
* [[Step-by-step Guide for Installing Moodle on Mac OS X 10.4 Client|Step by step installation on a Mac OS X 10.4 Client]]
* [[Cron | Installation of cron for Moodle]]
* [[CVS for Administrators]]

* [http://moodle.org/mod/forum/discuss.php?d=24632 Using Moodle: Dynamic DNS Home Server]

[[Category:Administrator]]
[[Category:Installation]]
[[Category:Mac OS X]]