Windows installation using XAMPP - Revision history

Leonstr: Minor corrections

2018-02-26T17:31:52Z

Minor corrections

← Older revision		Revision as of 17:31, 26 February 2018
Line 18:		Line 18:
	*Type localhost in your browser, or 127.0.0.1:181 (if you changed the port number)		*Type localhost in your browser, or 127.0.0.1:181 (if you changed the port number)
	*You should get to localhost/xampp splash page, your localhost webserver is running.		*You should get to localhost/xampp splash page, your localhost webserver is running.
	*Unpack the latest version of Moodle into the c:\xampp\~~htdoc~~ folder.		*Unpack the latest version of Moodle into the c:\xampp\htdocs folder.
	**Alternative rename the moodle folder if you plan on having different versions of Moodle		**Alternative rename the moodle folder if you plan on having different versions of Moodle
	**For example rename it something like C:\xampp\htdocs\moodle31		**For example rename it something like C:\xampp\htdocs\moodle31
	*In your web browser type in 127.0.0.1\moodle or 127.0.0.1:181\moodle31		*In your web browser type in 127.0.0.1/moodle or 127.0.0.1:181/moodle31
	*You will need to know port number and the usual Moodle Installation initial questions.		*You will need to know port number and the usual Moodle Installation initial questions.
	**Xampp uses the Mariadb database (based upon MySql), if the install says your MySQL database is too old go to the c:\xampp\htdocs\moodlel\config.php file and change the database line to $CFG->dbtype = 'mariadb';		**Xampp uses the Mariadb database (based upon MySql), if the install says your MySQL database is too old go to the c:\xampp\htdocs\moodlel\config.php file and change the database line to $CFG->dbtype = 'mariadb';

Germanvaleroelizondo: Added Be aware that XAMPP is designed for developers and so deliberately has just about all security features turned off.

2016-09-12T15:03:32Z

Added Be aware that XAMPP is designed for developers and so deliberately has just about all security features turned off.

← Older revision		Revision as of 15:03, 12 September 2016
Line 1:		Line 1:
	XAMPP is a fully functional web server package. It is built to test web based programs on a personal computer. It is not meant for online access via the web on a production server. This page describes how to install the XAMPP webserver package of programs and how to install a Moodle standard package on the server which was created.		XAMPP is a fully functional web server package. It is built to test web based programs on a personal computer. It is not meant for online access via the web on a production server. This page describes how to install the XAMPP webserver package of programs and how to install a Moodle standard package on the server which was created.

	:''TIP:'' These guidelines are intended for a Standard Moodle installation on a Windows PC for a private or test Moodle installation, not a production (public) site or service. '''XAMPP-lite''' is used to create a [[Complete install packages for Windows]] which has a different installation process.		:''TIP:'' These guidelines are intended for a Standard Moodle installation on a Windows PC for a private or test Moodle installation, not a production (public) site or service. Be aware that XAMPP is designed for developers and so deliberately has just about all security features turned off. '''XAMPP-lite''' is used to create a [[Complete install packages for Windows]] which has a different installation process.

	==Overview==		==Overview==

Rcollman: /* MySQL database settings */

2016-01-09T19:33:14Z

MySQL database settings

