Note: You are currently viewing documentation for Moodle 3.6. Up-to-date documentation for the latest stable version of Moodle is likely available here: Step-by-step Installation Guide for Ubuntu.

Step-by-step Installation Guide for Ubuntu: Difference between revisions

From MoodleDocs
(copied from 2.5 docs)
Line 1: Line 1:
== Step 1: Install Ubuntu 10.04 ==
== Step 1: Install Ubuntu 12.04LTS==


http://www.ubuntu.com/download
<br>Server Edition amd64 Preferred<br>
<br>http://www.ubuntu.com/download<br>


== Step 2: Install LAMP stack ==
== Step 2: Install Apache/MySQL/PHP ==
Open the Terminal and install tasksel
Open up Terminal and install the following;


<pre>sudo apt-get install tasksel</pre>
<pre>sudo apt-get install apache2 mysql mysql-server php5</pre>  


and then the LAMP stack:
''''It will prompt you to set the root password for mysql - take note of it, you will need it in step 6.'''


<pre>sudo tasksel install lamp-server</pre>
== Step 3: Install Additional Software ==


<pre>sudo apt-get install php5-curl php5-gd php5-intl php5-xmlrpc php5-ldap</pre>


This will run a gui install of the lamp stack.
Restart Apache so that the modules are loaded correctly


''''It will prompt you to set the root password for mysql - take note of it, you will need it in step 5.'''
<pre>sudo service apache2 restart</pre>
 
We will be using Git to install/update the Moodle Core Application
 
<pre>sudo apt-get install git-core</pre>
 
== Step 4: Download Moodle ==
 
Setup your local repository and download Moodle, We will use /opt for this installation.
 
<pre>cd /opt
 
sudo git clone git://git.moodle.org/moodle.git
 
cd moodle


== Step 3: Install the additional PHP extensions ==
git branch -a


<pre>sudo apt-get install php5-curl php5-gd php5-intl php5-xmlrpc</pre>
git branch --track MOODLE_25_STABLE origin/MOODLE_25_STABLE


restart apache for the installation to complete
git checkout MOODLE_25_STABLE</pre>


<pre>sudo service apache2 restart</pre>
== Step 5: Copy local repository to /var/www ==


== Step 4: Download Moodle ==
<pre>sudo cp -R /opt/moodle /var/www/</pre>
<pre>sudo mkdir /var/moodledata</pre>
<pre>sudo chown -R www-data /var/moodledata</pre>
<pre>sudo chmod -R 777 /var/moodledata</pre>
<pre>sudo chmod -R 0755 /var/www/moodle</pre>


<pre>cd /var/www
== Step 6: Setup MySQL Server ==


sudo wget http://download.moodle.org/stable25/moodle-latest-25.tgz
First we need to change the default storage engine to innodb


sudo tar -zxf moodle-latest-25.tgz
<pre>sudo vi /etc/mysql/my.cnf</pre>


sudo mkdir /var/moodledata
Scroll down to the [mysqld] section and under Basic Settings add the following line under the last statement


sudo chmod 777 /var/moodledata
<pre>default-storage-engine = innodb</pre>


sudo chmod 777 /var/www/moodle</pre>
<pre>:w</pre>
<pre>:q</pre>


== Step 5: Create Moodle database ==
Restart MySQL Server for changes to take affect
<pre>mysql -u root -p</pre>


You will be prompted for the mysql root password you have created in step 2
<pre>sudo service mysql restart</pre>


<pre>create database moodledb charset=utf8;
Now we need to create the Moodle MySQL User with the correct permissions


create user 'mdluser'@'localhost' identified by 'password';
Use the password you created in step 1
<pre>mysql -u root -p</pre>
mysql><pre>CREATE DATABASE moodle DEFAULT CHARACTER SET utf8 COLLATE utf8_unicode_ci;</pre>


grant all privileges on moodledb.* to 'mdluser'@'localhost';
Where it says "moodledude" and "passwordformoodledude" you should change to the username and password of your choosing.
mysql><pre>GRANT SELECT,INSERT,UPDATE,DELETE,CREATE,CREATE TEMPORARY TABLES,DROP,INDEX,ALTER ON moodle.* TO moodledude@localhost IDENTIFIED BY 'passwordformoodledude';</pre>
mysql><pre>quit;</pre>


\q</pre>


== Step 6: Setup Moodle server ==
== Step 7: Complete Setup ==


Open your browser and go to http://localhost/moodle  
Open your browser and go to http://IP.ADDRESS.OF.SERVER/moodle  


Follow the prompts selecting:
Follow the prompts selecting:


===database type===
===Database Type===


Choose: mysqli
Choose: mysqli


=== database settings ===
=== Database Settings ===


Host server: localhost
Host server: localhost


Database: moodledb
Database: moodle


User: mdluser
User: moodledude


Password: password
Password: passwordformoodledude


Tables Prefix: mdl_
Tables Prefix: mdl_


=== environment checks ===
=== Environment Checks ===


This will indicate if any elements required to run moodle haven't been installed.
This will indicate if any elements required to run moodle haven't been installed.


=== next next next... ===
=== Next next next... ===
follow prompts and confirm installation
follow prompts and confirm installation


