Interaktive serielle Konsole konfigurieren

Die Bare-Metal-Lösung bietet eine interaktive serielle Konsole für den Zugriff auf Ihre Server der Bare-Metal-Lösung. In der seriellen Konsole können Sie Befehle direkt ausführen und auf Aufforderungen reagieren. Sie können die serielle Konsole für Konfigurations- und Fehlerbehebungsaufgaben verwenden. Server der Bare-Metal-Lösung verwenden den ersten seriellen Port (Port 1) als serielle Konsole.

Die interaktive serielle Konsole wird nur auf den folgenden Servern unterstützt:

  • Server für allgemeine Zwecke mit TS54 (43.45.00.002) oder einer höheren Firmwareversion
  • Speicheroptimierte Server mit Firmwareversion 3.50.58 oder höher.

Aktualisieren Sie vor dem Start den Server auf die neueste Firmware. Siehe Vorbereitung.

Interaktive serielle Konsolenverbindungen, die älter als 30 Tage sind, werden möglicherweise erzwungen.

In diesem Dokument wird beschrieben, wie Sie den interaktiven Zugriff auf die serielle Konsole auf Ihren Servern aktivieren und deaktivieren.

Hinweise

  1. Aktivieren Sie die API der Bare-Metal-Lösung. Weitere Informationen finden Sie unter Google Cloud-Projekt für die Verwendung der Bare Metal Solution API einrichten.

  2. Gewähren Sie dem Nutzer die entsprechende IAM-Rolle (Identity and Access Management). Zum Ausführen aller Aufgaben in diesem Dokument benötigen Sie eine der folgenden Rollen:

    • roles/baremetalsolution.admin
    • roles/baremetalsolution.editor
  3. Prüfen Sie, ob Sie die erforderliche Version der Firmware haben:

    • Für allgemeine Server: TS54 (43.45.00.002) oder höher.
    • Für speicheroptimierte Server: 3.50.58 oder höher.

    Gehen Sie so vor:

    1. Führen Sie auf dem Server Ihrer Bare-Metal-Lösung den folgenden Befehl aus:

      sudo dmidecode -s bios-version
      

      Wenn der Vorgang erfolgreich war, wird in der Ausgabe die erforderliche BIOS-Version oder höher angezeigt. Bei einem Allzweckserver zeigt die Ausgabe beispielsweise die BIOS-Version 43.45.00.002 oder höher an:

      Version: BIOS_PUR043.45.00.002
      
    2. Wenn die BIOS-Version niedriger als die erforderliche Firmware ist, führen Sie ein Upgrade der Firmware für Ihre Server durch. Wenden Sie sich an den Customer Care, um Unterstützung beim Upgrade zu erhalten.

  4. Wenn Ihr Server für die Bare-Metal-Lösung vor Juni 2022 bereitgestellt wurde, fehlt bei den Kernel-Bootparametern möglicherweise die erforderliche Konfiguration für die interaktive serielle Konsole. Wenn sie jedoch nach Juni 2022 bereitgestellt wurde, ist die erforderliche Konfiguration möglicherweise bereits in Ihr Betriebssystem-Image integriert. Trotzdem besteht die Möglichkeit, dass Betriebssystem-Patching oder unternehmensspezifische Richtlinienerzwingung die Standard-Kernel-Bootparameter geändert haben. In jedem Fall empfehlen wir, die Verfügbarkeit der Betriebssystemkonfiguration zu prüfen, die für die interaktive serielle Konsole erforderlich ist.

    So prüfen Sie, ob Ihr Betriebssystem die erforderliche Konfiguration für die interaktive serielle Konsole hat:

    1. Suchen Sie im Verzeichnis /etc/default die Konfigurationsdatei GRand Unified Bootloader (GRUB).
    2. Prüfen Sie, ob die GRUB-Konfigurationsdatei die folgenden Einstellungen enthält:

      GRUB_CMDLINE_LINUX="(append to the existing value) console=tty0 console=ttyS0,115200"
      GRUB_TERMINAL_OUTPUT="console serial"
      GRUB_TERMINAL="console serial"
      GRUB_SERIAL_COMMAND="serial --speed=115200 --unit=0 --word=8 --parity=no --stop=1"
      

      Wenn die Datei diese Einstellungen enthält, überspringen Sie die restlichen Anweisungen. Mit Ihrer GRUB-Konfigurationsdatei können Sie auf die serielle Konsole zugreifen.

    3. Wenn die GRUB-Konfigurationsdatei diese Einstellungen nicht enthält, fügen Sie sie manuell hinzu.

    4. Führen Sie den Befehl grub-mkconfig aus, um die Änderungen zu verarbeiten. Weitere Informationen finden Sie in der GRUB-Dokumentation.

    5. Starten Sie Ihren Server neu.