← Older revision		Revision as of 19:33, 9 January 2016
Line 146:		Line 146:

	*In this example the database created is “moodle153”. If you created a password for root place it here. If you want the MySQL user admin to log into the moodle MySQL database, place that user and the password here.		*In this example the database created is “moodle153”. If you created a password for root place it here. If you want the MySQL user admin to log into the moodle MySQL database, place that user and the password here.
	*As a best practice, change the "mdl_" prefix to something else, perhaps "mdl_30_". ~~This will allow you to install multiple version of Moodle, each with there own table.~~		*As a best practice, change the "mdl_" prefix to something else, perhaps "mdl_30_".

	*In later versions of Moodle you maybe asked for the database port number. Refer to the XAMPP-Control.exe program main screen for that information. The default maybe 3306.		*In later versions of Moodle you maybe asked for the database port number. Refer to the XAMPP-Control.exe program main screen for that information. The default maybe 3306.

	:''TIP:'' You may want a separate database for each version of Moodle. UsephpMyAdmin to create the database (remember should be UTF-8)with a name something like moodle30. Then on this screen put the new database name ~~there~~.		:''TIP:'' You may want a separate database for each version of Moodle. UsephpMyAdmin to create the database (remember should be UTF-8)with a name something like moodle30. Then on this screen put the new database name.

	:''TIP:'' DO NOT USE THE “ROOT” USER WITHOUT A PASSWORD FOR PRODUCTION INSTALLATIONS AS THIS CREATES A SECURITY VULNERABILITY.		:''TIP:'' DO NOT USE THE “ROOT” USER WITHOUT A PASSWORD FOR PRODUCTION INSTALLATIONS AS THIS CREATES A SECURITY VULNERABILITY.
	[[image:Xampp28.gif\|thumb\|center\|MySQL database settings screen]]		[[image:Xampp28.gif\|thumb\|center\|MySQL database settings screen]]

Rcollman: /* Diagnostic report */ simplify with words, delete image

2016-01-09T19:29:41Z

Diagnostic report: simplify with words, delete image

← Older revision		Revision as of 19:29, 9 January 2016
Line 131:		Line 131:

	===Diagnostic report===		===Diagnostic report===
	A diagnostic report is displayed – hopefully ~~it will look like this, if~~ not you may need to address some issues. ~~See trouble shooting below~~. Generally speaking a ~~comment with~~ a "check" will allow you to continue.		A diagnostic report is displayed – hopefully every line has an "OK" in the status column. If not you may need to address some issues. Clicking on the report link will give you some hints to cure the problem. Generally speaking a line that has a "check" in the status column will allow you to continue.

	~~[[image:Xampp25.gif\|thumb\|center\|Initial diagnostic, it passed, no warnings]]~~

	*Click the “Next” button to continue.		*Click the “Next” button to continue.

Rcollman: /* Diagnostic report */

2016-01-09T19:21:15Z

Diagnostic report

← Older revision		Revision as of 19:21, 9 January 2016
Line 131:		Line 131:

	===Diagnostic report===		===Diagnostic report===
	A diagnostic report is displayed – hopefully it will look like this, if not you may need to address some issues.		A diagnostic report is displayed – hopefully it will look like this, if not you may need to address some issues. See trouble shooting below. Generally speaking a comment with a "check" will allow you to continue.

	[[image:Xampp25.gif\|thumb\|center\|Initial diagnostic, it passed, no warnings]]		[[image:Xampp25.gif\|thumb\|center\|Initial diagnostic, it passed, no warnings]]

Rcollman: /* Moodledata folder */ minor edits

2016-01-09T19:19:02Z

Moodledata folder: minor edits

← Older revision		Revision as of 19:19, 9 January 2016
Line 107:		Line 107:

	===Moodledata folder===		===Moodledata folder===
	It is a good practice to manually create the moodledata folder. In an standard default install, Moodle will look for it in the top most level of folders on your server, the same level as htdocs, apache, php ~~and those~~ folders. If you anticipate adding different versions of moodle on your XAMPP server, give the moodledata folder a unique name.		It is a good practice to manually create the moodledata folder. In an standard default install, Moodle will look for it in the top most level of folders on your server, the same level as htdocs, apache, and php folders. If you anticipate adding different versions of moodle on your XAMPP server, give the moodledata folder a unique name.
	*For example: "C:\~~X_server~~\moodledata301" or "C:\~~apachefriends\151~~\~~moodledata151~~".		*For example: "C:\xampp\moodledata301" or "C:\xampp\moodledata350".

	*You may have to change the permissions of the folder in some operating systems. To do this right click on the moodledata folder, select properties and the "Security" tab.		*You may have to change the permissions of the folder in some operating systems. To do this right click on the moodledata folder, select properties and the "Security" tab.

Rcollman: /* Extract standard Moodle package files */

2016-01-09T19:03:52Z

Extract standard Moodle package files

