Creazione e gestione di volumi duplicati di File Storage for Classic

Crea un volume di archiviazione file duplicato a partire da uno snapshot, con opzioni di capacità e prestazioni ereditate e personalizzabili. Il duplicato può essere dipendente o indipendente.

Puoi creare un duplicato di un IBM Cloud® File Storage for Classic esistente. Per impostazione predefinita, il volume duplicato eredita le opzioni di capacità e prestazioni del volume originale. Tuttavia, è possibile modificare entrambi gli attributi. Il duplicato ha una copia dei dati fino al momento dell'istantanea utilizzata per crearli. Il volume duplicato può essere dipendente o indipendente dal volume originale.

Se sei un utente di un account dedicato di IBM Cloud® Kubernetes Service, consulta le tue opzioni per la duplicazione di un volume nella Documentazione IBM Cloud Kubernetes Service.

Poiché il duplicato è basato sui dati in un'istantanea a un punto temporale, è necessario lo spazio di istantanea sul volume originale, prima che tu possa creare un duplicato. Per ulteriori informazioni sulle istantanee e su come ordinare lo spazio di istantanea, consulta la documentazione delle istantanee.

Tipi di volumi duplicati

Duplicato indipendente

I duplicati indipendenti possono essere creati sia dai volumi primari che da quelli di replica. Il nuovo duplicato viene creato nello stesso data center del volume originale. Se si crea un duplicato da un volume di replica, il volume duplicato viene creato nello stesso data center della replica.

Utilizzi comuni per un volume duplicato indipendente

  • Copia gold. Utilizza un volume di archiviazione come copia di riferimento da cui creare più istanze per vari scopi.
  • Aggiornamenti dei dati. Crea una copia dei tuoi dati di produzione da integrare nel tuo ambiente non di produzione a scopo di test.
  • Sviluppo e collaudo. Crea fino a quattro duplicati simultanei per volta di un volume per creare dati duplicati per attività di sviluppo e test.

Duplicato dipendente

I volumi duplicati dipendenti vengono creati utilizzando un'istantanea dal volume primario. I volumi di replica non possono essere utilizzati per creare o aggiornare i volumi duplicati.

Utilizzi comuni per un volume duplicato dipendente

  • Esecuzione di test del ripristino di emergenza. Crea un duplicato del volume di origine e confrontalo con la replica. Confrontando il duplicato con la replica, è possibile verificare che i dati replicati siano intatti e che possano essere utilizzati in caso di emergenza, senza interrompere la replica.
  • Ripristino da un'istantanea. Ripristina i dati sul volume originale con file e data specifici da un'istantanea senza sovrascrivere l'intero volume originale con la funzione di ripristino da un'istantanea.
  • Aggiornamenti dei dati. Crea una copia dei tuoi dati di produzione da integrare nel tuo ambiente non di produzione a scopo di test.
  • Sviluppo e collaudo. Crea fino a quattro duplicati simultanei per volta di un volume per creare dati duplicati per attività di sviluppo e test.

Creazione di un duplicato da un volume specifico nella console

  1. Vai al tuo elenco di File Storage for Classic. Dal menu Infrastruttura Icona VPC > Infrastruttura classica, fare clic su Storage > File Storage for Classic.

  2. Individua e fai clic sul nome del volume.

  3. Fare clic su Azioni Icona Azioni > Duplica condivisione.

  4. Selezionare se il duplicato deve essere dipendente o indipendente.

  5. Scegli la tua opzione di istantanea.

    • Creare ora un'istantanea per i dati più recenti.
    • Utilizzare l'ultima istantanea eseguita precedentemente.
  6. L'ubicazione e il profilo IOPS rimangono uguali al volume originale.

  7. È possibile scegliere di configurare il volume duplicato con fatturazione oraria o mensile. Il tipo di fatturazione per il volume originale viene selezionato automaticamente e puoi modificarlo se lo desideri.

  8. Se lo desideri, puoi specificare un valore IOPS diverso o un livello IOPS diverso per il nuovo volume. La designazione degli IOPS del volume originale è impostata per impostazione predefinita. Vengono visualizzate le combinazioni di Performance e dimensioni disponibili.

    • Se il tuo volume originale è al livello Endurance 0,25 IOPS, non puoi effettuare una nuova selezione.
    • Se il tuo volume originale è al livello Endurance 2, 4 o 10 IOPS, puoi spostarti dovunque tra questi livelli per il nuovo volume.
  9. Puoi aggiornare la dimensione del nuovo volume in modo che sia più grande dell'originale. La dimensione del volume originale è impostata per impostazione predefinita.

    File Storage for Classic può essere ridimensionato fino a 10 volte la dimensione originale del volume.

  10. Puoi aggiornare lo spazio di istantanea per il nuovo volume per aggiungere più, meno o zero spazio di istantanea. Lo spazio di istantanea del volume originale viene impostato per impostazione predefinita.

  11. Selezionare la casella per confermare di aver letto e accettato i termini, quindi fare clic su Crea per effettuare l'ordine.

