svcadm(8)을 검색하려면 섹션에서 8 을 선택하고, 맨 페이지 이름에 svcadm을 입력하고 검색을 누른다.
sysconfig(8)
sysconfig(8) System Administration Commands sysconfig(8)
NAME
sysconfig - unconfigure or reconfigure a Solaris instance
SYNOPSIS
/usr/sbin/sysconfig
/usr/sbin/sysconfig configure | reconfigure [-s] [--destructive]
[-c config_profile.xml | dir] [-g grouping,grouping]
/usr/sbin/sysconfig unconfigure [-s] [--destructive]
[-g grouping,grouping]
/usr/sbin/sysconfig unconfigure [-s] [-g system] [--destructive]
--remove-profiles
/usr/sbin/sysconfig create-profile [-o output_directory] [-l logfile]
[-v verbosity] [-b] [-g grouping,grouping]
DESCRIPTION
The sysconfig utility is the interface for unconfiguring and reconfig‐
uring a Solaris instance. A Solaris instance is defined as a boot envi‐
ronment in either a global or a non-global zone. Users are able to un‐
configure particular, predefined subsystems. The subsystems of a system
that are configurable are referred to as functional groupings. A func‐
tional grouping is a service or collection of services that are config‐
ured or unconfigured when the utility is executed.
There are three operations that are performed using the sysconfig util‐
ity: 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-interac‐
tively. If the configure sub-command is invoked without a profile, the
system is unconfigured immediately and an interactive interface is ac‐
tivated at the console that walks the user through the system configu‐
ration 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 configuration for
the requested functional grouping.
Configuration and reconfiguration are synonymous. The reconfigure sub‐
command is an alias for the configure subcommand.
The sysconfig command can also be used to generate a configuration pro‐
file using the create-profile subcommand. The resulting profile is used
with the sysconfig configure subcommand to configure functional group‐
ings 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 gener‐
ated by the user that describes the desired configuration of the target
system. The tool then generates a system configuration profile contain‐
ing the desired system configuration.
The SCI tool supports configuration of freshly installed or unconfig‐
ured 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 uti‐
lizing the SCI tool, such a system has to be unconfigured first before
the SCI tool can run.
Besides using sysconfig to perform system configurations, individual
functional groupings can be reconfigured and unconfigured. The func‐
tional groupings that can be configured on a system are network, nam‐
ing_services, location, users, identity, support, and keyboard. The
system grouping will configure or unconfigure all functional groupings.
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.
tab(); cw(1.37i) |cw(2.06i) |cw(2.06i) lw(1.37i) |lw(2.06i) |lw(2.06i)
GroupingComponentsUnconfigured State _ identitysystem nodenameunknown _
keyboardkeyboardU.S. English _ naming_servicesDNS, NIS, & LDAP
clients,No network naming services nsswitch _ networknetworkNo network
_ locationtimezoneUTC localeC locale _ supportASRASR disabled _ sys‐
temall groupingsall groupings unconfigured _ usersrootEmpty root pass‐
word initial user accountRemove user account
The sysconfig utility makes use of the Service Management Facility
(SMF) to centralize configuration information. The data generated by a
system configuration operation is an administrative customization to
the SMF repository stored by default at the sysconfig-profile layer of
the SMF repository. When sysconfig configure -c dir is used, individual
profiles can be applied at the enterprise-profile, site-profile, and
node-profile SMF layers by placing those profiles in the appropriate
subdirectory within dir: dir/enterprise, dir/site, and dir/node.
When sysconfig is used to configure the system, any values present in
the admin layer that mask values set by sysconfig are removed. This ap‐
plies only to the values that may be configured by using interactive
mode.
SUB-COMMANDS
This section describes supported subcommands and their associated op‐
tions.
/usr/sbin/sysconfig unconfigure [-s] [--destructive]
[-g grouping,grouping]
Unconfigure a system and leave it in the unconfigured state.
-s
Shut the system down after the unconfiguration completes.
-g grouping
The grouping to unconfigure. If -g is not specified, all group‐
ings will be unconfigured, resulting in a system unconfigura‐
tion. If -g system is specified, the user will be queried for
confirmation before system unconfiguration occurs.
--destructive
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 pre‐
serve might be deleted.
/usr/sbin/sysconfig unconfigure [-s] [-g system] [--destructive]
--remove-profiles
--remove-profiles
This option is only valid with the unconfigure subcommand.
This flag will unconfigure the system and remove configuration
data from the SMF enterprise-profile, site-profile, node-pro‐
file, sysconfig-profile, and admin layers. Profiles installed
by a package will not be removed. This effectively returns the
system to the original system configuration state that was de‐
livered by the installers.
Any unpackaged profiles stored in the /etc/svc/profile/enter‐
prise, /etc/svc/profile/site, /etc/svc/profile/node, and
/etc/svc/profile/sysconfig directory will be removed as part of
the process. Administrative customizations at the admin layer
will be deleted.
Because this action is extensive, the removed XML profiles will
be archived in a tar file named profiles-timestamp.tar in the
/etc/svc/profile/backup directory.
This option is only valid with the system grouping. Using -g
system is optional when calling this option.
/usr/sbin/sysconfig configure | reconfigure [-s] [--destructive]
[-c config_profile.xml | dir] [-g grouping,grouping]
Configure or reconfigure a grouping. The configure subcommand has
access to the same options as the unconfigure subcommand. It also
includes the following additional option.
-c config_profile.xml | dir
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 inter‐
active system configuration tool is used for the configuration
of the grouping.
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.
/usr/sbin/sysconfig create-profile [-o output_directory] [-l logfile]
[-v verbosity] [-b] [-g grouping,grouping]
Run the SCI tool and create a system configuration profile. The de‐
fault location for the profile is /system/volatile/profile/sc_pro‐
file.xml. The configuration generated is not applied to the system.
-o output_directory
Replace the default profile location with output_directory for
the configuration profile. A sc_profile.xml file will be cre‐
ated under this directory.
-l logfile, --log-location=logfile
Location of the log file. The default is /var/tmp/in‐
stall/sysconfig.log
-v verbosity, --log-level=verbosity
Verbosity level, one of error, warn, info, debug, or input.
These are in order of increasing verbosity, from least to most.
The default is info.
-b
Black-and-white version of SCI tool.
EXAMPLES
Example 1 Unconfiguring and Shutting Down
The following command unconfigures the system and leaves it in an un‐
configured state. By default, if no grouping is specified, the group‐
ings for the whole system are unconfigured.
# sysconfig unconfigure -s
Example 2 Unconfiguring the System
The following command unconfigures the system and leaves the system un‐
configured.
# sysconfig unconfigure -g system
Example 3 Reconfiguring the System Using the 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/my_sysconfig_directory/
# sysconfig configure -g system \
-c /tmp/my_sysconfig_directory/sc_profile.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
Example 7 Interactively Configuring Functional Groupings
The following command reconfigures the network and naming services
functional groupings. The SCI Tool is invoked and the groupings will be
reconfigured interactively.
# sysconfig configure -g network,naming_services
Example 8 Configuring Functional Groupings Non-interactively
The following sequence of commands creates a profile for the network
and naming services, then uses the profile to reconfigure the groupings
non-interactively.
# sysconfig create-profile -g network,naming_services \
-o /tmp/my_sysconfig_directory/
# sysconfig configure -g network,naming_services \
-c /tmp/my_sysconfig_directory/sc_profile.xml
Example 9 Unconfigure a System and Reverting the Groupings
The following command unconfigures a system and reverts the groupings
to the default installed state.
# sysconfigure unconfigure --include-site-profile
EXIT STATUS
0 Success.
>0 Failure.
ATTRIBUTES
See attributes(7) for descriptions of the following attributes:
tab() box; cw(2.75i) |cw(2.75i) lw(2.75i) |lw(2.75i) ATTRIBUTE TYPEAT‐
TRIBUTE VALUE _ Availabilitysystem/core-os system/install system/in‐
stall/configuration system/library/install _ Interface StabilityCommit‐
ted
SEE ALSO
svcprop(1), attributes(7), attributes(7), svcadm(8), svccfg(8)
Oracle Solaris 11.4 23 Jun 2025 sysconfig(8)