← Older revision		Revision as of 19:03, 9 January 2016
Line 104:		Line 104:
	Locate the zip file of the standard install package you downloaded from Moodle.org. The easiest method is to extract everything in the file to the htdocs folder that XAMPP just created. Most Windows operating systems come with an program that will recognize a zip file and ask you where you want to extract the files.		Locate the zip file of the standard install package you downloaded from Moodle.org. The easiest method is to extract everything in the file to the htdocs folder that XAMPP just created. Most Windows operating systems come with an program that will recognize a zip file and ask you where you want to extract the files.

	*Extract the Moodle files to htdocs. A default folder named “moodle” is created with all the Moodle folders and files within it.		*Extract the Moodle files to htdocs. A default folder named “moodle” is created with all the Moodle folders and files within it. If you anticipate wanting to have different versions of Moodle on this web server, change the name of the3 folder from moodle to say "moodle31' and then the next one to say "moodle35", etc.

	~~[[image:Xampp19.gif\|thumb\|center\|Example~~ of Moodle folder ~~inthe server~~'~~s htdocs]]~~

	===Moodledata folder===		===Moodledata folder===

Rcollman: /* Option create the database */ delete pictures, edit words for Xampp

2016-01-09T18:52:42Z

Option create the database: delete pictures, edit words for Xampp

← Older revision		Revision as of 18:52, 9 January 2016
Line 78:		Line 78:
	'''If Apache fails to run i.e. the "Running" text with the green background keeps disappearing) and you are using Skype or another program that uses port 80 e.g. IIS - please review "Troubleshooting" at the end of these instructions.'''		'''If Apache fails to run i.e. the "Running" text with the green background keeps disappearing) and you are using Skype or another program that uses port 80 e.g. IIS - please review "Troubleshooting" at the end of these instructions.'''

	==~~Create~~ the ~~MySQL~~ database==		==Option create the database==
			In some older versions of Moodle, it was necessary to created the database before Moodle could install the tables as part of the install process. In Moodle 3.x this is not necessary. However, you can create the database before starting the Moodle install and then put that database name when Moodle asks for it. While these instructions refer to MySQL, they also work for MariaDB which is part of XAMPP.

	To create a MySQL database for your Moodle “site” we will use the phpMyAdmin utility included with XAMPP.		To create a MySQL database for your Moodle “site” we will use the phpMyAdmin utility included with XAMPP.
	~~[[image:Xampp8.gif\|right\|Browser address bar]]~~
	*To access this launch the web browser of your choice (Firefox is used in this example), type local host or http://localhost/xampp/ in the address bar.

	*~~The XAMPP default page will be displayed which means~~ your ~~webserver is working~~. ~~Click~~ the ~~link for your preferred language – we will be using English~~.		*To access phpmyadmin launch the web browser of your choice, type localhost/phpmyadmin or 127.0.0.1/xampp/ in the address bar.
			*If you have set a password you will be prompted for it.
	*~~From the menu on the left, click on “phpMyAdmin”~~

	~~[[image:Xampp10~~.~~gif\|center\|Click on phpMyAdmin]]~~

	*When phpMy Admin has launched in your browser window, enter the name of your database in the “Create new database” field. Usually this is simply moodle, but you might say moodle310.		*When phpMy Admin has launched in your browser window, enter the name of your database in the “Create new database” field. Usually this is simply moodle, but you might say moodle310.

	~~[[Image:PhpMyAdmin3131 create database.png\|thumb\|center\|Center of initial phpMyAdmin screen]]~~

	* From the "Collation" drop down list select "utf8_unicode_ci"		* From the "Collation" drop down list select "utf8_unicode_ci"
Line 97:		Line 92:
	*Click the “Create” button to create the database.		*Click the “Create” button to create the database.

	You should see the database on the left with your moodle MySQL database name without files in it and/or a notice that it was created.		You should see the database on the left with your "moodle MySQL database name without files in it and/or a notice that it was created.


	===MySQL security===		===MySQL security===
	Security on a localhost may not be a big concern. ~~On the~~ XAMPP ~~page there is~~ a ~~security link on~~ the ~~left~~. ~~It will help you create a MySQL user and security password~~. ~~Usually this user is called root~~.		Security on a localhost may not be a big concern. The recent versions of XAMPP do not set a password for root, the superuser. Go to the file C:\xampp\phpmyadmin\config.inc.php, edit the line $cfg['Servers'][$i]['password'] = ''; For example to:
			$cfg['Servers'][$i]['password'] = 'password2016';

	==Prepare server for Moodle==		==Prepare server for Moodle==

Rcollman: /* Overview */ add sections for a straight XAMPP and a XAMPP install using Bitnami

2016-01-09T13:35:55Z

Overview: add sections for a straight XAMPP and a XAMPP install using Bitnami

← Older revision		Revision as of 13:35, 9 January 2016
Line 8:		Line 8:
	This is a guide for installing XAMPP and Moodle on a computer. The instructions are in the process of being updated. You may find the older instructions in previous versions of MoodleDocs.		This is a guide for installing XAMPP and Moodle on a computer. The instructions are in the process of being updated. You may find the older instructions in previous versions of MoodleDocs.

	~~An overview~~ of the ~~steps as~~ of ~~2015~~:		===XAMPP===
			*Download the latest version of XAMPP from Apachefriends.org
			*Install XAMPP - It will ask if you want to install it at C:\xampp
			**Alternatively, install in C:\xampp123 if you plan on installing more than one webserver
			*Use control.exe in the XAMPP folder to start and stop Apache and MySQL
			*Note the MySQL port.
			*If Apache will not start because of a port conflict
			**then use config button to change the http listening port to something like 127.0.0.1:181
			*Type localhost in your browser, or 127.0.0.1:181 (if you changed the port number)
			*You should get to localhost/xampp splash page, your localhost webserver is running.
			*Unpack the latest version of Moodle into the c:\xampp\htdoc folder.
			**Alternative rename the moodle folder if you plan on having different versions of Moodle
			**For example rename it something like C:\xampp\htdocs\moodle31
			*In your web browser type in 127.0.0.1\moodle or 127.0.0.1:181\moodle31
			*You will need to know port number and the usual Moodle Installation initial questions.
			**Xampp uses the Mariadb database (based upon MySql), if the install says your MySQL database is too old go to the c:\xampp\htdocs\moodlel\config.php file and change the database line to $CFG->dbtype = 'mariadb';
			**If you have not changed the database password, The dbuser = 'root' and dbpass ='';
			*The Moodle install process takes a long time. Be patient, even when things don't look like anything is happening.

			===XAMPP using Bitnami to install Moodle===
	*Download the latest version of XAMPP from Apachefriends.org		*Download the latest version of XAMPP from Apachefriends.org
	*Install XAMPP		*Install XAMPP
Line 20:		Line 38:
	*Click on the Moodle icon to allow Bitnami to install the latest version of Moodle.		*Click on the Moodle icon to allow Bitnami to install the latest version of Moodle.
	*You will need to know port number and the usual Moodle Installation initial questions.		*You will need to know port number and the usual Moodle Installation initial questions.
	*The process takes a long time. Be patient, even when things don't look like anything is happening.		*The Moodle install process takes a long time. Be patient, even when things don't look like anything is happening.
	*You should find your moodle files in /xampp/apps/moodle/htdocs. Enjoy.

	What follows are old XP instructions which will not help much.		What follows are old XP instructions which will not help much.

Rcollman: /* Now you can Moodle */

2015-11-23T19:23:12Z

Now you can Moodle

← Older revision		Revision as of 19:23, 23 November 2015
Line 169:		Line 169:
	===Now you can Moodle===		===Now you can Moodle===
	You will be asked to create the admin user for your Moodle site. Then as the admin Moodle user, you will be taken to the Front Page settings to start to build your new site.		You will be asked to create the admin user for your Moodle site. Then as the admin Moodle user, you will be taken to the Front Page settings to start to build your new site.
	Good job		Good job !

	==Troubleshooting==		==Troubleshooting==