Replikatdateifreigaben verwalten

Verwalten Sie Replikations-Dateifreigaben, indem Sie Replikationsbeziehungen entfernen, um unabhängige Lese-/Schreibfreigaben zu erstellen, die separat aktualisiert und gelöscht werden können.

Sie benötigen die IAM-Benutzerrollen 'Administrator' oder 'Bearbeiter', um Dateifreigabereplikate und die Replikationsbeziehung zu erstellen und zu verwalten. Eine Liste dieser Rollen und Aktionen finden Sie unter IAM-Rollen zum Erstellen und Verwalten von Dateifreigaben.

Informationen zur Replikationssynchronisation

Die Replikation ist eine asynchrone Operation, die nicht sofort ausgeführt wird. Nach jeder Synchronisationsoperation stellt das System nützliche Informationen zum letzten Replikationsprozess bereit, wie z. B. das Start-und Enddatum und das übertragene Datenvolumen. Durch Anzeigen der Replikationsinformationen können Sie ermitteln, wie lange die letzte Replikation gedauert hat, und die Übertragungsrate berechnen. Wenn Sie die übertragenen Datenwerte anzeigen, können Sie die globalen Transfergebühren am Ende des Abrechnungszeitraums schätzen.

Sie können die Informationen zur Replikationssynchronisation verwenden, um Ihren Replikationszeitplan zu optimieren. Es kann Ihnen helfen, die Kosten und die Häufigkeit auszugleichen, mit der die Daten auf dem Replikat aktualisiert werden müssen, um Ihre Zielsetzung für WiederherstellungspunktBei der Planung der Notfallwiederherstellung wird die Zeit, in der Daten wiederhergestellt werden, in Zeit gemessen (Sekunden, Minuten, Stunden), beginnend mit der wiederhergestellten Instanz und endend am Punkt des Notfalls. zu erfüllen. Es kann auch helfen zu bestimmen, ob der Replikationsprozess Gefahr einer Verschlechterung läuft.

Wenn das zu übertragende Datenvolumen das Datenvolumen überschreitet, das während des Replikationsfensters mit der normalen Übertragungsrate übertragen werden kann, kann der Replikationsprozess nicht abgeschlossen werden und der Replikationsstatus lautet degraded. Wenn diese Situation auftritt, versuchen Sie, die Änderungsrate für die Dateifreigabe und die Replikationsfrequenz anzupassen.

Das System fragt den letzten Synchronisierungsstatus alle 15 Minuten ab. Das Ergebnis zeigt die Daten der letzten abgeschlossenen Replikation an. Wenn eine Replikation während der Ausführung der Abfrage in Bearbeitung ist, wird sie nicht in der Antwort angezeigt. Nach Abschluss der Replikation aktualisiert die nächste Abfrage die Informationen zur letzten Synchronisation. Es ist mit einer kurzen Verzögerung zwischen dem Abschluss der Replikation und dem Zeitpunkt der Aktualisierung der letzten Synchronisierungsinformationen in den Schnittstellen zu rechnen.

Sie können Informationen zur letzten Replikationsoperation anzeigen, wenn Sie die Details der Quellen-oder Replikatfreigabe anzeigen. Weitere Informationen finden Sie unter Details zu einer Dateifreigabe in der Konsole anzeigen.

Sie können Informationen zur letzten Replikationsoperation anzeigen, wenn Sie die Details der gemeinsam genutzten Quellen-oder Replikatressource auflisten. Weitere Informationen finden Sie unter Details einer Dateifreigabe über die Befehlszeilenschnittstelle anzeigen.

Sie können die Details der letzten Synchronisation programmgesteuert abrufen, indem Sie die Methode /shares in der VPC-APIaufrufen. Suchen Sie den Abschnitt latest_sync in der API-Antwort, um festzustellen, wann die Replikation gestartet wurde (started_at), wann sie beendet wurde (completed_at) und wie viele Daten übertragen wurden (data_transferred). Weitere Informationen finden Sie unter Einzelne Dateifreigabe mit der API anzeigen.

Außerdem können Sie historische Informationen über die letzte Replikationssynchronisierung anzeigen, wenn Sie IBM Cloud Logs verwenden. Wenn die Replikation stattfindet, generiert der Dateiservice eine regional-file.00002I-Protokollnachricht, die Informationen zum Zeitpunkt der Replikation und zum Umfang der übertragenen Daten enthält. Weitere Informationen finden Sie unter Protokollierung für VPC.

