Nutanix Share Migration
- Marco Tubben
- Apr 24, 2023
- 2 min read
Nutanix heeft een ingebouwde functionaliteit voor het migreren van data van b.v. Windows file servers naar een Nutanix Files cluster. Deze wordt vaak over het hoofd gezien maar biedt een simpele en robuuste manier van data migratie in plaats van het gebruik van (betaalde) 3rd party tools.
Er zitten wel een paar beperkingen aan. Deze beperkingen zullen in de meest gangbare gevallen niet voorkomen, maar het is goed om ze toch even te benoemen :
-geen migratie van hard-links
-geen migratie van system access control lists (SACL’s)
-geen migratie van directory junctions
-geen support op custom extended attributen die op SMB shares zijn aangemaakt
-geen support op verschillende shares naar één target share migreren
Het proces bestaan in grove lijnen uit:
1 - Source share/server bekend maken op de omgeving
2 - Migratieplan aanmaken
3 - Daadwerkelijke migratie starten
4 - Eventueel opnieuw migreren van mislukte of inmiddels nieuw aangemaakte bestanden
Start allereerst een SSH sessie naar één van de Nutanix Files Server VM’s (FSVM) van het Nutanix Files cluster. Doe dit door eerst op een willekeurige CVM in te loggen, daar de beschikbare FSVM’s te laten zien dmv het ncli file-server list of ncli fs ls commando. Hierbij wordt het IP adres getoond op de regel met Nvm IP adresses <externe IP adres, interne IP adres>. Start vervolgens een SSH sessie naar het interne IP adres van een FSVM, dus het adres in het CVM/HOST subnet.
Alle commando’s worden uitgevoerd in de zogenaamde afs CLI
Stap 1 Aanmaken bron
afs migration.source_add source_alias=source_server_alias source_fs_fqdn="source_server_IP_address_or_FQDN" source_user='domain\\user_name' |

Kijk of koppeling geslaagd is:
afs migration.source_list |

Zoals te zien is de source file server nu bekend als BRON
Ik ga in deze voorbeelden er vanuit dat er al een Files share met de naam data is
Stap 2 Creëer migratie plan
afs migration.plan_create name=plan_name source_alias=source_server_alias / source_share=share/path target_share=target_share target_share_path=path/within/share |
Als optie kun je migrate=true of migrate=false toevoegen, de migratie zal dan direct of juist niet direct starten

De volgende extra commando’s zijn mogelijk indien je deze wilt gebruiken
migration.plan_summary geef een overzicht van het migratieplan migration.plan_pause pauzeer de migratie migration.plan_resume herstart de gepauzeerde migratie migration.plan_cancel stop de migratie migration.source_update pas de bron aan migration.source_delete verwijder de bron migration.source_list laat een lijst van bronnen zien |
Stap 3 Start de daadwerkelijke migratie
afs migration.plan_migrate name=plan_name |

Check de status van de migratie:
afs migration.plan_status name=plan_name verbose=true|false |

Stap 4 Eventueel opnieuw migreren van mislukte of nieuw aangemaakte bestanden
Het is mogelijk om een overzicht te maken van eventueel mislukte bestanden en deze in een logfile weg te schrijven:
afs migration.plan_get_failed_files_list name=plan_name / out_file=output_directory_path |
Herstart de datamigratie:
afs migration.plan_retry_failed_files name=plan_name |

Aanvullende tips:
Als een migratieplan gestopt wordt zal de Nutanix Files share waar de migratie naar toe gaat op Read Only staan. Om dit op te heffen kan de migratie plan weer opnieuw gestart worden of middels onderstaande commando weer op write toegang gezet worden:
afs share.client_blocking_filter share name delete Read-only ip_list=* vendor_name=kMigration |
Comments