Dopo aver selezionato Crea, viene visualizzata la finestra di conferma dell'ordine. Quando si chiude la finestra, si ritorna all'elenco delle risorse. Puoi tornare al tuo elenco di condivisioni File Storage for Classic per selezionare il nuovo duplicato di cui è stato eseguito il provisioning. La sezione Dettagli condivisione visualizza informazioni quali Tipo duplicato, un link alla pagina dei dettagli della condivisione parent e il nome dell'istantanea utilizzata per creare il duplicato.

Creazione di un duplicato dalla CLI

Prima di iniziare, decidi sul client CLI che vuoi utilizzare.

Creazione di un duplicato da IBMCLOUD CLI

È possibile utilizzare il comando ibmcloud sl file volume-duplicate per creare un duplicato per la condivisione file. Il seguente esempio crea un duplicato indipendente della condivisione file 560382016.

ibmcloud sl file volume-duplicate 560382016
This action will incur charges on your account. Continue?> y
OK
Order 110554892 was placed.
 > Storage as a Service
 > File Storage
 > 500 GBs
 > 4 IOPS per GB
 > 500 GB (Snapshot Space)
You may run 'ibmcloud sl file volume-list --order 110554892' to find this file volume after it is ready.

Il nuovo duplicato è pronto in pochi minuti.

$ ibmcloud sl file volume-list --order 110554892
id          username             datacenter   storage_type             capacity_gb   bytes_used   IOPs   ip_addr                                 lunId   active_transactions   rep_partner_count   notes
560391190   SL02SEV1414935_269   dal09        endurance_file_storage   500           -            -      fsf-dal0902b-fz.service.softlayer.com   -       1                     0                   -

Se si dispone di un'istantanea specifica che contiene i dati che si desidera utilizzare per creare il volume duplicato, specificare l'ID dell'istantanea utilizzando l'opzione --origin-snapshot-id.

Quando si desidera creare un duplicato dipendente del volume, utilizzare il comando con l'opzione --dependent-duplicate. Vedi il seguente esempio.

$ ibmcloud sl file volume-duplicate 560391190 --dependent-duplicate
This action will incur charges on your account. Continue?> y
OK
Order 110553472 was placed.
 > Storage as a Service
 > File Storage
 > 500 GBs
 > 4 IOPS per GB
 > 500 GB (Snapshot Space)
You may run 'ibmcloud sl file volume-list --order 110553472' to find this file volume after it is ready.

Per ulteriori informazioni su tutti i parametri disponibili per questo comando, vedi ibmcloud sl file volume - duplicate.

Creazione di un duplicato dall'SLCLI

Per creare un volume duplicato indipendente File Storage for Classic, puoi utilizzare il seguente comando.

