HelpOnInstallingMoinMoin

Differences between revisions 2 and 10 (spanning 8 versions)
⇤ ← Revision 2 as of 2006-07-12 21:43:32 →
Size: 407
Editor: taynzpxypro05
Comment:
← Revision 10 as of 2009-01-07 11:31:58 → ⇥
Size: 3166
Editor: mail
Comment: 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,
Line 3: Line 4:
Also note, all instances of the term "mywiki" should be updated to the wiki name you have chosen. This includes filenames! So, if your wiki instance is called "wiki1" then you should make changes to /etc/wiki1.py, NOT /etc/mywiki.py as the example shows. /!\ '''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,

Warning /!\ Note: This guide has been adjusted to accommodate for a custom wiki name. If you spot an error, please fix it.

Contents

  1. Steps to Install
    1. Install Required Packages
    2. Create a Wiki With "wikiname"
    3. Configure MoinMoin to Locate "wikiname"
    4. Make apache ready for your wiki
    5. See if it works
  2. Next Steps
    1. Security
  3. Troubleshootings
    1. Server Name warning
    2. Permission denied

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)