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

How 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.

Solaris 10 8/07: How 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.

Solaris 10 3/05 Through Solaris 10 11/06: How to Modify a Property Type in a Zone Configuration

Use this procedure to reset a standalone property that does not have related properties to configure. For example, to remove the existing pool association, you can reset the pool resource to null.

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. Reset the property to be changed, the existing pool association in this procedure.

   zonecfg:my-zone> set 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.

Solaris 10 8/07: How 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.

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 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

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 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