Interaktive serielle Konsole konfigurieren

Die Bare-Metal-Lösung bietet eine interaktive serielle Konsole für den Zugriff Server der Bare-Metal-Lösung. Sie können Befehle direkt ausführen und auf Eingabeaufforderungen reagieren in der seriellen Konsole. Mit der seriellen Konsole können Sie die Konfiguration vornehmen und Fehlerbehebungsaufgaben. Bare Metal-Lösungsserver 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 höhere Firmware-Version.
• Speicheroptimierte Server mit Firmwareversion 3.50.58 oder höher

Aktualisieren Sie Ihren Server vor Beginn auf die neueste Firmware. Siehe Vorbereitung.

Achtung: Einige Einschränkungen in Organisationsrichtlinien können dazu führen, dass die interaktive serielle Konsolenverbindung wird vom Server abgelehnt. Zum Aktivieren der interaktiven Zugriff auf die serielle Konsole haben, müssen Sie diese Einschränkungen der Organisationsrichtlinie entfernen. Weitere Informationen zu diesen Einschränkungen finden Sie unter Zugriff auf den seriellen VM-Port deaktivieren. (constraints/compute.disableSerialPortAccess) und Globalen Zugriff auf serielle VM-Ports deaktivieren (constraints/compute.disableGlobalSerialPortAccess) in Einschränkungen für Organisationsrichtlinien.

Verbindungen zur interaktiven seriellen Konsole, die älter als 30 Tage sind, werden möglicherweise zwangsweise getrennt.

In diesem Dokument wird beschrieben, wie Sie die interaktive serielle Konsole aktivieren und deaktivieren. auf euren Servern.

Hinweis

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

2. Weisen Sie dem Nutzer die entsprechende IAM-Rolle (Identity and Access Management) zu. Um alle Aufgaben in diesem Dokument ausführen zu können, benötigen Sie eine der folgenden Rollen:

   • roles/baremetalsolution.admin
   • roles/baremetalsolution.editor

3. Prüfen Sie, ob Sie die erforderliche Firmwareversion 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 Ihrem Bare-Metal-Lösungsserver den folgenden Befehl aus:

      sudo dmidecode -s bios-version
      

      Bei Erfolg wird in der Ausgabe die erforderliche BIOS-Version oder eine höhere angezeigt. Bei einem Server für allgemeine Zwecke wird beispielsweise eine BIOS-Version von 43.45.00.002 oder höher ausgegeben:

      Version: BIOS_PUR043.45.00.002
      

   2. Wenn die BIOS-Version niedriger als die erforderliche Firmware ist, führen Sie ein Firmware-Upgrade für Ihre Server durch. Wende dich an den Kundensupport, um Hilfe beim Upgrade zu erhalten.

      Hinweis: Wir benötigen eine Vorabankündigung von 5 Tagen, um das Upgrade zu planen. Das Upgrade erfordert etwa 10 Stunden. Wir können bis zu fünf Server gleichzeitig in einem 10-stündigen Zeitfenster aktualisieren.

