TOC

So installieren Sie MoinMoin mit Nginx unter Ubuntu 14.04

Einführung

MoinMoin ist eine leistungsstarke Open-Source-Wiki-Engine, die in Python geschrieben ist. Es bietet ein funktionsreiches Wiki mit einer großen Benutzergemeinschaft, das sehr anpassbar und benutzerfreundlich ist. MoinMoin wird von mehreren Organisationen für ihre öffentlichen Wikis verwendet, darunter Ubuntu, Apache, FreeBSD und andere.

In diesem Tutorial zeigen wir Ihnen, wie Sie Ihr eigenes MoinMoin-Wiki auf einem neuen Ubuntu 14.04-Server einrichten und dabei Nginx als Webserver und uWSGI als Anwendungs-Engine verwenden. Dieses spezielle Setup ist für ein einzelnes Wiki vorgesehen und ist sehr schnell und speichereffizient.

Voraussetzungen

Bevor Sie mit diesem Handbuch beginnen, sollten Sie auf Ihrem Server ein separates Benutzerkonto einrichten, das kein Root-Konto ist. Weitere Informationen hierzu finden Sie in den Schritten 1-4 unter initial server setup for Ubuntu 14.04. .

In diesem Handbuch wird davon ausgegangen, dass Sie einen neuen Ubuntu 14.04-Server haben.

In diesem Tutorial wird "+ vi " zum Öffnen und Bearbeiten von Dateien verwendet. Wenn Sie einen anderen Editor bevorzugen, können Sie ihn gegebenenfalls anstelle von " vi +" verwenden.

Lass uns anfangen!

Installieren Sie uWSGI

Lassen Sie uns zunächst uWSGI installieren, das wir als Anwendungsserver verwenden.

Aktualisieren Sie zunächst Ihre Apt-Datenbank mit dem folgenden Befehl:

sudo apt-get update

Eine einfache Möglichkeit, uWSGI zu installieren, ist die Verwendung des Python-Paketmanagers "+ pip +". Installieren Sie jetzt Python-pip und die Python-Bibliotheken:

sudo apt-get install python-pip python-dev

Mit der installierten Pip können wir die neueste stabile Version von uWSGI mit dem folgenden Befehl installieren:

sudo pip install http://projects.unbit.it/downloads/uwsgi-lts.tar.gz

Wenn uWSGI erfolgreich installiert wurde, wird folgende Meldung angezeigt:

   ############## end of uWSGI configuration #############
   total build time: 36 seconds
   *** uWSGI is ready, launch it with /usr/local/bin/uwsgi ***

Successfully installed uWSGI
Cleaning up...

Nachdem der uWSGI-Anwendungsserver installiert ist, können Sie MoinMoin herunterladen und installieren.

Installieren Sie Moinmoin

Suchen Sie vor der Installation von MoinMoin hier nach der Version, die Sie installieren möchten: MoinMoin Releases. Sie werden wahrscheinlich die neueste allgemeine Version verwenden wollen.

Suchen Sie nach der neuesten allgemeinen Version von MoinMoin und kopieren Sie die URL in Ihre Zwischenablage:

Bild: https://assets.digitalocean.com/articles/moin/download.png [MoinMoin Download]

Die letzte verfügbare allgemeine Version, als dieses Tutorial geschrieben wurde, war 1.9.8, daher bezieht sich die Beispiel-URL auf die 1.9.8-Version. Verwenden Sie diesen Befehl + wget +, um das MoinMoin-Archiv in Ihr Ausgangsverzeichnis herunterzuladen (ersetzen Sie die von Ihnen kopierte Download-URL):

cd ~
wget

Extrahieren Sie nun das Archiv mit tar:

tar zxvf moin-1.9.8.tar.gz

Wechseln Sie in das Verzeichnis, das durch Extrahieren des MoinMoin-Archivs erstellt wurde:

cd moin-*

Führen Sie den folgenden Befehl aus, um die MoinMoin Python-Anwendung zu erstellen und nach "+ / usr / local +" zu kopieren:

sudo python setup.py install --prefix=/usr/local

Angenommen, Sie arbeiten mit Python 2.7, dann installiert das Python-Skript das MoinMoin-Codepaket unter + / usr / local / lib // dist-packages / + und die restlichen MoinMoin-Daten unter `+ / usr / local / share / moin + `.

Jetzt ist die MoinMoin-Python-Anwendung installiert, aber noch nicht konfiguriert. Lassen Sie es uns jetzt konfigurieren.