$ slcli file volume-duplicate --help
Usage: slcli file volume-duplicate [OPTIONS] ORIGIN_VOLUME_ID
Options:
  -o, --origin-snapshot-id INTEGER
                                  ID of an origin volume snapshot to use for
                                  duplcation.
  -c, --duplicate-size INTEGER    Size of duplicate file volume in GB. ***If
                                  no size is specified, the size of the origin
                                  volume will be used.***
                                  Minimum: [the size
                                  of the origin volume]
  -i, --duplicate-iops INTEGER    Performance Storage IOPS, between 100 and
                                  6000 in multiples of 100 [only used for
                                  performance volumes] ***If no IOPS value is
                                  specified, the IOPS value of the origin
                                  volume will be used.***
                                  Requirements: [If
                                  IOPS/GB for the origin volume is less than
                                  0.3, IOPS/GB for the duplicate must also be
                                  less than 0.3. If IOPS/GB for the origin
                                  volume is greater than or equal to 0.3,
                                  IOPS/GB for the duplicate must also be
                                  greater than or equal to 0.3.]
  -t, --duplicate-tier [0.25|2|4|10]
                                  Endurance Storage Tier (IOPS per GB) [only
                                  used for endurance volumes] ***If no tier is
                                  specified, the tier of the origin volume
                                  will be used.***
                                  Requirements: [If IOPS/GB
                                  for the origin volume is 0.25, IOPS/GB for
                                  the duplicate must also be 0.25. If IOPS/GB
                                  for the origin volume is greater than 0.25,
                                  IOPS/GB for the duplicate must also be
                                  greater than 0.25.]
  -s, --duplicate-snapshot-size INTEGER
                                  The size of snapshot space to order for the
                                  duplicate. ***If no snapshot space size is
                                  specified, the snapshot space size of the
                                  origin file volume will be used.***
                                  Input
                                  "0" for this parameter to order a duplicate
                                  volume with no snapshot space.
  --billing [hourly|monthly]      Optional parameter for Billing rate (default
                                  to monthly)
  -h, --help                      Show this message and exit.

Anche i volumi duplicati dipendenti possono essere ordinati dalla CLI, con l'opzione --dependent-duplicate TRUE.

slcli file volume-duplicate --dependent-duplicate TRUE <primary-vol-id>

Per ulteriori informazioni relative alle opzioni di comando disponibili, consultare file volume-duplicate.

Creazione di una condivisione duplicata con l'API

Per ordinare un volume duplicato indipendente Block Storage for Classic con l'API, puoi eseguire una chiamata POST /SoftLayer_Product_Order/placeOrder. Il seguente esempio di API REST crea un duplicato indipendente per un volume Endurance (livelli IOPS).

URL
https://USERNAME:APIKEY@api.softlayer.com/rest/v3.1/SoftLayer_Product_Order/placeOrder
Immettere
POST

Corpo della richiesta

    {
       "parameters":[{
       "complexType": "SoftLayer_Container_Product_Order_Network_Storage_AsAService",
       "packageId": 531,
       "duplicateOriginVolumeId":<PrimaryId>,
       "isDependentDuplicateFlag": 1,
       "prices": [{"id": 12207}, {"id": 10723}, {"id": 10413}, {"id": 15749}, {"id":14043}],
       "quantity": 1,
       "location": 2,
       "volumeSize":23
       }]
   }

Se si dispone di un'istantanea specifica che contiene i dati che si desidera utilizzare per creare il volume duplicato, specificare l'ID dell'istantanea nella proprietà duplicateOriginSnapshotId.

Per ordinare un duplicato dipendente per un volume Performance (IOPS personalizzato), effettua una chiamata POST /SoftLayer_Product_Order/placeOrder come il seguente esempio di API REST.

URL
https://USERNAME:APIKEY@api.softlayer.com/rest/v3.1/SoftLayer_Product_Order/placeOrder
Immettere
POST

Corpo della richiesta

   {
       "parameters":[{
       "complexType": "SoftLayer_Container_Product_Order_Network_Storage_AsAService",
       "packageId": 531,
       "duplicateOriginVolumeId":<PrimaryId>,
       "isDependentDuplicateFlag": 1,
       "prices": [{"id": 15751}, {"id": 19487}, {"id": 18983}, {"id": 15749}, {"id":14043}],
       "quantity": 1,
       "iops":456,
       "location": 2,
       "volumeSize":23
       }]
   }

