2/4/2014

docs.oracle.com/cd/E19253-01/819-5461/ggset/index.html

Documentation Home > Oracle Solaris ZFS Administration Guide > Chapter 5 Installing and Booting an Oracle Solaris ZFS Root File System > Installing a ZFS Root File System (Initial Installation)

Oracle Solaris ZFS Administration Guide

Previous: Installing and Booting an Oracle Solaris ZFS Root File System (Overview) Next: Installing a ZFS Root File System (Oracle Solaris Flash Archive Installation)

Installing a ZFS Root File System (Initial Installation)

In this Solaris release, you can perform an initial installation by using the Solaris interactive text installer to create a ZFS storage pool that contains a bootable ZFS root file system. If you have an existing ZFS storage pool that you want to use for your ZFS root file system, then you must use Oracle Solaris Live Upgrade to migrate your existing UFS root file system to a ZFS root file system in an existing ZFS storage pool. For more information, see Migrating a UFS Root File System to a ZFS Root File System (Oracle Solaris Live Upgrade). If you will be configuring zones after the initial installation of a ZFS root file system and you plan on patching or upgrading the system, see Using Oracle Solaris Live Upgrade to Migrate or Upgrade a System With Zones (Solaris 10 10/08) or Using Oracle Solaris Live Upgrade to Migrate or Upgrade a System With Zones (at Least Solaris 10 5/09). If you already have ZFS storage pools on the system, they are acknowledged by the following message. However, these pools remain untouched, unless you select the disks in the existing pools to create the new storage pool.

T h e r ea r ee x i s t i n gZ F Sp o o l sa v a i l a b l eo nt h i ss y s t e m . H o w e v e r ,t h e yc a no n l yb eu p g r a d e d u s i n gt h eL i v eU p g r a d et o o l s . T h ef o l l o w i n gs c r e e n sw i l lo n l ya l l o wy o ut oi n s t a l laZ F Sr o o ts y s t e m , n o tu p g r a d eo n e . Caution Existing pools will be destroyed if any of their disks are selected for the new pool. Before you begin the initial installation to create a ZFS storage pool, see Oracle Solaris Installation and Oracle Solaris Live Upgrade Requirements for ZFS Support.

Example 51 Initial Installation of a Bootable ZFS Root File System

The Solaris interactive text installation process is basically the same as in previous Solaris releases, except that you are prompted to create a UFS or a ZFS root file system. UFS is the still the default file system in this release. If you select a ZFS root file system, you are prompted to create a ZFS storage pool. The steps for installing a ZFS root file system follow: 1. Select the Solaris interactive installation method because a Solaris Flash installation is not available to create a bootable ZFS root file system. However, you can create a ZFS flash archive to be used during a JumpStart installation. For more information, see Installing a ZFS Root File System (Oracle Solaris Flash Archive Installation). Starting in the Solaris 10 10/08 release, you can migrate a UFS root file system to a ZFS root file system as long as at least the Solaris 10 10/08 release is already installed. For more information about migrating to a ZFS root file system, see Migrating a UFS Root File System to a ZFS Root File System (Oracle Solaris Live Upgrade). 2. To create a ZFS root file system, select the ZFS option. For example:

C h o o s eF i l e s y s t e mT y p e

http://docs.oracle.com/cd/E19253-01/819-5461/ggset/index.html

1/6

2/4/2014

docs.oracle.com/cd/E19253-01/819-5461/ggset/index.html

S e l e c tt h ef i l e s y s t e mt ou s ef o ry o u rS o l a r i si n s t a l l a t i o n

[]U F S [ X ]Z F S 3. After you select the software to be installed, you are prompted to select the disks to create your ZFS storage pool. This screen is similar as in previous Solaris releases.

