HelpOnInstallingMoinMoin

Differences between revisions 2 and 7 (spanning 5 versions)
⇤ ← Revision 2 as of 2006-07-12 21:43:32 →
Size: 407
Editor: taynzpxypro05
Comment:
← Revision 7 as of 2008-04-09 19:47:13 → ⇥
Size: 2396
Editor: 80
Comment:
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.

= 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"
<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.

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"
<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.

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