Mix Installation (Sourcen für Linux)

From JonDonym Wiki
(Difference between revisions)
Jump to: navigation, search
m
(Kompilieren/Installieren mit den rc-Scripten)
Line 25: Line 25:
  
 
==== Kompilieren/Installieren mit den rc-Scripten ====
 
==== Kompilieren/Installieren mit den rc-Scripten ====
Im Verzeichnis ''stable/misc/Linux/rc-scripts'' sind Maintenace Scripte vorhanden, welche die Installation und Wartung der Software vereinfachen. Als erstes sind diese Scripte an die vorgesehenen Stellen zu kopieren.
+
Im Unterverzeichnis ''misc/Linux/rc-scripts'' der Sourcen sind Maintenace Scripte vorhanden, welche die Installation und Wartung der Software vereinfachen. Als erstes sind diese Scripte an die vorgesehenen Stellen zu kopieren.
  
  <code>cp /home/mix/stable/misc/Linux/rc-scripts/etc_default_mix /etc/default/mix
+
  <code>cd /home/mix/stable
  cp /home/mix/stable/misc/Linux/rc-scripts/etc_init.d_mix.redhat /etc/init.d/mix</code>
+
cp misc/Linux/rc-scripts/etc_default_mix /etc/default/mix
 +
  cp misc/Linux/rc-scripts/etc_init.d_mix.redhat /etc/init.d/mix</code>
  
 
In der Parameter-Datei ''/etc/default/mix'' können einzelne Optionen an die lokale Installation angepasst werden. Außerdem sind die für den Mix passenden Compile-Optionen zu aktivieren. Es sind zwei Varianten vorbereitet: für Premium-Mixe und für kostenfreie Mixe.
 
In der Parameter-Datei ''/etc/default/mix'' können einzelne Optionen an die lokale Installation angepasst werden. Außerdem sind die für den Mix passenden Compile-Optionen zu aktivieren. Es sind zwei Varianten vorbereitet: für Premium-Mixe und für kostenfreie Mixe.
Line 44: Line 45:
 
  <code>/etc/init.d/mix compile
 
  <code>/etc/init.d/mix compile
 
  /etc/init.d/mix install</code>
 
  /etc/init.d/mix install</code>
 
  
 
==== Kompilieren/Installieren mit make ====
 
==== Kompilieren/Installieren mit make ====

Revision as of 14:52, 21 April 2010

File:En.png File:De.png  Hauptseite (de)

Contents

HowTo zur Installation der Mix-Server Software

Diese Anleitung beschreibt die Installation des Mixes und nötiger zusätzlicher Software für RedHat Linux. Für Debian and Ubuntu Server stellt die JonDos GmbH Pakete in ihrem Repository zur Verfügung, um die Installation zu vereinfachen. Siehe: Mix Installation (Debian und Ubuntu).

Die Software für den Mix-Server steht als Quellcode zur Verfügung.

Voraussetzungen

Um die Mix-Sourcen zu kompilieren, werden die Bibliotheken OpenSSL (mindestens v.0.9.7) und Xerces-C++ benötigt. Außerdem braucht man einen C++ compiler, make und subversion. Alles Nötige kann mit dem Paket-Management der Distribution installiert werden.

yum install g++ make libssl-devel libxerces-c2-devel subversion

Für Premium-Mixe werden zusätzlich ein PostgreSQL-Datenbank-Server, der passende Client und die C-Bibliotheken für PostgreSQL Clients benötigt.

yum install postgresql postgresql-client libpq-devel


Auschecken des Quellcodes vom Repository

Als erstes ist die aktuelle Stable-Version vom Repository auszuchecken. Wir empfehlen, das Verzeichnis /home/mix zu nutzen.

mkdir /home/mix
cd /home/mix
svn checkout https://svn.jondos.de/svn/proxytest/proxytest/branches/stable


Kompilieren/Installieren mit den rc-Scripten

Im Unterverzeichnis misc/Linux/rc-scripts der Sourcen sind Maintenace Scripte vorhanden, welche die Installation und Wartung der Software vereinfachen. Als erstes sind diese Scripte an die vorgesehenen Stellen zu kopieren.

cd /home/mix/stable
cp misc/Linux/rc-scripts/etc_default_mix /etc/default/mix
cp misc/Linux/rc-scripts/etc_init.d_mix.redhat /etc/init.d/mix

In der Parameter-Datei /etc/default/mix können einzelne Optionen an die lokale Installation angepasst werden. Außerdem sind die für den Mix passenden Compile-Optionen zu aktivieren. Es sind zwei Varianten vorbereitet: für Premium-Mixe und für kostenfreie Mixe.

SOURCE_PATH="/home/mix/"
# compile optins for free mixes
COMPILE_OPTIONS="--enable-new-flow-control --enable-new-channel-encryption --enable-server_monitoring"
MIXCONF="/etc/mix/config.xml"
MAXFILEDESCRIPTORS=32768