S e l e c tD i s k s O nt h i ss c r e e ny o um u s ts e l e c tt h ed i s k sf o ri n s t a l l i n gS o l a r i ss o f t w a r e . S t a r tb yl o o k i n ga tt h eS u g g e s t e dM i n i m u mf i e l d ;t h i sv a l u ei st h e a p p r o x i m a t es p a c en e e d e dt oi n s t a l lt h es o f t w a r ey o u ' v es e l e c t e d .F o rZ F S , m u l t i p l ed i s k sw i l lb ec o n f i g u r e da sm i r r o r s ,s ot h ed i s ky o uc h o o s e ,o rt h e s l i c ew i t h i nt h ed i s km u s te x c e e dt h eS u g g e s t e dM i n i m u mv a l u e . N O T E :* *d e n o t e sc u r r e n tb o o td i s k D i s kD e v i c e A v a i l a b l eS p a c e = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = [ X ] c 1 t 0 d 0 6 9 9 9 4M B ( F 4t oe d i t ) [] c 1 t 1 d 0 6 9 9 9 4M B [ ] c 1 t 2 d 0 0M B [ ] c 1 t 3 d 0 0M B M a x i m u mR o o tS i z e : 6 9 9 9 4M B S u g g e s t e dM i n i m u m : 8 2 7 9M B You can select the disk or disks to be used for your ZFS root pool. If you select two disks, a mirrored two-disk configuration is set up for your root pool. Either a two-disk or a three-disk mirrored pool is optimal. If you have eight disks and you select all of them, those eight disks are used for the root pool as one big mirror. This configuration is not optimal. Another option is to create a mirrored root pool after the initial installation is complete. A RAID-Z pool configuration for the root pool is not supported. For more information about configuring ZFS storage pools, see Replication Features of a ZFS Storage Pool. 4. To select two disks to create a mirrored root pool, use the cursor control keys to select the second disk. In the following example, both c 1 t 1 d 0 and c 1 t 2 d 0 are selected as the root pool disks. Both disks must have an SMI label and a slice 0. If the disks are not labeled with an SMI label or they don't contain slices, then you must exit the installation program, use the f o r m a t utility to relabel and repartition the disks, and then restart the installation program.

S e l e c tD i s k s O nt h i ss c r e e ny o um u s ts e l e c tt h ed i s k sf o ri n s t a l l i n gS o l a r i ss o f t w a r e . S t a r tb yl o o k i n ga tt h eS u g g e s t e dM i n i m u mf i e l d ;t h i sv a l u ei st h e a p p r o x i m a t es p a c en e e d e dt oi n s t a l lt h es o f t w a r ey o u ' v es e l e c t e d .F o rZ F S , m u l t i p l ed i s k sw i l lb ec o n f i g u r e da sm i r r o r s ,s ot h ed i s ky o uc h o o s e ,o rt h e s l i c ew i t h i nt h ed i s km u s te x c e e dt h eS u g g e s t e dM i n i m u mv a l u e . N O T E :* *d e n o t e sc u r r e n tb o o td i s k D i s kD e v i c e A v a i l a b l eS p a c e = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = [ X ] c 1 t 0 d 0 6 9 9 9 4M B [ X ] c 1 t 1 d 0 6 9 9 9 4M B ( F 4t oe d i t ) [ ] c 1 t 2 d 0 0M B [ ] c 1 t 3 d 0 0M B M a x i m u mR o o tS i z e : 6 9 9 9 4M B S u g g e s t e dM i n i m u m : 8 2 7 9M B If the Available Space column identifies 0 MB, the disk most likely has an EFI label. If you want to use a disk with an EFI label, you will need to exit the installation program, relabel the disk with an SMI label by using the f o r m a t e command, then restart the installation program. If you do not create a mirrored root pool during installation, you can easily create one after the installation. For information, see How to Create a Mirrored Root Pool (Post Installation). 5. After you have selected a disk or disks for your ZFS storage pool, a screen similar to the following is displayed:

http://docs.oracle.com/cd/E19253-01/819-5461/ggset/index.html

2/6

2/4/2014

docs.oracle.com/cd/E19253-01/819-5461/ggset/index.html

C o n f i g u r eZ F SS e t t i n g s S p e c i f yt h en a m eo ft h ep o o lt ob ec r e a t e df r o mt h ed i s k ( s )y o uh a v ec h o s e n . A l s os p e c i f yt h en a m eo ft h ed a t a s e tt ob ec r e a t e dw i t h i nt h ep o o lt h a ti s t ob eu s e da st h er o o td i r e c t o r yf o rt h ef i l e s y s t e m . Z F SP o o lN a m e :r p o o l Z F SR o o tD a t a s e tN a m e :s 1 0 s _ u 9 w o s _ 0 8 Z F SP o o lS i z e( i nM B ) :6 9 9 9 5 S i z eo fS w a pA r e a( i nM B ) :2 0 4 8 S i z eo fD u m pA r e a( i nM B ) :1 5 3 6 ( P o o ls i z em u s tb eb e t w e e n6 2 3 1M Ba n d6 9 9 9 5M B ) [ X ]K e e p/a n d/ v a rc o m b i n e d []P u t/ v a ro nas e p a r a t ed a t a s e t From this screen, you can change the name of the ZFS pool, the dataset name, the pool size, and the swap and dump device sizes by moving the cursor control keys through the entries and replacing the default value with new values. Or, you can accept the default values. In addition, you can modify how the / v a r file system is created and mounted. In this example, the root dataset name is changed to z f s B E.

