Installationsanleitung
Systemanforderungen
Bevor Sie den AGRIFUTURE Desktop Agent (DA) herunterladen, überprüfen Sie bitte die folgenden Systemanforderungen:
- Windows:
- Windows 10 oder höher
- aktiviertes WSL: learn.microsoft.com/de-de/windows/wsl/install
- macOs:
- macOS 11 oder höher
- docker: docs.docker.com/get-docker/
- netstat: wiki.ubuntuusers.de/netstat/
- Linux:
- docker: docs.docker.com/get-docker/
- netstat: wiki.ubuntuusers.de/netstat/
- xdg-open from xdg-utils: wiki.ubuntuusers.de/xdg-utils/
Download
Sie können den Desktop Agent unter https://github.com/SteveKnobloch/AGRIFUTURE_desktop_agent/releases/latest herunderladen.
Bitte wählen Sie unter "Assets" das entsprechende Paket:
- die “.deb” Datei für alle Debian-basierten Systeme (z.B. Linux Ubuntu, Mint usw.)
- die “.dmg” Datei für macOS
- die “.exe” Datei für Windows
- die “.zip” or “.tar.gz” Datei, wenn Sie den DA vom Source-Code installieren möchten (nicht empfohlen)
Installation
Linux (Debian-basiert)
Bei den meisten Distributionen können Sie die heruntergeladene Datei einfach öffnen und installieren, indem Sie den Anweisungen des Installers folgen. Anderfalls können Sie den DA auch manuell installieren: Öffnen Sie ein Terminal-Fenster, wechseln Sie in das Verzeichnis, in dem die heruntergeladene Datei liegt und führen Sie folgenden Befehl aus: sudo dpkg -i AgrifutureDesktopAgent.deb
macOS
Öffnen Sie einfach die dmg-Datei und verschieben Sie die App "AgrifutureDesktopAgent" in den Ordner "Programme". Beim ersten Öffnen wird macOS Ihnen mitteilen, dass es die App aus Sicherheitsgründen nicht öffnen kann. Ist dies der Fall, öffnen Sie den Ordner "Programme" im Finder, klicken Sie mit der rechten Maustaste auf die App und dann auf "Öffnen". Sie haben nun die Möglichkeit, die App zu öffnen. Es öffnet sich ein Terminal, in dem Sie aufgefordert werden, die Berechtigung für "bash" zu erteilen. Bitte bestätigen Sie dies.
Windows
Führen Sie die .exe-Datei aus. Möglicherweise wird Windows die Ausführung verhindern. Klicken Sie dann auf "Weitere Informationen" und dann auf "Trotzdem ausführen".
Geben Sie danach dem Installer bitte die Berechtigung, die Installation auszuführen. Nun öffnet sich das DA-Installationsprogramm. Sie können einen anderen Installationsordner wählen oder mit dem Standardordner fortfahren. Klicken Sie nun bitte auf "Install".
Ein Terminalfenster wird geöffnet. Bitte warten Sie, bis alle Prozesse abgeschlossen sind. Das Terminal-Fenster wird danach automatisch geschlossen. Das Installationsprogramm wird Sie auffordern, Ihren Computer neu zu starten, bitte bestätigen Sie dies.
Nach dem Neustart warten Sie bitte einen Moment, bis das Installationsprogramm erneut startet. Sie müssen dem Installer erlauben, sich erneut auszuführen. Bitte klicken Sie im Installationsprogramm erneut auf Installieren. Es öffnet sich eine Reihe von Terminalfenstern, die automatisch die Abhängigkeiten installieren. Dies kann ein paar Minuten dauern. Sie werden aufgefordert, den Computer neu zu starten. Bestätigen Sie dies.
Danach warten Sie bitte erneut, lassen das Installationsprogramm ausführen und klicken im Installationsprogramm auf Installieren. Ein weiteres Terminalfenster wird geöffnet. Bitte warten Sie, bis alle Prozesse abgeschlossen sind. Das Terminal wird nach Abschluss der Vorgänge automatisch geschlossen. Klicken Sie nun im Installationsprogramm auf Schließen. Sie haben nun alle erforderlichen Abhängigkeiten installiert.
Starten Sie die Anwendung "Docker Desktop" und navigieren Sie zu "Settings".
Gehen Sie zu "General" und aktivieren Sie die Optionen "Start Docker Desktop when you log in" und "Use the WSL 2 based engine" wie im Bild gezeigt.
Navigieren Sie dann zu "Ressourcen" → "WSL Integration" und aktivieren Sie die Option "Enable integration with my default WSL distro" und aktivieren Sie die Distro "Ubuntu". Sie können nun nach der App "AgrifutureDesktopAgent" suchen und diese öffnen.
Linux (vom Quelltext)
Zunächst müssen Sie alle Erwähnungen der Zeichenkette {{ ADA_VERSION }} in den folgenden Dateien durch die aktuelle Version ersetzen (zum Beispiel: 1.0.0)::
- src/launcher/agrifuture-desktop-agent.sh
- src/launcher/debian/AgrifutureDesktopAgent/agrifuture-desktop-agent.desktop
Anschließend müssen Sie die folgenden Dateien an den entsprechenden Stellen installieren:
- src/launcher/agrifuture-desktop-agent.sh in einem Ordner in $PATH. Üblicherweise wird /usr/local/bin verwendet. Stellen Sie sicher, dass die installierte Datei ausführbar ist.
- src/launcher/debian/AgrifutureDesktopAgent/agrifuture-desktop-agent.desktop in einem Ordner für Desktop-Einträge. Meist ist das $XDG_DATA_DIRS/applications. Ein typischer Pfad wäre /usr/local/share/applications.
- src/launcher/debian/AgrifutureDesktopAgent/agrifuture-desktop-agent.png in einen Ordner, an dem Symbole für Desktop-Symbole gespeichert werden, meist $XDG_DATA_DIRS/pixmaps. Ein Beispiel dafür wäre /usr/local/share/pixmaps.
Eine komplette Installation könnte folgendermaßen aussehen:
- export VERSION=1.0.0 # Bitte anpassen
- cd src/launcher
- sed -i "s/{{ ADA_VERSION }}/$VERSION/g" ./agrifuture-desktop-agent.sh
- sed -i "s/{{ ADA_VERSION }}/$VERSION/g" ./debian/AgrifutureDesktopAgent/agrifuture-desktop-agent.desktop
- sudo install -DT ./agrifuture-desktop-agent.sh /usr/local/bin/agrifuture-desktop-agent
- sudo install -Dm 644 -t /usr/share/applications ./debian/AgrifutureDesktopAgent/agrifuture-desktop-agent.desktop
- sudo install -Dm 644 -t /usr/share/pixmaps ./debian/AgrifutureDesktopAgent/agrifuture-desktop-agent.png