4. Wenn Ihr Server für die Bare-Metal-Lösung vor Juni 2022 bereitgestellt wurde, Kernel-Bootparameter möglicherweise nicht die erforderliche Konfiguration für interaktive serielle Konsole. Wenn das Gerät hingegen nach Juni 2022 bereitgestellt wurde, ist die erforderliche Konfiguration möglicherweise bereits in Ihrem Betriebssystem-Image integriert. Trotzdem kann es vorkommen, dass Betriebssystem-Patches Die unternehmensspezifische Richtlinienerzwingung hat möglicherweise den Standard-Kernel geändert. Bootparameter. Wir empfehlen Ihnen in jedem Fall, die Verfügbarkeit der für die interaktive serielle Konsole erforderlichen Betriebssystemkonfiguration zu prüfen.

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

   1. Suchen Sie im Verzeichnis /etc/default nach der Konfigurationsdatei des GRand Unified Bootloaders (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. Sie können Ihre GRUB-Konfigurationsdatei verwenden, um auf die serielle Konsole zuzugreifen.

   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. Für Weitere Informationen finden Sie in der GRUB-Dokumentation.

   5. Starten Sie den 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. Erstellen 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 des Servers.
• PROJECT_ID: Ihre Projekt-ID.
• REGION: Region Ihres Servers.

API

Geben Sie Ihre Projekt-ID, die 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 durchgeführt werden.

Hinweis: In Projekten mit VPC-SC kann kein Jumphost oder eine andere VM verwendet werden.

Führen Sie den Befehl ssh-keygen von 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: Stammname Ihrer SSH-Schlüsseldatei, mit der die öffentlichen und privaten Schlüssel generiert wurden.
• PASSPHRASE: Passphrase, die beim Zugriff auf Ihre Server über die serielle Konsole verwendet werden soll.

Mit dem Befehl ssh-keygen wird Ihr privater Schlüssel in einer Datei namens SSH_KEY_ID und Ihr öffentlicher Schlüssel in einer Datei namens SSH_KEY_ID.pub in Ihrem Basisverzeichnis gespeichert.

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 zum Registrieren Ihrer SSH-Schlüssel den Befehl gcloud bms ssh-keys add-Befehl.

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

Ersetzen Sie Folgendes:

• SSH_KEY_ID: Stammname Ihrer SSH-Schlüsseldatei, mit der die öffentlichen und privaten Schlüssel generiert wurden.
• PROJECT_ID: Ihre Projekt-ID.
• REGION: Region Ihres Servers.
• SERVER_NAME: Name Ihres Servers.

API

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

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: Stammname Ihrer SSH-Schlüsseldatei, mit der die öffentlichen und privaten Schlüssel generiert wurden.

Informationen zum Verwalten der SSH-Schlüssel 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=[e-mail]
  

Ersetzen Sie Folgendes:

• SSH_KEY_ID: Stammname Ihrer SSH-Schlüsseldatei, mit der die öffentlichen und privaten Schlüssel generiert wurden.
• PROJECT_ID: Ihre Projekt-ID.
• REGION: Region Ihres Servers.
• SERVER_NAME: Name Ihres Servers.
• USERNAME: Nutzername, mit dem Sie auf die Bare-Metal-Lösung zugreifen über die serielle Konsole verbinden.

Geben Sie die zuvor konfigurierte Passphrase für den SSH-Schlüssel ein, wenn Sie dazu aufgefordert werden. Bei Bedarf drücken Sie die Enter- oder Return-Taste, um Zugriff auf die interaktive Seriennummer .

Verbindung zur interaktiven seriellen Konsole trennen

So trennen Sie die Verbindung zur seriellen Konsole:

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

Verwenden Sie bei SAP HANA in der Bare-Metal-Lösung die Taste CTRL + ] q, um die Verbindung zur interaktiven seriellen Konsole zu trennen.

SSH-Schlüssel verwalten

Die SSH-Schlüssel werden pro Projekt gespeichert. Du kannst deine SSH-Schlüssel verwalten in auf folgende Arten:

• SSH-Schlüssel auflisten
• SSH-Schlüssel löschen

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 eine Liste der öffentlichen SSH-Schlüssel aufzurufen.

gcloud bms ssh-keys list --project=PROJECT_ID

Ersetzen Sie Folgendes:

• PROJECT_ID: Ihre Projekt-ID.

API

Geben Sie zum Auflisten der öffentlichen SSH-Schlüssel Ihre Projekt-ID ein und geben Sie Folgendes aus: curl-Befehl.

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

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

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

Ersetzen Sie Folgendes:

• SSH_KEY_ID: Stammname Ihrer SSH-Schlüsseldatei, mit der die öffentlichen und privaten Schlüssel generiert wurden.
• PROJECT_ID: Ihre Projekt-ID.

API

Um einen öffentlichen SSH-Schlüssel zu löschen, gib deine Projekt-ID und die SSH-Schlüssel-ID ein und gib das Problem an folgenden curl-Befehl.

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: Stammname Ihrer SSH-Schlüsseldatei, mit der die öffentlichen und privaten Schlüssel generiert wurden.

Interaktiven seriellen Konsolenzugriff deaktivieren

Folgen Sie der Anleitung unten, um den Zugriff auf die interaktive serielle Konsole auf einem Server zu deaktivieren.

gcloud

Zum Deaktivieren der interaktiven seriellen Konsole führen Sie den Befehl gcloud bms instances disable-serial-console-Befehl.

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

Ersetzen Sie Folgendes:

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

API

Wenn Sie die interaktive serielle Konsole deaktivieren möchten, geben Sie Ihre Projekt-ID, die Region und den 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.