Überprüfung der Replikation über die API

Mithilfe der API können Sie überprüfen, ob die Replikation erfolgreich war, noch aussteht oder fehlgeschlagen ist. Sie können die Anforderung GET /shares/{share_id} absetzen, um den Status mit der Freigabe-ID der Quellen-oder Replikatfreigaben anzuzeigen.

curl -X GET \
"$vpc_api_endpoint/v1/shares/$share_id?version=2023-08-08&generation=2"\
-H "Authorization: Bearer $iam_token"

Prüfen Sie in der Antwort die Eigenschaft latest_job. Das Beispiel zeigt, dass die Replikationsübernahme erfolgreich war:

  "created_at": "2023-08-08T23:31:59Z",
  "crn": "crn:[...]",
  "encryption": "provider_managed",
  "href": "$vpc_api_endpoint/v1/shares/199d78ec-b971-4a5c-a904-8f37ae710c63",
  "id": "199d78ec-b971-4a5c-a904-8f37ae710c63",
  "iops": 3000,
  "lifecycle_state": "stable",
  "name": "share-name1",
  .
  .
  .
  "latest_job": {
      "status": "succeeded",
      "status_reason": {
          "code": "",
          "message": "",
          "more_info": ""
      },
      "type": "replication_failover"
  }

Wenn bei einer Replikationsaufteilung die Replikatfreigabe von der Quellenfreigabe getrennt wird, wird in der Antwort der Status running für latest_job angezeigt.

"latest_job": {
    "status": "running",
     "status_reason": {
          "code": "",
          "message": "",
         "more_info": ""
    },
    "type": "replication_split"
},

Eine Replikationsoperation failover oder split kann nicht ausgeführt werden, wenn eine andere Operation für die Dateifreigabe ausgeführt wird, wie z. B. die Erweiterung der Größe. In der Antwort, die auf das Problem hinweist, wird der Fehler 409 angezeigt. Beispiel:

"errors": [
    {
        "code": "share_operation_pending",
          "message": "An operation 'replication_failover' is pending on file share, request to 'replication_split' cannot be accepted.",
          "more_info": "Before sending another request wait for the current operation to complete and try again."
     }
],
"trace": "4634eee2-0a9b-43b7-b35e-8885cc258500"

Replikationsbeziehung entfernen

Sie können die Replikation beenden, indem Sie die Replikationsbeziehung zwischen der Quell-Dateifreigabe und der Replikat-Dateifreigabe aufheben. Diese Operation wird als Trennen (Aufteilen) der Dateifreigaben bezeichnet. Durch das Entfernen der Replikationsbeziehung werden zwei unabhängige Dateifreigaben mit Schreib-/Lesezugriff erstellt. Daten werden nicht mehr zwischen ihnen synchronisiert. Sie können jede Dateifreigabe separat verwalten, die Kapazität erweitern, die IOPS anpassen und weitere Replikate erstellen.

Sie können außerdem festlegen, dass die Quell- und Replikat-Dateifreigaben aufgeteilt werden, falls ein Failover-Vorgang fehlschlägt.

Die Replikationsbeziehung kann nicht entfernt werden, wenn gerade ein anderer Vorgang an der Quell- oder Replikat-Dateifreigabe durchgeführt wird (beispielsweise wenn die Dateifreigabe vergrößert wird). Der geteilte Vorgang bleibt im Schwebezustand, bis der andere Vorgang abgeschlossen ist.

Das Entfernen der Replikationsbeziehung kann nicht rückgängig gemacht werden. Außerdem werden die Daten auf der Replik vor dem Entfernen der Replikationsbeziehung nicht automatisch mit der Quelldatei synchronisiert.

Entfernen der Replikationsbeziehung in der Konsole

So entfernen Sie die Replikationsbeziehung in der Konsole:

  1. Rufen Sie die Liste aller Dateifreigaben auf. Klicken Sie in der Konsole IBM Cloud auf das Symbol Navigation > Infrastruktur VPC > Storage > File Storage Shares.

  2. Klicken Sie auf den Namen einer Dateifreigabe oder Replikatdateifreigabe, um die zugehörige Detailseite aufzurufen.

  3. Klicken Sie im Abschnitt Replikationsbeziehung für Dateifreigabe auf Replikationsbeziehung entfernen. Durch das Entfernen der Replikationsbeziehung werden zwei unabhängige Dateifreigaben erstellt.

  4. Klicken Sie im neuen Fenster auf „ Verknüpfung aufheben “. Die Daten auf der Replik werden nicht automatisch mit der Quellfreigabe synchronisiert, bevor die Replikationsbeziehung entfernt wird.

