JavaScript is required to for searching.
Skip Navigation Links
Exit Print View
Oracle Solaris Administration: ZFS File Systems     Oracle Solaris 11 Information Library
search filter icon
search icon

Document Information


1.  Oracle Solaris ZFS File System (Introduction)

2.  Getting Started With Oracle Solaris ZFS

3.  Oracle Solaris ZFS and Traditional File System Differences

4.  Managing Oracle Solaris ZFS Storage Pools

5.  Managing ZFS Root Pool Components

6.  Managing Oracle Solaris ZFS File Systems

Managing ZFS File Systems (Overview)

Creating, Destroying, and Renaming ZFS File Systems

Creating a ZFS File System

Destroying a ZFS File System

Renaming a ZFS File System

Introducing ZFS Properties

ZFS Read-Only Native Properties

The used Property

Settable ZFS Native Properties

The canmount Property

The casesensitivity Property

The copies Property

The dedup Property

The encryption Property

The recordsize Property

The sharesmb Property

The volsize Property

ZFS User Properties

Querying ZFS File System Information

Listing Basic ZFS Information

Creating Complex ZFS Queries

Managing ZFS Properties

Setting ZFS Properties

Inheriting ZFS Properties

Querying ZFS Properties

Querying ZFS Properties for Scripting

Mounting ZFS File Systems

Managing ZFS Mount Points

Automatic Mount Points

Legacy Mount Points

Mounting ZFS File Systems

Using Temporary Mount Properties

Unmounting ZFS File Systems

Sharing and Unsharing ZFS File Systems

Legacy ZFS Sharing Syntax

New ZFS Sharing Syntax

Displaying ZFS Share Information

ZFS Sharing Inheritance

Changing a ZFS Share

Removing a ZFS Share

ZFS File Sharing Within a Non-Global Zone

New ZFS Sharing and Legacy Share Command Summary

Troubleshooting ZFS Share Problems

ZFS Sharing Migration/Transition Issues

Setting ZFS Quotas and Reservations

Setting Quotas on ZFS File Systems

Setting User and Group Quotas on a ZFS File System

Setting Reservations on ZFS File Systems

Encrypting ZFS File Systems

Changing an Encrypted ZFS File System's Keys

Delegating ZFS Key Operation Permissions

Mounting an Encrypted ZFS File System

Interactions Between ZFS Compression, Deduplication, and Encryption Properties

Examples of Encrypting ZFS File Systems

Migrating ZFS File Systems

How to Migrate a File System to a ZFS File System

Troubleshooting ZFS File System Migrations

Upgrading ZFS File Systems

7.  Working With Oracle Solaris ZFS Snapshots and Clones

8.  Using ACLs and Attributes to Protect Oracle Solaris ZFS Files

9.  Oracle Solaris ZFS Delegated Administration

10.  Oracle Solaris ZFS Advanced Topics

11.  Oracle Solaris ZFS Troubleshooting and Pool Recovery

12.  Archiving Snapshots and Root Pool Recovery

13.  Recommended Oracle Solaris ZFS Practices

A.  Oracle Solaris ZFS Version Descriptions


Migrating ZFS File Systems

You can use the shadow migration feature to migrate file systems as follows:

Shadow migration is a process that pulls the data to be migrated:

You can use the shadow property URI to identify the file system to be migrated in two ways:

Review the following considerations when migrating file systems:

How to Migrate a File System to a ZFS File System

  1. If you are migrating data from a remote NFS server, confirm that the name service information is accessible on both systems.

    For a large migration using NFS, you might consider doing a test migration of a subset of the data to ensure that the UID, GUID, and ACL information migrates correctly.

  2. Install the shadow-migration package, if necessary, and enable the shadowd service to assist with the migration process.
    # pkg install shadow-migration
    # svcadm enable shadowd

    If you do not enable the shadowd process, you will have to reset the shadow property to none when the migration process is complete.

  3. Set the local or remote file system to be migrated to read-only.

    If you are migrating a local ZFS file system, set it to read-only. For example:

    # zfs set readonly=on tank/home/data

    If you are migrating a remote file system, share it read-only. For example,

    # share -F nfs -o ro /export/home/ufsdata
    # share
    -               /export/home/ufsdata   ro   ""  
  4. Create a new ZFS file system with the shadow property set to the file system to be migrated.

    For example, if you are migrating a local ZFS file system, rpool/old, to a new ZFS file system, users/home/shadow, set the shadow property to rpool/old when the users/home/shadow file system is created.

    # zfs create -o shadow=file:///rpool/old users/home/shadow

    For example, to migrate /export/home/ufsdata from a remote server, set the shadow property when the ZFS file system is created.

    # zfs create -o shadow=nfs://v120-brm-02/export/home/ufsdata users/home/shadow2
  5. Check the progress of the migration.

    For example:

    # shadowstat
                                    BYTES   BYTES           ELAPSED
    DATASET                         XFRD    LEFT    ERRORS  TIME
    users/home/shadow               45.5M   2.75M   -       00:02:31
    users/home/shadow               55.8M   -       -       00:02:41
    users/home/shadow               69.7M   -       -       00:02:51
    No migrations in progress

    When the migration is complete, the shadow property is set to none.

    # zfs get -r shadow users/home/shadow*
    NAME                PROPERTY  VALUE   SOURCE
    users/home/shadow   shadow    none    -
    users/home/shadow2  shadow    none    -

Troubleshooting ZFS File System Migrations

Review the following points when troubleshooting ZFS migration problems: