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:
-
Rufen Sie die Liste aller Dateifreigaben auf. Klicken Sie in der Konsole IBM Cloud auf das
Navigation > Infrastruktur
> Storage > File Storage Shares.
-
Klicken Sie auf den Namen einer Dateifreigabe oder Replikatdateifreigabe, um die zugehörige Detailseite aufzurufen.
-
Klicken Sie im Abschnitt Replikationsbeziehung für Dateifreigabe auf Replikationsbeziehung entfernen. Durch das Entfernen der Replikationsbeziehung werden zwei unabhängige Dateifreigaben erstellt.
-
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.
-
Suchen Sie Ihre Freigabe über die Befehlszeilenschnittstelle, indem Sie Ihre Dateifreigaben in der Region mit dem Befehl
ibmcloud is sharesauflisten.ibmcloud is sharesListing 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 -
Zeigen Sie die Details der Dateifreigabe an, die Sie mit dem Befehl
ibmcloud is shareändern möchten.ibmcloud is share my-file-shareGetting 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 -
Führen Sie den Befehl
ibmcloud is share-replica-splitaus und geben Sie die Replikatdateifreigabe nach Name oder ID an.ibmcloud is share-replica-split r006-6d1719da-f790-45cc-9f68-896fd5673a1aThis 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. -
Das Ergebnis dieses Vorgangs sind zwei unabhängige Datei-Freigaben mit Lese- und Schreibzugriff. Wenn Sie die Dateifreigaben in der Region auflisten, wird
nonein der Replikationsspalte für die beiden Dateifreigaben angezeigt.ibmcloud is sharesListing 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.