Tech:Troubleshooting: Difference between revisions
Jump to navigation
Jump to search
Content added Content deleted
imported>Addshore No edit summary |
imported>Addshore m (23 revisions imported from techwiki:Troubleshooting) |
||
(20 intermediate revisions by 4 users not shown) | |||
Line 1: | Line 1: | ||
UPDATE THE [[SAL]] WITH WHAT YOU DO! |
|||
===This is a cached copy of the requested page, and may not be up to date (in red)=== |
===This is a cached copy of the requested page, and may not be up to date (in red)=== |
||
# Try running 'rebuildFileCache.php' over the wiki |
# Try running 'rebuildFileCache.php' over the wiki |
||
# If you get the message saying the wiki does not exist see [[Renaming a database]] |
# If you get the message saying the wiki does not exist see [[Renaming a database]] |
||
# If the issue persists, fix it! |
|||
===Magic Word Exceptions=== |
===Mediawiki Magic Word Exceptions=== |
||
This probably means that the Localisation cache has not updated or someone has enabled an extension on a wiki without it being enabled on extload. |
This probably means that the Localisation cache has not updated or someone has enabled an extension on a wiki without it being enabled on extload. |
||
# Make sure the extension is included on extloadwiki |
# Make sure the extension is included on extloadwiki |
||
# If the issue persists run 'rebuildLocalisationCache.php --wiki extloadwiki' |
# If the issue persists run 'rebuildLocalisationCache.php --wiki extloadwiki' |
||
# If the issue persists check /var/log/mediawiki/debuglogs/exception.log and fix it! |
|||
# Don't try to add global user groups to the ansible playbook, this will cause the localisation cache to screw up and need to be re-run. Instead, create them on Orain Meta via the Global User Groups special pages. |
|||
===Unknown database errors everywhere=== |
|||
# Check the dblist located at "/srv/mediawiki/w/all.dblist" looks correct (this should be a list of database|sitename|wikitags) |
|||
# If this is incorrect and for example the list is HTML then replace the list with the following "metawiki|Orain Meta|" |
|||
# Once this is saved all wikis should be back once the db_list update script is run (which is on a 1 min cron) |
|||
; metawiki |
|||
# With [https://github.com/Orain/ansible-playbook/commit/ec2f525e04863c2a5285991705e6d3487e709993#diff-9f957f2d0351d97a8e2903c3b8d159c5 this commit], metawiki will always be online in the event of the dblist becoming corrupted. |
|||
===Ansible Playbook doesn't appear to be updating=== |
|||
# Is the cronjob for root still there? |
|||
# Check /var/log/ans-all.log for errors |
|||
# Fix them (best bet is probably reverting the changes on github that broke it!) |
|||
===You changed stuff, stuff broke, you dont know why=== |
|||
# If it was an extension have you read the documentation and done everything required (update.php, dependancies) |
|||
# Have you done everything documented currently at [https://github.com/Orain/ansible-playbook/blob/master/README.md our readme] |
|||
# Try manually flushing the APC cache [https://github.com/Orain/ansible-playbook/blob/master/roles/mediawiki/handlers/main.yml#L1 see here] |
|||
# Revert your change! or cry and scream until someone else fixes it |
|||
=== Server/nginx dies or is unresponsive === |
|||
When this happened the web server seemed to totally inaccessible. Hitting any page would not even show / throw a MW exception, nothing would appear in the nginx, mediawiki or syslogs... |
|||
# <code>service nginx stop</code> |
|||
# <code>service nginx start</code> |
|||
# rebuild i18n if it works - if not, looks as the nginx error.log or syslogs. |
Latest revision as of 19:54, 3 April 2015
UPDATE THE SAL WITH WHAT YOU DO!
This is a cached copy of the requested page, and may not be up to date (in red)
- Try running 'rebuildFileCache.php' over the wiki
- If you get the message saying the wiki does not exist see Renaming a database
- If the issue persists, fix it!
Mediawiki Magic Word Exceptions
This probably means that the Localisation cache has not updated or someone has enabled an extension on a wiki without it being enabled on extload.
- Make sure the extension is included on extloadwiki
- If the issue persists run 'rebuildLocalisationCache.php --wiki extloadwiki'
- If the issue persists check /var/log/mediawiki/debuglogs/exception.log and fix it!
- Don't try to add global user groups to the ansible playbook, this will cause the localisation cache to screw up and need to be re-run. Instead, create them on Orain Meta via the Global User Groups special pages.
Unknown database errors everywhere
- Check the dblist located at "/srv/mediawiki/w/all.dblist" looks correct (this should be a list of database|sitename|wikitags)
- If this is incorrect and for example the list is HTML then replace the list with the following "metawiki|Orain Meta|"
- Once this is saved all wikis should be back once the db_list update script is run (which is on a 1 min cron)
- metawiki
- With this commit, metawiki will always be online in the event of the dblist becoming corrupted.
Ansible Playbook doesn't appear to be updating
- Is the cronjob for root still there?
- Check /var/log/ans-all.log for errors
- Fix them (best bet is probably reverting the changes on github that broke it!)
You changed stuff, stuff broke, you dont know why
- If it was an extension have you read the documentation and done everything required (update.php, dependancies)
- Have you done everything documented currently at our readme
- Try manually flushing the APC cache see here
- Revert your change! or cry and scream until someone else fixes it
Server/nginx dies or is unresponsive
When this happened the web server seemed to totally inaccessible. Hitting any page would not even show / throw a MW exception, nothing would appear in the nginx, mediawiki or syslogs...
service nginx stop
service nginx start
- rebuild i18n if it works - if not, looks as the nginx error.log or syslogs.