Portal:BOINC/Installation/Linux

BOINC Installation auf Linux

Grundsätzlich muss unterschieden werden zwischen einer manuellen Installation und einer aus dem Repository der jeweiligen Distribution. Während die manuelle Installation wie unten beschrieben auf allen Distributionen durchgeführt werden kann, sind bei der Installation aus den Repos der Distribution die entsprechenden Paketverwaltungstools zu nutzen. Grundsätzlich ist die Installation über die Paketverwaltung vorzuziehen. Derart installiert wird BOINC fortan automatisch gestartet, mit Sicherheitsupdates versorgt und läuft auch unterhalb eines eigenen Benutzers. Anwendungen der Projekte können also nicht auf die Daten des Users zugreifen.

openSUSE

Unter openSUSE (getestet mit Tumbleweed, Februar 2021) lässt sich BOINC mit zypper installieren.

 sudo zypper install boinc-manager boinc-client

Beide Pakete lassen sich auch unabhängig voneinander installieren, ein zusammenfassendes BOINC Metapaket gibt es nicht. Die BOINC-Binärdateien landen nun in /usr/bin/, die Konfigurationsdateien sowie veränderliche Dateien in /var/lib/boinc. Letzteres enthält damit auch sämtliche Daten der Projekte.

Anschließend noch den eigenen User der Gruppe BOINC hinzufügen, dann kann dieser auf die Passwortdatei des BOINC Clients zugreifen.

 sudo usermod -a boinc eigeneruser

Innerhalb der Desktopsitzung wird die Gruppenzugehörigkeit erst nach einem Logout/Login oder Reboot aktiv.

Nach erfolgter Installation lässt sich der Client über das Kommando service kontrollieren.

 sudo service boinc-client start
 sudo service boinc-client stop
 sudo service boinc-client restart

Auch dessen Status lässt sich abfragen.

 sudo service boinc-client status

Nun noch den Autostart von BOINC aktivieren, dann wird es mit dem System automatisch gestartet.

 sudo /sbin/chkconfig boinc-client on

Damit ist der openSUSE spezifische Teil der Installation abgeschlossen.

Debian

Unter Debian sind lediglich die Pakete boinc-client und boinc-manager zu installieren, welche sich bei Debian im main repository befinden.

Das funktioniert auf der Konsole mit dem Kommando

sudo apt install boinc-client boinc-manager

Natürlich können diese Pakete auch über den jeweils bevorzugten grafischen Paketmanager installiert werden. Das Programm apt ist jedoch auf jedem Debian mit Sicherheit verfügbar. Während der Installation wird automatisch der Benutzer boinc angelegt, mit dessen (eingeschränkten) Rechten das Programm zukünftig läuft. Start- und Stopskripte werden in den entsprechenden Runleveln abgelegt. Händische Starts, Neustarts und Stops des BOINC Clients erledigen die folgenden Kommandos:

sudo service boinc-client start
sudo service boinc-client restart
sudo service boinc-client stop

Die Konfigurationsdateien landen in /etc/boinc-client/, die BOINC-Binärdateien in /usr/bin/ sowie veränderliche Dateien in /var/lib/boinc-client/. Das letztgenannte Verzeichnis enthält damit sämtliche Daten der Projekte sowie die BOINC Logfiles.

Ubuntu, Mint und andere Derivate

Unter Ubuntu und dessen Derivate sind lediglich die Pakete boinc-client und boinc-manager zu installieren, welche sich bei Ubuntu im main repository befinden.

Das funktioniert auf der Konsole mit dem Kommando

sudo apt install boinc-client boinc-manager

Natürlich können diese Pakete auch über den jeweils bevorzugten grafischen Paketmanager installiert werden.

Während der Installation wird automatisch der Benutzer boinc angelegt, mit dessen (eingeschränkten) Rechten das Programm zukünftig läuft. Start- und Stopskripte werden in den entsprechenden Runleveln abgelegt. Händische Starts, Neustarts und Stops des BOINC Clients erledigt das folgende Kommando:

service boinc-client start
service boinc-client restart
service boinc-client stop

