Cloning a Snapshot (CLI)

Note:

Cloning is a licensed feature for certain models. For details, refer to the "Oracle Software License Agreement ("SLA") and Entitlement for Hardware Systems with Integrated Software Options" and the Licensing Information User Manual for the software release.

Use the following procedure to make a clone of an existing snapshot of a filesystem or LUN.

Note:

Clones of projects are not supported.

1. Go to the appropriate filesystem, LUN, or project and enter snapshots.

   hostname:shares myproject/demo_share> snapshots
   hostname:shares myproject/demo_share snapshots>

2. Select the snapshot you want to clone.

   hostname:shares myproject/demo_share snapshots> select snap1

3. Use the clone command, followed by the name of the local project in which you want to create the clone if different from the original project, and then the clone name.

   By default, the clone is created in the same project as the snapshot being cloned.

   hostname:shares myproject/demo_share@snap1> clone demo_clone

   You are placed into an uncommitted share context. From here, you can adjust properties as needed before committing the changes to create the clone.

   The clone will have the same retention hold setting as the original snapshot. To apply or remove a retention hold for the clone, make a snapshot of the clone and specify a new retention hold setting.

   To use the snapshot retention hold feature, apply deferred update "Support for Snapshot Retention." For information about deferred updates, see Deferred Updates in Oracle ZFS Storage Appliance Customer Service Manual, Release OS8.8.x.

4. Use the get command to view properties.

   hostname:shares myproject/demo_clone (uncommitted clone)> get
                       aclinherit = restricted (inherited)
                          aclmode = discard (inherited)
                            atime = true (inherited)
                  casesensitivity = mixed
                         checksum = fletcher4 (inherited)
                      compression = off (inherited)
                            dedup = false (inherited)
                    compressratio = 100
                           copies = 1 (inherited)
                         creation = Mon Nov 15 2021 17:27:29 GMT+0000 (UTC)
                          logbias = latency (inherited)
                       mountpoint = /export/clone0 (inherited)
                    normalization = none
                            quota = 0
                       quota_snap = true
                         readonly = false (inherited)
                       recordsize = 128K (inherited)
                      reservation = 0
                 reservation_snap = true
                         rstchown = true (inherited)
                   secondarycache = all (inherited)
                           shadow = none
                           nbmand = false (inherited)
                         sharesmb = off (inherited)
                         sharenfs = off (inherited)
                          snapdir = hidden (inherited)
                         utf8only = true
                            vscan = false (inherited)
                       encryption = off
                       writelimit = unlimited (default)
                        readlimit = unlimited (default)
                        snaplabel =
                         sharedav = off (inherited)
                         shareftp = off (inherited)
                        sharesftp = off (inherited)
                        sharetftp = off (inherited)
                 shareobjectstore = off (inherited)
                          shares3 = off (inherited)
                         shareoci = off (inherited)
                             pool = p0
                           origin = default/f0@snap0
                   canonical_name = p0/local/default/clone0
               effectivereadlimit = unlimited
              effectivewritelimit = unlimited
                         exported = true (inherited)
                        nodestroy = false
                     maxblocksize = 1M (inherited)
                     lz4supported = true (inherited)
      acl_passthru_mode_supported = true (inherited)
                       space_data = 1K
                 space_unused_res = 0
                  space_snapshots = 0
                  space_available = 5.35T
                      space_total = 1K
                         root_acl = 
                 root_permissions = 700
                        root_user = nobody
                       root_group = other
                      smbshareacl =
                  snapret_enabled = false

5. Use the set command to adjust properties.

   hostname:shares myproject/demo_clone (uncommitted clone)> set quota=10G
                            quota = 10G (uncommitted)

6. Use the commit command to commit the changes, and to create the clone.

   hostname:shares myproject/demo_clone (uncommitted clone)> commit
   hostname:shares myproject/demo_share@demo_clone>

Related Topics

• To perform share operations on a clone, see Shares and Projects.

• To make a clone of a clone, see Cloning a Clone.

• To view all the clones of a particular snapshot, see Viewing Clones of a Snapshot (CLI).

• To determine the snapshot from which a clone was made, see Viewing a Clone Origin (CLI).

• To make a clone of a snapshot in a replication package, see Cloning a Snapshot in a Replication Package (CLI).