Se si dispone di un'istantanea specifica che contiene i dati che si desidera utilizzare per creare il volume duplicato, specificare l'ID dell'istantanea nella proprietà duplicateOriginSnapshotId.

Per ulteriori informazioni sull'API e sulle opzioni, vedi la Guida di riferimento API. Cercare il SoftLayer_Container_Product_Order_Network_Storage_AsAService tipo di dati.

Gestione del tuo volume duplicato

A tutti i volumi duplicati può accedere un host per le operazioni di lettura e scrittura non appena viene eseguito il provisioning del volume.

Tuttavia, le istantanee e la replica di volumi duplicati indipendenti sono consentite solo quando la copia dei dati dall'originale al duplicato è completa e il volume duplicato è completamente indipendente. A seconda della quantità di dati, il processo di separazione può richiedere diverse ore. Una volta completata l'operazione, la copia potrà essere gestita e utilizzata come volume indipendente.

Mentre i dati vengono copiati dal volume originale alla copia indipendente, è possibile notare che l'indicatore di stato nella pagina dei dettagli mostra che la duplicazione è in corso. Durante questo periodo, è possibile collegarsi a un host e leggere e scrivere sul volume, ma non è possibile creare pianificazioni di snapshot né aggiornare i dati dalla condivisione file originale. Una volta completato il processo di separazione, il nuovo volume è indipendente da quello originale e può essere gestito normalmente tramite snapshot e replica. Il duplicato indipendente può essere aggiornato manualmente utilizzando un'istantanea dal volume principale una volta completata la conversione.

I duplicati dipendenti non passano attraverso il processo di separazione e possono essere aggiornati manualmente in qualsiasi momento. Il processo di aggiornamento può essere avviato dalla CLI, con l'API o nella console. In seguito, se desideri convertire il duplicato dipendente in un volume indipendente, puoi avviare tale processo utilizzando anche l'IU, l'API o la CLI.

Il volume duplicato dipendente blocca l'istantanea originale in modo che l'istantanea non possa essere eliminata mentre il duplicato dipendente esiste.

Aggiornamento dei dati sul duplicato dal volume padre nella console

Man mano che passa il tempo e il volume primario cambia, è possibile aggiornare il volume duplicato con queste modifiche per riflettere lo stato corrente attraverso l'azione di aggiornamento. L'aggiornamento consiste nell'acquisire un'istantanea del volume primario e quindi nell'aggiornare il volume duplicato utilizzando i dati di tale istantanea.

Se il volume duplicato è indipendente, è possibile arrestare un'operazione di aggiornamento in esecuzione e avviarne una nuova.

  1. Vai al tuo elenco di File Storage for Classic. Dal menu Infrastruttura Icona VPC > Infrastruttura classica, fare clic su Storage > File Storage for Classic.

  2. Individua il volume duplicato e fai clic sul suo nome per visualizzare i dettagli del volume.

  3. Fare clic su Azioni Icona Azioni > Ripristina istantanea principale.

  4. Dall'elenco di istantanee, selezionare l'istantanea principale che contiene i dati che si desidera ripristinare sul volume duplicato. Se il volume duplicato che si sta aggiornando è un volume indipendente, è possibile arrestare un'operazione in esecuzione e forzare l'avvio di un nuovo ripristino. Se si desidera forzare l'arresto di un processo di aggiornamento corrente, selezionare la casella prima di continuare.

    Il ripristino dei dati da un'istantanea comporta la perdita di tutti i dati creati o modificati da quando è stata eseguita l'istantanea selezionata. Durante l'operazione di aggiornamento, il volume duplicato viene disabilitato e deve essere rimontato al termine dell'aggiornamento.

  5. Fai clic su per avviare l'aggiornamento. Il ricaricamento potrebbe richiedere un po' di tempo. La barra di stato mostra la percentuale di dati copiata nel volume. Per visualizzare lo stato aggiornato, aggiornare la pagina nel browser.

