Conan Server Conan ist ein Paketmanager für die Sprachen C und C++. Es handelt sich dabei um ein kostenloses Werkzeug, das auf vielen Betriebssystemen lauffaehig ist und die Entwicklung von Software mit nachvollziehbaren Abhaengigkeiten zu vorkompilierten Binaerbibliotheken erlaubt, die in Form von Conan-Paketen gemeinsam mit den Rezepten zu deren Erstellung in einem lokalen Cache oder auf verteilen Servern abgelegt werden koennen. Conan unterschtuetzt eine Vielzahl an Build-Systemen und erlaubt die Entwicklung fuer die verschiedensten Zielsysteme. Die von den Conan-Entwicklern empfolene Plattform zur serverseitigen Ablage von Conan-Paketen ist "JFrog Artifactory for C/C++", eine kommer- zielle Server-Loesung, zu der es auch eine Community-Edition gibt. Diese kann man hier herunterladen: https://conan.io/downloads.html Neben Artifactory bringt das Conan-Projekt selbst ebenfalls einen Package-Server mit, der als Referenzimplementierung dient und hinsicht- lich der Funktionalitaet auf das Wesentliche reduziert ist. Dieser Server kann mit dem vorliegenden eisfair-Paket installiert, konfiguriert und betrieben werden. Sobald der Server gestartet wurde, kann man mit Hilfe des conan-Tools Pakete auf diesen uebertragen (upload), diesen nach Paketen durchsuchen (list/search) oder Abhaengigkeiten von diesem herunterladen (install). Ein Web-Interface besitzt der Server nicht (sondern lediglich eine REST API). Installation ------------ Das Conan-Server Paket wird ueber das Setup-Menue installiert. Im Fall eines Updates wird die Konfiguration der bereits installierten Paket- version automatisch uebernommen. Falls der Dienst vor einem Update bereits gestartet war, wird er automatisch gestoppt und im Anschluss an die Installation wieder gestartet. Nach Abschluss der Installation ist das Paketmenue ueber das Service- menue (Service administration) auffindbar. Konfiguration ------------- START_CONAN_SERVER Schaltet den Dienst frei. Sobald der Wert auf 'yes' gesetzt wird, wird conan-server beim Aktivieren der Konfiguration und bei jedem Neustart des Systems automatisch gestartet. Gueltige Werte: yes, no Beispiel: START_CONAN_SERVER='yes' CONAN_SERVER_DIR Es handelt sich hierbei um das Verzeichnis, in dem conan-server seine Daten ablegen soll. Standardwert: CONAN_SERVER_DIR='/srv/conan-server' CONAN_SERVER_PORT IPv4-Port auf dem der Server-Dienst Anfragen entgegennehmen soll. Standardwert: CONAN_SERVER_PORT='9300' CONAN_SERVER_HOSTNAME Dies ist der Host-Namen, der zur Bildung von URLs verwendet werden soll. Beispiel: CONAN_SERVER_HOSTNAME='myserver.local.net' CONAN_SERVER_AUTH_TIMEOUT Fuer die hier angegebene Zeitspanne in Sekunden haelt der Server eine Sitzung offen, bevor erneut eine Anmeldung notwendig ist. Beispiel: CONAN_SERVER_AUTH_TIMEOUT='1800' CONAN_SERVER_NUM_WORKERS Dies ist die Anzahl an Worker-Prozessen, die simultan Anfragen bearbeiten koennen. Ein sinnvoller Wert fuer diese Option haengt von der Menge der Anfragen ab, die der Server verarbeiten muss. Fuer ein lokales Heimnetzwerk liegt der Wert im niedrigen ein- stelligen Bereich. Beispiel: CONAN_SERVER_NUM_WORKERS='4' CONAN_SERVER_USER_N Aktuell unterstuetzt der conan-server lediglich eine Authen- tifizierung von Anwendern auf der Basis einer voreingestellten Liste. Der hier angegebene Wert gibt an, wie viele Benutzer angelegt werden sollen. CONAN_SERVER_USER_%_NAME Hier wird der Login-Name des Benutzers angegeben. Dieser Name wird neben der Anmeldung auch in den unten beschriebenen Berechtigungsregeln (ACLs) verwendet. Beispiel: CONAN_SERVER_USER_1_NAME='mustermann' CONAN_SERVER_USER_%_PASSWD Hier wird das zum Login-Namen passende Kennwort angegeben. Aktuell kann der Anwender sein Kennwort nicht eigenstaendig abaendern. CONAN_SERVER_RD_ACL_N Ueber diese Liste koennen Leseberechtigungen auf Teilbereiche oder auf den gesamten Datenbestand des Servers vergeben werden. Hier wird die Anzahl an Regeln festgelegt, die angelegt werden sollen. Die Vergabe von Berechtigungen erfolgt auf der Basis der Paketre- ferenzen, die nach dem Schema: 'package/version@owner/channel' auf- gebaut sind. Die Regeln werden der Reihe nach abgearbeitet. Sobald die Suchmaske bestehend aus 'NAME', 'VER', 'OWNER', 'CHAN' zutrifft, wird die Suche abgebrochen und die gefundene Regel an- gewendet. CONAN_SERVER_RD_ACL_%_NAME Mit diesem Feld 'NAME' wird der Paketnamen selektriert, der fuer diese Regel gelten soll. Soll die Regel auf alle Paketnamen zu- treffen, kann der Wildcard '*' verwendet werden. CONAN_SERVER_RD_ACL_%_VER Mit diesem Feld 'VER' wird die Paketversion selektriert, die fuer diese Regel gelten soll. Soll die Regel auf alle Paketversionen zu- treffen, kann der Wildcard '*' verwendet werden. CONAN_SERVER_RD_ACL_%_OWNER Mit diesem Feld 'OWNER' wird die Domaene bzw. die Organisation selektriert, die fuer diese Regel gelten soll. Soll die Regel auf alle Organisationen zutreffen, kann der Wildcard '*' verwendet werden. CONAN_SERVER_RD_ACL_%_CHAN Mit diesem Feld 'CHAN' wird der Kanal selektriert, der fuer diese Regel gelten soll. Soll die Regel auf alle Kanaele zu- treffen, kann der Wildcard '*' verwendet werden. CONAN_SERVER_RD_ACL_%_USERS Hier wird die Liste der Anwender angegeben, fuer die Leseberechti- gungen vergeben werden sollen, falls die mit NAME, VER, OWNER, CHAN vorgenommene Auswahl zutrifft. Um alle Anwender zugleich zu se- lektieren, kann der Wildcard '*' verwendet werden. CONAN_SERVER_WR_ACL_N Ueber diese Liste koennen Schreibberechtigungen auf Teilbereiche oder auf den gesamten Datenbestand des Servers vergeben werden. Hier wird die Anzahl an Regeln festgelegt, die angelegt werden sollen. Die Vergabe von Berechtigungen erfolgt auf der Basis der Paketre- ferenzen, die nach dem Schema: 'package/version@user/channel' auf- gebaut sind. Die Regeln werden der Reihe nach abgearbeitet. Sobald die Suchmaske bestehend aus 'NAME', 'VER', 'USER', 'CHAN' zutrifft, wird die Suche abgebrochen und die gefundene Regel an- gewendet. CONAN_SERVER_WR_ACL_%_NAME Mit diesem Feld 'NAME' wird der Paketnamen selektriert, der fuer diese Regel gelten soll. Soll die Regel auf alle Paketnamen zu- treffen, kann der Wildcard '*' verwendet werden. CONAN_SERVER_WR_ACL_%_VER Mit diesem Feld 'VER' wird die Paketversion selektriert, die fuer diese Regel gelten soll. Soll die Regel auf alle Paketversionen zu- treffen, kann der Wildcard '*' verwendet werden. CONAN_SERVER_WR_ACL_%_OWNER Mit diesem Feld 'OWNER' wird die Domaene bzw. die Organisation selektriert, die fuer diese Regel gelten soll. Soll die Regel auf alle Organisationen zutreffen, kann der Wildcard '*' verwendet werden. CONAN_SERVER_WR_ACL_%_CHAN Mit diesem Feld 'CHAN' wird der Kanal selektriert, der fuer diese Regel gelten soll. Soll die Regel auf alle Kanaele zu- treffen, kann der Wildcard '*' verwendet werden. CONAN_SERVER_WR_ACL_%_USERS Hier wird die Liste der Anwender angegeben, fuer die Schreibberech- tigungen vergeben werden sollen, falls die mit NAME, VER, OWNER, CHAN vorgenommene Auswahl zutrifft. Um alle Anwender zugleich zu selektieren, kann der Wildcard '*' verwendet werden. Das Paketmenue ---------------- Conan server administration --------------------------- * View documentation Dokumentation zum Paket conan-server auf eisfair anzeigen. * Edit configuration Konfiguration des Servers ueber die eisfair-Konfigurationsebene bearbeiten. * Advanced configuration file handling Versionsverwaltung der Konfiguration des Servers. * Show status Den aktuellen Status des Servers anzeigen. * Stop service Den Server-Dienst manuell stoppen. * Start service Den Server-Dienst manuell starten.