![Page 1: Troubleshooting Moodle Marcus Green Senior Developer Titus … · Purge your cache Zero danger takes a matter of seconds From the browser admin/purgecaches.php From the command line](https://reader035.vdocuments.site/reader035/viewer/2022070806/5f0425817e708231d40c8a73/html5/thumbnails/1.jpg)
Troubleshooting Moodle
Marcus Green
Senior Developer
Titus Learning
1
![Page 2: Troubleshooting Moodle Marcus Green Senior Developer Titus … · Purge your cache Zero danger takes a matter of seconds From the browser admin/purgecaches.php From the command line](https://reader035.vdocuments.site/reader035/viewer/2022070806/5f0425817e708231d40c8a73/html5/thumbnails/2.jpg)
Moodle is strong and stable
● But you don’t just run Moodle
● You run integrations such as SSO
● You run 3rd party plugins
2
![Page 3: Troubleshooting Moodle Marcus Green Senior Developer Titus … · Purge your cache Zero danger takes a matter of seconds From the browser admin/purgecaches.php From the command line](https://reader035.vdocuments.site/reader035/viewer/2022070806/5f0425817e708231d40c8a73/html5/thumbnails/3.jpg)
Using plugins is fine and necessary
● Moodle.org’s Moodle cloud has 5
● But you do become dependent on them
● https://www.tituslearning.com/evaluating-moodle-plugins/
3
![Page 4: Troubleshooting Moodle Marcus Green Senior Developer Titus … · Purge your cache Zero danger takes a matter of seconds From the browser admin/purgecaches.php From the command line](https://reader035.vdocuments.site/reader035/viewer/2022070806/5f0425817e708231d40c8a73/html5/thumbnails/4.jpg)
Categories of trouble
● Things are broken
● Things are slow
● Everything is fine (but not as expected)
4
![Page 5: Troubleshooting Moodle Marcus Green Senior Developer Titus … · Purge your cache Zero danger takes a matter of seconds From the browser admin/purgecaches.php From the command line](https://reader035.vdocuments.site/reader035/viewer/2022070806/5f0425817e708231d40c8a73/html5/thumbnails/5.jpg)
Interviewing the suspect (PICNIC)
● People ‘mis-report’
● Give vague explanations
● Have sausage fingers
5
![Page 6: Troubleshooting Moodle Marcus Green Senior Developer Titus … · Purge your cache Zero danger takes a matter of seconds From the browser admin/purgecaches.php From the command line](https://reader035.vdocuments.site/reader035/viewer/2022070806/5f0425817e708231d40c8a73/html5/thumbnails/6.jpg)
Something has changed
● Your system was working
● It’s broken so something has changed
● No, really something has changed
6
![Page 7: Troubleshooting Moodle Marcus Green Senior Developer Titus … · Purge your cache Zero danger takes a matter of seconds From the browser admin/purgecaches.php From the command line](https://reader035.vdocuments.site/reader035/viewer/2022070806/5f0425817e708231d40c8a73/html5/thumbnails/7.jpg)
The admin did it
● It is hard for end users to break it
● The admin has changed something
● Even if they say they didn’t
- Even if that is YOU
7
![Page 8: Troubleshooting Moodle Marcus Green Senior Developer Titus … · Purge your cache Zero danger takes a matter of seconds From the browser admin/purgecaches.php From the command line](https://reader035.vdocuments.site/reader035/viewer/2022070806/5f0425817e708231d40c8a73/html5/thumbnails/8.jpg)
Purge your cache
● Zero danger takes a matter of seconds
● From the browser
○ admin/purgecaches.php
● From the command line
○ admin/cli/purge_caches.php
8
![Page 9: Troubleshooting Moodle Marcus Green Senior Developer Titus … · Purge your cache Zero danger takes a matter of seconds From the browser admin/purgecaches.php From the command line](https://reader035.vdocuments.site/reader035/viewer/2022070806/5f0425817e708231d40c8a73/html5/thumbnails/9.jpg)
Eliminate the theme
● Not only for display issues
● Change to a core theme (Boost/Clean)
● Allow theme changes in the URL
- admin/settings.php?section=themesettings
9
![Page 10: Troubleshooting Moodle Marcus Green Senior Developer Titus … · Purge your cache Zero danger takes a matter of seconds From the browser admin/purgecaches.php From the command line](https://reader035.vdocuments.site/reader035/viewer/2022070806/5f0425817e708231d40c8a73/html5/thumbnails/10.jpg)
Everything is logged
● Moodle has excellent logging
● Your web server will record all requests
● You need to understand its logging
10
![Page 11: Troubleshooting Moodle Marcus Green Senior Developer Titus … · Purge your cache Zero danger takes a matter of seconds From the browser admin/purgecaches.php From the command line](https://reader035.vdocuments.site/reader035/viewer/2022070806/5f0425817e708231d40c8a73/html5/thumbnails/11.jpg)
The core report filter
11
![Page 12: Troubleshooting Moodle Marcus Green Senior Developer Titus … · Purge your cache Zero danger takes a matter of seconds From the browser admin/purgecaches.php From the command line](https://reader035.vdocuments.site/reader035/viewer/2022070806/5f0425817e708231d40c8a73/html5/thumbnails/12.jpg)
Extended log search
12
![Page 13: Troubleshooting Moodle Marcus Green Senior Developer Titus … · Purge your cache Zero danger takes a matter of seconds From the browser admin/purgecaches.php From the command line](https://reader035.vdocuments.site/reader035/viewer/2022070806/5f0425817e708231d40c8a73/html5/thumbnails/13.jpg)
Extended log search interface
13
![Page 14: Troubleshooting Moodle Marcus Green Senior Developer Titus … · Purge your cache Zero danger takes a matter of seconds From the browser admin/purgecaches.php From the command line](https://reader035.vdocuments.site/reader035/viewer/2022070806/5f0425817e708231d40c8a73/html5/thumbnails/14.jpg)
Apache webserver logging
● Apache is the A in LAMP
● All requests can be logged on the server
● The level can be raised to give more detail
14
![Page 15: Troubleshooting Moodle Marcus Green Senior Developer Titus … · Purge your cache Zero danger takes a matter of seconds From the browser admin/purgecaches.php From the command line](https://reader035.vdocuments.site/reader035/viewer/2022070806/5f0425817e708231d40c8a73/html5/thumbnails/15.jpg)
Raise Apache log level
Then restart the server
15
![Page 16: Troubleshooting Moodle Marcus Green Senior Developer Titus … · Purge your cache Zero danger takes a matter of seconds From the browser admin/purgecaches.php From the command line](https://reader035.vdocuments.site/reader035/viewer/2022070806/5f0425817e708231d40c8a73/html5/thumbnails/16.jpg)
500 errors
16
![Page 17: Troubleshooting Moodle Marcus Green Senior Developer Titus … · Purge your cache Zero danger takes a matter of seconds From the browser admin/purgecaches.php From the command line](https://reader035.vdocuments.site/reader035/viewer/2022070806/5f0425817e708231d40c8a73/html5/thumbnails/17.jpg)
Error.log
● Probably the most useful
● Gives the line in the file where error occured
17
![Page 18: Troubleshooting Moodle Marcus Green Senior Developer Titus … · Purge your cache Zero danger takes a matter of seconds From the browser admin/purgecaches.php From the command line](https://reader035.vdocuments.site/reader035/viewer/2022070806/5f0425817e708231d40c8a73/html5/thumbnails/18.jpg)
Access.log
Access.log
18
![Page 19: Troubleshooting Moodle Marcus Green Senior Developer Titus … · Purge your cache Zero danger takes a matter of seconds From the browser admin/purgecaches.php From the command line](https://reader035.vdocuments.site/reader035/viewer/2022070806/5f0425817e708231d40c8a73/html5/thumbnails/19.jpg)
Theme designer mode
● Is your site unusably slow
● /admin/settings.php?section=themesettings
19
![Page 20: Troubleshooting Moodle Marcus Green Senior Developer Titus … · Purge your cache Zero danger takes a matter of seconds From the browser admin/purgecaches.php From the command line](https://reader035.vdocuments.site/reader035/viewer/2022070806/5f0425817e708231d40c8a73/html5/thumbnails/20.jpg)
Performance and hardware
● How much hardware do you need?
● Hardware and performance forum
● Hardware and performance FAQ
20
![Page 21: Troubleshooting Moodle Marcus Green Senior Developer Titus … · Purge your cache Zero danger takes a matter of seconds From the browser admin/purgecaches.php From the command line](https://reader035.vdocuments.site/reader035/viewer/2022070806/5f0425817e708231d40c8a73/html5/thumbnails/21.jpg)
White screen of death
● Or ‘random gibberish’
● Turn on moodle debugging
● That may tell you which plugin is broken
21
![Page 22: Troubleshooting Moodle Marcus Green Senior Developer Titus … · Purge your cache Zero danger takes a matter of seconds From the browser admin/purgecaches.php From the command line](https://reader035.vdocuments.site/reader035/viewer/2022070806/5f0425817e708231d40c8a73/html5/thumbnails/22.jpg)
If the web interface is working
● admin/settings.php?section=debugging
● https://docs.moodle.org/36/en/Debugging
22
![Page 23: Troubleshooting Moodle Marcus Green Senior Developer Titus … · Purge your cache Zero danger takes a matter of seconds From the browser admin/purgecaches.php From the command line](https://reader035.vdocuments.site/reader035/viewer/2022070806/5f0425817e708231d40c8a73/html5/thumbnails/23.jpg)
From the command line
● In config.php
//NOT FOR PRODUCTION SERVERS!@error_reporting(E_ALL | E_STRICT); @ini_set('display_errors', '1'); $CFG->debug = (E_ALL | E_STRICT);
$CFG->debugdisplay = 1;$CFG->debugusers = '2';
23
![Page 24: Troubleshooting Moodle Marcus Green Senior Developer Titus … · Purge your cache Zero danger takes a matter of seconds From the browser admin/purgecaches.php From the command line](https://reader035.vdocuments.site/reader035/viewer/2022070806/5f0425817e708231d40c8a73/html5/thumbnails/24.jpg)
Email problems?
● Almost never a Moodle problem
● Moodle just talks to it, but this might help
24
![Page 25: Troubleshooting Moodle Marcus Green Senior Developer Titus … · Purge your cache Zero danger takes a matter of seconds From the browser admin/purgecaches.php From the command line](https://reader035.vdocuments.site/reader035/viewer/2022070806/5f0425817e708231d40c8a73/html5/thumbnails/25.jpg)
Forgot admin password?
● From the command line
● admin/cli/php reset_password.php
● == Password reset ==
● Enter username (manual authentication only)
● : admin
25
![Page 26: Troubleshooting Moodle Marcus Green Senior Developer Titus … · Purge your cache Zero danger takes a matter of seconds From the browser admin/purgecaches.php From the command line](https://reader035.vdocuments.site/reader035/viewer/2022070806/5f0425817e708231d40c8a73/html5/thumbnails/26.jpg)
Terrible interface?
● Don’t like the default interface
● Take a look at the themes in the plugins db
○ (We like Fordson)
● Get Titus to customise and brand it for you
26
![Page 27: Troubleshooting Moodle Marcus Green Senior Developer Titus … · Purge your cache Zero danger takes a matter of seconds From the browser admin/purgecaches.php From the command line](https://reader035.vdocuments.site/reader035/viewer/2022070806/5f0425817e708231d40c8a73/html5/thumbnails/27.jpg)
Moodle forums
● General Help
● Full description
● Rate response as ‘Useful’
27
![Page 28: Troubleshooting Moodle Marcus Green Senior Developer Titus … · Purge your cache Zero danger takes a matter of seconds From the browser admin/purgecaches.php From the command line](https://reader035.vdocuments.site/reader035/viewer/2022070806/5f0425817e708231d40c8a73/html5/thumbnails/28.jpg)
Fin
https://twitter.com/marcusavgreen
https://twitter.com/TitusLearning
Any Questions?
28