Conversione di un volume dipendente in un duplicato indipendente nella console

  1. Vai al tuo elenco di File Storage for Classic. Dal menu Infrastruttura Icona VPC > Infrastruttura classica, fare clic su Storage > File Storage for Classic.
  2. Individua il volume duplicato e fai clic sul suo nome per visualizzare i dettagli del volume.
  3. Fare clic su Azioni icona Azioni > Converti duplicato dipendente.
  4. Selezionare la casella per confermare che si desidera continuare con la conversione.
  5. Fai clic su Yes.

Il processo di conversione potrebbe richiedere un po' di tempo. Più grande è il volume, più tempo ci vuole per convertirlo. Puoi visualizzare lo stato del processo sulla pagina dei dettagli del volume sotto l'intestazione Stato di conversione duplicato.

Aggiornamento dei dati sul duplicato dal volume parent dalla CLI

Man mano che passa il tempo e il volume primario cambia, è possibile aggiornare il volume duplicato con queste modifiche per riflettere lo stato corrente attraverso l'azione di aggiornamento. L'aggiornamento implica l'esecuzione di un'istantanea del volume principale e quindi l'aggiornamento del volume duplicato utilizzando tale istantanea.

Un aggiornamento non comporta tempi di inattività sul volume primario. Tuttavia, durante la transazione di aggiornamento, il volume duplicato non è disponibile e deve essere rimontato al termine dell'aggiornamento.

Il processo di aggiornamento può richiedere molto tempo. Se si rileva che si dispone di nuovi dati che si desidera copiare nel volume duplicato indipendente, è possibile immettere il comando file volume-refresh con l'opzione --force-refresh per arrestare tutte le transazioni di aggiornamento in corso e in sospeso e avviare un nuovo aggiornamento.

Il processo di aggiornamento forzato funziona solo su volumi indipendenti.

Aggiornamento dei dati su un duplicato dipendente da IBMCLOUD CLI

È possibile utilizzare il comando ibmcloud sl file volume-refresh per aggiornare i dati sul volume duplicato con i dati da un'istantanea del volume principale. Il seguente esempio mostra come creare manualmente un'istantanea del volume principale 560391190, quindi utilizzare la nuova istantanea 560391944 per aggiornare i dati sulla condivisione file 560391814.

$ ibmcloud sl file snapshot-create 560391190
OK
New snapshot 560391944 was created.
$ ibmcloud sl file volume-refresh 560391814 560391944
OK

Per ulteriori informazioni su tutti i parametri disponibili per questo comando, consulta ibmcloud sl file volume - refresh.

Aggiornamento dei dati su un duplicato dipendente dalla SLCLI

Gli aggiornamenti possono essere avviati utilizzando il seguente comando.

slcli file volume-refresh <duplicate-vol-id> <primary-snapshot-id>

Per ulteriori informazioni relative alle opzioni di comando disponibili, consultare slcli file volume-refresh.

Conversione di un volume dipendente in un duplicato indipendente dalla CLI

Se in futuro desideri utilizzare il volume dipendente come volume autonomo, puoi convertirlo in un normale volume indipendente File Storage for Classic tramite la CLI.

Conversione di un volume dipendente da IBMCLOUD CLI

Utilizzare il comando ibmcloud sl file volume-convert per convertire un duplicato dipendente in una condivisione file indipendente. Il seguente esempio mostra come convertire la condivisione file 560391814 in un volume indipendente.

$ ibmcloud sl file volume-convert 560391814
OK

Il processo di conversione potrebbe richiedere un po' di tempo. Più grande è il volume, più tempo ci vuole per convertirlo.

Per ulteriori informazioni su tutti i parametri disponibili per questo comando, vedi ibmcloud sl file volume - convert.

Conversione di un volume dipendente dalla SLCLI

utilizzare il seguente comando.

slcli file volume-convert <dependent-vol-id>

Il processo di conversione potrebbe richiedere un po' di tempo. Più grande è il volume, più tempo ci vuole per convertirlo. Utilizzare il seguente comando per controllare l'avanzamento.