Auf der Detailseite der Dateifreigabe wird keine Replikationsbeziehung angezeigt.

Replikationsbeziehung über die Befehlszeilenschnittstelle entfernen

Bevor Sie die Befehlszeilenschnittstelle (CLI) verwenden können, müssen Sie die IBM Cloud-CLI und das VPC-CLI-Plug-in installieren. Weitere Informationen finden Sie unter CLI-Voraussetzungen.

  1. Suchen Sie Ihre Freigabe über die Befehlszeilenschnittstelle, indem Sie Ihre Dateifreigaben in der Region mit dem Befehl ibmcloud is shares auflisten.

    ibmcloud is shares
    
    Listing shares in all resource groups and region us-south under account Test Account as user test.user@ibm.com...
    ID                                          Name                    Lifecycle state   Zone         Profile   Size(GB)   Resource group  Replication role   Accessor binding role   Snapshot count   Snapshot size
    r006-2a10af45-de9e-4894-8e9e-fd01a25ec529   my-replica-file-share   stable            us-south-1   dp2       101        Default         replica            none                    0                0
    r006-74634ace-43bd-4983-a22b-47b1c9662794   my-source-file-share    stable            us-south-2   dp2       101        Default         source             none                    1                1
    r006-b1707390-3825-41eb-a5bb-1161f77f8a58   my-vpc-file-share       stable            us-south-2   dp2       1000       Default         none               none                    0                0
    r006-b696742a-92ee-4f6a-bfd7-921d6ddf8fa6   my-file-share           stable            us-south-2   dp2       1500       Default         none               none                    0                0
    
  2. Zeigen Sie die Details der Dateifreigabe an, die Sie mit dem Befehl ibmcloud is share ändern möchten.

    ibmcloud is share my-file-share
    
    Getting file share my-file-share under account Test Account as user test.user@ibm.com...
    
    ID                           r006-b696742a-92ee-4f6a-bfd7-921d6ddf8fa6
    Name                         my-file-share
    CRN                          crn:v1:bluemix:public:is:us-south-2:a/a1234567::share:r006-b696742a-92ee-4f6a-bfd7-921d6ddf8fa6
    Lifecycle state              stable
    Access control mode          security_group
    Accessor binding role        none
    Zone                         us-south-2
    Profile                      dp2
    Size(GB)                     1500
    IOPS                         2000
    Encryption                   provider_managed
    Mount Targets                ID                                          Name
                                 r006-dd497561-c7c9-4dfb-af0a-c84eeee78b61   my-cli-share-mount-target-1
    
    Resource group               ID                                 Name
                                 db8e8d865a83e0aae03f25a492c5b39e   Default
    
    Created                      2023-10-18T22:15:15+00:00
    Latest job                   Job status   Job status reasons
                                 succeeded    -
    
    Replication share            ID                                          Name               Resource type
                                 r006-6d1719da-f790-45cc-9f68-896fd5673a1a   my-replica-share   share
    
    Replication role             source
    Replication status           active
    Replication status reasons   Status code   Status message
                                 -             -
    
    Snapshot count               0
    Snapshot size                0
    Source snapshot              -
    Allowed Access Protocols     nfs4
    Availability Mode            zonal
    Bandwidth(Mbps)              1
    Storage Generation           1
    
  3. Führen Sie den Befehl ibmcloud is share-replica-split aus und geben Sie die Replikatdateifreigabe nach Name oder ID an.

    ibmcloud is share-replica-split r006-6d1719da-f790-45cc-9f68-896fd5673a1a
    
    This will disassociate a replica file share r006-6d1719da-f790-45cc-9f68-896fd5673a1a from its source file share and cannot be undone. Continue [y/N] ?> y
    The request to disassociate a replica file share r006-6d1719da-f790-45cc-9f68-896fd5673a1a from its source file share was accepted, under account Test Accouont as user test.user@ibm.com...
    OK
    Replica File share r006-6d1719da-f790-45cc-9f68-896fd5673a1a is disassociated.
    
  4. Das Ergebnis dieses Vorgangs sind zwei unabhängige Datei-Freigaben mit Lese- und Schreibzugriff. Wenn Sie die Dateifreigaben in der Region auflisten, wird none in der Replikationsspalte für die beiden Dateifreigaben angezeigt.

    ibmcloud is shares
    
    Listing shares in all resource groups and region us-south under account Test Account as user test.user@ibm.com...
    ID                                          Name                    Lifecycle state   Zone         Profile   Size(GB)   Resource group   Replication role
    r006-dc6a644d-c7da-4c91-acf0-d66b47fc8516   my-replica-file-share   stable            us-south-1   dp2       1500       Default          replica
    r006-e4acfa9b-88b0-4f90-9320-537e6fa3482a   my-source-file-share    stable            us-south-2   dp2       1500       Default          source
    r006-6d1719da-f790-45cc-9f68-896fd5673a1a   my-replica-share        stable            us-south-3   dp2       1500       Default          none
    r006-925214bc-ded5-4626-9d8e-bc4e2e579232   my-new-file-share       stable            us-south-2   dp2       500        Default          none
    r006-b1707390-3825-41eb-a5bb-1161f77f8a58   my-vpc-file-share       stable            us-south-2   dp2       1000       Default          none
    r006-b696742a-92ee-4f6a-bfd7-921d6ddf8fa6   my-file-share           stable            us-south-2   dp2       1500       Default          none
    

