HelpOnInstallingMoinMoin

Differences between revisions 1 and 11 (spanning 10 versions)
Revision 1 as of 2006-07-12 21:38:46
Size: 147
Editor: taynzpxypro05
Comment:
Revision 11 as of 2011-02-23 04:54:11
Size: 3257
Editor: eth220-133
Comment: help with css. soz about the formatting
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
}}}

(Note: /moin_static171 will probably have to be changed to your current version number)

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.

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

(Note: /moin_static171 will probably have to be changed to your current version number)

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)