Administration FAQ

Diese Seite muss überarbeitet werden.

Allgemeine Fragen

Wie finde ich heraus, welche Version von Moodle aktuell installiert ist?

Diese Information finden Sie auf der Seite Einstellungen > Website-Administration > Mitteilungen.

Ich habe mein Administrator-Kennwort vergessen

Als erstes können Sie versuchen, den Button Ja, bitte beim Login helfen auf der Login-Seite von Moodle zu benutzen. Sie bekommen dann eine E-Mail mit entsprechenden Informationen.

Kennwörter können von der Kommandozeile aus neu gesetzt werden.

Generell gilt, dass Nutzerkennwörter in der Tabelle mdl_user der Moodle-Datenbank gespeichert werden, insbesondere das Kennwort des Administrators. Für den Zugriff auf die Datenbank ist phpMyAdmin ein nützliches Werkzeug. Die Kennwörter in der Tabelle sind MD5-verschlüsselt. Kopieren Sie das verschlüsselte Kennwort (unverschlüsselt: guest) des Gast-Nutzers guest in das Kennwort-Feld des Datensatzes des Administrator-Nutzers admin, dann können Sie sich mit admin/guest wieder als Administrator anmelden und anschließend das Administrator-Kennwort im Nutzerprofil neu setzen.

Wie verhindere ich, dass Nutzer/innen sich während Wartungsarbeiten anmelden?

Moodle kann auf der Seite Einstellungen > Website-Administration > Server > Wartungsmos in den Wartungsmodus gesetzt werden. Dann können Nutzer/innen nicht in Moodle arbeiten.

Moodle hängt im Wartungsmodus fest

Manchmal bleibt Moodle im Wartungsmodus hängen. Beim Aktivieren des Wartusmodus wird eine Datei maintenance.html im Moodle-Datenverzeichnis moodledata erzeugt. Dabei können Fehler auftreten:

• Prüfen Sie, ob der Webserver-Nutzer Schreibrechte im Moodle-Datenverzeichnis moodledata hat.
• Löschen Sie die Datei maintenance.html manuell, um den Wartungsmodus aufzuheben.

Wie kann ich den Domain-Namen oder die URL meiner Moodle-Site ändern?

Die Basis-URL Ihrer Moodle-Site wird in der Moodle-Konfigurationsdatei config.php gesetz: $CFG->wwwroot. Alle Verlinkungen (z.B. URLs von Kursen oder Aktivitäten in Moodle) werden mit Hilfe dieser Basis-URL dynamisch beim Aufruf der entsprechenden Moodle-Seite erzeugt. (Man spricht in solchen Fällen von relativen Verlinkungen.)

Ihre Moodle-Site kann auch absolute Verlinkungen enthalten, die z.B. auf Arbeitsmaterialien verweisen und die beim Einfügen von Verlinkungen im Moodle-Texteditor entstehen.

Um solche absoluten Verlinkungen gesammelt zu ändern (z.B. beim Wechsel der Moodle.Basis-URL) stellt Moodle ein Kommandozeilen-Werkzeug bereit.

• Melden Sie sich als Administrator/in in Moodle an.
• Rufen Sie im Browser die URL http://IhreMoodleSite.de/admin/tool/replace/index.php auf.
• Tragen Sie im Formular ein, wonach Sie suchen und ersetzen und klicken Sie auf den Button Ersetzen.

Achtung: Es wird dringend empfohlen, vor dem Suchen und Ersetzen die Moodle-Datenbank zu sichern, falls etwas schief geht!

Wenn Sie die Moodle-Domain ändern, kann es sein, dass Sie auch die Konfiguration Ihres Webservers und/oder des DNS-Servers anpassen müssen. Siehe Moodle-Migration für weitere Informationen.

Meine Logdaten-Tabelle ist verschwunden - ich finde keine Logdaten mehr!

Am wahrscheinlichsten ist, dass Ihre mdl_log Tabelle zerstört ist. Um das herauszufinden, überprüfen Sie das Datenbank-Schema.

Hinweis: Ab Moodle 2.7 gibt es ein neues Logging-System. Prüfen Sie auf der Seite Einstellungen > Website-Administration > Plugins > Logdaten > Logdaten verwalten, ob Ihre Moodle-Site dieses neue Logging-System verwendet und stellen Sie sicher, dass die Standardlogdaten aktiviert sind.

Wie kann ich die Moodle-Datenbank reparieren?

Detaillierte Informationen dazu finden Sie im Artikel Datenbank-Schema prüfen.

Sicherheitseinstellungen

Wie funktionieren die Begrenzungen zur Dateigröße beim Hochladen von Dateien?

