Server Agent via STACKIT Portal installieren

Um unsere neuesten Funktionen wie STACKIT Run Command STACKIT Server Update Management und viele weitere zukünftige Funktionen nutzen zu können, muss der STACKIT Server Agent als Basis auf Ihrem Server installiert werden. Er dient als Schnittstelle zwischen unserer Infrastruktur und dem Betriebssystem empfängt und verarbeitet remote gesendete Skripte und führt diese lokal auf Ihrem Server aus, sodass Sie Ihren Server nach Bedarf konfigurieren können.

Die folgende Dokumentation beschreibt zwei Wege, um Ihren Server vollständig mit der neuesten verfügbaren Version des STACKIT Server Agent zu konfigurieren. Sie können entweder im STACKIT Portal einen neuen Server einrichten, der den STACKIT Server Agent beim ersten Boot automatisch bereitstellt (deployt), oder, falls Sie bereits einen laufenden Linux– oder Windows Server besitzen, ein Skript manuell ausführen, das den STACKIT Server Agent herunterlädt und installiert.

Wenn Sie es vorziehen, Ihr System zu konfigurieren und die Funktion STACKIT Run Command per API zu verwalten lesen Sie bitte diese Dokumentation: Server Agent über API installieren.

STACKIT Server Agent über das STACKIT Portal während der Deployment des Servers installieren

1. Überprüfen Sie anhand der Tabelle, ob Ihr Betriebssystem eine automatisierte Installation des STACKIT Server Agent über das STACKIT Portal beim ersten Boot unterstützt.

   Image	Installation über API	Installation über STACKIT Portal
   Windows Server 2016	✅	✅
   Windows Server 2019	✅	✅
   Windows Server 2022	✅	✅
   Windows Server 2025	✅	✅
   RHEL	✅	✅
   CentOS	✅	✅
   Ubuntu	✅	✅
   Fedora	✅	✅
   Rocky Linux	✅	✅
   AlmaLinux	✅	✅
   Debian	✅	✅ (Noch nicht in Debian 11 unterstützt)

   Falls nicht, verwenden Sie die API: Server Agent über API installieren Alternativ können Sie den Agent manuell installieren, sobald der Server eingerichtet ist und läuft (siehe unten).

2. Gehen Sie während der Erstellung des Servers zur Registerkarte Server erstellen und wählen Sie STACKIT Server Agent bereitstellen aus.

3. Schließen Sie den Server-Bestellvorgang ab.

   Der STACKIT Server Agent wird dann während der anfänglichen Konfiguration beim ersten Boot installiert. Sobald der Server seine Deployment-Konfigurationsroutinen abgeschlossen hat, ist er bereit zur Nutzung und kann zur Ausführung von Befehlen verwendet werden.

Beispiel des STACKIT Server Agent auf einem Windows Server 2022:

STACKIT Server Agent auf einem vorhandenen Server (Linux) installieren

Wichtig: Um den STACKIT Server Agent zu installieren, benötigen Sie Administrative (Superuser)-Berechtigungen!

1. Melden Sie sich remote auf Ihrem Server an. Verwenden Sie eine Methode die eine Zwischenablage-Funktionalität beinhaltet, z. B. Remote Desktop Connection.

2. Öffnen Sie eine Shell.

