Oracle ZFS Storage Appliance: How to Rename a Storage Pool

Asset ID:	1-71-1948043.1
Update Date:	2015-12-04
Keywords:

Solution Type Technical Instruction Sure

Solution 1948043.1 : Oracle ZFS Storage Appliance: How to Rename a Storage Pool

Applies to:

Sun ZFS Storage 7420 - Version All Versions and later
Sun ZFS Storage 7320 - Version All Versions and later
Sun ZFS Storage 7120 - Version All Versions and later
Sun Storage 7410 Unified Storage System - Version All Versions and later
Sun Storage 7310 Unified Storage System - Version All Versions and later
7000 Appliance OS (Fishworks)

Goal

How to rename a Storage Pool

Solution

NOTE : Renaming a pool needs DOWNTIME, as the storage pool must be unconfigured.

From Appliance BUI :

Unconfigure the storage pool you want to rename.

Configuration > Storage > Select the Pool > UNCONFIG
Commit

Import the Pool and rename

Click on Import tab
Click on the pool name
You can now change the name.

Commit

From Appliance CLI :

Step1 : List the available storage pools

nas:> configuration
nas:configuration> storage
nas:configuration storage> ls

nas:configuration storage> ls
Pools:

   POOL             OWNER         DATA PROFILE LOG PROFILE STATUS   ERRORS
   pool-1           nas raidz2        -            online   0
-> pool-0           nas mirror        log_stripe   online   0

Properties:
                          pool = pool-0
                        status = online
                        errors = 0
                       profile = mirror
                   log_profile = log_stripe
                 cache_profile = -
                         scrub = none requested
nas:configuration storage (pool-0)>

Step 2 : Unconfigure the pool

In this example we are renaming "pool-1"

Select the pool you want to rename, if different from the default selection in above command :

                nas:configuration storage (pool-0)> set pool=pool-1
                               pool = pool-1
               nas:configuration storage (pool-1)>

Unconfigure the pool :

                nas:configuration storage (pool-1)> unconfig

               nas:configuration storage (pool-1) unconfigure>

               nas:configuration storage (pool-1) unconfigure> done
               Unconfiguring your storage will remove any existing filesystems and LUNs. This
               operation can be undone by importing the unconfigured storage pool.

               Are you sure? (Y/N)   <-- Select "Y"

               nas:configuration storage>

Step 3 : Import the pool

Run the import command :

               nas:configuration storage> import
               ...
               ...
               nas:configuration storage discover>

Once the prompt returns run "done" :

               nas:configuration storage discover> done
               ...
               ...
               nas:configuration storage select>

Check the pools available for import :

               nas:configuration storage select> ls
                       ID        STATE    PREVNAME         PROFILE    DATA SPARE CACHE    LOG
               pool = pool-000 online   pool-1           raidz2        6      0      0      0

                   NEWNAME
               name = pool-1

Step 4 : Rename the Pool

Select the pool using pool ID ;

nas:configuration storage select> set pool=pool-000
pool = pool-000

Rename the pool :

               nas:configuration storage select> set name=pool-2
                                   name = pool-2
               nas:configuration storage select>

Finish the renaming :

nas:configuration storage select> done

Step 5 : List out available pools

nas:configuration storage (pool-0)> ls
Pools:

   POOL             OWNER         DATA PROFILE LOG PROFILE STATUS   ERRORS
   pool-2           nas raidz2        -            online   0
-> pool-0           nas mirror        log_stripe   online   0

Properties:
                          pool = pool-0
                        status = online
                        errors = 0
                       profile = mirror
                   log_profile = log_stripe
                 cache_profile = -
                         scrub = none requested

Attachments

This solution has no attachment