InstallLocalMediaWiki
From Clothbot
(Difference between revisions)
Revision as of 22:18, 2 January 2008 (edit) AndrewPlumb (Talk | contribs) (→Steps) ← Previous diff |
Current revision (03:11, 3 January 2008) (edit) AndrewPlumb (Talk | contribs) (→Steps) |
||
Line 1: | Line 1: | ||
=How To Install a Local MediaWiki= | =How To Install a Local MediaWiki= | ||
+ | |||
+ | Specific to Mac OS X | ||
+ | * Performed on a Leopard-upgraded-from-Tiger machine (not clean) | ||
==Steps== | ==Steps== | ||
- | # Download mysql-5.0.45-osx10.4-i686.dmg | + | # Download mysql-5.0.45-osx10.4-i686.dmg [http://dev.mysql.com/downloads/mysql/5.0.html#macosx-dmg] |
## Read the included ReadMe.txt file | ## Read the included ReadMe.txt file | ||
## Shut down any existing MySQL servers that are running | ## Shut down any existing MySQL servers that are running | ||
## Launch the pkg installer (mysql-5.0.45-osx10.4-i686.pkg) | ## Launch the pkg installer (mysql-5.0.45-osx10.4-i686.pkg) | ||
## Install the MySQLStartupItem.pkg to make automatic start-up easier to manage. | ## Install the MySQLStartupItem.pkg to make automatic start-up easier to manage. | ||
- | # Download MediaWiki | ||
- | ## Read [http://www.mediawiki.org/wiki/Manual:Installation Installation Guide] | ||
# In your '''System Preferences''', go into '''Sharing''' and turn on '''Web Sharing''' | # In your '''System Preferences''', go into '''Sharing''' and turn on '''Web Sharing''' | ||
#* You should now be able to see an Apache web server running at http://localhost/ | #* You should now be able to see an Apache web server running at http://localhost/ | ||
+ | #** [http://discussions.apple.com/thread.jspa?messageID=5761831� Problem with permissions] with Leopard-upgraded account. | ||
+ | #*** Terminal: '''sudo cp /etc/httpd/users/*.conf /etc/apache2/users/.''' | ||
+ | ## Terminal: '''sudo vi /etc/apache2/httpd.conf''' | ||
+ | ##* Uncomment: ''LoadModule php5_module libexec/apache2/libphp5.so'' | ||
+ | ##** vi (find the ''php5'' string): '''/php5''' | ||
+ | ##** vi (move to the start of the line): '''^''' | ||
+ | ##** vi (erase the ''#'' character): '''x''' | ||
+ | ##** vi (colon character, '''w'''rite and '''q'''uit): ''':wq''' | ||
+ | ## GUI Editor Alternative: '''sudo /Applications/TextEdit.app/Contents/MacOS/TextEdit /etc/apache2/httpd.conf''' | ||
+ | ##* Erase the '''#''' in front of the ''LoadModule php5_module libexec/apache2/libphp5.so'' line. | ||
+ | ##* Save and exit. Make sure it '''does not''' Line-Wrap. | ||
+ | # Reboot so mysql and apache start up fresh. | ||
+ | # Download MediaWiki [http://www.mediawiki.org/wiki/Download] | ||
+ | ## Read the Installation Guide [http://www.mediawiki.org/wiki/Manual:Installation] | ||
+ | ## Terminal: '''cd /Library/WebServer/Documents''' | ||
+ | ## Terminal: '''sudo mkdir wiki''' | ||
+ | ## Terminal: '''cd wiki''' | ||
+ | ## Terminal: '''sudo tar xvfz ~/Downloads/mediawiki-1.11.0.tar.gz''' | ||
+ | ## Browse to ''http://localhost/wiki/mediawiki-1.11.0/'' | ||
+ | ##* Note the message to change permissions: | ||
+ | ##** Terminal: '''cd .../mediawiki-1.11.0''' | ||
+ | ##** Terminal: '''sudo chmod a+w config''' | ||
+ | ##** Retry running configuration. | ||
+ | ## Configure using the web form | ||
+ | ##* If you're going to use a Creative Commons license, configure it '''first''' before anything else. The new form won't retain of the field values so you'll be entering things twice. | ||
+ | ##* Be sure to assign a prefix in the '''Database table prefix''' field. Makes it easier to maintain multiple wikis and/or start from scratch. | ||
+ | ##* '''Error:''' ''Attempting to connect to database server as root...failed with error [2002] Can't connect to local MySQL server through socket /var/lib/mysql/mysql.sock'' | ||
+ | ##** '''Change:''' Field '''Database Host''' from ''localhost'' to ''127.0.0.1'' | ||
+ | ##* '''Error:''' ''Attempting to connect to database server as wikiuser...failed due to authentication errors. Check passwords.'' | ||
+ | ##** '''Change:''' | ||
+ | ##*** Checkbox '''Superuser account''' to ''checked'' | ||
+ | ##*** Leave field '''Superuser password''' blank. | ||
+ | ## Terminal: '''sudo mv config/LocalSettings.php .''' | ||
+ | # Follow the link to ''http://localhost/wiki/mediawiki-1.11.0/index.php'' | ||
+ | |||
+ | ==Tips and Tricks== | ||
+ | |||
+ | # Download and install CocoaMySQL [http://cocoamysql.sourceforge.net/] to more easily maintain your MySQL databases. | ||
+ | # If you want to reconfigure your wiki from scratch, delete or rename the LocalSettings.php and rerun the install process. | ||
=References= | =References= | ||
Line 23: | Line 63: | ||
** [http://www.mediawiki.org/wiki/MediaWiki MediaWiki Main Page] | ** [http://www.mediawiki.org/wiki/MediaWiki MediaWiki Main Page] | ||
*** [http://www.mediawiki.org/wiki/Installation Installation] | *** [http://www.mediawiki.org/wiki/Installation Installation] | ||
+ | |||
+ | [[Category:Project]] [[Category:MacOSXHack]] |
Current revision
Contents |
[edit]
How To Install a Local MediaWiki
Specific to Mac OS X
- Performed on a Leopard-upgraded-from-Tiger machine (not clean)
[edit]
Steps
- Download mysql-5.0.45-osx10.4-i686.dmg [1]
- Read the included ReadMe.txt file
- Shut down any existing MySQL servers that are running
- Launch the pkg installer (mysql-5.0.45-osx10.4-i686.pkg)
- Install the MySQLStartupItem.pkg to make automatic start-up easier to manage.
- In your System Preferences, go into Sharing and turn on Web Sharing
- You should now be able to see an Apache web server running at http://localhost/
- Problem with permissions with Leopard-upgraded account.
- Terminal: sudo cp /etc/httpd/users/*.conf /etc/apache2/users/.
- Problem with permissions with Leopard-upgraded account.
- Terminal: sudo vi /etc/apache2/httpd.conf
- Uncomment: LoadModule php5_module libexec/apache2/libphp5.so
- vi (find the php5 string): /php5
- vi (move to the start of the line): ^
- vi (erase the # character): x
- vi (colon character, write and quit): :wq
- Uncomment: LoadModule php5_module libexec/apache2/libphp5.so
- GUI Editor Alternative: sudo /Applications/TextEdit.app/Contents/MacOS/TextEdit /etc/apache2/httpd.conf
- Erase the # in front of the LoadModule php5_module libexec/apache2/libphp5.so line.
- Save and exit. Make sure it does not Line-Wrap.
- You should now be able to see an Apache web server running at http://localhost/
- Reboot so mysql and apache start up fresh.
- Download MediaWiki [2]
- Read the Installation Guide [3]
- Terminal: cd /Library/WebServer/Documents
- Terminal: sudo mkdir wiki
- Terminal: cd wiki
- Terminal: sudo tar xvfz ~/Downloads/mediawiki-1.11.0.tar.gz
- Browse to http://localhost/wiki/mediawiki-1.11.0/
- Note the message to change permissions:
- Terminal: cd .../mediawiki-1.11.0
- Terminal: sudo chmod a+w config
- Retry running configuration.
- Note the message to change permissions:
- Configure using the web form
- If you're going to use a Creative Commons license, configure it first before anything else. The new form won't retain of the field values so you'll be entering things twice.
- Be sure to assign a prefix in the Database table prefix field. Makes it easier to maintain multiple wikis and/or start from scratch.
- Error: Attempting to connect to database server as root...failed with error [2002] Can't connect to local MySQL server through socket /var/lib/mysql/mysql.sock
- Change: Field Database Host from localhost to 127.0.0.1
- Error: Attempting to connect to database server as wikiuser...failed due to authentication errors. Check passwords.
- Change:
- Checkbox Superuser account to checked
- Leave field Superuser password blank.
- Change:
- Terminal: sudo mv config/LocalSettings.php .
- Follow the link to http://localhost/wiki/mediawiki-1.11.0/index.php
[edit]
Tips and Tricks
- Download and install CocoaMySQL [4] to more easily maintain your MySQL databases.
- If you want to reconfigure your wiki from scratch, delete or rename the LocalSettings.php and rerun the install process.
[edit]