slcli file duplicate-convert-status <dependent-vol-id>

Il seguente esempio mostra l'output che puoi aspettarti.

slcli file duplicate-convert-status 370597202
Username            Active Conversion Start Timestamp   Completed Percentage
SL02SEVC307608_74   2022-06-13 14:59:17                 90

Per ulteriori informazioni relative alle opzioni di comando disponibili, consultare file duplicate-convert-status.

Aggiornamento dei dati sul duplicato dal volume parent con l'API

Man mano che passa il tempo e il volume primario cambia, è possibile aggiornare il volume duplicato con queste modifiche per riflettere lo stato corrente attraverso l'azione di aggiornamento. L'aggiornamento consiste nell'acquisire un'istantanea del volume primario e quindi nell'aggiornare il volume duplicato utilizzando i dati di tale istantanea.

Un aggiornamento non comporta tempi di inattività sul volume primario. Tuttavia, durante la transazione di aggiornamento, il volume duplicato viene disabilitato e deve essere rimontato al termine dell'aggiornamento.

Il processo di aggiornamento può richiedere molto tempo. È possibile che si disponga di nuovi dati che si desidera aggiungere al duplicato prima che l'aggiornamento in esecuzione sia terminato. In tal caso, è possibile effettuare una seconda chiamata a refreshDuplicate e specificare il secondo parametro forceRefresh come true per arrestare tutte le transazioni di aggiornamento in corso e in sospeso e avviare un nuovo aggiornamento. Se il secondo parametro è impostato su false o non è specificato, la chiamata ha esito negativo se è già in corso un altro aggiornamento.

Il processo di aggiornamento forzato funziona solo su volumi indipendenti.

Esempio API REST

URL
https://USERNAME:APIKEY@api.softlayer.com/rest/v3.1/SoftLayer_Network_Storage/duplicateVolumeId/refreshDuplicate
Immettere
POST

Corpo della richiesta

   {
    "parameters": [primaryVolumeSnapshotId, true OR false]
   }

Esempio API SOAP

URL
https://api.softlayer.com/soap/v3.1/SoftLayer_Network_Storage
Immettere
POST

Corpo della richiesta

   <?xml version="1.0" encoding="UTF-8"?>
   <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://api.service.softlayer.com/soap/v3.1/">
   <SOAP-ENV:Header>
    <ns1:authenticate>
     <username>USERNAME</username>
     <apiKey>APIKEY</apiKey>
    </ns1:authenticate>
    <ns2:SoftLayer_Network_StorageInitParameters>
     <id>duplicate Volume Id</id>
    </ns2:SoftLayer_Network_StorageInitParameters>
   </SOAP-ENV:Header>
   <SOAP-ENV:Body>
    <ns1:refreshDuplicate>
      <snapshotId xsi:type="int">primary Volume Snapshot Id</snapshotId>
      <forceRefresh xsi:type="boolean">true</forceRefresh> <-- (remove this tag for normal refresh)
    </ns1:refreshDuplicate>
   </SOAP-ENV:Body>
   </SOAP-ENV:Envelope>

Per ulteriori informazioni sull'API e le opzioni, vedi la Guida di riferimento API e SoftLayer_Network_Storage::refreshDuplicate.

Conversione di un volume dipendente in un duplicato indipendente con la API

Se in futuro desideri utilizzare il volume dipendente come volume autonomo, puoi convertirlo in un normale volume indipendente IBM Cloud® Block Storage for Classic tramite l'API. Si veda il seguente esempio che utilizza l'API REST.

URL
https://USERNAME:APIKEY@api.softlayer.com/rest/v3.1/SoftLayer_Network_Storage/<storageId>/convertCloneDependentToIndependent
Immettere
POST
Corpo della richiesta
vuoto

Per ulteriori informazioni sull'API e sulle opzioni, vedi la Guida di riferimento API.

Annullamento di un volume di archiviazione con un duplicato dipendente

Per eliminare un volume principale che presenta volumi dipendenti attivi, è necessario eliminare prima i volumi dipendenti duplicati.