Interaktiven seriellen Konsolenzugriff aktivieren

So aktivieren Sie die interaktive serielle Konsole und greifen darauf zu:

  1. Zugriff auf die interaktive serielle Konsole aktivieren
  2. Generieren Sie einen SSH-Schlüssel.
  3. Registrieren Sie den SSH-Schlüssel.
  4. Stellen Sie eine Verbindung zum Server her.

Zugriff auf die interaktive serielle Konsole aktivieren

Bevor Sie die interaktive serielle Konsole verwenden können, müssen Sie den Zugriff darauf auf Ihrem Server aktivieren.

gcloud

Führen Sie den Befehl gcloud bms instances enable-serial-console aus, um den Zugriff auf die interaktive serielle Konsole zu aktivieren.

gcloud bms instances enable-serial-console SERVER_NAME --project=PROJECT_ID --region=REGION

Ersetzen Sie Folgendes:

  • SERVER_NAME: Name Ihres Servers.
  • PROJECT_ID: Ihre Projekt-ID.
  • REGION: Region Ihres Servers.

API

Geben Sie Ihre Projekt-ID, Ihre Region und den Servernamen ein und führen Sie den folgenden curl-Befehl aus, um den Zugriff auf die interaktive serielle Konsole zu aktivieren.

curl -v \
-X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/instances/SERVER_NAME:enableInteractiveSerialConsole"

Ersetzen Sie Folgendes:

  • PROJECT_ID: Ihre Projekt-ID.
  • REGION: Region Ihres Servers.
  • SERVER_NAME: Name Ihres Servers.

SSH-Schlüsselpaar generieren

Generieren Sie ein SSH-Schlüsselpaar, um Ihren Zugriff auf die serielle Konsole zu authentifizieren. Dies muss nur einmal pro Projekt erfolgen.

Führen Sie den Befehl ssh-keygen auf einer Jump-Host-VM-Instanz oder einem anderen mit dem Internet verbundenen Terminal aus, um ein neues SSH-Schlüsselpaar zu erstellen.

  ssh-keygen -b 4096 -f SSH_KEY_ID -N 'PASSPHRASE' -t rsa
  

Ersetzen Sie Folgendes:

  • SSH_KEY_ID: Root-Name der SSH-Schlüsseldatei, die zum Generieren der öffentlichen und privaten Schlüssel verwendet wird.
  • PASSPHRASE: Passphrase für den Zugriff auf Ihre Server über die serielle Konsole.

Der Befehl ssh-keygen speichert Ihren privaten Schlüssel in einer Datei namens SSH_KEY_ID und Ihren öffentlichen Schlüssel in einer Datei namens SSH_KEY_ID.pub in Ihrem Basisverzeichnis.

SSH-Schlüssel registrieren

Registrieren Sie die SSH-Schlüssel in Ihrem Projekt, um Ihren Zugriff auf die serielle Konsole zu authentifizieren. Dies muss nur einmal pro Schlüsselpaar erfolgen.

gcloud

Führen Sie den Befehl gcloud bms ssh-keys add aus, um Ihre SSH-Schlüssel zu registrieren.

gcloud bms ssh-keys add SSH_KEY_ID --project=PROJECT_ID --key-file=SSH_KEY_ID.pub

Ersetzen Sie Folgendes:

  • SSH_KEY_ID: Root-Name der SSH-Schlüsseldatei, die zum Generieren der öffentlichen und privaten Schlüssel verwendet wird.
  • PROJECT_ID: Ihre Projekt-ID.
  • REGION: Region Ihres Servers.
  • SERVER_NAME: Name Ihres Servers.

API

Geben Sie zum Registrieren der SSH-Schlüssel Ihre Projekt-ID, die SSH-Schlüssel-ID und den Dateinamen des öffentlichen Schlüssels ein und führen Sie den folgenden curl-Befehl aus.

