InfoScale™ 9.0 Solutions Guide - AIX

To migrate a native file system to the VxFS file system

1. Install Storage Foundation on the physical application host.

   Refer to the InfoScale Installation Guide.

2. Add new storage to the physical application host on which you will configure VxVM.

   Refer to the InfoScale Storage Foundation Administrator's Guide.

3. Create a VxVM volume according to the your desired configuration on the newly added storage. The volume size cannot be less than source file system size.

   # vxdg init dg disk_access_name
   # vxassist -g dg make vol1 size

   Refer to the InfoScale Storage Foundation Administrator's Guide.

4. Mount the source file system if the file system is not mounted already.

   # mount -t ext4special /mnt1

5. (Optional) Run the fsmigadm analyze command and ensure that all checks pass:

   # fsmigadm analyze /dev/vx/dsk/dg/vol1 /mnt1
   

   Here /dev/vx/dsk/dg/vol1 is the target device and /mnt1 is the mounted source file system.

6. If the application is online, then shut down the application.
7. Start the migration by running fsmigadm start:

   # fsmigadm start /dev/vx/dsk/dg/vol1 /mnt1
   

   The fsmigadm command performs the following tasks:

   • Unmounts the source file system.

   • Creates a VxFS file system using the mkfs command on the new storage provided, specifying the same block size (bsize) as the source file system. You can use the -b blocksize option with fsmigadm start to specify your desired supported VxFS block size.

   • Mounts the target file system.

   • Mounts the source file system inside the target file system, as /mnt1/lost+found/srcfs.

   You can perform the following operations during the migration on the target VxFS file system:

   • You can get the status of the migration using the fsmigadm status command:

     # fsmigadm status /mnt1
     /mnt1:
             Source Device:                  /dev/sdh
             Target Device:                  /dev/vx/dsk/migdg/vol1
             Throttle rate:                  0 MB/s
             Copy rate:                      0.00 MB/s
             Total files copied:             9104
             Total data copied:              585.01 MB
             Migration Status:               Migration completed

   • You can speed up or slow down the migration using the fsmigadm throttle command:

     # fsmigadm throttle 9g /mnt1

   • You can pause the migration using fsmigadm pause command:

     # fsmigadm pause /mnt1

   • You can resume the migration using the fsmigadm resume command:

     # fsmigadm resume /mnt1

   The application can remain online throughout the entire migration operation. When the background copy operation completes, you are alerted via the system log.

   Both the target and the source file systems are kept up-to-date until the migration is committed.

8. While the background copy operation proceeds, you can bring the application online.
9. After the background copy operation completes, if you brought the application online while the migration operation proceeded, then shut down the application again.
10. Commit the migration:

    # fsmigadm commit /mnt1

    The fsmigadm command unmounts the source file system, unmounts the target file system, and then remounts the migrated target VxFS file system on the same mount point.

    Note:

    Make sure to commit the migration only after the background copy operation is completed.

11. Start the application on the Storage Foundation stack.