Setup a Project Wiki: Difference between revisions
Jump to navigation
Jump to search
Jjaythomas (talk | contribs) |
Jjaythomas (talk | contribs) |
||
Line 164: | Line 164: | ||
==Upgrade MediaWiki== | ==Upgrade MediaWiki== | ||
running the latest version,mediawiki-1.8.5 mediawiki-1.11.2. | |||
You were right about webapp-config, that was the key to resolving the database connectivity error. | |||
After changing a few values in: | |||
/etc/vhosts/webapp-config | |||
vhost_root="/home/projects/${vhost_hostname}" | |||
vhost_hostname="infrastructure" | |||
vhost_server="lighttpd" | |||
Figuring out how to configure webapp-config took a long time; I've littered errors all over /home/projects that I will clean up tomorrow. | |||
But when I ran this webapp-config command: | |||
webapp-config -I -h infrastructure -u root -d /wiki mediawiki 1.11.2 | |||
mediawiki populated the correct folder. | |||
After that I followed the post install instructions: | |||
================================================================= | |||
POST-INSTALL INSTRUCTIONS | |||
================================================================= | |||
1. Completing setup: | |||
$ cd /home/projects/infrastructure/htdocs/wiki | |||
Then temporarily make the MediaWiki /config directory writable | |||
to the user the web server is running as. The quickest way is | |||
to make the directory world writable. For example: | |||
$ chmod a+w config | |||
Then access it via a web browser, for example: | |||
lynx http://infrastructure/wiki/config/ | |||
2. After setup move the newly created LocalSettings.php from the config/ | |||
directory to the main mediawiki directory, for example: | |||
$ mv config/LocalSettings.php . | |||
Remember to restore safe permissions to the MediaWiki config/ and | |||
LocalSettings.php (which contains clear-text passwords). | |||
$ chmod a-w config | |||
$ chmod ug=r,o= LocalSettings.php | |||
$ chown root:apache LocalSettings.php | |||
chown root:lighttpd LocalSettings.php | |||
If you wish to enable image uploads then you must manually edit the | |||
LocalSettings.php file to uncomment the $wgEnableUploads line. If MediaWiki was built with the imagemagick USE-flag the directory | |||
permissions are correct, otherwise you must install ImageMagick and | |||
also adjust permissions on the images directory to allow the server | |||
to write. For example: | |||
$ chown lighttpd:lighttpd /home/projects/infrastructure/htdocs/wiki/images | |||
After that I had to copy over the images, math, and skins directory from the old wiki site. I copied over LdapAuthentication.php as well. I am able to authenticate as jjaythomas, so our LDAP connectivity appears to be working. | |||
I think the math feature is still unconfigured, however, because I could not set the "math" USE flag, and the post-install instructions say this: | |||
_______ | |||
Math Support: | |||
If you wish to enable the math support then you must manually edit" | |||
the LocalSettings.php file to uncomment the $wgUseTeX line. | |||
MediaWiki must have been built with the math USE-flag enabled or the | |||
necessary support executable will not be present. | |||
You may also have to execute | |||
$ texconfig dvips printcmd - | |||
if you have not configured tetex before. | |||
________ | |||
After that, I repopulated our Localsettings.php file with a bunch of values I "felt" should be there (I've marked my changes fairly clearly). | |||
I'm sure that there will be numerous bugs to iron out over Localsettings.php, but I can't find any obvious errors. | |||
The original site is preserved on this path: /home/projects/infrastructure/htdocs/wiki.old | |||
A bunch of our webapp-config mistakes will need to be mopped up, they will be listed as folders called /mediawiki and /wiki. | |||
I was reluctant to remove them when my goal was to get our wiki back online. I would have just deleted them, but a post-install instruction indicated: | |||
______________ | |||
* Running /usr/sbin/webapp-cleaner -p -C mediawiki | |||
* Unused versions of mediawiki detected. | |||
* To clean, run the following command: | |||
* emerge -Cav =mediawiki-1.8.5 | |||
>>> www-apps/mediawiki-1.11.2 merged. | |||
>>> No packages selected for removal by clean | |||
>>> Auto-cleaning packages... | |||
>>> No outdated packages were found on your system. | |||
* Messages for package www-apps/mediawiki-1.11.2: | |||
* | |||
* Don't forget to use webapp-config to remove any copies of | |||
* mediawiki-1.11.2 installed in | |||
* | |||
* /var/www/infrastructure/htdocs/home/projects/infrastructure/htdocs/wiki | |||
* /var/www/infrastructure/htdocs/infrastructure | |||
* /var/www/infrastructure/htdocs/mediawiki | |||
* /var/www/localhost/htdocs/mediawiki | |||
* /var/www/infrastructure/htdocs/wiki | |||
________________ | |||
***As as side note, I think that we can set the "vhost" flag on future upgrades. When you set that flag webapp-config is run automatically. Now that the /etc/vhosts/webapp-config has been tailored to our web root and lighttpd, I think automatic webapp-config will work. |