[OracleOSS] [TitleIndex] [WordIndex]

HelpOnInstalling/ApacheOnMacOsx

You must not be afraid to use the terminal. It is possible but much harder to install without using the terminal.

There are 2 step in the installation:

  1. Install the MoinMoin engine - once

  2. Create wiki instance. You can create and serve as many wikis as you like.

1. Installing MoinMoin

1.1. Download

Download the source on the Desktop. You should see a moin-1.3.tar.gz file. Extract this file on the desktop with Stuffit Expander, or from the terminal (faster and safer):

cd ~/Desktop
tar -xzf moin-1.3.0.tar.gz

1.2. Install procedure

Use these commands in the terminal to install the MoinMoin wiki engine into the system.

First, open a shell as root. You will need this to install MoinMoin and configure the wiki. When asked, enter your password.

sudo -s
... password:

Now you have root privileges in this shell.

Install:

cd moin-1.3.0
python setup.py install --install-data='/usr/local'

Now the installation is finished. You will not have to repeat this step unless you upgrade moin.

1.3. Optional Installs

1.3.1. RSS

If you want your wiki to support RSS and Mozilla Firefox Live Bookmarks features, you have to install PyXML. Get PyXML from http://sourceforge.net/projects/pyxml/ and install according to the instructions.

2. Creating a wiki

After you have installed the software, you need to create a wiki. You may create several wikis if you need.

2.1. Copying a template wiki

Copy a template wiki from the /usr/local/share/moin. Do not try to run the wiki from /usr/local/share/moin/data because your wiki will be overwritten when you install a new version of moin.

The following instructions will create a wiki called "mywiki". You can choose any name you like, except the reserved name "wiki".

Do these commands:

cd /usr/local/share/moin
mkdir mywiki
cp -r data mywiki
cp -r underlay mywiki
cp server/moin.cgi mywiki
cp config/wikiconfig.py mywiki

2.2. Setting Permissions

You have to make the web server the owner of the files in your wiki. Unless you changed the default configuration, both are 'www'.

chown -R www:www mywiki
chmod -R ug+rwX mywiki
chmod -R o-rwx mywiki

2.3. Configure Apache

We'll use the pico editor:

pico /etc/httpd/httpd.conf

Go to the end of the Aliases section and edit like the example below:

    Alias /wiki/ "/usr/local/share/moin/htdocs/"      
    ScriptAlias /mywiki "/usr/local/share/moin/mywiki/moin.cgi"       

Use Control+O to save the file and Control+X to exit pico.

Restart Apache - open System Preferences, go to the Sharing page, select "Personal Web Sharing" and click "Stop" then "Start". Or just type this instead:

apachectl graceful
... /usr/sbin/apachectl graceful: httpd gracefully restarted

Instance creation finished - exit from the shell with the root privileges - working as root is dangerous.

exit

Now you are running again safely.

2.4. Testing Your New Wiki

In a web-browser surf to the site: http://localhost/mywiki

You should see the FrontPage of your new wiki.

Now run the unit tests, to make sure everything is fine. Go to this address: http://localhost/mywiki?action=test

You should see a report on the wiki and tests results for the MoinMoin engine. If some of the tests fail, please report the problem on MoinMoinBugs.

2.5. Configuring Your wiki

The wiki you created is a new "Untitled Wiki", using the default configuration. You want to give a better name and setup some configuration values. Open wikiconfig.py and read the comments. You can edit the file with any text editor, like pico, emacs, or BBEdit.

For more help on configuration, see HelpOnConfiguration.


2011-12-23 01:01