3. Optional: Signatur verifizieren Sie können die GPG-Signatur des STACKIT Server Agent-Pakets mit den folgenden Skripten verifizieren:

   • Linux, RPM-basiert (Fedora, RedHat) Source file: RPM (Fedora/RedHat based)

   #!/bin/bash
   
   #Download GPG public key
   curl [https://stackit-server-agent.object.storage.eu01.onstackit.cloud/stackit-server-agent.gpg](https://stackit-server-agent.object.storage.eu01.onstackit.cloud/stackit-server-agent.gpg) -o /tmp/stackit-server-agent.gpg
   ### Install dependencies
   
   yum install gnupg -y
   
   ### Import GPG Public key
   gpg --import /tmp/stackit-server-agent.gpg
   
   ### Download STACKIT Server Agent
   curl [http://169.254.169.254/stackit/v1/server-agent/amd64/rpm](http://169.254.169.254/stackit/v1/server-agent/amd64/rpm) -o /tmp/stackit-server-agent.rpm
   
   ### Download the package signature file
   curl [https://stackit-server-agent.object.storage.eu01.onstackit.cloud/stackit-server-agent.rpm.sig](https://stackit-server-agent.object.storage.eu01.onstackit.cloud/stackit-server-agent.rpm.sig) -o /tmp/stackit-server-agent.rpm.sig
   
   if gpg --verify /tmp/stackit-server-agent.rpm.sig /tmp/stackit-server-agent.rpm
   then
   echo "The STACKIT Server Agent is verified successfully"
   else
   echo "The STACKIT Server Agent is not verified successfully"
   rm -rf /tmp/stackit-server-agent.gpg /tmp/stackit-server-agent.rpm.sig /tmp/stackit-server-agent.rpm
   
   exit 1
   fi
   
   rm -rf /tmp/stackit-server-agent.gpg /tmp/stackit-server-agent.rpm.sig

   • Linux, DEB-based (Debian, Ubuntu)
     Source file: DEB (Debian based)

   #!/bin/bash
   
   #Download GPG public key
   curl https://stackit-server-agent.object.storage.eu01.onstackit.cloud/stackit-server-agent.gpg -o /tmp/stackit-server-agent.gpg
   
   ### Install dependencies
   
   apt-get update && apt-get install gnupg -y
   
   ### Import GPG Public key
   gpg --import /tmp/stackit-server-agent.gpg
   
   ### Download STACKIT Server Agent
   curl http://169.254.169.254/stackit/v1/server-agent/amd64/deb -o /tmp/stackit-server-agent.deb
   
   ### Download the package signature file
   curl https://stackit-server-agent.object.storage.eu01.onstackit.cloud/stackit-server-agent.deb.sig -o /tmp/stackit-server-agent.deb.sig
   
   if gpg --verify /tmp/stackit-server-agent.deb.sig /tmp/stackit-server-agent.deb
   then
   echo "The STACKIT Server Agent is verified successfully"
   else
   echo "The STACKIT Server Agent is not verified successfully"
   rm -rf /tmp/stackit-server-agent.deb /tmp/stackit-server-agent.deb.sig /tmp/stackit-server-agent.gpg
   exit 1
   fi
   
   rm -rf /tmp/stackit-server-agent.gpg /tmp/stackit-server-agent.deb.sig

   Sobald das Paket erfolgreich verifiziert wurde, können Sie es installieren, indem Sie ausführen:

   Source file: RPM (Fedora/RedHat based)

   yum localinstall /tmp/stackit-server-agent.rpm -y

   oder
   Source file: DEB (Debian based)

   dpkg -i /tmp/stackit-server-agent.deb

4. STACKIT Server Agent herunterladen und installieren (ohne GPG-Verifizierung) Kopieren Sie das Skript in die Shell und führen Sie es aus:

   • Linux, RPM-based (Fedora, RedHat)
     Source file: RPM (Fedora/RedHat based)

   #!/bin/bash
   
   ### Download STACKIT Server Agent
   curl http://169.254.169.254/stackit/v1/server-agent/amd64/rpm -o /tmp/stackit-server-agent.rpm
   
   ### Install the Agent
   yum localinstall /tmp/stackit-server-agent.rpm -y
   
   ### Cleaning up
   rm -rf /tmp/stackit-server-agent.rpm

   • Linux, DEB-based (Debian, Ubuntu)
     Source file: DEB (Debian based)

   #!/bin/bash
   
   ### Download STACKIT Server Agent
   curl http://169.254.169.254/stackit/v1/server-agent/amd64/deb -o /tmp/stackit-server-agent.deb
   
   ### Install the Agent
   dpkg -i /tmp/stackit-server-agent.deb
   
   ### Cleaning up
   rm -rf /tmp/stackit-server-agent.deb

5. Wenn die Installation erfolgreich war, überprüfen Sie, ob der Dienst läuft:

   systemctl status stackit-server-agent.service

   

Der STACKIT Server Agent ist nun vollständig konfiguriert und kann Befehle remote akzeptieren und lokal auf Ihrem System ausführen.

STACKIT Server Agent auf einem vorhandenen Server (Windows) installieren

1. Melden Sie sich remote auf Ihrem Server an. Verwenden Sie eine Methode, die eine Zwischenablage-Funktionalität beinhaltet, z. B. Remote Desktop Connection.

2. Starten Sie PowerShell ISE mit erhöhten Berechtigungen.

3. Kopieren Sie das Skript in die Shell und führen Sie es aus. Source file: MSI

   ## Download STACKIT Server Agent
   New-Item -ItemType Directory -Path "C:\ProgramData\STACKIT\ServerAgent" -Force
   Invoke-WebRequest -Uri "http://169.254.169.254/stackit/v1/server-agent/amd64/msi" -OutFile "C:\ProgramData\STACKIT\ServerAgent\STACKITServerAgent.msi"
   
   ### Install the Agent
   Start-Process -FilePath "C:\Windows\System32\msiexec.exe" -ArgumentList "/i C:\ProgramData\STACKIT\ServerAgent\STACKITServerAgent.msi /quiet /l*v C:\Windows\Temp\STACKITServerAgent_install.log" -NoNewWindow -Wait

4. Überprüfen Sie nach erfolgreicher Installation, ob der Dienst läuft. Öffnen Sie die PowerShell und führen Sie den folgenden Befehl aus:

   Get-Service STACKITServerAgent

   Alternativ überprüfen Sie den Status in der Registerkarte Dienst des Task-Managers:

   

Der STACKIT Server Agent ist nun vollständig konfiguriert und kann zur Ausführung von Befehlen verwendet werden.