Go to main content

man pages section 1M: System Administration Commands

Exit Print View

Updated: July 2017
 
 

txzonemgr(1M)

Name

txzonemgr - Trusted Extensions Zone Manager configuration utility

Synopsis

/usr/sbin/txzonemgr [-c | -d[f] | -Z file]

Description

The txzonemgr shell script provides a simple, menu-based GUI wizard for creating, installing, initializing, and booting labeled zones on a system on which Trusted Extensions is enabled. The script also provides menu items for networking options, name services options, and making the global zone a client of an existing LDAP server. By default, all zones are configured to use the same name service and IP address as the global zone.

txzonemgr can also perform a limited set of commands in command-line mode instead of GUI mode, by using appropriate options, described below.

txzonemgr is run by roles granted in the Zone Management Rights Profile, or by root in the global zone.

Options

Without options, txzonemgr operates as a menu-based GUI. Using any options will result in command-line operation only. Except as specified below, options cannot be combined.

The following options are supported:

–c

Create default zones. Requires that no zones already exist. The number, names, and attributes of the zones created is subject to change. However, typically a “public” zone and at least one other zone is created.

–d

Destroy all zones. All zones will be halted, uninstalled, and deleted. Prompts for confirmation unless the –f option is also specified.

–f

Force. Can be used with –d to override prompt for confirmation.

–Z file

Create a set of zones using the list specified in the file. Each line in the file must contain a zone name and its corresponding label, separated by whitespace. The label should not be quoted even if it contains whitespace. If an existing zone named “snapshot” exists, all the specified zones are cloned from it. Otherwise the first zone in the list is installed, and then a snapshot zone is cloned from it. The remaining zones are then cloned from the snapshot. The zones are configured to require manual booting. However, when an authorized user assigns a valid label to a GNOME workspace, the corresponding zone is booted automatically.

Exit Status

No values are returned for GUI mode. For command-line operation, the following exit values are returned:

0

Successful completion.

1

An error occurred.

2

Invalid usage.

Attributes

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE
ATTRIBUTE VALUE
Command Interface Stability
Committed
Interactive Dialogue
Not an Interface

See Also

zenity(1) (not a SunOS man page), ipadm(1M), zoneadm(1M), zonecfg(1M), attributes(5), rbac(5), zones(5)

Solaris Trusted Extensions Administrator's Procedures

Notes

If administering zones from JDS, use txzonemgr rather than CDE actions.

txzonemgr uses the zenity command. For details, see the zenity(1) man page, which is not part of the SunOS collection.