Die Konfigurationsdateien landen in /etc/boinc-client/, die BOINC-Binärdateien in /usr/bin/ sowie veränderliche Dateien in /var/lib/boinc-client/. Das letztgenannte Verzeichnis enthält damit sämtliche Daten der Projekte sowie die BOINC Logfiles.

Fedora

Installation für einen User

Bitte wie oben für die manuelle Installation beschrieben vorgehen.

Um BOINC automatisch mit der Anmeldung starten zu können, öffnet man im Menü System → Einstellungen → Persönlich → Sitzungen und fügt dort /home/username/BOINC/run_manager als neues Startprogramm hinzu.

Installation für alle User

Unter Fedora muss zunächst mittels dnf BOINC installiert werden.

sudo dnf install boinc-manager

Als nächstes fügt man den eigenen User der Gruppe boinc hinzu. Der entsprechende Dialog ist im Menü unter System → Administration → Benutzer und Gruppen zu finden. Nun muss die Datei /var/lib/boinc/gui_rpc_auth.cfg für diese Gruppe lesbar gemacht werden.

su root
chmod g+r /var/lib/boinc/gui_rpc_auth.cfg

Im eigenen Home-Verzeichnis legt man nun einen Link an. Sollte gui_rpc_auth.cfg nicht vorhanden sein muss der boinc-Service gestartet werden. Danach ist die Datei da.

ln /var/lib/boinc/gui_rpc_auth.cfg

Anschließend startet man den BOINC-Service neu.

/sbin/service boinc-client restart

Den BOINC-Manager startet man durch Aufruf von boincmgr im Home-Verzeichnis. Um BOINC als Service laufen zu lassen, ruft man system-config-service auf und aktiviert boinc_client. Alternativ kann man als root den folgenden Befehl ausführen.

/sbin/chkconfig --level 35 boinc-client on

Ob die Einstellungen richtig übernommen wurden kann man prüfen mit:

/sbin/chkconfig --list boinc-client

Falls es hier zu einer Fehlermeldung kommt:

ln -s /var/lib/boinc/gui_rpc_auth.cfg

Manuelle Installation

Der hier gezeigte Weg funktioniert mit allen Linux-Versionen. Auch wird am Beispiel vom QMC@home ein Projekt über die CLI hinzugefügt. Zum Anmelden des Boinc-Clienten beim QMC Projekt benötigt man folgende Dinge:

1. Die Adresse des QMC Projekts: https://qah.uni-muenster.de
2. Einen QMC Account mit einem Account-Key (Hexadezimalzahl mit 32 Stellen)

Ins Home-Verzeichnis wechseln

cd

Download des Boinc Clienten (Installationsdatei - Achtung, die Versionsnummer kann sich ändern)

wget https://boinc.berkeley.edu/dl/boinc_7.4.22_x86_64-pc-linux-gnu.sh
      

Ausführbar machen der Installationsdatei

chmod +x ./boinc_7.4.22_x86_64-pc-linux-gnu.sh

Installation starten (Unterverzeichnis "BOINC" wird angelegt und der Client hinein kopiert)

./boinc_7.4.22_x86_64-pc-linux-gnu.sh

Ausgabe: use /home/username/BOINC/run_manager to start BOINC

Hier müssen jetzt die Daten vom QMC Projekt und der persönliche Account-key angegeben werden.

cd BOINC
./boinc --attach_project https://qah.uni-muenster.de ecaePersönlicher-Account-Key6b0a

nachdem er sich beim Projekt angemeldet hat (einiger Output auf dem Bildschirm) CTRL+C drücken, um den Clienten zu beenden.

Der Client soll im Hintergrund laufen und seine Meldungen in die Datei "log.txt" schreiben

./boinc 2>&1 >log.txt &

Dann noch den Clienten anweisen, dass er ständig laufen soll und auch immer aufs Netzwerk zugreifen kann.

./boinc_cmd --set_run_mode always
./boinc_cmd --set_network_mode always

Mit

./boinc_cmd --get_project_status 

kann man sich den aktuellen Status des Clienten anzeigen lassen

Zum Beenden des Clienten

./boinc_cmd --quit