System Administration Guide: Virtualization Using the Solaris Operating System

Using the zonecfg Command to Modify a Zone Configuration

You can also use the zonecfg command to do the following:

ProcedureHow to Modify a Resource Type in a Zone Configuration

You can select a resource type and modify the specification for that resource.

Note that the contents of software packages in the inherit-pkg-dir directory cannot be modified or removed after the zone has been installed with zoneadm.

You must be the global administrator in the global zone to perform this procedure.

  1. Become superuser, or assume the Primary Administrator role.

    To create the role and assign the role to a user, see Using the Solaris Management Tools With RBAC (Task Map) in System Administration Guide: Basic Administration.

  2. Select the zone to be modified, my-zone in this procedure.


    global# zonecfg -z my-zone
    
  3. Select the resource type to be changed, for example, a resource control.


    zonecfg:my-zone> select rctl name=zone.cpu-shares
    
  4. Remove the current value.


    zonecfg:my-zone:rctl> remove value (priv=privileged,limit=20,action=none)
    
  5. Add the new value.


    zonecfg:my-zone:rctl> add value (priv=privileged,limit=10,action=none)
    
  6. End the revised rctl specification.


    zonecfg:my-zone:rctl> end
    
  7. Commit the zone configuration for the zone.


    zonecfg:my-zone> commit
    
  8. Exit the zonecfg command.


    zonecfg:my-zone> exit
    

    Note that even if you did not explicitly type commit at the prompt, a commit is automatically attempted when you type exit or an EOF occurs.

    Committed changes made through zonecfg take effect the next time the zone is booted.

ProcedureHow to Clear a Property Type in a Zone Configuration

Use this procedure to reset a standalone property.

  1. Become superuser, or assume the Primary Administrator role.

    To create the role and assign the role to a user, see Using the Solaris Management Tools With RBAC (Task Map) in System Administration Guide: Basic Administration.

  2. Select the zone to be modified, my-zone in this procedure.


    global# zonecfg -z my-zone
    
  3. Clear the property to be changed, the existing pool association in this procedure.


    zonecfg:my-zone> clear pool
    
  4. Commit the zone configuration for the zone.


    zonecfg:my-zone> commit
    
  5. Exit the zonecfg command.


    zonecfg:my-zone> exit
    

    Note that even if you did not explicitly type commit at the prompt, a commit is automatically attempted when you type exit or an EOF occurs.

    Committed changes made through zonecfg take effect the next time the zone is booted.

ProcedureHow to Rename a Zone

This procedure can be used to rename zones that are in either the configured state or the installed state.

You must be the global administrator in the global zone to perform this procedure.

  1. Become superuser, or assume the Primary Administrator role.

    To create the role and assign the role to a user, see Using the Solaris Management Tools With RBAC (Task Map) in System Administration Guide: Basic Administration.

  2. Select the zone to be renamed, my-zone in this procedure.


    global# zonecfg -z my-zone
    
  3. Change the name of the zone, for example, to newzone.


    zonecfg:my-zone> set zonename=newzone
    
  4. Commit the change.


    zonecfg:newzone> commit
    
  5. Exit the zonecfg command.


    zonecfg:newzone> exit
    

    Committed changes made through zonecfg take effect the next time the zone is booted.

ProcedureHow to Add a Dedicated Device to a Zone

The following specification places a scanning device in a non-global zone configuration.

You must be the global administrator in the global zone to perform this procedure.

  1. Become superuser, or assume the Primary Administrator role.

    To create the role and assign the role to a user, see Using the Solaris Management Tools With RBAC (Task Map) in System Administration Guide: Basic Administration.

  2. Add a device.


    zonecfg:my-zone> add device
    
  3. Set the device match, /dev/scsi/scanner/c3t4* in this procedure.


    zonecfg:my-zone:device> set match=/dev/scsi/scanner/c3t4*
    
  4. End the device specification.


    zonecfg:my-zone:device> end
    
  5. Exit the zonecfg command.


    zonecfg:my-zone> exit
    

ProcedureHow to Set zone.cpu-shares in the Global Zone

This procedure is used to persistently set shares in the global zone.

You must be the global administrator in the global zone to perform this procedure.

  1. Become superuser, or assume the Primary Administrator role.

    To create the role and assign the role to a user, see Using the Solaris Management Tools With RBAC (Task Map) in System Administration Guide: Basic Administration.

  2. Use the zonecfg command .


    # zonecfg -z global
    
  3. Set five shares for the global zone.


    zonecfg:global> set cpu-shares=5
    
  4. Exit zonecfg.


    zonecfg:global> exit