welcome: please sign in
location: Diff for "Cloud/Images/IFCA_MoinMoin_Appliance"
Differences between revisions 9 and 10
Revision 9 as of 2012-11-07 12:22:58
Size: 3768
Editor: enol
Comment:
Revision 10 as of 2017-07-04 11:10:47
Size: 0
Editor: aloga
Comment: Deprecated
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
= IFCA MoinMoin 1.9.3 Appliance =
Ubuntu Server 12.04 JeOS with MoinMoin 1.9.3 installed

== Details ==
 Name:: IFCA MoinMoin 1.9.3 Appliance
 Created:: 2012-10-16T13:27:04Z
 Updated:: 2012-10-16T13:28:59Z
 Status:: ACTIVE
 Supported by:: IFCA
 ID:: 9b8aaa86-5a40-4deb-89f9-793fb153f74a
 Minimum Disk:: 0
 Minimum Ram:: 0
 Architecture:: x86_64

== Description ==

This is an Ubuntu Server 12.04 with the MoinMoin 1.9.3 wiki engine installed.

MoinMoin is an advanced, easy to use and extensible WikiEngine with a large community of users. Said in a few words, it is about collaboration on easily editable web pages. MoinMoin is Free Software licensed under the GPL

This appliance includes:

 * MoinMoin configurations:
    * Installed from package management.
    * Wiki data maintained in `/usr/share/moin/data/`.
    * Enabled FCKeditor by default (ease of use).
    * Use Apache WSGI (performance).
 * Postfix MTA (bound to localhost) to allow sending of email (e.g., password recovery).

== Usage ==

Boot the machine, and browse to its IP address to configure it. Create a user named !WikiAdmin to administer your new wiki.

=== [Optional] Using a volume for storing wiki contents ===

Once the VM is deleted, the wiki contents will be lost if you do not copy them to a safe place. A way to avoid this and reuse the wiki contents after the VM is deleted is to use volumes for store these data. The volumes are persistent and can be attached to a running VM as a block device.

The [[Cloud/Usage#Permanent_Storage:_Volumes|manual]] contains more information on volumes, here we describe how to use this feature for storing the MoinMoin data:
 1. When you create the VM, be sure to specify a [[Cloud/Usage#Keypairs|keypair]] to be able to login into the machine.
 1. Create a new [[Cloud/Usage#Permanent_Storage:_Volumes|volume]] and attach it the running VM, do also create the filesystem once attached.
 1. Mount the volume at /srv (assuming /dev/xvdc is the attachment device):
{{{
sudo mount -t ext4 -o sync /dev/xvdc /srv
}}}
 1.#4 Stop the apache webserver
{{{
$ sudo service apache2 stop
 * Stopping web server apache2
 ... waiting . [ OK ]
}}}
 1.#5 Copy /usr/share/moin/data/ to /srv
{{{
$ sudo cp -a /usr/share/moin/data/ /srv/moin
}}}
 1.#6 Edit `/etc/moin/mywiki.py`, change `data_dir = '/usr/share/moin/data/'` to `data_dir = '/srv/moin'`
 1. Restart apache:
{{{
$ sudo service apache2 start
 * Starting web server apache2 [ OK ]

}}}

Before deleting the VM, be sure to umount the volume (`sudo umount /srv`). Once deleted, if you want to reuse the volume with the wiki contents in another VM you will need to perform these actions:
 1. When you create the VM, be sure to specify a [[Cloud/Usage#Keypairs|keypair]] to be able to login into the machine.
 1. Attach the volume you have created and contains the data to the VM.
 1. Mount the volume at /srv (`sudo mount -t ext4 -o sync /dev/xvdc /srv`)
 1. Stop apache (`sudo service apache2 stop`)
 1. Edit `/etc/moin/mywiki.py`, change `data_dir = '/usr/share/moin/data/'` to `data_dir = '/srv/moin'`
 1. Restart apache (`sudo service apache2 start`)

The new VM will now serve the wiki contents existing in the volume.


##=== FCKeditor ===
##FCKeditor is enabled by default. If required, it can be disabled like this:
##
##{{{
## sed -i "s|editor_force = False|editor_force = True|" /etc/moin/mywiki.py
## /etc/init.d/apache2 restart
##}}}
##

----
CategoryCloudAppliance