HelpOnInstallingMoinMoin
147
Comment:
|
3166
Adding alias for moin_static171. This is needed for img and CSS to work correctly.
|
Deletions are marked like this. | Additions are marked like this. |
Line 1: | Line 1: |
Varies somewhat from the setup described on [http://moinmoin.wikiwikiweb.de/] homepage, see [http://www.ubuntuforums.org/showthread.php?t=206853] | ## page was renamed from HelpOnInstalling Varies somewhat from the setup described on [[http://moinmoin.wikiwikiweb.de/]] homepage, /!\ '''Note:''' This guide has been adjusted to accommodate for a custom wiki name. If you spot an error, please fix it. <<TableOfContents(3)>> = Steps to Install = Derived from [[http://www.ubuntuforums.org/showthread.php?t=206853]] == Install Required Packages == Required packages are as follows: * python-moinmoin (Which should point to the proper python version) * apache2 webserver {{{ sudo apt-get install python-moinmoin sudo apt-get install apache2 }}} == Create a Wiki With "wikiname" == Create a wiki called "wikiname" and set the permissions. {{{ cd /usr/share/moin sudo mkdir wikiname sudo cp -R data wikiname sudo cp -R underlay wikiname sudo cp server/moin.cgi wikiname sudo chown -R www-data.www-data wikiname sudo chmod -R ug+rwx wikiname sudo chmod -R o-rwx wikiname }}} == Configure MoinMoin to Locate "wikiname" == Relevant MoinMoin config files are located in /etc/moin/ Edit /etc/moin/farmconfig.py, and after the line {{{"wikis = ["}}} add your "wikiname". For a single instance wiki, this would entail renaming the following line from: {{{ ("mywiki", r".*"), }}} to {{{ ("wikiname", r".*"), }}} Copy the /etc/moin/mywiki.py file to /etc/moin/wikiname.py: {{{ sudo cp /etc/moin/mywiki.py /etc/moin/wikiname.py }}} Edit the /etc/moin/wikiname.py and change all instances of mywiki to wikiname. In addition to this, change the data dir to point to your local installation of MoinMoin: {{{ data_dir = '/usr/share/moin/wikiname/data' }}} == Make apache ready for your wiki == Insert into {{{/etc/apache2/sites-available/default}}} (inside of the "{{{<VirtualHost *>}}}" tag) {{{ ### moin ScriptAlias /wikiname "/usr/share/moin/wikiname/moin.cgi" alias /wiki "/usr/share/moin/htdocs" alias /moin_static171 "/usr/share/moin/htdocs" <Directory /usr/share/moin/htdocs> Order allow,deny allow from all </Directory> ### end moin }}} Restart apache to apply your changes: {{{ sudo /etc/init.d/apache2 restart }}} == See if it works == Go to your wiki's homepage: http://127.0.0.1/wikiname Or try the test command: http://127.0.0.1/wikiname?action=test = Next Steps = == Security == You should probably set up MoinMoin:PasswordProtectedEditing and investigate other security stuff: MoinMoin:SecurityPolicy. = Troubleshootings = == Server Name warning == {{{ apache2: Could not reliably determine the server's fully qualified domain name, using 127.0.1.1 for ServerName }}} http://wiki.apache.org/httpd/CouldNotDetermineServerName?highlight=(ServerName) Solution: * Add in /etc/apache2/apache.conf the following: {{{ ServerName <hostname> }}} Where <hostname> is your actual host name, like www.google.com or IP like 89.234.12.45 == Permission denied == (13)Permission denied: make_sock: could not bind to address 0.0.0.0:80 no listening sockets available, shutting down http://wiki.apache.org/httpd/CouldNotDetermineServerName?highlight=(ServerName) Solution: |
Varies somewhat from the setup described on http://moinmoin.wikiwikiweb.de/ homepage,
Note: This guide has been adjusted to accommodate for a custom wiki name. If you spot an error, please fix it.
Contents
Steps to Install
Derived from http://www.ubuntuforums.org/showthread.php?t=206853
Install Required Packages
Required packages are as follows:
- python-moinmoin (Which should point to the proper python version)
- apache2 webserver
sudo apt-get install python-moinmoin sudo apt-get install apache2
Create a Wiki With "wikiname"
Create a wiki called "wikiname" and set the permissions.
cd /usr/share/moin sudo mkdir wikiname sudo cp -R data wikiname sudo cp -R underlay wikiname sudo cp server/moin.cgi wikiname sudo chown -R www-data.www-data wikiname sudo chmod -R ug+rwx wikiname sudo chmod -R o-rwx wikiname
Configure MoinMoin to Locate "wikiname"
Relevant MoinMoin config files are located in /etc/moin/
Edit /etc/moin/farmconfig.py, and after the line "wikis = [" add your "wikiname". For a single instance wiki, this would entail renaming the following line from:
("mywiki", r".*"),
to
("wikiname", r".*"),
Copy the /etc/moin/mywiki.py file to /etc/moin/wikiname.py:
sudo cp /etc/moin/mywiki.py /etc/moin/wikiname.py
Edit the /etc/moin/wikiname.py and change all instances of mywiki to wikiname. In addition to this, change the data dir to point to your local installation of MoinMoin:
data_dir = '/usr/share/moin/wikiname/data'
Make apache ready for your wiki
Insert into /etc/apache2/sites-available/default (inside of the "<VirtualHost *>" tag)
### moin ScriptAlias /wikiname "/usr/share/moin/wikiname/moin.cgi" alias /wiki "/usr/share/moin/htdocs" alias /moin_static171 "/usr/share/moin/htdocs" <Directory /usr/share/moin/htdocs> Order allow,deny allow from all </Directory> ### end moin
Restart apache to apply your changes:
sudo /etc/init.d/apache2 restart
See if it works
Go to your wiki's homepage:
http://127.0.0.1/wikiname Or try the test command:
http://127.0.0.1/wikiname?action=test
Next Steps
Security
You should probably set up PasswordProtectedEditing and investigate other security stuff: SecurityPolicy.
Troubleshootings
Server Name warning
apache2: Could not reliably determine the server's fully qualified domain name, using 127.0.1.1 for ServerName
Solution:
- Add in /etc/apache2/apache.conf the following:
ServerName <hostname>
Where <hostname> is your actual host name, like www.google.com or IP like 89.234.12.45
Permission denied
(13)Permission denied: make_sock: could not bind to address 0.0.0.0:80 no listening sockets available, shutting down
http://wiki.apache.org/httpd/CouldNotDetermineServerName?highlight=(ServerName)
Solution:
HelpOnInstallingMoinMoin (last edited 2011-02-23 04:54:11 by eth220-133)