Voraussetzungen für ODF

Bare Metal Worker Nodes mit lokalem NVME-Speicher

Verwenden Sie Flavors mit dem Suffix d, die lokale NVME-Festplatten enthalten.

Anforderungen an den Arbeitsknoten

ODF benötigt mindestens 3 Worker Nodes für hohe Verfügbarkeit und Datenredundanz.

Konfiguration der Zone

• OpenShift Virtualisierungsbereitstellungen: Single-Zone-Cluster werden empfohlen, um die Speicherlatenz für VM Workloads zu minimieren. Während Multizonen-Implementierungen eine bessere Hochverfügbarkeit bieten, kann die zonenübergreifende Speicherreplikation die Leistung von VM beeinträchtigen.
• Allgemeine ODF-Einsätze: Es werden mindestens 3 Zonen für hohe Verfügbarkeit und Disaster Recovery empfohlen.

ODF über die Konsole installieren

1. Melden Sie sich bei Ihrem IBM Cloud Konto an und navigieren Sie zu Ihrem Cluster.

2. Klicken Sie in der Clusternavigation auf Add-ons.

3. Klicken Sie auf der Karte „ OpenShift-Datenbasis “ auf „ Installieren “.

4. Wählen Sie die Option Lokaler Speicher.

   Remote Block Volume Attachment wird für VPC Bare Metal Nodes nicht unterstützt.

5. Wählen Sie eine der folgenden Suchmethoden aus:

   Automatische Entdeckung (empfohlen)

   Wählen Sie Automatische Erkennung, um verfügbare Festplatten auf Ihren Bare Metal Worker Nodes automatisch zu erkennen und zu verwenden.

   Spezifikation der manuellen Festplatte

   Wenn Sie es vorziehen, die Laufwerke manuell anzugeben, gehen Sie wie folgt vor:

   1. Melden Sie sich an jedem Arbeitsknoten an, um die verfügbaren Festplatten zu ermitteln.

      oc debug node/<node-name>
      

   2. Lassen Sie Host-Binärdateien zu.

      chroot /host
      

   3. Verfügbare Geräte auflisten.

      lsblk
      

   4. Finden Sie die by-id für jede Festplatte.

      ls -l /dev/disk/by-id/
      

   5. Fügen Sie die Festplatten-IDs in den Parameter OSD-Pod-Festplatten-IDs ein.

6. Konfigurieren Sie bei Bedarf weitere Parameter:

   • Ressourcenprofil: Wählen Sie je nach Arbeitsbelastung balanced oder performance
   • Verschlüsselung: Aktivieren Sie bei Bedarf die Verschlüsselung mit Hyper Protect Crypto Services
   • Anzahl der OSD-Platten: Geben Sie die Anzahl der Festplatten pro Arbeitsknoten an

7. Klicken Sie auf Installieren, um ODF bereitzustellen.

Weitere Informationen über ODF-Parameter finden Sie unter OpenShift Data Foundation-Parameterreferenz.

ODF über die Befehlszeile installieren

1. Sehen Sie sich die verfügbaren Zusatzoptionen an.

   ibmcloud oc cluster addon options --addon openshift-data-foundation --version 4.20.0
   

2. Aktivieren Sie das Add-on OpenShift Data Foundation mit automatischer Festplattenerkennung und Virtualisierungsunterstützung.

   ibmcloud oc cluster addon enable openshift-data-foundation \
     -c <cluster-name> \
     --version 4.20.0 \
     --param "odfDeploy=true" \
     --param "osdStorageClassName=localblock" \
     --param "autoDiscoverDevices=true" \
     --param "resourceProfile=performance" \
     --param "setDefaultStorageClassForVirtualization=true"
   

3. Stellen Sie sicher, dass sich das Add-on im Status „Bereit“ befindet.

   oc get storagecluster -n openshift-storage
   

   Beispielausgabe:

   NAME                 AGE   PHASE   EXTERNAL   CREATED AT             VERSION
   ocs-storagecluster   53m   Ready              2025-03-10T12:20:52Z   4.20.0
   

Überprüfen der ODF-Installation

1. Überprüfen Sie den Status des Speicher-Clusters.

   oc get storagecluster -n openshift-storage
   

2. Überprüfen Sie, ob Speicherklassen verfügbar sind.

   oc get storageclass | grep ocs
   

3. Stellen Sie sicher, dass die ODF-Pods laufen.

   oc get pods -n openshift-storage
   

Weitere Informationen zur Bereitstellung von ODF finden Sie unter Bereitstellen von OpenShift Data Foundation auf VPC-Clustern.

Voraussetzungen für VPC File Storage

• Jede unterstützte Bare-Metal-Variante
• VPC-Infrastruktur

Schritt 1: Deaktivieren Sie standardmäßig die VPC- Block Storage

1. Bearbeiten Sie die Konfigurationskarte des VPC-Block-CSI-Treibers.

   oc edit cm addon-vpc-block-csi-driver-configmap -n kube-system
   

