Debuggen Ihrer Portworx-Installation

Virtual Private Cloud Classic-Infrastruktur

Dieser Abschnitt zur Fehlerbehebung gilt ausschließlich für Red Hat OpenShift-Cluster, auf denen die Version 3.11 ausgeführt wird.

Wenn Sie eine Portworx-Serviceinstanz aus dem IBM Cloud-Katalog erstellen, schlägt die Portworx-Installation in Ihrem Cluster fehl und die Serviceinstanz zeigt den Status Bereitstellung fehlgeschlagen an.

Bevor Portworx in Ihrem Cluster installiert ist, wird eine Reihe von Prüfungen durchgeführt, um die Informationen zu überprüfen, die Sie auf der Portworx-Serviceseite des IBM Cloud-Katalogs angegeben haben.

Wenn eine dieser Prüfungen fehlschlägt, ändert sich der Status des Portworx-Service in Provision failure (Bereitstellung fehlgeschlagen). Es ist nicht erkennbar, welche Prüfung fehlgeschlagen ist oder welche Informationen fehlen, um die Installation abzuschließen.

Folgen Sie diesen Anweisungen, um die Fehlerbehebung für Ihre Portworx-Installation zu starten und um die Informationen zu überprüfen, die Sie im IBM Cloud-Katalog eingegeben haben.

Wenn Sie falsche Angaben finden oder wenn Sie die Konfiguration Ihres Clusters ändern müssen, korrigieren Sie die Angaben bzw. die Clusterkonfiguration. Erstellen Sie anschließend eine neue Portworx-Serviceinstanz, um die Installation erneut zu starten.

Schritt 1: IBM Cloud-Kataloginformationen überprüfen

Überprüfen Sie zunächst, ob die Informationen, die Sie in den IBM Cloud-Katalog eingegeben haben, korrekt sind. Wenn Informationen falsch eingegeben wurden, besteht die Installation die Prüfungen der Installationsvorbereitung nicht und schlägt fehl, ohne zu starten.

  1. Stellen Sie sicher, dass sich der Cluster, in dem Sie Portworx installieren möchten, in der von Ihnen ausgewählten IBM Cloud-Region und Ressourcengruppe befindet.

    ibmcloud oc cluster get --cluster CLUSTER_NAME_OR_ID

  2. Stellen Sie sicher, dass die Berechtigungen des IBM Cloud-API-Schlüssels, den Sie eingegeben haben, für Ihren Cluster ausreichen. Sie müssen über die Plattformzugriffsrolle Bearbeiter und die Servicezugriffsrolle Manager für Red Hat OpenShift on IBM Cloud verfügen. Weitere Informationen finden Sie unter Benutzerzugriffsberechtigungen.

  3. Überprüfen Sie, ob Sie den etcd-API-Endpunkt für Ihre Databases for etcd-Serviceinstanz im korrekten Format eingegeben haben.

    1. Rufen Sie den Databases for etcd-Endpunkt ab.

    2. Fügen Sie den etcd-Endpunkt im Format etcd:<etcd_endpoint1>;etcd:<etcd_endpoint2> hinzu. Wenn Sie mehr als einen Endpunkt haben, geben Sie alle Endpunkte an und trennen Sie sie mit einem Semikolon (;).

      Beispiel für einen Endpunkt:

      etcd:https://1ab234c5-12a1-1234-a123.databases.appdomain.cloud:32059

  4. Überprüfen Sie, ob Sie die Berechtigungsnachweise für den Zugriff auf Ihre Databases for etcd-Serviceinstanz in einem geheimen Kubernetes-Schlüssel in Ihrem Cluster gespeichert haben. Weitere Informationen finden Sie unter Databases for etcd-Serviceinstanz für Portworx-Metadaten einrichten.

    1. Überprüfen Sie die Schritt 4-6 und stellen Sie sicher, dass Sie den korrekten Benutzernamen, das korrekte Kennwort und das korrekte Zertifikat abgerufen haben.
    2. Listen Sie die geheimen Schlüssel in Ihrem Cluster auf und suchen Sie nach dem geheimen Schlüssel, der die Berechtigungsnachweise Ihrer Databases for etcd-Serviceinstanz enthält.
        oc get secrets
    ```
3. Stellen Sie sicher, dass der Benutzername, das Kennwort und das Zertifikat als Wert mit Base64-Codierung in Ihrem geheimen Kubernetes-Schlüssel gespeichert sind.
4. Überprüfen Sie, ob Sie den korrekten Namen des geheimen Schlüssels im IBM Cloud-Katalog angegeben haben.

  5. Wenn Sie die Einrichtung der Datenträgerverschlüsselung mit IBM Key Protect ausgewählt haben, stellen Sie sicher, dass Sie eine IBM Key Protect-Instanz in Ihrem IBM Cloud-Konto erstellt und dass Sie die Berechtigungsnachweise für den Zugriff auf die Instanz in einem geheimen Kubernetes-Schlüssel im portworx-Projekt Ihres Clusters gespeichert haben. Weitere Informationen finden Sie unter Verschlüsselung einzelner Datenträger für Portworx-Datenträger aktivieren.

    1. Stellen Sie sicher, dass der API-Schlüssel Ihrer Service-ID sowie die IBM Key Protect-Instanz-ID, der Rootschlüssel und der API-Endpunkt als Werte mit Base64-Codierung im geheimen Kubernetes-Schlüssel Ihres Clusters gespeichert sind.
    2. Stellen Sie sicher, dass der Name des geheimen Schlüssels px-ibm lautet.
    3. Stellen Sie sicher, dass Sie den geheimen Schlüssel im Projekt portworx Ihres Clusters erstellt haben.

Schritt 2: Cluster-Setup überprüfen

Wenn Sie die Informationen auf der IBM Cloud-Katalogseite korrekt eingegeben haben, überprüfen Sie, ob das Cluster-Setup für Portworx korrekt ist.

  1. Stellen Sie sicher, dass der Cluster, den Sie verwenden möchten, die Mindestanforderungen an die Hardware für Portworx erfüllt.
  2. Wenn Sie einen VM-Cluster verwenden wollen, müssen Sie Ihrem Cluster unaufbereiteten, unformatierten und nicht angehängten Blockspeicher hinzufügen, damit Portworx die Platten in die Portworx-Speicherebene aufnehmen kann.

Schritt 3: Unterstützung durch Portworx und IBM anfordern

Wenden Sie sich mit einer der folgenden Methoden an den Portworx-Support.