CVS for Administrators

Embed Size (px)

Citation preview

  • 8/8/2019 CVS for Administrators

    1/5

    CVS for Administrators

    From MoodleDocs

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

    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.

    Contents

    1 CVS Servers

    1.1 Switching to a new server

    1.1.1 Switching to a new server on Unix

    1.1.2 Switching to a new server with TortoiseCVS

    2 Instructions

    2.1 From a Unix computer

    2.2 Changing the directory name

    2.3 Change directory owner

    2.4 From a Windows computer2.5 From a Mac OS X computer

    2.6 Troubleshooting

    3 See also

    CVS Servers

    Please choose the closest CVS mirror server to you from this list:

    Country Server Provided by

    EU eu.cvs.moodle.org

    The Open University In case of trouble, contact

    Rod Norfor or Derek Woolhead

    S for Administrators - MoodleDocs http://docs.moodle.org/en/CVS_for_Administrators

    5 24-10-2008 15:50

  • 8/8/2019 CVS for Administrators

    2/5

    ES es.cvs.moodle.org

    Mondragon Unibertsitatea In case of trouble,

    contact [email protected]

    or [email protected]

    UK uk.cvs.moodle.org

    Cumbria and Lancashire Education Online (CLEO

    ) in collaboration with Lancaster University

    Network Services (LUNS )

    US us.cvs.moodle.org

    San Francisco State University, Academic Technology (SFSU

    ). In case of trouble, contact iLearn support

    US us2.cvs.moodle.org

    The Contractors Institute pserver

    and viewvc. In case of trouble contact 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 Moodle

    Outage mailing list .

    (If you would like to contribute to the project by running a mirror, please see How to set up a CVS mirror)

    Switching to a new 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\.m

    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

    S for Administrators - MoodleDocs http://docs.moodle.org/en/CVS_for_Administrators

    5 24-10-2008 15:50

  • 8/8/2019 CVS for Administrators

    3/5

    .

    setting.

    Instructions

    From a Unix computer

    To connect and login for the first time to the CVS server, you can use this command (remember to replaceSERVER.cvs.moodle.org in the instructions below with the mirror server you chose above):

    cvs -d:pserver:[email protected]:/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:[email protected]:/cvsroot/moodle co -P -r MOODLE_19_WEEKLY moodle

    Or the latest development version (not for production use):

    cvs -z3 -d:pserver:[email protected]:/cvsroot/moodle co -P moodle

    Or the modules in Contrib

    cvs -z3 -d:pserver:[email protected]:/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 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.

    S for Administrators - MoodleDocs http://docs.moodle.org/en/CVS_for_Administrators

    5 24-10-2008 15:50

  • 8/8/2019 CVS for Administrators

    4/5

    Tortoise CVS Screen capture

    Tortoise CVS (real name)Screen ca ture

    Changing the directory name

    By default, the CVS checkout creates a diectory 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 follwing. This would download the MOODLE_19_STABLE branch into a

    directory called "mydirectory" (-d mydirectory).

    cvs -z3 -d:pserver:[email protected]:/cvsroot/moodle co -d mydirectory -r MOODLE_19_STABLE

    Or the latest development version to a directory called 'moodle-dev':

    cvs -z3 -d:pserver:[email protected]:/cvsroot/moodle co -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 (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):

    Get TortoiseCVS from tortoisecvs.org

    and install it, then reboot.

    1.

    Find or create a new folder somewhere where you want Moodle to be

    downloaded to.

    2.

    Right-mouse-click that folder and choose "CVS Checkout" from the

    menu. You should see a dialog box.

    3.

    Copy this text into the CVSROOT field::pserver:[email protected]:/cvsroot

    /moodle

    NOTE - replace "SERVER" with "eu", "es", "uk" or "us"

    depending on your location.

    4.

    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-

    " "

    5.

    S for Administrators - MoodleDocs http://docs.moodle.org/en/CVS_for_Administrators

    5 24-10-2008 15:50

  • 8/8/2019 CVS for Administrators

    5/5

    checked.

    Press the button: "OK" and everything should be downloaded.6.

    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 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:[email protected]:/cvsroot/moodle loginLogging in to :pserver:[email protected]:2401/cvsroot/moodle

    CVS password:

    cvs [login aborted]: connect to us.cvs.moodle.org(130.212.64.111):2401 failed: Connection timed out

    See also

    Development:Setting up Eclipse for step by step instructions for setting up the Eclipse IDE

    for Moodle development, which including how to do the necessary CVS

    operations

    Development:Tracking Moodle CVS with git

    Using Moodle forum discussions:

    Using cvs

    CVS Updating of 3rd-Party Plug-ins in the Moodle folder itself

    simple question for cvs

    Retrieved from "http://docs.moodle.org/en/CVS_for_Administrators"

    Category: Administrator

    S for Administrators - MoodleDocs http://docs.moodle.org/en/CVS_for_Administrators