Weitere Informationen zu den Befehlsoptionen finden Sie unter ibmcloud is share-replica-split.

Replikationsbeziehung mit der API entfernen

Erstellen Sie eine Anforderung DELETE /shares/{replica_id}/source, um die Replikationsbeziehung zu entfernen. Beim Aufteilen einer Dateifreigabe wird die Replikationsbeziehung entfernt und es werden zwei unabhängige Dateifreigaben erstellt. Nach dem Entfernen der Beziehung kann die Beziehung nicht wiederhergestellt werden. Eine Dateifreigabe kann nicht aufgeteilt werden, wenn die lifecycle_state der Dateifreigabe updating ist oder wenn Replikatoperationen in Bearbeitung sind.

curl -X DELETE \
"$vpc_api_endpoint/v1/shares/{replica_share_id}/source?version=2023-08-08&generation=2"\
-H "Authorization: Bearer $iam_token"\

Eine erfolgreiche Antwort gibt an, dass die Anforderung zum Aufheben der Zuordnung einer Replikatdateifreigabe zu der zugehörigen Quellendateifreigabe akzeptiert wurde.

Replikationsbeziehung mit Terraform entfernen

Verwenden Sie die Ressource ibm_is_share_replica_operations, um die Quellen-und Replikatfreigaben aufzuteilen. Beim Aufteilen einer Dateifreigabe wird die Replikationsbeziehung entfernt und es werden zwei unabhängige Dateifreigaben erstellt. Nach dem Entfernen der Beziehung kann die Beziehung nicht wiederhergestellt werden.

resource "ibm_is_share_replica_operations" "test" {
  share_replica = ibm_is_share.replica.id
  split_share = true
}

Weitere Informationen zu den Argumenten und Attributen finden Sie unter ibm_is_share_replica_operations.

Löschen von Replikaten und Quelldateifreigaben

Möglicherweise möchten Sie Ihre Dateifreigabe-Replik aus verschiedenen Gründen löschen. Einer der möglichen Gründe ist, die Löschung der Quelldatei-Freigabe freizugeben. Da sich die Replik-Dateifreigabe in der aktiven Replikation von der Quellfreigabe befindet, muss die Replik-Dateifreigabe von der Quelle getrennt werden, bevor die Quelldateifreigabe gelöscht werden kann. Sie können die Anteile auf zwei Arten aufteilen:

  • Führen Sie eine manuelle Aufteilung durch, wodurch die Replikationsbeziehung aufgehoben und zwei unabhängige Lese-/Schreib-Dateifreigaben erstellt werden. Anschließend können Sie die replizierte Dateifreigabe wie eine normale Dateifreigabe verwenden oder löschen.

  • Löschen Sie die Replikat-Dateifreigabe direkt, nachdem Sie die Einhängeziele gelöscht haben. Ein split-Prozess wird automatisch im Hintergrund eingeleitet. Nach Abschluss des Aufteilungsvorgangs wird die Replikatdateifreigabe gelöscht, und die Quellfreigabe kann ebenfalls gelöscht werden.

Sie können Dateifreigaben (Quelle oder Replikat) in der Konsole, über die Befehlszeilenschnittstelle, mit der API oder Terraform löschen.