Die Dateigröße beim Hochladen von Dateien wird an verschiedenen Stellen begrenzt. Jede der unten aufgezählten Einstellungen begrenzt die jeweils nachfolgenden. 1. Webserver-Einstellung LimitRequestBody: Das ist eine Einstellung in der Konfigurationsdatei vom Apache-Webserver (je nach Linux-Distribution zu finden z.B. unter /usr/local/apache2/conf/httpd.conf oder /etc/apache2conf/httpd.conf). Die Angabe erfolgt in Byte.

2. PHP-Einstellungen: Diese stehen in der Konfigurationsdatei php.ini. Betroffen sind die Einstellungen

    upload_max_filesize 64M
    post_max_size 64M

PHP-Einstellungen können auch in einer .htaccess Datei hinterlegt sein:

php_value upload_max_filesize 64M
php_value post_max_size 64M

Eine .htaccess Datei wird meistens im Wurzelverzeichnis der Moodle-Installation gespeichert, d.h. die Einstellungen wirken sich auf die gesamte Moodle-Site aus. Wenn Sie die Einstellungen nur auf bestimmte Moodle-Bereiche eingrenzen wollen, dann müssen Sie eine Kopie der php.ini Datei in die entsprechenden Unterverzeichnisse der Moodle-Installation oder ins Moodle-Datenverzeichnis kopieren, z.B.

• public_html
• moodle/admin
• moodle/course
• moodle/files
• moodle/repository
• moodledata

Beachten Sie, dass Sie nach Änderungen in der Webserver- bzw. PHP-Konfiguration den Webserver neu starten müssen. Auf der Seite Einstellungen > Website-Administration > Server > PHP-Info können Sie prüfen, ob die Änderungen in Moodle wirksam geworden sind.

3. Moodle hat eine systemweite Einstellung Maximale Dateigröße maxbytes. Diese Einstellung legt die maximale Größe von Dateien fest, die Sie in Moodle hochladen können. Sie wird auf der Seite Einstellungen > Website-Administration > Sicherheit > Website-Rechte eingestellt. Die auswählbare Obergrenze wird durch die Einstellungen in der PHP-Konfigurationsdatei begrenzt.

4. Den Standardwert für den Datei-Upload in neu angelegten Kursen sollten Sie kleiner als die systemweite maximale Dateigröße wählen. Gehen Sie dazu auf die Seite Einstellungen > Website-Administration > Kurse > Grundeinstellungen und wählen Sie einen geeigneten Wert für Maximale Dateigröße maxbytes. In jedem Kurs kann dieser Wert in den Kurseinstellungen individuell vom Trainer angepasst werden.

5. Auf Aktivitäten-Ebene können Sie die maximale Dateigröße noch einmal einschränken, z.B. bei Foren oder Aufgaben.

Siehe auch:

• Detailed instructions to increase the maximum allowed size for uploaded files Diskussionsbeitrag im Kurs Using Moodle auf moodle.org
• Instructions to increase maximum allowed size on hosted servers Diskussionsbeitrag im Kurs Using Moodle auf moodle.org

Wie ändere ich die maximale Dateigröße bei einer lokalen Moodle-Installation unter Windows?

Wenn Sie Moodle lokal unter Windows installiert haben (z.B. mit Hilfe des vollständigen Installationspakets für Windows), dann können Sie den Standardwert von 16M wie folgt anpassen:

• Öffnen Sie die Datei /php/php.ini mit einem einfachen texteditor wie Notepad oder Wordpad.
• Suchen Sie in der Datei nach dem Parameter upload_max_filesize
• Ändern Sie den Wert von 16M auf die gewünschte Größe.
• Suchen Sie in der Datei nach dem Parameter post_max_filesize
• Ändern Sie den Wert von 16M auf die gewünschte Größe.
• Speichern Sie die Datei.
• Starten Sie den xampp neu.

Wie ändere ich den Parameter max execution time für Datei-Uploads?

Wenn Sie die maximale Dateigröße für den Datei-Upload erhöhen, kann als Nebeneffekt das Hochladen länger dauern, als der PHP-Parameter max execution time in der Konfigurationsdatei php.ini erlaubt (standardmäßig 300 Sekunden / 5 Minuten). In diesem Fall sollten Sie den Wert des Parameters ebenfalls erhöhen, z.B. auf 600 Sekunden / 10 Minuten:

max_execution_time = 600

Wenn Sie die PHP-Einstellungen wieder in einer .htaccess Datei gespeichert haben, dann ergänzen Sie folgende Zeile:

php_value max_execution_time 600

Starten Sie den Webserver neu und prüfen Sie auf der Seite Einstellungen > Website-Administration > Server > PHP-Info, ob die Änderungen in Moodle wirksam geworden sind.

Logging in and out

My site is logging users out to quickly

User login sessions are checked to see if the user is still active, and will log them out after a specific period of idleness. This is set in Site administration > Server > Session handling > Timeout. The default is two hours. Increase it if you need to.

Users can not login, they need cookies and debug mentions config.php

Your site's config.php file probably has extra lines after ?>. Solution is to delete the last ?>.

After using the 'Login as' function, why am I logged out of Moodle?

