Go to main content

man pages section 8: System Administration Commands

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

txzonemgr(8)

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.

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(7) for descriptions of the following attributes:

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

See Also

zenity(1), attributes(7), rbac(7), zones(7), ipadm(8), zoneadm(8), zonecfg(8)

Trusted Extensions Configuration and Administration

History

The txzonemgr command was added to Solaris in Solaris 10 4/08 (Update 5). Prior to that it was included in the Trusted Extensions add-on for Solaris.