===create a site administrator account ===
===Create a Site Administrator Account ===
Create your moodle user account which will have site administrator permissions.
Create your moodle user account which will have site administrator permissions.


Line 87: Line 110:


===Installation Complete ===
===Installation Complete ===
Bravo! You can now start playing with moodle!
Congrats! You can now start using Moodle!
 
== Suggestions: Install APC/Change Document Root==
 
Highly suggest that you install a PHP Accelerator, We will use APC for this install.
 
<pre>sudo apt-get install php-apc</pre>
 
Restart Apache for changes to take affect.
 
<pre>sudo service apache2 restart</pre>
 
That's it for the PHP Accelerator!
 
Don't like http://ip.address.of.server/moodle?
 
Open up Apache Config and change the document root
 
<pre>sudo vi /etc/apache2/sites-available/default</pre>
 
On 2nd or 3rd line where DocumentRoot is;
 
<br>Change From: DocumentRoot /var/www<br>
<br>Change To:  DocumentRoot /var/www/moodle<br>
 
Scroll down a little farther where it says <Directory /var/www/>
 
<br>Change From: <Directory /var/www/><br>
<br>Change To:  <Directory /var/www/moodle/><br>
 
<pre>:w</pre>
<pre>:q</pre>
 
Restart Apache for changes to take affect.
 
<pre>sudo service apache2 restart</pre>
 
Important note!
 
If you have already installed Moodle then you should make the below changes.
 
Edit config.php for Moodle
 
Under $CFG->wwwroot change to http://ip.address.of.server/ instead of http://ip.address.of.server/moodle

Revision as of 11:13, 5 November 2013

Step 1: Install Ubuntu 12.04LTS


Server Edition amd64 Preferred

http://www.ubuntu.com/download

Step 2: Install Apache/MySQL/PHP

Open up Terminal and install the following;

sudo apt-get install apache2 mysql mysql-server php5

'It will prompt you to set the root password for mysql - take note of it, you will need it in step 6.

Step 3: Install Additional Software

sudo apt-get install php5-curl php5-gd php5-intl php5-xmlrpc php5-ldap

Restart Apache so that the modules are loaded correctly

sudo service apache2 restart

We will be using Git to install/update the Moodle Core Application

sudo apt-get install git-core

Step 4: Download Moodle

Setup your local repository and download Moodle, We will use /opt for this installation.

cd /opt

sudo git clone git://git.moodle.org/moodle.git

cd moodle

git branch -a

git branch --track MOODLE_25_STABLE origin/MOODLE_25_STABLE

git checkout MOODLE_25_STABLE

Step 5: Copy local repository to /var/www

sudo cp -R /opt/moodle /var/www/
sudo mkdir /var/moodledata
sudo chown -R www-data /var/moodledata
sudo chmod -R 777 /var/moodledata
sudo chmod -R 0755 /var/www/moodle

Step 6: Setup MySQL Server

First we need to change the default storage engine to innodb

sudo vi /etc/mysql/my.cnf

Scroll down to the [mysqld] section and under Basic Settings add the following line under the last statement

default-storage-engine = innodb
:w
:q

Restart MySQL Server for changes to take affect

sudo service mysql restart

Now we need to create the Moodle MySQL User with the correct permissions

Use the password you created in step 1

mysql -u root -p

mysql>

CREATE DATABASE moodle DEFAULT CHARACTER SET utf8 COLLATE utf8_unicode_ci;

Where it says "moodledude" and "passwordformoodledude" you should change to the username and password of your choosing.

mysql>

GRANT SELECT,INSERT,UPDATE,DELETE,CREATE,CREATE TEMPORARY TABLES,DROP,INDEX,ALTER ON moodle.* TO moodledude@localhost IDENTIFIED BY 'passwordformoodledude';

mysql>

quit;


Step 7: Complete Setup

Open your browser and go to http://IP.ADDRESS.OF.SERVER/moodle

Follow the prompts selecting:

Database Type

Choose: mysqli

Database Settings

Host server: localhost

Database: moodle

User: moodledude

Password: passwordformoodledude

Tables Prefix: mdl_

Environment Checks

This will indicate if any elements required to run moodle haven't been installed.

Next next next...

follow prompts and confirm installation

Create a Site Administrator Account

Create your moodle user account which will have site administrator permissions.

The password you select has to meet certain security requirements.

Installation Complete

Congrats! You can now start using Moodle!

Suggestions: Install APC/Change Document Root

Highly suggest that you install a PHP Accelerator, We will use APC for this install.

sudo apt-get install php-apc

Restart Apache for changes to take affect.

sudo service apache2 restart

That's it for the PHP Accelerator!

Don't like http://ip.address.of.server/moodle?

Open up Apache Config and change the document root

sudo vi /etc/apache2/sites-available/default

On 2nd or 3rd line where DocumentRoot is;


Change From: DocumentRoot /var/www

Change To: DocumentRoot /var/www/moodle

Scroll down a little farther where it says <Directory /var/www/>


Change From: <Directory /var/www/>

Change To: <Directory /var/www/moodle/>

:w
:q

Restart Apache for changes to take affect.

sudo service apache2 restart

Important note!

If you have already installed Moodle then you should make the below changes.

Edit config.php for Moodle

Under $CFG->wwwroot change to http://ip.address.of.server/ instead of http://ip.address.of.server/moodle