NetVision-Technik - IPCop-Kompilierungs-Howto

Kleine Anmerkung: Ich bediene mich des Wortes kompilieren als Übersetzung für "build", weils am ehesten Sinn macht, bauen klingt seltsam^ ^

IPCop kompilieren

Es gibt einige Unterschiede zwischen der aktuellen IPCop-Version (v1.4.x) und der nächsten Hauptversion (v2).

Der v1.4-Code liegt in einem CVS
Der v2-Code liegt in einem SVN

Die Ordnerstruktur der V2 ist anders aufgebaut (build, log etc.), um das Kompilieren auf verschiedenen Systemen zu vereinfachen.

Kompilieren des aktuellen und stabilen IPCop v1.4.x
Den IPCop-Code laden
Der Sourcecode für IPCop kann auf zwei Arten geladen werden.

Manueller Download aus dem Source-tgz , der mit jeder Version geliefert wird.
Direktzugriff auf das CVS-Repository

Beispiel anhand v1.4.18 (ipcop-1.4.18-sources.tgz package):

Extrahieren:

Code:

tar xvfz ipcop-1.4.18-sources.tgz

Zum Kompilieren sind Root-Rechte erforderlich. Diese erhält man - sofern man noch nicht root ist - durch das Öffnen eines Terminals und das Eingeben von:

Code:

su - root

gefolgt vom root-Passwort.

Wechseln zum IPCop-Ordner:

Code:

cd ipcop

Ausführen des Kommandos ls sollte verschiedene Ordner (zB doc, config, src usw.) anzeigen.
Die Datei make.sh muss ausführbar gemacht werden:

Code:

chmod 755 make.sh

make.sh lässt sich jetzt ausführen, um verschieden Aufgaben zu erledigen.

Andere Sourcen laden

IPCop benötigt viele andere source packages zum kompilieren. Diese werden aus dem Internet geladen und in einem Cache-Ordner gespeichert werden (Geschieht nur einmal).
Es wird empfohlen alle benötigten Dateien vor dem Kompilieren zu laden, da es sonst zu Fehlern/und oder Abbrüchen während des Kompilierens kommen kann.
Auch hier gibt es wieder zwei Möglichkeiten:

Seit v1.4.12 können alle benötigten Files in einem großen (255MB) package von Sourceforge geladen werden

Code:

./make.sh getothersrc

Die einzelnen source packages von ihren jeweiligen Seiten laden

Code:

./make.sh prefetch

Normalerweise ist der erste Befehl schneller (da die Mirror von Sourceforge generell hohen Speed ermöglichen, während die verschiedenen Source-Seiten unterschiedlichen Speed ermöglichen), außerdem kann man sich sicher sein, dass alle benötigten packages geladen werden. Beim zweiten Befehl besteht die Möglichkeit, dass Dateien verschoben wurden und nicht unter der verwendeten URL gefunden werden können. In diesem Falle gibt make.sh einen Fehler aus. Eine Google-Suche oder ein Blick auf http://ipcop.ath.cx können dann hilfreich sein.

./make.sh prefetch kann empfehlenswert sein, wenn man mit einem CVS-Zweig arbeitet, da das othersrc-package vor jedem größeren Versionrelease hochgeladen wird und bereits für das nächste größere Release hinzugefügte Dateien nicht im othersrc-package enthalten sein können.

Erforderliche Binaries
make.sh führt beim Kompilieren einige Befehle aus, die auf dem System verfügbar sein müssen. Die Verfügbarkeit sichert man normalerweise durch das Installieren einer Entwicklungsumgebung. Informationen für das Installieren der Entwicklungsumgebung könnt ihr den Hilfeseiten eures Systems entnehmen.

Es gibt auch die Möglichkeit eine prekompilierte toolchain zu verwenden, wenn das System nicht fähig ist, diesen ersten Schritt des Kompilierens zu machen.
Die prekompilierte toolchain erhält man mit:

Code:

./make.sh gettoolchain

Für v1.4.x von IPCop hängt das geladene toolchain-package von der CPU ab. Toolchain-packages sind verfügbar für i586 und i686 sowie alpha und powerpc.

Andere häufig verwendete make.sh Befehle

Code:

./make.sh

gibt eine Erklärung der verfügbaren Befehle aus.

Die eigentliche Kompilierung startet man mit:

Code:

./make.sh build

Eine erneute, saubere Kompilierung nach einigen Änderungen macht man mit:

Code:

./make.sh clean ./make.sh build

Kompilieren des experimentellen IPCop v2
Folgt demnächst ;)

Alle Angaben ohne Gewähr, mein Englisch ist nicht perfekt, demnach kann die Übersetzung Fehler enthalten. Die Übersetzung ist nicht 100% komplett, da ich mir erlaubt habe Sachen wie den selektive Rebuild nach kleineren Changes (Weil mMn fortgeschrittenes Zeugs und als Fortgeschrittener sollte man genug englisch können) und die Fehlermeldung der ersten Versionen wegzulassen.
Quellen:
Übergeordnete Info
v1.4.x
v2