Konfigurieren Sie die MoinMoin-Anwendung

Vor dem eigentlichen Start der MoinMoin-Anwendung müssen die Konfigurationsdateien vorbereitet werden.

Wechseln Sie in das Installationsverzeichnis:

cd /usr/local/share/moin

Kopieren Sie dann die Beispiel-Serverkonfigurationsdatei "+ moin.wsgi +" in das aktuelle Verzeichnis:

sudo cp server/moin.wsgi .

Öffnen Sie die Serverkonfigurationsdatei zum Bearbeiten:

sudo vi moin.wsgi

Fügen Sie unter der Zeile + import sys, os + die folgenden Zeilen ein:

sys.path.insert(0, '/usr/local/lib/python2.7/dist-packages/')
sys.path.insert(0, '/usr/local/share/moin/')

Speichern und schließen. Dadurch wird die Anwendung mit dem Speicherort des MoinMoin-Codes und dem Speicherort der Wiki-Konfigurationsdateien konfiguriert.

Als nächstes erstellen und öffnen Sie + uwsgi.ini:

sudo vi uwsgi.ini

Fügen Sie die folgenden Zeilen in die Datei ein:

[uwsgi]
uid = www-data
gid = www-data
socket = /usr/local/share/moin/moin.sock
chmod-socket = 660
logto = /var/log/uwsgi/uwsgi.log

chdir = /usr/local/share/moin/
wsgi-file = moin.wsgi

master
workers = 3
max-requests = 200
harakiri = 30
die-on-term

Speichern und schließen. Die Datei "+ uwsgi.ini +" wird zum Laden der MoinMoin-Anwendung mit dem uWSGI-Anwendungsserver verwendet. Hier legen wir unter anderem die Benutzer-, Socket- und Serverkonfigurations- und Protokolldateien fest, die die Anwendung verwenden soll. Sie können die Anzahl der Mitarbeiter, die maximalen Anforderungen oder die zulässige Sitzungsdauer (harakiri) anpassen.

Erstellen Sie nun das Verzeichnis "+ / var / log / uwsgi +", in das die uWSGI-Anwendung ihre Protokolle schreibt:

sudo mkdir -p /var/log/uwsgi
sudo chown www-data /var/log/uwsgi

Als nächstes erstellen wir ein initctl-Skript, das zum Starten unserer MoinMoin-Anwendung verwendet wird. Dieses Skript aktiviert MoinMoin beim Serverstart und ermöglicht es Ihnen, die uWSGI-Anwendung mit + start moin + und + stop moin + zu steuern.

Erstelle und öffne + moin.conf + mit dem folgenden Befehl:

sudo vi /etc/init/moin.conf

Fügen Sie die folgenden Konfigurationszeilen ein:

description "moin uwsgi service"

start on runlevel [2345]
stop on runlevel [!2345]

chdir /usr/local/share/moin
exec /usr/local/bin/uwsgi /usr/local/share/moin/uwsgi.ini
respawn

Speichern und schließen. Es ist wichtig, dass die Pfade in den Zeilen "+ chdir " und " exec " genau wiedergeben, wo MoinMoin installiert wurde und wo die Dateien " uwsgi " binary und " uwsgi.ini +" vorhanden sind.

Sie können den Anwendungsserver jetzt starten (+ sudo start moin +), aber wir werden zuerst einige Änderungen an der Wiki-Konfiguration vornehmen.

Wiki konfigurieren

Nachdem der uWSGI-Anwendungsserver fertig ist, möchten wir das eigentliche Wiki konfigurieren.

Wechseln Sie in das MoinMoin-Installationsverzeichnis und kopieren Sie die Beispieldatei + wikiconfig.py +:

cd /usr/local/share/moin
sudo cp config/wikiconfig.py .

Öffnen Sie nun die Datei zum Bearbeiten:

sudo vi wikiconfig.py

Hier können wir verschiedene Aspekte des Wikis konfigurieren. Wir möchten mindestens die folgenden Elemente konfigurieren:

  • + sitename +: Der Titel Ihres Wikis

  • + page_front_page +: Kommentieren Sie diese Zeile aus, um eine normale Titelseite zu aktivieren

  • + superuser +: Der Name des Benutzers, den Sie als Administrator des Wikis verwenden möchten. Dieser Artikel muss auch nicht kommentiert werden

Suchen Sie die folgenden Zeilen (und kommentieren Sie sie gegebenenfalls aus, indem Sie das "+ # +" löschen), und ändern Sie die hervorgehobenen Werte nach Ihren Wünschen:

   sitename = u''

   page_front_page = u"FrontPage"

   superuser = [u"", ]