Z F SP o o lN a m e :r p o o l Z F SR o o tD a t a s e tN a m e :z f s B E Z F SP o o lS i z e( i nM B ) :6 9 9 9 5 S i z eo fS w a pA r e a( i nM B ) :2 0 4 8 S i z eo fD u m pA r e a( i nM B ) :1 5 3 6 ( P o o ls i z em u s tb eb e t w e e n6 2 3 1M Ba n d6 9 9 9 5M B ) [ X ]K e e p/a n d/ v a rc o m b i n e d []P u t/ v a ro nas e p a r a t ed a t a s e t 6. You can change the installation profile at this final installation screen. For example:

P r o f i l e T h ei n f o r m a t i o ns h o w nb e l o wi sy o u rp r o f i l ef o ri n s t a l l i n gS o l a r i ss o f t w a r e . I tr e f l e c t st h ec h o i c e sy o u ' v em a d eo np r e v i o u ss c r e e n s . = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = I n s t a l l a t i o nO p t i o n :I n i t i a l B o o tD e v i c e :c 1 t 0 d 0 R o o tF i l eS y s t e mT y p e :Z F S C l i e n tS e r v i c e s :N o n e R e g i o n s :N o r t hA m e r i c a S y s t e mL o c a l e :C(C) S o f t w a r e :S o l a r i s1 0 ,E n t i r eD i s t r i b u t i o n P o o lN a m e :r p o o l B o o tE n v i r o n m e n tN a m e :z f s B E P o o lS i z e :6 9 9 9 5M B D e v i c e si nP o o l :c 1 t 0 d 0 c 1 t 1 d 0 7. After the installation is completed, review the resulting ZFS storage pool and file system information. For example:

# z p o o ls t a t u s p o o l :r p o o l s t a t e :O N L I N E s c r u b :n o n er e q u e s t e d c o n f i g : N A M E S T A T E R E A DW R I T EC K S U M r p o o l O N L I N E 0 0 0 http://docs.oracle.com/cd/E19253-01/819-5461/ggset/index.html

3/6

2/4/2014

docs.oracle.com/cd/E19253-01/819-5461/ggset/index.html

r p o o l m i r r o r 0 c 1 t 0 d 0 s 0 c 1 t 1 d 0 s 0

O N L I N E O N L I N E O N L I N E O N L I N E

0 0 0 0

0 0 0 0

0 0 0 0

e r r o r s :N ok n o w nd a t ae r r o r s # z f sl i s t N A M E U S E D A V A I L R E F E R M O U N T P O I N T r p o o l 8 . 0 3 G 5 8 . 9 G 9 6 K / r p o o l r p o o l / R O O T 4 . 4 7 G 5 8 . 9 G 2 1 K l e g a c y r p o o l / R O O T / z f s B E 4 . 4 7 G 5 8 . 9 G 4 . 4 7 G / r p o o l / d u m p 1 . 5 0 G 5 8 . 9 G 1 . 5 0 G r p o o l / e x p o r t 4 4 K 5 8 . 9 G 2 3 K / e x p o r t r p o o l / e x p o r t / h o m e 2 1 K 5 8 . 9 G 2 1 K / e x p o r t / h o m e r p o o l / s w a p 2 . 0 6 G 6 1 . 0 G 1 6 K The sample z f sl i s t output identifies the root pool components, such as the r p o o l / R O O T directory, which is not accessible by default. 8. To create another ZFS boot environment (BE) in the same storage pool, you can use the l u c r e a t e command. In the following example, a new BE named z f s 2 B E is created. The current BE is named z f s B E, as shown in the z f sl i s t output. However, the current BE is not acknowledged in the l u s t a t u s output until the new BE is created.

# l u s t a t u s E R R O R :N ob o o te n v i r o n m e n t sa r ec o n f i g u r e do nt h i ss y s t e m E R R O R :c a n n o td e t e r m i n el i s to fa l lb o o te n v i r o n m e n tn a m e s If you create a new ZFS BE in the same pool, use syntax similar to the following:

# l u c r e a t enz f s 2 B E I N F O R M A T I O N :T h ec u r r e n tb o o te n v i r o n m e n ti sn o tn a m e d-a s s i g n i n gn a m e< z f s B E > . C u r r e n tb o o te n v i r o n m e n ti sn a m e d< z f s B E > . C r e a t i n gi n i t i a lc o n f i g u r a t i o nf o rp r i m a r yb o o te n v i r o n m e n t< z f s B E > . T h ed e v i c e< / d e v / d s k / c 1 t 0 d 0 s 0 >i sn o tar o o td e v i c ef o ra n yb o o te n v i r o n m e n t ;c a n n o tg e tB EI D . P B Ec o n f i g u r a t i o ns u c c e s s f u l :P B En a m e< z f s B E >P B EB o o tD e v i c e< / d e v / d s k / c 1 t 0 d 0 s 0 > . C o m p a r i n gs o u r c eb o o te n v i r o n m e n t< z f s B E >f i l es y s t e m sw i t ht h ef i l e s y s t e m ( s )y o us p e c i f i e df o rt h en e wb o o te n v i r o n m e n t .D e t e r m i n i n gw h i c h f i l es y s t e m ss h o u l db ei nt h en e wb o o te n v i r o n m e n t . U p d a t i n gb o o te n v i r o n m e n td e s c r i p t i o nd a t a b a s eo na l lB E s . U p d a t i n gs y s t e mc o n f i g u r a t i o nf i l e s . C r e a t i n gc o n f i g u r a t i o nf o rb o o te n v i r o n m e n t< z f s 2 B E > . S o u r c eb o o te n v i r o n m e n ti s< z f s B E > . C r e a t i n gb o o te n v i r o n m e n t< z f s 2 B E > . C l o n i n gf i l es y s t e m sf r o mb o o te n v i r o n m e n t< z f s B E >t oc r e a t eb o o te n v i r o n m e n t< z f s 2 B E > . C r e a t i n gs n a p s h o tf o r< r p o o l / R O O T / z f s B E >o n< r p o o l / R O O T / z f s B E @ z f s 2 B E > . C r e a t i n gc l o n ef o r< r p o o l / R O O T / z f s B E @ z f s 2 B E >o n< r p o o l / R O O T / z f s 2 B E > . S e t t i n gc a n m o u n t = n o a u t of o r< / >i nz o n e< g l o b a l >o n< r p o o l / R O O T / z f s 2 B E > . P o p u l a t i o no fb o o te n v i r o n m e n t< z f s 2 B E >s u c c e s s f u l . C r e a t i o no fb o o te n v i r o n m e n t< z f s 2 B E >s u c c e s s f u l . Creating a ZFS BE within the same pool uses ZFS clone and snapshot features to instantly create the BE. For more details about using Oracle Solaris Live Upgrade for a ZFS root migration, see Migrating a UFS Root File System to a ZFS Root File System (Oracle Solaris Live Upgrade). 9. Next, verify the new boot environments. For example:

# l u s t a t u s B o o tE n v i r o n m e n t I s A c t i v eA c t i v e C a n C o p y N a m e C o m p l e t eN o w O nR e b o o tD e l e t eS t a t u s -----z f s B E y e s y e s y e s n o z f s 2 B E y e s n o n o y e s # z f sl i s t N A M E U S E D A V A I L R E F E R M O U N T P O I N T r p o o l 8 . 0 3 G 5 8 . 9 G 9 7 K / r p o o l r p o o l / R O O T 4 . 4 7 G 5 8 . 9 G 2 1 K l e g a c y r p o o l / R O O T / z f s 2 B E 1 1 6 K 5 8 . 9 G 4 . 4 7 G / http://docs.oracle.com/cd/E19253-01/819-5461/ggset/index.html

4/6

2/4/2014

r p o o l / R O O T / z f s 2 B E r p o o l / R O O T / z f s B E r p o o l / R O O T / z f s B E @ z f s 2 B E r p o o l / d u m p r p o o l / e x p o r t r p o o l / e x p o r t / h o m e r p o o l / s w a p

1 1 6 K 4 . 4 7 G 7 5 . 5 K 1 . 5 0 G 4 4 K 2 1 K 2 . 0 6 G

docs.oracle.com/cd/E19253-01/819-5461/ggset/index.html 5 8 . 9 G 4 . 4 7 G / 5 8 . 9 G 4 . 4 7 G / - 4 . 4 7 G 5 8 . 9 G 1 . 5 0 G 5 8 . 9 G 2 3 K / e x p o r t 5 8 . 9 G 2 1 K / e x p o r t / h o m e 6 1 . 0 G 1 6 K -

10. To boot from an alternate BE, use the l u a c t i v a t e command. After you activate the BE on a SPARC based system, use the b o o t L command to identify the available BEs when the boot device contains a ZFS storage pool. When booting from an x86 based system, identify the BE to be booted from the GRUB menu. For example, on a SPARC based system, use the b o o t L command to display a list of available BEs. To boot from the new BE, z f s 2 B E, select option 2. Then, type the displayed b o o t Z command.

