top of page
  • Writer's pictureMarco Tubben

Nutanix Share Migration


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


60 views0 comments

Recent Posts

See All

Nutanix Files Share protection

Het was al enige tijd mogelijk om de Nutanix Files servers te beschermen middels DR. Zie hiervoor mijn eerdere blog over Nutanis Files DR Sinds versie 4.0 is deze functionaliteit uitgebreid. Het is nu

bottom of page