Go to main content
Oracle® ZFS Storage Appliance Administration Guide, Release OS8.7.0

Exit Print View

Updated: July 2017
 
 

Renaming a Storage Pool (CLI)

To rename a storage pool, you must unconfigure it and then immediately import it with a new name. While storage is unconfigured, data will be inaccessible and there is a potential for data loss. Importing a storage pool can take a considerable amount of time.

Before You Begin

  • Do not perform a pool configuration operation while a disk firmware upgrade is occurring. To check if an upgrade is in progress, navigate to maintenance system updates.

  • Do not rename a pool while the peer controller is down or unreachable.

  1. Go to configuration storage.
  2. If you have multiple pools, a default pool is selected and displayed. If this is not the pool you want to rename, enter set pool= and specify another online pool.

    Note -  If you have a single pool, the pool name is not displayed, but it is selected.
    hostname:configuration storage (pool0)> set pool=pool1
                              pool = pool1
  3. Enter unconfig.
    hostname:configuration storage (pool1)> unconfig
  4. Enter done.
  5. Enter import.
    hostname:configuration storage> import
    
    Search for storage. Begin the process of searching for existing storage pools.
    
    Subcommands that are valid in this context:
    
       help [topic]         => Get context-sensitive help. If [topic] is specified,
                               it must be one of "builtins", "commands", "general",
                               "help" or "script".
    
       show                 => Show information pertinent to the current context
    
       abort                => Abort this task (potentially resulting in a
                               misconfigured system)
    
       done                 => Finish operating on "discover"
    
    hostname:configuration storage> discover>
    
  6. Enter done.
  7. To select the storage pool you just unconfigured, enter set pool= and the pool name.
    hostname:configuration storage select> set pool=pool1
                              pool = pool1
  8. To rename the storage pool, enter set name= and a new name.
    hostname:configuration storage (pool1)> set name=NewPool
                              pool = NewPool
  9. Enter done.

Related Topics