HelpOnInstallingMoinMoin

Differences between revisions 3 and 4
Revision 3 as of 2006-10-27 06:09:03
Size: 2158
Editor: CPE001310050565-CM0014e8b55ec6
Comment: added steps. these should be grown to make better.
Revision 4 as of 2006-12-18 16:05:09
Size: 2354
Editor: d206-116-6-170
Comment: Corrected for change of wiki name.
Deletions are marked like this. Additions are marked like this.
Line 3: Line 3:
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. You must also replace some instances of mywiki with your wiki's name (wiki1). (Such as in /etc/moin/mywiki.py, /etc/moin/farmconfig.py, and /etc/apache2/sites-available/default. Some files/folders need to be renamed like /etc/moin/mywiki.py, /usr/share/moin/mywiki) /!\ '''Note:''' This guide has been adjusted to accommodate for a custom wiki name. If you spot an error, please fix it.
Line 8: Line 8:
== Get Software ==
Install MoinMoin and Apache2.
== Install Required Packages ==

Required packages are as follows:
 * python-moinmoin (Which should point to the proper python version)
 * apache2 webserver
Line 16: Line 19:
== Create your own wiki called mywiki ==
Create a wiki called mywiki and set the permissions.
== Create a Wiki With "wikiname" ==
Create a wiki called "wikiname" and set the permissions.
Line 21: Line 24:
sudo mkdir mywiki
sudo cp -R data mywiki
sudo cp -R underlay mywiki
sudo cp server/moin.cgi mywiki
sudo chown -R www-data.www-data mywiki
sudo chmod -R ug+rwx mywiki
sudo chmod -R o-rwx mywiki
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
Line 30: Line 33:
== Commission moin to find your new wiki ==
Insert into farmconfig.py, on a line after "wikis = ["
== 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:
Line 37: Line 42:

In mywiki.py change the data_dir line to
to
Line 41: Line 45:
data_dir = '/usr/share/moin/mywiki/data' ("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'
Line 50: Line 65:
ScriptAlias /mywiki "/usr/share/moin/mywiki/moin.cgi" ScriptAlias /wikiname "/usr/share/moin/wikiname/moin.cgi"

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 python2.4-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"
<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/mywiki

Or try the test command:

http://127.0.0.1/mywiki?action=test

Next Steps

Security

You should probably set up PasswordProtectedEditing and investigate other security stuff: SecurityPolicy.

HelpOnInstallingMoinMoin (last edited 2011-02-23 04:54:11 by eth220-133)