Setup a Project Wiki: Difference between revisions

From Research
Jump to navigation Jump to search
(Removed outdated install docs)
Line 139: Line 139:


'''
'''
==Upgrade MediaWiki - this section needs work==
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.

Revision as of 06:12, 18 February 2010