Difference between revisions of "The Wiki"

VisualWikitext

Revision as of 01:39, 1 November 2016

What is the wiki

A wiki a collaborative editing environment that all PS:One member's have access to.

We use it for

Votes/Vote proposals
Meeting Agendas/ Meeting Notes
Recording Policies
Hosting the Bylaws
Note Taking
Systems Documentation

Wiki Usage Guides

Equipment Labels

https://wiki.pumpingstationone.org/Template:EquipmentPage

Extra Features

WikiBot

The user:wikibot makes edits to the wiki automatically, making simple cleanups and doing link verification. It's running based off the Pywikibot software.

Cirrus Search

The default search in mediawiki does exact matching, but doesn't to lexicographical searches. We have Cirrus Search installed, along with indexing daemons that run nightly on the mediawiki server.

Visual Editor

The Visual Editor Is a feature Media Wiki has been working on for a while, but still isn't perfect. Most notably it breaks pretty hard on Equipment Pages.

The parsoid daemon is currently offline

Technical

The wiki is running MediaWiki's wiki software, the same as WikiPedia, along with some 3rd party extensions.

Hosted at https://wiki.pumpingstationone.org
The wiki lives on wiki.ad.pumpingstationone.org under /srv/http/wiki.pumpingstationone.org/.
Nightly dumps are publicly available: PS1 Wiki Dumps
Upgrading Mediawiki

LDAP Authentication

The LdapAuthentication plugin hasn't had a real update since 2012. I needed to make this change: https://www.mediawiki.org/w/index.php?title=Topic:Sl9i17el9a1g9tv1&topic_showPostId=sm0okbrd7fjrprxb#flow-post-sm0okbrd7fjrprxb to get the plugin to work again.

Mediawiki Job Queue

The mediawiki Job Queue handles things like propagating template changes, link changes, search changes, etc. These operations can be slow, and the wiku runs 1 job per pageload. There is also a systemd timer that clears the job queue during off peak hours.

Page Caching

We have a few types of cacheing enabled in mediawiki. We have APC object and ond opcode cacheing enabled.

We also have a mediawiki file cacheing enabled. The file cache only takes affect for non logged in users, and non special pages.

Troubleshooting Common Issues

"Wiki uses cookies to log in users. You have cookies disabled. Please enable them and try again." This issue seems to appear randomly every once in a while, even if users have cookies enabled in their browsers, they still can't login (and basically no one can login or edit any pages at that point). We're not sure what the root cause is yet, but this StackOverflow answer points to some potential solutions.
- If you want to get it working right now, just SSH into wiki.ad.pumpingstationone.org as root and run systemctl restart php-fpm to just restart mediawiki. Generally, that gets things working properly again, at least for a little while.

Allowed File types

log in to wiki.ad.pumpingstationone.org and edit /srv/http/wiki.pumpingstationone.org/LocalSettings.php

Find the $wgFileExtensions variable and make whatever changes you see fit.

@@ Line 59: / Line 59: @@
 We also have a mediawiki file cacheing enabled.  The file cache only takes affect for non logged in users, and non special pages.
+=== Troubleshooting Common Issues ===
+* '''"Wiki uses cookies to log in users. You have cookies disabled. Please enable them and try again."''' This issue seems to appear randomly every once in a while, even if users have cookies enabled in their browsers, they still can't login (and basically no one can login or edit any pages at that point). We're not sure what the root cause is yet, but [http://stackoverflow.com/questions/16127882/how-can-i-fix-the-mediawiki-error-wiki-uses-cookies-to-log-in-users-you-have-c this StackOverflow answer] points to some potential solutions.
+** If you want to get it working right now, just SSH into wiki.ad.pumpingstationone.org as root and run <code>systemctl restart php-fpm</code> to just restart mediawiki. Generally, that gets things working properly again, at least for a little while.
 == Allowed File types ==