Mix Installation (Sourcen für Linux)

From JonDonym Wiki
(Difference between revisions)
Jump to: navigation, search
(Zusätzliche Features freischalten)
Line 15: Line 15:
 
  <code>yum install postgresql postgresql-client libpq-devel</code>
 
  <code>yum install postgresql postgresql-client libpq-devel</code>
  
==== Kompilieren des Quellcodes ====
+
==== Auschecken des Quellcodes vom Repository ====
 
Als erstes ist die aktuelle Stable-Version vom Repository auszuchecken. Wir empfehlen, das Verzeichnis ''/home/mix'' zu nutzen.
 
Als erstes ist die aktuelle Stable-Version vom Repository auszuchecken. Wir empfehlen, das Verzeichnis ''/home/mix'' zu nutzen.
  
Line 22: Line 22:
 
  svn checkout https://svn.jondos.de/svn/proxytest/proxytest/branches/stable</code>
 
  svn checkout https://svn.jondos.de/svn/proxytest/proxytest/branches/stable</code>
  
 +
==== 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 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.
  
Line 42: Line 43:
 
  /etc/init.d/mix install</code>
 
  /etc/init.d/mix install</code>
  
 +
==== Kompilieren/Installieren mit make ====
 
Alternativ kann der Mix auch mit dem üblichen Dreisatz installiert werden.
 
Alternativ kann der Mix auch mit dem üblichen Dreisatz installiert werden.
  
Line 88: Line 90:
  
 
==== Start des Mix-Servers ====
 
==== Start des Mix-Servers ====
Es ist eine [[Mix-Server Konfiguration|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:
+
Es ist eine [[Mix-Server Konfiguration|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:
 +
 
 +
<code>/etc/init.d/mix start</code>
 +
 
 +
Alternativ kann der Mix-Server mit folgenden Kommandos gestartet werden:
  
 
  <code>ulimit -SHn 32768
 
  <code>ulimit -SHn 32768
Line 96: Line 102:
  
 
==== Update der Mix-Software ====
 
==== Update der Mix-Software ====
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, sind folgende Schritte nötig:
+
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:
 +
 
 +
<code>/etc/init.d/mix upgrade
 +
/etc/init.d/mix restart</code>
 +
 
 +
Alternativ sind folgende Schritte nötig:
  
 
  <code>cd /home/mix/stable
 
  <code>cd /home/mix/stable

Revision as of 16:00, 19 April 2010

File:En.png File:De.png  Hauptseite (de) | Installation der Mix-Server Software

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

cp /home/mix/stable/misc/Linux/rc-scripts/etc_default_mix /etc/default/mix
cp /home/mix/stable/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 der 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:

/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

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

Alternativ sind folgende Schritte nötig:

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