Using the zonecfg Command to Modify a Zone Configuration

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

• Modify a resource type in a zone configuration

• Clear a property value in a zone configuration

• Add a dedicated device to a zone

• Modify a zone's privilege set

• Add and remove storage

How to Modify a Resource Type in a Zone Configuration

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

You must be the global administrator in the global zone or a user with the correct rights profile to perform this procedure.

1. Become root or assume an equivalent role.
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.

How to Clear a Property in a Zone Configuration

Use this procedure to reset a standalone property.

1. Become root or assume an equivalent role.
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.

How to Rename a Zone

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

Note that zones with either rootzpool or zpool resources cannot be renamed in the installed state because the zonename is part of the existing zpool name. To rename these zones, see “Renaming Zones on Shared Storage” at the end of this procedure.

You must be the global administrator in the global zone or a user with the correct rights profile to perform this procedure.

1. Become root or assume an equivalent role.
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.

Renaming Zones on Shared Storage

A zone in the installed state that has either rootzpool or zpool resources cannot be renamed because the zonename is part of the existing zpool name. To rename a zone on shared storage that has been installed and has online zpools, perform the following steps. The zone my-zone is renamed in this procedure.

• Detach the zone, my-zone in this procedure:

  # zoneadm -z my-zone detach

• Rename the zone by using the zonecfg command.

  # zonecfg -z my-zone ; "set zonename=newname ; set zonepath=/store/newname"

• Use zoneadm attach to reattach the zone.

  # zoneadm -z newname attach

How 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 or a user with appropriate authorizations to perform this procedure.

1. Become root or assume an equivalent role.
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

How 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 or a user in the global zone with the correct rights profile to perform this procedure.

1. Become root or assume an equivalent role.
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