Danach ist die Software zu kompilieren und zu installieren:

/etc/init.d/mix compile
/etc/init.d/mix install

Kompilieren/Installieren mit make

Alternativ kann die Software des Mix auch mit dem üblichen Dreisatz installiert werden.

cd /home/mix/stable
./configure --enable-new-channel-encryption --enable-new-flow-control
make
make install


Zusätzliche Features freischalten

In Abhängigkeit von den benötigten Funktionen können oder müssen in den COMPILE_OPTIONS oder bei ./configure einige zusätzliche Features aktiviert werden

 ./configure --enable-new-channel-encryption --enable-new-flow-control --enable-payment .... ....

Für Premiumdienste ist folgendes Feature unbedingt nötig:

  • --enable-payment Payment-Support aktivieren.

Monitoring des Mixes:

  • --enable-server_monitoring Bei Aktivierung dieser Funktion stellt der Mix einen Monitoring Port bereit (üblicherweise Port 8080). Über diesen Port kann man XML-Daten abfragen, die Aukunft über den Status des Mixes und der Kaskade geben. Ein Plug-In zur Einbindung in Nagios findet man in den Sourcen im Verzeichnis misc/nagios.

Logging Features für besondere Situationen:

  • --enable-crime-detection Lawful Inspection freischalten. Die Parameter, welche Daten protokolliert werden sollen, können in der Mix-Konfiguration angegeben werden. Aktivieren sie dieses Feature nur, wenn sie durch autorisierte Behörden dazu gezwungen sind. Nur alle Mixe einer Kaskade gemeinsam können den Zusammenhang von aufgerufenem Dienst und Nutzer herstellen.
  • --enable-dataretentionlog Vorratsdatenspeicherung aktivieren. Aktivieren sie dieses Feature nur, wenn sie wirklich der Meinung sind, im Rahmen der Vorratsdatenspeicherung (VDS) loggen zu müssen. Die JonDos GmbH rät allen Betreibern, keine Daten im Rahmen der VDS zu erheben.

Weitere Features:

  • --enable-bandwidth-limitation Begrenzung der Bandbreite einer Kaskade, kann nur durch den letzten Mix einer Kaksade realisiert werden.


System User Account für den Mix Server anlegen

Es ist keine gute Idee, den Mix mit root-Rechten laufen zu lassen. Legen sie einen System User an, wir empfahlen den Naman mix. Dieser Account ist in der Mix-Konfiguration anzugeben. Der Mix-Server wird nach dem Start zu dieser UID wechseln.

Anlegen eines System User Accounts mit useradd:

adduser --quiet --system --disabled-password --shell=/bin/false --group mix


Verzeichnis für Logdaten anlegen

Das Verzeichnis der Logdaten und der Name der Logdateien kann in der Mix-Konfiguration angegeben werden. Auch die maximale Größe der Logdateien kann in der Konfiguration angegeben werden. Es ist keine zusätzliche Rotation der Logdateien nötig. Der Mix kümmert sich selbst darum.

Anlegen des Logverzeichnisses:

mkdir /var/log/mix
chown mix:adm /var/log/mix
chmod 0750 /var/log/mix


Start des Mix-Servers

Es ist eine Konfiguration für den Mix zu erstellen. Üblicherweise wird diese Konfiguration im Verzeichnis /etc/mix unter dem Namen config.xml gespeichert. Anschließend startet man den Mix-Server mit dem rc-Script. Wenn sie die Konfiguration in einem andren Verzeichnis abgelegt haben, passen sie bitte die Option MIXCONFIG in der Datei /etc/default/mix an.

/etc/init.d/mix start

Alternativ kann der Mix-Server mit folgenden Kommandos gestartet werden:

ulimit -SHn 32768
mix -c /etc/mix/config.xml

Nach dem Start wechselt der Mix zur UID, die in der Konfiguration angegeben wurde. In der Regel wird der Username mix verwendet.


Update der Mix-Software mit den rc-Scripten

Wie andere Software auch wird der Mix gelegentlich aktualisiert. Neue Features kommen hinzu, Bugs werden beseitigt. Updates werden auf der JonDos Operator Mailingliste angekündigt. Um die Software zu aktualisieren, kann man das rc-Script nutzen:

/etc/init.d/mix upgrade
/etc/init.d/mix restart


Update der Mix-Software per Hand

Alternativ sind folgende Schritte nötig, um die Software zu aktualisieren

cd /home/mix/stable
make distclean
svn update
./configure --enable-new-channel-encryption --enable-new-flow-control --enable-server_monitoring --enable-payment .... ....
make
make install

Danach kann der Mix neu gestartet werden.

Personal tools