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. Sie können Befehle direkt in der seriellen Konsole ausführen und auf Aufforderungen reagieren. Mit der seriellen Konsole können Sie Konfigurations- und Fehlerbehebungsaufgaben ausführen. Server der Bare-Metal-Lösung verwenden den ersten seriellen Port (Port 1) als serielle Konsole.
Die interaktive serielle Konsole wird nur auf Servern mit TS54
-Firmware (43.45.00.002
) unterstützt. Aktualisieren Sie den Server vor dem Start auf die TS54
-Firmware. Siehe Vorbereitung.
Interaktive serielle Konsolenverbindungen, die älter als 30 Tage sind, werden möglicherweise zwangsweise getrennt.
In diesem Dokument wird beschrieben, wie Sie den interaktiven seriellen Konsolenzugriff auf Ihren Servern aktivieren und deaktivieren.
Hinweise
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.
Weisen Sie dem Nutzer die entsprechende IAM-Rolle (Identity and Access Management) zu. Zum Ausführen aller Aufgaben in diesem Dokument benötigen Sie eine der folgenden Rollen:
roles/baremetalsolution.admin
roles/baremetalsolution.editor
Prüfen Sie, ob Sie die erforderliche Version der Firmware haben:
TS54
(43.45.00.002
) oder höher. Gehen Sie so vor:Führen Sie auf dem Server der Bare-Metal-Lösung den folgenden Befehl aus:
sudo dmidecode -s bios-version
Bei Erfolg wird in der Ausgabe eine BIOS-Version von
43.45.00.002
oder höher angezeigt, wie im folgenden Beispiel gezeigt:Version: BIOS_PUR043.45.00.002
Wenn die BIOS-Version niedriger als
43.45.00.002
ist, führen Sie ein Upgrade der Firmware für Ihre Server durch. Wenden Sie sich an Customer Care, um Unterstützung beim Upgrade zu erhalten.
Prüfen Sie, ob die GRand Unified Bootloader-Datei (GRUB) in Ihrem Betriebssystem die richtige Konfiguration zur Unterstützung der seriellen Konsole hat. Gehen Sie so vor:
- Suchen Sie die GRUB-Konfigurationsdatei im Verzeichnis
/etc/default
. 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.
Wenn die GRUB-Konfigurationsdatei diese Einstellungen nicht enthält, fügen Sie sie manuell hinzu.
Führen Sie den Befehl
grub-mkconfig
aus, um die Änderungen zu verarbeiten. Weitere Informationen finden Sie in der GRUB-Dokumentation.Starten Sie den Server neu.
- Suchen Sie die GRUB-Konfigurationsdatei im Verzeichnis
Interaktiven seriellen Konsolenzugriff aktivieren
Gehen Sie folgendermaßen vor, um die interaktive serielle Konsole zu aktivieren und darauf zuzugreifen:
- Zugriff auf die interaktive serielle Konsole aktivieren
- Generieren Sie einen SSH-Schlüssel.
- Registrieren Sie den SSH-Schlüssel.
- 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 durchgeführt werden.
Führen Sie den Befehl ssh-keygen
über eine Jump-Host-VM-Instanz oder ein anderes mit dem Internet verbundenes 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, die beim Zugriff auf Ihre Server über die serielle Konsole verwendet werden soll.
Mit dem Befehl ssh-keygen
wird der private Schlüssel in einer Datei namens SSH_KEY_ID und der öffentliche 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
Registrieren Sie Ihre SSH-Schlüssel mit dem Befehl gcloud bms ssh-keys add
.
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 Ihrer 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 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=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.
Wenn Sie dazu aufgefordert werden, geben Sie 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
Gehen Sie folgendermaßen vor, um die Verbindung zur seriellen Konsole zu trennen:
- Drücken Sie die Taste
ENTER
oderRETURN
. - Geben Sie "
~.
" ein (Tilde gefolgt von einem Punkt).
Verwenden Sie für SAP HANA on 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 in Ihrem Projekt registrierten öffentlichen SSH-Schlüssel auflisten.
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
Zum Löschen eines öffentlichen SSH-Schlüssels geben Sie Ihre Projekt-ID und die SSH-Schlüssel-ID ein und führen 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
Verwenden Sie die folgende 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.