Note: You are currently viewing documentation for Moodle 3.8. Up-to-date documentation for the latest stable version of Moodle may be available here: Complete Install Packages for Mac OS X.

Complete Install Packages for Mac OS X: Difference between revisions

From MoodleDocs
Line 23: Line 23:
'''Step 2:'''  Doubleclick the file Moodle4Mac.dmg to mount the installation disk.  
'''Step 2:'''  Doubleclick the file Moodle4Mac.dmg to mount the installation disk.  


:[[Image:Moodle4Mac_1.png|thumb|center|300px]]
:[[Image:Moodle4Mac_1.png|thumb|center|400px]]




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


:[[Image:Moodle4Mac_2.png|thumb|center|300px]]
:[[Image:Moodle4Mac_2.png|thumb|center|400px]]




'''Step 5:''' 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??
'''Step 5:''' 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|thumb|center|300px]]
:[[Image:Moodle4Mac_3.jpg|thumb|center|400px]]





Revision as of 20:34, 17 March 2007

Complete install packages for Mac OS X are available from Moodle Downloads. 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 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 are interested to use the normally web server that comes preinstalled with every Mac Computer you should read this Step-by-Step Guide for Installing Moodle. Please remember that the complete package Moodle4Mac is ready to use and really nothing must be installed.


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: 256 MB or better
 + Hard Disk: 250 MB free
 + System Software: Mac OS X 10.3 or 10.4

Install complete package Moodle4Mac

Download and install Moodle4Mac

Step 1: 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.

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. Doubleclick the icon MAMP to start the server.

Moodle4Mac 2.png


Step 5: Start your browser and type http://127.0.0.1:8888 or http://localhost:8888 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??

Moodle4Mac 3.jpg


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

Only use MAMP for local installations

Because everybody can read the predefined passwords of Moodle and MAMP you should know that the installation is not good for public servers. It's not secure!! To get Moodle4Mac for an internet connected server you must change the admin passwords (Moodle and MySQL) and open the firewall on port 8888. Please read this: How to secure MAMP?

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 on the MAMP server.
 

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.

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.

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.

File: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!!

#! /bin/sh
#
#  This CVS update for Mac OS X is part 
#  of the installation package Moodle4Mac
# 
#  20061212 - Ralf Krause
#

export CVS_RSH=ssh

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

cd /Applications/MAMP/htdocs/moodle17/

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

if ! grep "moodle.cvs.sourceforge.net" ~/.cvspass > /dev/null
then
    ### login to the cvs server only for the first time
    echo "CVS password is empty ... please only press  to start"
    cvs -d :pserver:anonymous@moodle.cvs.sourceforge.net:/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 -C"
echo
cvs -q update -dP -r MOODLE_17_STABLE

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.7.

  • Moodle 1.6 uses MOODLE_16_STABLE
  • Moodle 1.7 uses MOODLE_17_STABLE
  • Moodle 1.8 beta uses MOODLE_18_STABLE
  • Moodle 1.9 dev 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.

File: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.

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