Install the Server Agent on a Server

In dieser Dokumentation wird beschrieben, wie Sie den STACKIT Server Agent auf einem bereits vorhandenen und laufenden Server installieren.

Wenn Sie den STACKIT Server Agent lieber über das STACKIT Portal installieren möchten, lesen Sie bitte diese Dokumentation: Installation des Server Agents über das Portal.

Wenn Sie es vorziehen, den STACKIT Server Agent über die STACKIT IAAS API, die STACKIT CLI oder STACKIT Terraform zu installieren, lesen Sie bitte diese Dokumentation: Server Agent über API installieren.

STACKIT Server Agent auf einem vorhandenen Server (Linux) installieren

Wichtig: Um den STACKIT Server Agent zu installieren, benötigen Sie Administrative (Superuser)-Berechtigungen! Bitte passen Sie ebenso die [region]-Variablen in den Endpunkten der folgenden Skripte an die Region an, in der Ihr Server gehostet wird (eu01/eu02)!

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.[region].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 -o /tmp/stackit-server-agent.rpm
   
   ### Download the package signature file
   curl https://stackit-server-agent.object.storage.[region].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.[region].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.[region].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 Taskmanagers:

   

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