Speichern und schließen. Dies ist eine Python-Datei. Achten Sie daher darauf, bereits vorhandene Einrückungen beizubehalten.

Bevor Sie die Anwendung starten, ändern Sie den Besitz und die Berechtigungen der MoinMoin-Verzeichnisse:

sudo chown -R www-data: /usr/local/share/moin
sudo chmod -R o-rwx /usr/local/share/moin

Starten Sie den uWSGI-Anwendungsserver mit folgendem Befehl:

sudo start moin

MoinMoin läuft jetzt, aber wir müssen Configure Nginx, den Webserver, installieren, bevor Sie es verwenden können.

Installieren und konfigurieren Sie Nginx

Wir werden Nginx als unseren Webserver verwenden, also lassen Sie uns es jetzt installieren und konfigurieren.

Installieren Sie Nginx mit apt:

sudo apt-get install nginx

Wechseln Sie nun in das Verzeichnis "+ sites-available " und erstellen Sie eine neue Serverblock-Konfigurationsdatei für das Wiki. Wir werden uns " moin +" nennen:

cd /etc/nginx/sites-available
sudo vi moin

Fügen Sie in die Datei die folgenden Zeilen ein (ersetzen Sie die hervorgehobenen Teile durch Ihre eigenen Informationen):

server {
   server_name ;

   access_log /var/log/nginx/access.log;
   error_log /var/log/nginx/error.log;

   location / {
       include uwsgi_params;
       uwsgi_pass unix:///usr/local/share/moin/moin.sock;
       uwsgi_modifier1 30;
   }
}

Dies ist eine reine Nginx-Konfiguration. Sie können jederzeit Änderungen vornehmen, die Ihrer Meinung nach für Ihren Server geeignet sind.

Erstellen wir nun einen symbolischen Link zu unserer neuen Serverblock-Konfigurationsdatei im Verzeichnis "+ sites-enabled +":

cd /etc/nginx/sites-enabled
sudo ln -s ../sites-available/moin .

Und lösche den symbolischen Link zum + default + Serverblock:

sudo rm default

Jetzt ist der Serverblock "+ moin +" der Standard.

Starten Sie Nginx neu, um die neuen Einstellungen zu laden:

sudo service nginx restart

Dein neues Wiki ist online! Es ist unter der IP-Adresse oder dem Hostnamen Ihres Servers verfügbar.

Erstelle einen Wiki Superuser

Das Letzte, was Sie tun müssen, bevor Sie Ihr Wiki verwenden können, ist das Erstellen des Superuser-Kontos. Dieses Konto verfügt über Administratorrechte für das Blog. Wir haben den Namen dieses Benutzers im Feld "+ superuser " in der Datei " wikiconfig.py +" im Abschnitt "Wiki konfigurieren" dieses Tutorials konfiguriert. Stellen Sie daher sicher, dass Sie hier denselben Namen verwenden.

Stellen Sie in einem Webbrowser über die IP-Adresse oder den Hostnamen eine Verbindung zu Ihrem Server her: + http: // +

Sie werden auf der folgenden Startseite begrüßt:

Bild: https://assets.digitalocean.com/articles/moin/welcome.png [Startseite]

Klicken Sie oben auf der Seite auf den Link * Login *.

Bild: https://assets.digitalocean.com/articles/moin/login.png [Login]

Klicken Sie auf der Anmeldeseite auf den Link * Sie können jetzt einen erstellen *.

image: https://assets.digitalocean.com/articles/moin/create.png [Erstellen]

Geben Sie auf der Seite "Konto erstellen" den Namen ein, der Ihrer Superuser-Konfiguration entspricht (das verwendete Beispiel "WikiAdmin"), und geben Sie Ihr Kennwort und Ihre E-Mail-Adresse ein. Klicken Sie dann auf die Schaltfläche "Profil erstellen".

Wenn alles gut gegangen ist, sollten Sie die folgende Erfolgsmeldung sehen:

image: https://assets.digitalocean.com/articles/moin/created.png [Benutzer erstellt]

Das ist es! Ihr Wiki kann jetzt verwendet werden.

Fazit

Nachdem Sie Ihr MoinMoin-Wiki eingerichtet haben, können Sie es für die Zusammenarbeit verwenden. Sie können Inhalte und Benutzer hinzufügen oder deren Konfiguration und Themen ändern.

Related