This is by design. After using the 'Login as' function, for security reasons you are automatically logged out of Moodle when you return to your normal role. If you login again you will be redirected to the page that you were on previously.

Text and Appearance

Why do I see [[missing strings]]?

Double square brackets around text indicate that language strings are missing for that function for that language. This is most common with third-party plugins or for languages that may not have all the strings translated for it yet.

First update your language packs to the latest versions in Site administration > Language > Language packs > Update all installed language packs.

If the missing strings are for a non-standard plugin, try to update that plugin and / or check with that plugin maintainer to see if this is a reported issue. If you have access to the server code, you can check the code for this plugin; language strings are supposed to be contained in a lang folder within the module or plugin folder.

Note: after changing language strings you may see a lag in the cache for these to show up. You can force this in Site administration > Development > Purge all caches.

Changing text in Moodle

The language editing interface in Administration > Language > Language customisation enables you to easily change any string, any word or phrase, used on the site.

The strings are stored per language pack. So if you change them for 'en' (common English), that will not change them for 'en_us' (US English) or any other language.

You may need to search through several files to find the word or phrase you are looking for. The file moodle.php contains all common site-wide phrases and the admin.php contains many admin phrases. Tip: if you don't know the file the string is in, select ALL the file options to search through.

Also, these customisations override but do not delete the default language strings but are stored separately in the language folders in your site's moodledata location.

My style sheet or other theme changes aren't showing up

Browsers usually cache style sheets and so a forced refresh in your browser is required before any changes show up.

The Moodle server also caches all styles. You can force a refresh of the cache from disk in Site Administration>Appearance>Themes>Theme selector, click "Clear theme caches".

How can I change center of the Front Page from course categories to something else?

Go to Front Page > Settings and change "Front page" to None all down. Change "Front page items when logged in" to None all down. Ensure that "Include a topic section" is checked. Save changes and return to the front page. Turn editing on, obviously, and you should now see the "Add a resource" and "Add an activity" drop down combo-boxes. Select "Add a resource" and select "Insert a label". You can then edit the label in any way you want to in the WYSYWYG editor.

How can I change the initial login screen?

Edit one of the language files. Site administration > Language> Language customisation, look in the moodle.php file. Look for loginusing or loginsteps or loginstepsnone string variables.

How can I change the initial login screen help?

To change or add a help message for the login go to Site administration > Plugins > Authentication > Manage authentication. Type your help message in there in the Instructions text box.

Errors and Troubleshooting

How do I enable/disable debugging?

If you are getting a blank or partially complete page, or receive a page that presents a short error message that is not informative enough, you can turn on debugging to learn more details.

Turning on debugging will let you see what the error message is, which may help you diagnose the problem. Set this in Site administration > Development > Debugging - see Debugging for more.

Incomplete page displayed when I click "Turn Editing On"

When you see an incomplete page, it is normally a sign that an error occurred. To find out more, turn on Debugging, and you should see an error message which may help you to diagnose the problem.

This is usually as a result of an incompatible contributed module or block that you have installed. Follow these steps:

1. Follow the module removal instructions in Installing contributed modules or plugins.
2. Re-visit your course page and try clicking on the "Turn Editing On" button again.

If you find an incompatible module or block, please report the problem to the person named as the maintainer in the Modules and Plugins database.

Receive error message "a required parameter (id) was missing" when uploading a file or

This message sometimes is generated when attempting to upload a file larger than the upload limit. This can also be caused by user's having more than one login to the same site open in the same browser in different windows or tabs.

User gets 'an invalid session key' error

A number of things may caused the invalid session key error. The most common is if the person tries to login into the same Moodle site in more than one tab or window in the same browser. That will not work. The fix is to close all those tabs and windows and close and restart the browser. This is almost always a transient issue. The fix is to close and restart the browser, and log back into Moodle.

If you send someone a URL to something in Moodle, like a course activity or particular page, is may be that the session id key is tacked onto the end of the URL. Simply delete that parameter from the URL.

Why is a page blank, or half missing?

A blank page, or a page that seems to have half missing, is normally a sign that an error occurred. If (as is recommended on production systems) you have display of error messages turned off, it can be very hard to understand what is going on.

The solution is to turn on the debugging options temporarily. Then, when you go back to the problem page, you should see the error message. Once you had finished solving the problem, remember to turn debugging off again.

How can I fix just one bug, without upgrading my whole site?

Suppose:

• You are experiencing a particular bug.
• You have searched in the tracker, and found that your problem is MDL-abc, and that it has been fixed in the latest version.
• For some reason, you cannot upgrade your whole site, even though the latest version probably has security fixes.

Then, how can you get the fix for just this one bug, without upgrading your whole site? Well, if you are prepared to manually patch the code, you can probably get this information from the tracker. Please see How to fix just one bug without upgrading guide.

Siehe auch

• Fehler FAQ
• Installation FAQ