Skip Navigation Links | |
Exit Print View | |
![]() |
man pages section 1M: System Administration Commands Oracle Solaris 11 Information Library |
- unconfigure or reconfigure a Solaris instance
/usr/sbin/sysconfig
/usr/sbin/sysconfig configure [-s] [-c config_profile.xml | dir] [--destructive] [-g system]
/usr/sbin/sysconfig unconfigure [-s] [--destructive] [-g system]
/usr/sbin/sysconfig create-profile [-o output_file [-l logfile] [-v verbosity] [-b] [-g system]
The sysconfig utility is the interface for unconfiguring and reconfiguring a Solaris instance. A Solaris instance is defined as a boot environment in either a global or a non-global zone.
There are three operations that are performed using the sysconfig utility: unconfiguration, configuration, and profile creation.
When sysconfig is called with the unconfigure subcommand, the system is unconfigured and left in an unconfigured state.
System configuration can occur either interactively or non-interactively. If the configure sub-command is invoked without a profile, the SCI Tool is activated and walks the user through the system configuration process. If the configure subcommand is invoked with a profile, then the configuration reads the profile and the configuration occurs non-interactively. The result in either case is a new system configuration.
The sysconfig command can also be used to generate a system configuration profile using the create-profile subcommand. The resulting profile is used with the sysconfig configure subcommand to configure systems non-interactively. Valid profile names include an .xml extension.
Configuration of a system can be performed either interactively, using the System Configuration Interactive (SCI) Tool, or non-interactively, using a system configuration profile.
The SCI tool configures the target system in an interactive way using a text user interface. It can also be used to collect information generated by the user that describes the desired configuration of the target system. The tool then generates a system configuration profile containing the desired system configuration.
The SCI tool supports configuration of freshly installed or unconfigured systems. It is designed to provide system configuration for newly created non-global zones and during text installation. If there is a need to modify the configuration of an already configured system utilizing SCI tool, such a system has to be unconfigured first before SCI tool can run.
The functional groupings that can be configured on a system are network, location, users, identity, and kbd_layout. Groupings can also be unconfigured and left in an unconfigured state. The default values for unconfigured groupings are shown below.
The following groupings are configurable.
Grouping | Components | Unconfigured State ------------------------------------------------------------ identity | system nodename | unknown ------------------------------------------------------------ kbd_layout | Keyboard | U.S. English ------------------------------------------------------------ network | network | No network ------------------------------------------------------------ location | timezone | UTC | locale | C locale ------------------------------------------------------------ users | root | Empty root password | initial user account | Remove user account ------------------------------------------------------------ naming_services | DNS, NIS and LDAP | No network naming | clients, nsswitch | services ------------------------------------------------------------
This section describes supported subcommands and their associated options.
Unconfigure a system and leave it in the unconfigured state.
Shut the system down after the unconfiguration completes.
If -g is not specified, the user will be queried for confirmation before system configuration occurs.
Do not preserve system data that is normally preserved during unconfiguration. By specifying this flag, the user indicates to any groupings unconfigured that data they would ordinarily preserve might be deleted.
Configure or reconfigure a system. The configure subcommand has access to the same options as the unconfigure subcommand. It also includes the following additional option.
Provides a profile or a directory of profiles to apply during configuration. If a profile is applied, the configuration step occurs non-interactively. If no profile is provided, the interactive system configuration tool is used for the configuration of the system.
All profiles must have an .xml file extension.
If you supply a directory to -c, all profiles in that directory must be valid (correctly formed) configuration profiles.
Run the SCI tool and create a system configuration profile. The default location for the profile is /system/volatile/profile/sc_profile.xml. The configuration generated is not applied to the system.
Replace the default profile location with output_file for the configuration profile.
Location of the log file. Used only with -o option.
Verbosity level. Used only with -o option.
Black and white version of SCI tool. Used only with -o option.
Example 1 Unconfiguring and Shutting Down
The following command unconfigures the system and leaves it in an unconfigured state. By default, if no grouping is specified, the groupings for the whole system are unconfigured.
# sysconfig unconfigure -s
Example 2 Unconfiguring the System
The following command unconfigures the system groupings and leaves the system unconfigured.
# sysconfig unconfigure -g system
Example 3 Reconfiguring System Using SCI Tool
The following command brings up the SCI Tool to reconfigure a system.
# sysconfig configure
Example 4 Reconfiguring Using a Profile
The following command reconfigures a system using a profile.
# sysconfig configure -c some_profile.xml
Example 5 Creating and Using a Profile
The following sequence of commands creates a profile, then uses it to reconfigure a system.
# sysconfig create-profile -o /tmp/myprofile.xml # sysconfig configure -g system -c /tmp/myprofile.xml
Example 6 Configuring the System in a Zone
The following command configures the system in a zone.
# zlogin ZONENAME root@ZONENAME# sysconfig configure -g system
Success.
Failure.
See attributes(5) for descriptions of the following attributes:
|
svcprop(1), svcadm(1M), svccfg(1M), attributes(5), attributes(5)