curl -v \
-X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/global/sshKeys?ssh_key_id=SSH_KEY_ID" \
--data "{\"public_key\": \"$(cat SSH_KEY_ID.pub)\"}"

Ersetzen Sie Folgendes:

  • PROJECT_ID: Ihre Projekt-ID.
  • SSH_KEY_ID: Root-Name der SSH-Schlüsseldatei, die zum Generieren der öffentlichen und privaten Schlüssel verwendet wird.

Informationen zum Verwalten von SSH-Schlüsseln in Ihrem Projekt finden Sie unter SSH-Schlüssel verwalten.

Verbindung zum Server herstellen

Verwenden Sie SSH, um auf die interaktive serielle Konsole zuzugreifen. Führen Sie dazu diesen Befehl aus:

  ssh -i SSH_KEY_ID -p 9600 PROJECT_ID.REGION.SERVER_NAME.USERNAME.bms=true@ssh-serialport.googleapis.com
  

Ersetzen Sie Folgendes:

  • SSH_KEY_ID: Root-Name der SSH-Schlüsseldatei, die zum Generieren der öffentlichen und privaten Schlüssel verwendet wird.
  • PROJECT_ID: Ihre Projekt-ID.
  • REGION: Region Ihres Servers.
  • SERVER_NAME: Name Ihres Servers.
  • USERNAME: Nutzername, mit dem Sie über die serielle Konsole auf den Server der Bare-Metal-Lösung zugreifen.

Geben Sie bei Aufforderung die zuvor konfigurierte Passphrase für den SSH-Schlüssel ein. Drücken Sie bei Bedarf die Taste Enter oder Return, um Zugriff auf die interaktive serielle Konsole zu erhalten.

Verbindung zur interaktiven seriellen Konsole trennen

So trennen Sie die Verbindung zur seriellen Konsole:

  1. Drücken Sie die ENTER- oder RETURN-Taste.
  2. Geben Sie "~." ein (Tilde gefolgt von einem Punkt).

Verwenden Sie für SAP HANA auf Bare-Metal-Lösung CTRL + ] q, um die Verbindung zur interaktiven seriellen Konsole zu trennen.

SSH-Schlüssel verwalten

Die SSH-Schlüssel werden pro Projekt gespeichert. Sie können Ihre SSH-Schlüssel so verwalten:

SSH-Schlüssel auflisten

Sie können die öffentlichen SSH-Schlüssel auflisten, die in Ihrem Projekt registriert sind.

gcloud

Führen Sie den Befehl gcloud bms ssh-keys list aus, um die öffentlichen SSH-Schlüssel aufzulisten.

gcloud bms ssh-keys list --project=PROJECT_ID

Ersetzen Sie Folgendes:

  • PROJECT_ID: Ihre Projekt-ID.

API

Geben Sie Ihre Projekt-ID ein und führen Sie den folgenden curl-Befehl aus, um die öffentlichen SSH-Schlüssel aufzulisten.

curl -v \
-X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/global/sshKeys"

Ersetzen Sie Folgendes:

  • PROJECT_ID: Ihre Projekt-ID.

SSH-Schlüssel löschen

Sie können einen SSH-Schlüssel aus der Liste der autorisierten Schlüssel für ein Projekt löschen.

gcloud

Führen Sie den Befehl gcloud bms ssh-keys remove aus, um einen öffentlichen SSH-Schlüssel zu löschen.

gcloud bms ssh-keys remove SSH_KEY_ID --project=PROJECT_ID

Ersetzen Sie Folgendes:

  • SSH_KEY_ID: Root-Name der SSH-Schlüsseldatei, die zum Generieren der öffentlichen und privaten Schlüssel verwendet wird.
  • PROJECT_ID: Ihre Projekt-ID.

API

Um einen öffentlichen SSH-Schlüssel zu löschen, geben Sie Ihre Projekt-ID und die SSH-Schlüssel-ID ein und führen Sie den folgenden curl-Befehl aus.

curl -v \
-X DELETE \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/global/sshKeys/SSH_KEY_ID"

Ersetzen Sie Folgendes:

  • PROJECT_ID: Ihre Projekt-ID.
  • SSH_KEY_ID: Root-Name der SSH-Schlüsseldatei, die zum Generieren der öffentlichen und privaten Schlüssel verwendet wird.

Interaktiven seriellen Konsolenzugriff deaktivieren

Folgen Sie dieser Anleitung, um den interaktiven Zugriff auf die serielle Konsole auf einem Server zu deaktivieren.

gcloud

Führen Sie den Befehl gcloud bms instances disable-serial-console aus, um die interaktive serielle Konsole zu deaktivieren.

gcloud bms instances disable-serial-console SERVER_NAME --project=PROJECT_ID --region=REGION

Ersetzen Sie Folgendes:

  • SERVER_NAME: Name Ihres Servers.
  • PROJECT_ID: Ihre Projekt-ID.
  • REGION: Region Ihres Servers.

API

Geben Sie zum Deaktivieren der interaktiven seriellen Konsole Ihre Projekt-ID, Ihre Region und Ihren Servernamen ein und führen Sie den folgenden curl-Befehl aus.

curl -v \
-X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/instances/SERVER_NAME:disableInteractiveSerialConsole"

Ersetzen Sie Folgendes:

  • PROJECT_ID: Ihre Projekt-ID.
  • REGION: Region Ihres Servers.
  • SERVER_NAME: Name Ihres Servers.