Installation FAQ - Revision history

Tim@horizoneducationnetwork.org: clean up, typos fixed: apache → Apache

2021-09-21T18:34:41Z

clean up, typos fixed: apache → Apache

← Older revision		Revision as of 18:34, 21 September 2021
Line 151:		Line 151:
	* You are using the correct username and password, yes?		* You are using the correct username and password, yes?

	If you are still having problems, read the [[~~Can_not_log_in~~ \| Cannot log in]] page. You '''could''' also try changing the admin password. Proceed as if you have lost it - see [[Administration FAQ]].		If you are still having problems, read the [[Can not log in\|Cannot log in]] page. You '''could''' also try changing the admin password. Proceed as if you have lost it - see [[Administration FAQ]].

	[[#top\|Top]]		[[#top\|Top]]
Line 176:		Line 176:
	</code>		</code>

	Another reason might be that PHP has not been configured to support MySQL (or whatever other database you are using). This is common on RedHat and OpenBSD installations. In this case, an error is generated, but since error displays are often disabled by default, all that is seen on the browser is a blank screen. To enable PHP error displays see [[~~Installation_FAQ~~#~~How_to_enable_and_check_PHP_error_logs~~ \| How to enable and check PHP error logs]].		Another reason might be that PHP has not been configured to support MySQL (or whatever other database you are using). This is common on RedHat and OpenBSD installations. In this case, an error is generated, but since error displays are often disabled by default, all that is seen on the browser is a blank screen. To enable PHP error displays see [[Installation FAQ#How to enable and check PHP error logs\|How to enable and check PHP error logs]].

	To determine if database support is your problem, insert this as the second line in your ''config.php'' file		To determine if database support is your problem, insert this as the second line in your ''config.php'' file
Line 191:		Line 191:

	*'''Check your web server log files!!'''		*'''Check your web server log files!!'''
	:If a particular page is blank or incomplete (it doesn't display the footer), before you do anything else switch on [[Debugging]] and [[~~Installation_FAQ~~#~~How_to_enable_and_check_PHP_error_logs~~ \| check your PHP error logs]]. Having established that PHP error logging is working, reproduce the error. Immediately check the error log file right at the end. Hopefully you will see a PHP error message at or very near the end of the file. This may solve your problem directly or makes it a lot easier to diagnose the problem in the Moodle forums.		:If a particular page is blank or incomplete (it doesn't display the footer), before you do anything else switch on [[Debugging]] and [[Installation FAQ#How to enable and check PHP error logs\|check your PHP error logs]]. Having established that PHP error logging is working, reproduce the error. Immediately check the error log file right at the end. Hopefully you will see a PHP error message at or very near the end of the file. This may solve your problem directly or makes it a lot easier to diagnose the problem in the Moodle forums.

	*If you are '''upgrading to a new version of Moodle''', check that you do not have an old version of a non-standard block or module installed. Remove any such blocks or modules installed using the admin settings page and start the install process again. However, do also make sure that you have included all optional plugins that were required by your courses. This is particularly common with "editing on".		*If you are '''upgrading to a new version of Moodle''', check that you do not have an old version of a non-standard block or module installed. Remove any such blocks or modules installed using the admin settings page and start the install process again. However, do also make sure that you have included all optional plugins that were required by your courses. This is particularly common with "editing on".
Line 197:		Line 197:
	*If you '''do not see any blocks listed''', turn editing on and remove any blocks that you have added to that page and try reloading.		*If you '''do not see any blocks listed''', turn editing on and remove any blocks that you have added to that page and try reloading.

	*You may get this error immediately after '''selecting a language'''. At this stage of the installation process your Moodle computer may need to connect to the Internet and download a language pack, so check that the computer can access the Internet by using a browser. Check also that your PHP settings are as given in the Moodle [[~~Installing_Moodle~~#Requirements \| Moodle Requirements]] page.		*You may get this error immediately after '''selecting a language'''. At this stage of the installation process your Moodle computer may need to connect to the Internet and download a language pack, so check that the computer can access the Internet by using a browser. Check also that your PHP settings are as given in the Moodle [[Installing Moodle#Requirements\|Moodle Requirements]] page.

	'''See also''':		'''See also''':
Line 264:		Line 264:

	==Migrating Moodle to a new site or server==		==Migrating Moodle to a new site or server==
	Migrating Moodle means that you have to move the current installation to a new server, and so may have to change IP addresses or DNS entries. To do this you will need to change the $CFG->wwwroot value in the config.php on the new server. You will also have to change any absolute links stored in the database backup file (before restoring the file on the new server) either using the [[Search and replace tool]], your text editor or another "search and replace" tool, e.g. sed. For more details see the [[~~Moodle_migration~~ \| Moodle Migration]] page.		Migrating Moodle means that you have to move the current installation to a new server, and so may have to change IP addresses or DNS entries. To do this you will need to change the $CFG->wwwroot value in the config.php on the new server. You will also have to change any absolute links stored in the database backup file (before restoring the file on the new server) either using the [[Search and replace tool]], your text editor or another "search and replace" tool, e.g. sed. For more details see the [[Moodle migration\|Moodle Migration]] page.

	[[#top\|Top]]		[[#top\|Top]]
Line 276:		Line 276:
	[[#top\|Top]]		[[#top\|Top]]
	==Maximum upload file size - how to change it?==		==Maximum upload file size - how to change it?==
	There are several places to change the maximum file upload size. The first place to check is in Site administration > Security > Site security settings and look for "Maximum uploaded file size". This is the "maxbyte" variable found in older versions of Moodle (under Admin > Variables). Teachers may also set the maximum file size by the [[~~Course_settings~~#~~Maximum_upload_size~~\|course administration block]].		There are several places to change the maximum file upload size. The first place to check is in Site administration > Security > Site security settings and look for "Maximum uploaded file size". This is the "maxbyte" variable found in older versions of Moodle (under Admin > Variables). Teachers may also set the maximum file size by the [[Course settings#Maximum upload size\|course administration block]].

	If the above does not provide a large enough figure you will need to make changes in your server settings. The usual place is in your php.ini file (go to Site administration > Server > PHPinfo and check a few lines down for its location). Look for settings '''upload_max_filesize''' and '''post_max_size''', setting them both to your desired new value (e.g. '64MB'). You will need to restart the web server for these changes to take effect - e.g. on Linux, '''/etc/init.d/apache2 force-reload'''. Check your documentation or just reboot the server. [http://nginx.org/en/docs/http/ngx_http_core_module.html#client_max_body_size NGINX] system administrators should also add client_max_body_size=XXX to the "http" section of their nginx main configuration file. ([https://rtcamp.com/tutorials/php/increase-file-upload-size-limit/#change-in-nginx-config see more info])		If the above does not provide a large enough figure you will need to make changes in your server settings. The usual place is in your php.ini file (go to Site administration > Server > PHPinfo and check a few lines down for its location). Look for settings '''upload_max_filesize''' and '''post_max_size''', setting them both to your desired new value (e.g. '64MB'). You will need to restart the web server for these changes to take effect - e.g. on Linux, '''/etc/init.d/apache2 force-reload'''. Check your documentation or just reboot the server. [http://nginx.org/en/docs/http/ngx_http_core_module.html#client_max_body_size NGINX] system administrators should also add client_max_body_size=XXX to the "http" section of their nginx main configuration file. ([https://rtcamp.com/tutorials/php/increase-file-upload-size-limit/#change-in-nginx-config see more info])

	For more help see:		For more help see:
	*[[~~Administration_FAQ~~#~~How_do_the_limits_on_uploaded_files_work~~.3F]]		*[[Administration FAQ#How do the limits on uploaded files work.3F]]
	*[[~~Installing_Moodle~~#~~Recheck_PHP_settings~~]]		*[[Installing Moodle#Recheck PHP settings]]
	*[[~~Installing_Moodle~~#~~Using_a_~~.~~htaccess_file_for_webserver_and_PHP_settings~~]]		*[[Installing Moodle#Using a .htaccess file for webserver and PHP settings]]
	*[[~~Site_policies~~#~~Maximum_uploaded_file_size~~]]		*[[Site policies#Maximum uploaded file size]]
	*These forum posts: http://moodle.org/mod/forum/discuss.php?d=63840#287960 and http://moodle.org/mod/forum/discuss.php?d=93882#p414650		*These forum posts: http://moodle.org/mod/forum/discuss.php?d=63840#287960 and http://moodle.org/mod/forum/discuss.php?d=93882#p414650

Line 303:		Line 303:
	== How do I run multiple instances of Moodle without duplicating base code? ==		== How do I run multiple instances of Moodle without duplicating base code? ==

	See [http://moodle.org/mod/forum/discuss.php?d=13211 this thread] for a detailed explanation by [[User:~~Martin_Langhoff~~\| Martin Langhoff]].		See [http://moodle.org/mod/forum/discuss.php?d=13211 this thread] for a detailed explanation by [[User:Martin Langhoff\|Martin Langhoff]].

	== How do I install a plugin? ==		== How do I install a plugin? ==
Line 318:		Line 318:

	Installing Moodle in a shared web hosting environment:		Installing Moodle in a shared web hosting environment:
	* [[~~Finding_and_Selecting_A_Web_Host~~\|Finding and Selecting a web host]]		* [[Finding and Selecting A Web Host\|Finding and Selecting a web host]]

	[[Category:FAQ]]		[[Category:FAQ]]

Mudrd8mz: Text replacement - "class="nicetable"" to "class="wikitable""

2021-07-14T13:24:55Z

Text replacement - "class="nicetable"" to "class="wikitable""

← Older revision		Revision as of 13:24, 14 July 2021
Line 63:		Line 63:

	Dynamic Extensions ('''Windows Only''')		Dynamic Extensions ('''Windows Only''')
	{\| class="~~nicetable~~"		{\| class="wikitable"
	\|-		\|-
	! PHP 5.3.x		! PHP 5.3.x

Leonstr: Support for FreeTDS removed in PHP 7.0 (php-mssql extension)

2020-05-12T10:20:43Z

Support for FreeTDS removed in PHP 7.0 (php-mssql extension)

← Older revision		Revision as of 10:20, 12 May 2020
Line 304:		Line 304:

	See [http://moodle.org/mod/forum/discuss.php?d=13211 this thread] for a detailed explanation by [[User:Martin_Langhoff\| Martin Langhoff]].		See [http://moodle.org/mod/forum/discuss.php?d=13211 this thread] for a detailed explanation by [[User:Martin_Langhoff\| Martin Langhoff]].

	~~== What is FreeTDS and how can I use it in my installation? ==~~
	[[Installing MSSQL for PHP\|FreeTDS]] is an open source implementation of the Tabular Data Stream protocol used by Microsoft SQL Server and Sybase for their databases. Unfortunately, Microsoft servers don't usually accept TDS 5.0 connections. FreeTDS allows your Unix/Linux applications to talk to these other database products and import and export data between different systems successfully.

	== How do I install a plugin? ==		== How do I install a plugin? ==

Tobias.reischmann: /* I am being told that I need the intl php plugin to continue to install Moodle 2.x */

2019-04-04T08:40:44Z

I am being told that I need the intl php plugin to continue to install Moodle 2.x

← Older revision		Revision as of 08:40, 4 April 2019
Line 29:		Line 29:

	==I am being told that I need the '''intl php plugin''' to continue to install Moodle 2.x==		==I am being told that I need the '''intl php plugin''' to continue to install Moodle 2.x==
	The intl.dll from Zend is part of the PHP 5.2.8 release and later. It is aimed at improving the internationalization of php pages and Moodle 2.x uses it as part of this process. If your install is on a local machine or network, then you can download the latest version of PHP and update your PHP. You then have to uncomment all the required dynamic extensions you need, including the php_intl.dll extension. The problem is then solved. If the install is on a host server, then you need to contact your host and ask them to do the same, As an alternative, you can unzip/untar the download file, copy and paste the intl.dll file to your php/ext folder and include the line:		The intl.dll from Zend is part of the PHP 5.2.8 release and later. It is aimed at improving the internationalization of php pages and Moodle 2.x uses it as part of this process. If your install is on a local machine or network, then you can download the latest version of PHP and update your PHP. You then have to uncomment all the required dynamic extensions you need, including the php_intl.dll extension. The problem is then solved. If the install is on a host server, then you need to contact your host and ask them to do the same. As an alternative, you can unzip/untar the download file, copy and paste the intl.dll file to your php/ext folder and include the line:
	extension=php_intl.dll		extension=php_intl.dll
	in the Dynamic Extensions section of your php.ini file.		in the Dynamic Extensions section of your php.ini file.

Giuliettahara: /* I can't enable a plugin on the Plugins overview page because the icon is not clickable */

2018-12-20T11:46:17Z

I can't enable a plugin on the Plugins overview page because the icon is not clickable

← Older revision		Revision as of 11:46, 20 December 2018
Line 313:		Line 313:

	==I can't enable a plugin on the Plugins overview page because the icon is not clickable==		==I can't enable a plugin on the Plugins overview page because the icon is not clickable==
	The open and closed eye icon on the Plugins overview page is simply there to show whether or not a plugin is enabled. You can't edit plugins from this screen. If you wish to enable a plugin, to to the appropriate page for managing the type of plugin you need, for instance ''Settings>Site administration>Plugins>Repositories>Manage repositories'' or ''Settings>Site administration>Plugins>Activity modules>Manage activities.''		The open and closed eye icon on the Plugins overview page is simply there to show whether or not a plugin is enabled. You can't edit plugins from this screen. If you wish to enable a plugin, go to the appropriate page for managing the type of plugin you need, for instance ''Settings>Site administration>Plugins>Repositories>Manage repositories'' or ''Settings>Site administration>Plugins>Activity modules>Manage activities.''

	== See also ==		== See also ==

Giuliettahara: /* Maximum upload file size - how to change it? */

2018-12-20T10:41:19Z

Maximum upload file size - how to change it?

← Older revision		Revision as of 10:41, 20 December 2018
Line 276:		Line 276:
	[[#top\|Top]]		[[#top\|Top]]
	==Maximum upload file size - how to change it?==		==Maximum upload file size - how to change it?==
	There are several places to change the maximum file upload size. The first place to check is ~~the Administration block.~~ Security -> Site ~~Policies ->~~ and look for "Maximum ~~Uploaded File Size~~". This is the "maxbyte" variable found in older versions of Moodle (under Admin > Variables). Teachers may also set the maximum file size by the [[Course_settings#Maximum_upload_size\|course administration block]].		There are several places to change the maximum file upload size. The first place to check is in Site administration > Security > Site security settings and look for "Maximum uploaded file size". This is the "maxbyte" variable found in older versions of Moodle (under Admin > Variables). Teachers may also set the maximum file size by the [[Course_settings#Maximum_upload_size\|course administration block]].

	If the above does not provide a large enough figure you will need to make changes in your server settings. The usual place is in your php.ini file (go to Site administration > Server > PHPinfo and check a few lines down for its location). Look for settings '''upload_max_filesize''' and '''post_max_size''', setting them both to your desired new value (e.g. '64MB'). You will need to restart the web server for these changes to take effect - e.g. on Linux, '''/etc/init.d/apache2 force-reload'''. Check your documentation or just reboot the server. [http://nginx.org/en/docs/http/ngx_http_core_module.html#client_max_body_size NGINX] system administrators should also add client_max_body_size=XXX to the "http" section of their nginx main configuration file. ([https://rtcamp.com/tutorials/php/increase-file-upload-size-limit/#change-in-nginx-config see more info])		If the above does not provide a large enough figure you will need to make changes in your server settings. The usual place is in your php.ini file (go to Site administration > Server > PHPinfo and check a few lines down for its location). Look for settings '''upload_max_filesize''' and '''post_max_size''', setting them both to your desired new value (e.g. '64MB'). You will need to restart the web server for these changes to take effect - e.g. on Linux, '''/etc/init.d/apache2 force-reload'''. Check your documentation or just reboot the server. [http://nginx.org/en/docs/http/ngx_http_core_module.html#client_max_body_size NGINX] system administrators should also add client_max_body_size=XXX to the "http" section of their nginx main configuration file. ([https://rtcamp.com/tutorials/php/increase-file-upload-size-limit/#change-in-nginx-config see more info])

Giuliettahara: /* Email copies are not being sent from my forums */

2018-12-20T08:02:07Z

Email copies are not being sent from my forums

← Older revision		Revision as of 08:02, 20 December 2018
Line 125:		Line 125:

	Tips:		Tips:
	* Try the default settings in ''~~Settings >~~ Site administration > ~~Plugins > Message outputs~~ > Email''. This generally works. Except...		* Try the default settings in '' Site administration > Server > Email''. This generally works. Except...
	* On a Windows server you must supply the address of an SMTP server (Windows, unlike Unix, does not have a build in mail server) in the above settings page		* On a Windows server you must supply the address of an SMTP server (Windows, unlike Unix, does not have a build in mail server) in the above settings page
	* Make sure that ''allowuseremailcharset'' in ''~~Settings >~~ Site administration > ~~Plugins~~ > ~~Message outputs~~ > ~~Email~~'' is set to No unless you really know what you are doing. Setting this to Yes can cause a problem in some versions of Moodle.		* Make sure that ''allowuseremailcharset'' in ''Site administration > Server > Email > Outgoing mail configuration'' is set to No unless you really know what you are doing. Setting this to Yes can cause a problem in some versions of Moodle.
	* Check your firewall or ask your network administrator. Many mail servers are heavily locked down and you may need permission to send mail through them.		* Check your firewall or ask your network administrator. Many mail servers are heavily locked down and you may need permission to send mail through them.

Tsala: /* When upgrading Moodle claims my MySQL database is not UTF8 when I'm sure it is */ removing old FAQ

2017-12-07T15:15:37Z

When upgrading Moodle claims my MySQL database is not UTF8 when I'm sure it is: removing old FAQ

@@ Line 300: / Line 300: @@
   ini_set('precision', 14);
 to your config.php file, and report your success in MDL-18253.
 == How do I run multiple instances of Moodle without duplicating base code? ==

Tsala: /* See also */ removing links

2017-10-26T07:13:49Z

Stuartrmealor: /* See also */

2017-04-04T01:45:15Z

← Older revision		Revision as of 07:13, 26 October 2017
Line 331:		Line 331:
	* [[Errors FAQ]]		* [[Errors FAQ]]
	* [http://moodle.org/mod/forum/view.php?id=28 Installing and upgrading help forum] on moodle.org		* [http://moodle.org/mod/forum/view.php?id=28 Installing and upgrading help forum] on moodle.org
	* [[Beginning_Moodle_2.0_Administration\|Beginning Moodle 2.0 Administration FAQ]]
	~~Once your site is installed use these movies to inform your initial site setup;~~
	* [https://youtu.be/6b4bPmScegw MoodleBites for Administrators - Site setup part 1] YouTube movie
	* [https://youtu.be/XiHWJEJG8Ow MoodleBites for Administrators - Site setup part 2] YouTube movie

	Installing Moodle in a shared web hosting environment:		Installing Moodle in a shared web hosting environment:

← Older revision		Revision as of 01:45, 4 April 2017
Line 332:		Line 332:
	* [http://moodle.org/mod/forum/view.php?id=28 Installing and upgrading help forum] on moodle.org		* [http://moodle.org/mod/forum/view.php?id=28 Installing and upgrading help forum] on moodle.org
	* [[Beginning_Moodle_2.0_Administration\|Beginning Moodle 2.0 Administration FAQ]]		* [[Beginning_Moodle_2.0_Administration\|Beginning Moodle 2.0 Administration FAQ]]
			Once your site is installed use these movies to inform your initial site setup;
			* [https://youtu.be/6b4bPmScegw MoodleBites for Administrators - Site setup part 1] YouTube movie
			* [https://youtu.be/XiHWJEJG8Ow MoodleBites for Administrators - Site setup part 2] YouTube movie

	Installing Moodle in a shared web hosting environment:		Installing Moodle in a shared web hosting environment: