Download und Installation
Downloads

Es stehen hochoptimierte Installationspakete für 32/64 Bit Raspberry Pi OS Bullseye/Bookworm/Trixie mit Release-Versionen und regelmäßigen Builds der Entwicklungs-Version zur Verfügung. Falls Sie SCSI2Pi für andere Linux-Distributionen wie Ubuntu oder Manjaro benötigen, compilieren Sie die Sourcen.

Installation/Update

SCSI2Pi ist in Sekundenschnelle installiert oder aktualisiert. Installieren Sie einfach das Debian-Binärpaket für Ihren Pi:

>sudo apt install ./scsi2pi_RELEASE_ARCH.deb

Eine Warnung wie "Download is performed unsandboxed as root" kann ignoriert werden.

Nach der Erstinstallation sollte man die Einstellungen in /etc/s2p.conf anpassen, z. B. den Standard-Pfad für Laufwerks-Images.
Bei der Installation wird ein eventuell vorhandener PiSCSI-Systemservice deaktiviert. Stattdessen wird der SCSI2Pi-Systemservice eingerichtet, aber per Default nicht automatisch gestartet. Beachten Sie, dass der PiSCSI- und der SCSI2Pi-Systemservice nicht gleichzeitig laufen können. Sie können jederzeit zwischen diesen Services umschalten.
Der Standard-Installationspfad der SCSI2Pi-Binaries und -Manpages ist /opt/scsi2pi. Sie sollten diese Pfade in Ihr Environment aufnehmen, z. B. in .profile oder .bash_profile:

export PATH=/opt/scsi2pi/bin:$PATH
export MANPATH=/opt/scsi2pi/man:$MANPATH

Die mit dem Debian-Paket installierten SCSI2Pi-Binaries lassen sich ohne Root-Rechte starten.

Deinstallation

Deinstalliert wird SCSI2Pi mit:

>sudo apt remove scsi2pi

Downgrade

Sollte ein Downgrade erforderlich sein, kann eine ältere Version wie folgt installiert werden:

>sudo apt --reinstall install ./scsi2pi_RELEASE_ARCH.deb

Bitte öffnen Sie ein GitHub-Ticket, falls wegen eines Bugs in einem neuen Release ein Downgrade erforderlich ist.

Verwalten von SCSI2Pi mit der PiSCSI-Weboberfläche

SCSI2Pi ist kompatibel zur PiSCSI-Weboberfläche, die man vor oder nach der Installation von SCSI2Pi installieren kann. Leider kommt die Weboberfläche nicht mit unbekannten Gerätetypen klar, obwohl dies grundsätzlich möglich wäre. Daher lassen sich mit SCSI2Pi Gerätetypen in der von der Weboberfläche genutzten API abschalten. Starten Sie hierzu s2p mit -w SCSG,SCTP oder tragen Sie in /etc/s2p.conf folgendes ein:

without_types=SCSG

Diese Einstellung wirkt sich auch auf die SCSI-Control-App aus, so dass sich diese Gerätetypen nicht mehr mit der App anlegen lassen. Die eigentliche s2p-Funktionalität bleibt jedoch unverändert.

Verwalten von SCSI2Pi ohne die PiSCSI-Weboberfläche

SCSI2Pi lässt sich auch ohne Weboberfläche verwalten. Dies geschieht mit dem s2pctl-Tool (Details liefert die Manpage) und/oder mit der SCSI-Control-App.

Compilieren der Quelltexte

Man kann SCSI2Pi auch selber compilieren, z. B. ohne nicht benötigte Gerätetypen für noch kompaktere Binaries. Das SCSI2Pi-Wiki liefert weitere Informationen.

Schnellstart
  1. Laden Sie das SCSI2Pi-Debian-Paket für Ihren Pi herunter und installieren Sie es mit sudo apt install ./scsi2pi_RELEASE_ARCH.deb.
  2. Starten Sie entweder den Systemservice mit sudo systemctl start s2p, oder starten Sie s2p manuell mit /opt/scsi2pi/bin/s2p.
  3. Legen Sie Geräte an mit der PiSCSI-Weboberfläche, der SCSI-Control-App, s2pctl oder mit Properties in der Konfigurationsdatei /etc/s2p.conf (für eine dauerhafte Konfiguration).
  4. Beachten Sie, dass nach dem Editieren von /etc/s2p.conf ein Neustart von s2p erforderlich ist.