| | 1 | = Mediawiki = |
| | 2 | |
| | 3 | Install |
| | 4 | {{{ |
| | 5 | echo www-apps/mediawiki mysql vhosts imagemagick >> /etc/portage/package.use |
| | 6 | emerge -v mediawiki |
| | 7 | }}} |
| | 8 | |
| | 9 | Install in vhost |
| | 10 | {{{ |
| | 11 | webapp-config -I -h rp.thinkthinkdo.com -d mediawiki mediawiki 1.11.2 |
| | 12 | }}} |
| | 13 | |
| | 14 | webapp-config displays the following post-installation instructions (TO BE DONE!!!) |
| | 15 | {{{ |
| | 16 | ================================================================= |
| | 17 | POST-INSTALL INSTRUCTIONS |
| | 18 | ================================================================= |
| | 19 | |
| | 20 | 1. Completing setup: |
| | 21 | |
| | 22 | To complete installation cd into the MediaWiki install location, but |
| | 23 | make sure to start mysql first. |
| | 24 | |
| | 25 | $ /etc/init.d/mysql start |
| | 26 | $ cd /var/www/rp.thinkthinkdo.com/web/mediawiki |
| | 27 | |
| | 28 | Then temporarily make the MediaWiki /config directory writable |
| | 29 | to the user the web server is running as. The quickest way is |
| | 30 | to make the directory world writable. For example: |
| | 31 | |
| | 32 | $ chmod a+w config |
| | 33 | |
| | 34 | Then access it via a web browser, for example: |
| | 35 | |
| | 36 | lynx http://rp.thinkthinkdo.commediawiki/config/ |
| | 37 | |
| | 38 | 2. After setup move the newly created LocalSettings.php from the config/ |
| | 39 | directory to the main mediawiki directory, for example: |
| | 40 | |
| | 41 | $ mv config/LocalSettings.php . |
| | 42 | |
| | 43 | Remember to restore safe permissions to the MediaWiki config/ and |
| | 44 | LocalSettings.php (which contains clear-text passwords). |
| | 45 | |
| | 46 | $ chmod a-w config |
| | 47 | $ chmod ug=r,o= LocalSettings.php |
| | 48 | $ chown root:apache LocalSettings.php |
| | 49 | |
| | 50 | After these steps MediaWiki should be accesable at |
| | 51 | http://rp.thinkthinkdo.commediawiki/ |
| | 52 | |
| | 53 | 3. Enabling Optional Features: |
| | 54 | |
| | 55 | If you wish to enable image uploads then you must manually edit the |
| | 56 | LocalSettings.php file to uncomment the $wgEnableUploads line. |
| | 57 | If MediaWiki was built with the imagemagick USE-flag the directory |
| | 58 | permissions are correct, otherwise you must install ImageMagick and |
| | 59 | also adjust permissions on the images directory to allow the server |
| | 60 | to write. For example: |
| | 61 | |
| | 62 | $ chown apache:apache /var/www/rp.thinkthinkdo.com/web/mediawiki/images |
| | 63 | |
| | 64 | Math Support: |
| | 65 | |
| | 66 | If you wish to enable the math support then you must manually edit" |
| | 67 | the LocalSettings.php file to uncomment the $wgUseTeX line. |
| | 68 | MediaWiki must have been built with the math USE-flag enabled or the |
| | 69 | necessary support executable will not be present. |
| | 70 | You may also have to execute |
| | 71 | |
| | 72 | $ texconfig dvips printcmd - |
| | 73 | |
| | 74 | if you have not configured tetex before. |
| | 75 | |
| | 76 | |
| | 77 | 4. Things you need to have on the server: |
| | 78 | |
| | 79 | - SQL database of your choice and support for that database compiled in PHP |
| | 80 | We check for required PHP features for mysql and postgres use flags in the ebuild; |
| | 81 | you are on your own if you are using a different kind of DB backend. |
| | 82 | - dev-php/PEAR-Mail is needed for using external smtp server. |
| | 83 | |
| | 84 | These are not installed as dependencies since it is possible to run the database |
| | 85 | and other services on other machines. |
| | 86 | |
| | 87 | It is very important that you follow all the major versions upgrade instructions |
| | 88 | from the mediawiki.org web page - http://www.mediawiki.org/wiki/Manual:Upgrading |
| | 89 | |
| | 90 | Do not, I repeat, do not assume that we can upgrade from version to version just |
| | 91 | like this. Make backups before upgrading. |
| | 92 | |
| | 93 | ================================================================= |
| | 94 | }}} |
| | 95 | |