o k b o o tL E x e c u t i n gl a s tc o m m a n d :b o o tL B o o td e v i c e :/ p c i @ 7 c 0 / p c i @ 0 / p c i @ 1 / p c i @ 0 , 2 / L S I L o g i c , s a s @ 2 / d i s k @ 0 F i l ea n da r g s :L 1z f s B E 2z f s 2 B E S e l e c te n v i r o n m e n tt ob o o t :[1-2] : 2 T ob o o tt h es e l e c t e de n t r y ,i n v o k e : b o o t[ < r o o t d e v i c e > ]Zr p o o l / R O O T / z f s 2 B E o k b o o tZr p o o l / R O O T / z f s 2 B E For more information about booting a ZFS file system, see Booting From a ZFS Root File System.

How to Create a Mirrored Root Pool (Post Installation)

If you did not create a mirrored ZFS root pool during installation, you can easily create one after the installation. For information about replacing a disk in root pool, see How to Replace a Disk in the ZFS Root Pool. 1. Display your current root pool status.

# z p o o ls t a t u sr p o o l p o o l :r p o o l s t a t e :O N L I N E s c r u b :n o n er e q u e s t e d c o n f i g : N A M E S T A T E r p o o l O N L I N E c 1 t 0 d 0 s 0 O N L I N E e r r o r s :N ok n o w nd a t ae r r o r s 2. Attach a second disk to configure a mirrored root pool. R E A DW R I T EC K S U M 0 0 0 0 0 0

# z p o o la t t a c hr p o o lc 1 t 0 d 0 s 0c 1 t 1 d 0 s 0 P l e a s eb es u r et oi n v o k ei n s t a l l b o o t ( 1 M )t om a k e' c 1 t 1 d 0 s 0 'b o o t a b l e . M a k es u r et ow a i tu n t i lr e s i l v e ri sd o n eb e f o r er e b o o t i n g . 3. View the root pool status to confirm that resilvering is complete.

# z p o o ls t a t u sr p o o l p o o l :r p o o l s t a t e :O N L I N E s t a t u s :O n eo rm o r ed e v i c e si sc u r r e n t l yb e i n gr e s i l v e r e d . T h ep o o lw i l l c o n t i n u et of u n c t i o n ,p o s s i b l yi nad e g r a d e ds t a t e . a c t i o n :W a i tf o rt h er e s i l v e rt oc o m p l e t e . s c r u b :r e s i l v e ri np r o g r e s sf o r0 h 1 m ,2 4 . 2 6 %d o n e ,0 h 3 mt og o http://docs.oracle.com/cd/E19253-01/819-5461/ggset/index.html

5/6

2/4/2014

docs.oracle.com/cd/E19253-01/819-5461/ggset/index.html s c r u b :r e s i l v e ri np r o g r e s sf o r0 h 1 m ,2 4 . 2 6 %d o n e ,0 h 3 mt og o c o n f i g :

N A M E r p o o l m i r r o r 0

S T A T E O N L I N E O N L I N E

R E A DW R I T EC K S U M 0 0 0 0 0 0 0 0 0 0 0 0 3 . 1 8 Gr e s i l v e r e d

c 1 t 0 d 0 s 0 O N L I N E c 1 t 1 d 0 s 0 O N L I N E e r r o r s :N ok n o w nd a t ae r r o r s

In the above output, the resilvering process is not complete. Resilvering is complete when you see messages similar to the following:

s c r u b :r e s i l v e rc o m p l e t e da f t e r0 h 1 0 mw i t h0e r r o r so nT h uM a r1 11 1 : 2 7 : 2 22 0 1 0 4. Apply boot blocks to the second disk after resilvering is complete.

s p a r c # i n s t a l l b o o tFz f s/ u s r / p l a t f o r m / ` u n a m ei ` / l i b / f s / z f s / b o o t b l k/ d e v / r d s k / c 1 t 1 d 0 s 0

x 8 6 # i n s t a l l g r u b/ b o o t / g r u b / s t a g e 1/ b o o t / g r u b / s t a g e 2/ d e v / r d s k / c 1 t 1 d 0 s 0 5. Verify that you can boot successfully from the second disk. 6. Set up the system to boot automatically from the new disk, either by using the e e p r o m command, the s e t e n v command from the SPARC boot PROM. Or, reconfigure the PC BIOS. Previous: Installing and Booting an Oracle Solaris ZFS Root File System (Overview) Next: Installing a ZFS Root File System (Oracle Solaris Flash Archive Installation)
2010, Oracle Corporation and/or its affiliates

http://docs.oracle.com/cd/E19253-01/819-5461/ggset/index.html

6/6