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.

+

{{Installing Moodle}}

−

+

Note: The CVS servers have now been shut down. Please use our [[Git for Administrators|Git repository]].

−

[[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]

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

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>

# 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. Please read [[Complete_Install_Packages_for_Mac_OS_X#How_To_Update_Your_Moodle4Mac | How To Update Your Moodle4Mac]]. It works fine with the new 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

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.

*[[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