These testing instructions will require you to reconfigure your web server.

Configuration

How this is done will depend heavily on your web server, and configuration.

The following are provided as examples of how you may reconfigure your web server. Your requirements may differ.

Apache with site in a sub-directory

These instructions assume that you have a Moodle site in a sub-directory, such as http://example.com/moodle.

If you have additional nesting, this may need modification.

1. * Make a backup of your current apache configuration file before making changes.
2. Download and extract the moodle-apache_with_83424.zip file attached to this issue.
3. Place these files in their current structure into your apache configuration directory, usually found at /etc/apache2/ or similar.
4. Update them according to your needs (see inline documentation).

Nginx with site in a sub-directory

This reconfiguration example assumes that your Moodle is hosted inside a directory like https://example.com/mysite

If you have additional nesting, this may need modification.

1. * Make a backup of your current nginx configuration file before making changes.
2. Download and extract the moodle-nginx_with_83424.zip file attached to this issue.
3. Place these files in their current structure into your nginx configuration directory, usually found at /etc/nginx/ or similar.
4. Update them according to your needs, for example:
   1. SSL - moodle_servers.conf contains two server stanzas, one for HTTP and one for HTTPS.
      1. If you have SSL certifiates, set the paths for them
      2. If you do not, comment out the second server for port 443
   2. Update the site configuration: blocks/moodle_block.conf:
      1. If the root of your Moodle site's is located at /var/www/moodle, you would set the $root variable to /var/www/moodle/public.
      2. Set the server_names appropriate to your machine
      3. Set the path for your error log.
5. Restart your web server

Other notes

1. If you use MDK please ensure that you are using the latest version, as older versions may not support the new public directory.

Tests

Test CLI installation

1. Create a new Moodle Site and install it via the CLI:

   php public/admin/cli/install.php

   1. Confirm that you have a public directory in the root of your Moodle installation
2. Attempt to log in to your Moodle site via the web interface
   1. confirm that you can access the site

Test web installation

1. Create a new Moodle Site and install it via the web interface:
2. Navigate to your Moodle site in a web browser, such as `http://example.com/yourmoodle`.
3. Follow the installation instructions
4. Attempt to log in to your Moodle site via the web interface
   1. confirm that you can access the site

Upgrade using CLI

1. Create a new Moodle site running Moodle version 5.0
2. Navigate to your Moodle site in a terminal
3. Check out the latest version of the integration / MDL-83424 branch from git
4. Run the upgrade script:

   php public/admin/cli/upgrade.php

   1. Confirm that you have a public directory in the root of your Moodle installation
5. Attempt to log in to your Moodle site via the web interface
   1. confirm that you can access the site

Upgrade using web interface

1. Create a new Moodle site running Moodle version 5.0
2. Navigate to your Moodle site in a terminal
3. Check out the latest version of the integration / MDL-83424 branch from git
4. Visit your Moodle site in a web browser, such as `http://example.com/yourmoodle`.
5. Follow the upgrade instructions
6. Attempt to log in to your Moodle site via the web interface
   1. confirm that you can access the site

Fails against automated checks.

Checked MDL-83424 using repository: https://github.com/andrewnicols/moodle.git

• main [branch: MDL-83424-main | CI Job]
  • Error: The MDL-83424-main branch at https://github.com/andrewnicols/moodle.git does not apply clean to origin/main
  • Error: Merge conflict(s) in file(s):
  • Error: public/completion/tests/behat/multiple_grading_items_activity_completion.feature
  • Error: public/course/format/topics/tests/behat/default_sections.feature
  • Error: public/course/format/weeks/UPGRADING.md
  • Error: public/course/format/weeks/tests/behat/default_sections.feature
  • Error: public/course/tests/behat/max_number_sections.feature
  • Error: public/lib/amd/build/page_title.min.js
  • Error: public/lib/amd/build/page_title.min.js.map
  • Error: public/lib/amd/src/page_title.js
  • Error: public/lib/classes/oauth2/client/microsoft.php
  • Error: public/mod/glossary/tests/behat/overview_report.feature
  • Error: public/mod/subsection/tests/behat/subsection_limit.feature
  • Error: public/version.php

Should these errors be fixed?

Built on: Mon Jun 9 04:05:45 UTC 2025

Launching automatic jobs for branch MDL-83424-main

• https://ci.moodle.org/view/Testing/job/DEV.02%20-%20Developer-requested%20PHPUnit/19338/ PHPUnit (sqlsrv / complete)
• https://ci.moodle.org/view/Testing/job/DEV.01%20-%20Developer-requested%20Behat/66063/ Behat (NonJS - boost and classic / complete)
• https://ci.moodle.org/view/Testing/job/DEV.01%20-%20Developer-requested%20Behat/66064/ Behat (Firefox - boost / complete)
• https://ci.moodle.org/view/Testing/job/DEV.01%20-%20Developer-requested%20Behat/66065/ Behat (Firefox - classic / complete)
• https://ci.moodle.org/view/Testing/job/DEV.01%20-%20Developer-requested%20Behat/66066/ App tests (stable app version) / complete)
• https://ci.moodle.org/view/Testing/job/DEV.02%20-%20Developer-requested%20PHPUnit/19334/ PHPUnit (pgsql / complete)
• https://ci.moodle.org/view/Testing/job/DEV.02%20-%20Developer-requested%20PHPUnit/19335/ PHPUnit (mariadb / complete)
• https://ci.moodle.org/view/Testing/job/DEV.02%20-%20Developer-requested%20PHPUnit/19336/ PHPUnit (sqlsrv / complete)

Built on: Wed May 14 03:35:49 UTC 2025