2. Setzen Sie IsStorageClassDefault auf false.

   data:
     IsStorageClassDefault: "false"
   

3. Speichern Sie die Datei und verlassen Sie den Editor.

Schritt 2: Installieren Sie den VPC-Datei-CSI-Treiber

Schritt 3: Standard-Speicherklasse festlegen

1. Verfügbaren Speicherklassen auflisten.

   oc get storageclass | grep vpc-file
   

2. Wählen Sie eine für Ihre Arbeitslast geeignete Speicherklasse aus:

   • ibmc-vpc-file-1000-iops: Für moderate Arbeitslasten (40 GB – 2000 IOPS)
   • ibmc-vpc-file-6000-iops: Für höhere Arbeitslasten (100 GB – 6000 IOPS)
   • ibmc-vpc-file-metro-1000-iops: Für Bereitstellungen mit mehreren Zonen

3. Bearbeiten Sie die Konfigurationsdatei „CSI driver configmap“ der VPC-Datei.

   oc edit cm addon-vpc-file-csi-driver-configmap -n kube-system
   

4. Stellen Sie das Feld „ SET_DEFAULT_STORAGE_CLASS “ auf die von Ihnen gewählte Speicherklasse ein.

   data:
     SET_DEFAULT_STORAGE_CLASS: "ibmc-vpc-file-metro-1000-iops"
   

5. Speichern Sie die Datei und verlassen Sie den Editor.

6. Warten Sie ein paar Minuten, bis die Änderungen wirksam werden.

7. Überprüfen Sie die Standard-Speicherklasse.

   oc get storageclass | grep "(default)"
   

Schritt 4: Speicherprofile für die VPC konfigurieren File Storage

Nach der Installation des „ OpenShift Virtualization Operator“ müssen Sie Speicherprofile für VPC- File Storage s konfigurieren, da der Container Disk Importer (CDI) die Eigenschaften von VPC- File Storage s nicht automatisch erkennt.

Dieser Schritt muss nach der Installation des „ OpenShift Virtualization Operator“ durchgeführt werden.

for sp in $(oc get storageprofile.cdi.kubevirt.io -o json | jq -r '.items[] | select(.status.provisioner == "vpc.file.csi.ibm.io") | .metadata.name'); do
  oc patch storageprofile.cdi.kubevirt.io "$sp" --type=merge -p '{
    "spec": {
      "claimPropertySets": [
        {
          "accessModes": ["ReadWriteMany"],
          "volumeMode": "Filesystem"
        }
      ]
    }
  }'
done

Überprüfung der Installation von VPC- File Storage

1. Überprüfen Sie, ob die Pods des VPC-Datei-CSI-Treibers ausgeführt werden.

   oc get pods -n kube-system | grep vpc-file
   

2. Vergewissern Sie sich, dass die Standard-Speicherklasse korrekt eingestellt ist.

   oc get storageclass | grep "(default)"
   

3. Testen Sie die Speicherbereitstellung, indem Sie ein Test-PVC erstellen.

   apiVersion: v1
   kind: PersistentVolumeClaim
   metadata:
     name: test-pvc
   spec:
     accessModes:
     - ReadWriteMany
     resources:
       requests:
         storage: 10Gi
   

4. Überprüfen Sie, ob das PVC fest sitzt.

   oc get pvc test-pvc
   

5. Löschen Sie das Test-PVC.

   oc delete pvc test-pvc
   

ODF-Installation schlägt fehl

Wenn die ODF-Installation fehlschlägt, überprüfen Sie Folgendes:

• Überprüfen Sie, ob Ihre Bare-Metal-Knoten über lokalen NVME-Speicher verfügen
• Stellen Sie sicher, dass Sie über mindestens 3 Worker-Knoten verfügen
• Prüfen Sie, ob die Festplatten ausgehängt und unformatiert sind
• Überprüfen Sie die ODF-Betreiberprotokolle: oc logs -n openshift-storage -l app=ocs-operator

VPC- File Storage-PVCs stehen noch aus

Wenn PVCs im Status „Ausstehend“ verbleiben:

• Überprüfen Sie, ob das VPC-Datei-CSI-Treiber-Add-on installiert ist und ordnungsgemäß funktioniert
• Überprüfen Sie, ob die Standard-Speicherklasse korrekt eingestellt ist
• Stellen Sie sicher, dass die Speicherprofile mit dem Zugriffsmodus „RWX“ konfiguriert sind
• CSI-Fahrerprotokolle überprüfen: oc logs -n kube-system -l app=ibm-vpc-file-csi-controller

Speicherprofile wurden nicht aktualisiert

Falls die Speicherprofile nicht die richtige Konfiguration anzeigen:

• Stellen Sie sicher, dass der „ OpenShift-Virtualisierungsoperator“ installiert ist
• Warten Sie, bis die Speicherprofile automatisch erstellt wurden
• Speicherprofile manuell mit den bereitgestellten Befehlen anpassen
• Überprüfen Sie, ob der Name des Provisioners übereinstimmt vpc.file.csi.ibm.io