 |
Index for
Section 8 |
|
 |
Alphabetical
listing for S |
|
 |
Bottom of
page |
|
sysman_clone(8)
NAME
sysman_clone - Saves SysMan configuration information, which can be used to
clone configurations on similar systems
SYNOPSIS
/usr/sbin/sysman -clone
/usr/sbin/sysman -clone -apply [file]
/usr/sbin/sysman -clone -help
/usr/sbin/sysman -clone -list
/usr/sbin/sysman -clone -save [file]
/usr/sbin/sysman -clone -validate [file]
OPTIONS
The file argument is optional and specifies an alternate path to the
configuration description file (CDF). The default path and file name is
var/adm/smlogs/config.cdf.
-apply
Applies the configuration information specified in the
/var/adm/smlogs/config.cdf file. If the optional file parameter is
specified, this parameter specifies a CDF file in an alternate
location. When performing an apply operation, the CDF automatically is
validated prior to the actual apply operation.
-help
Displays command usage information for the sysman(8) command.
-list
Lists the current values for all configured SysMan components/groups
supported by sysman -clone.
-save
Saves the current values for all configured SysMan components/groups
supported by sysman -clone to the /var/adm/smlogs/config.cdf file. If
the optional file parameter is specified, component/group information
is saved to the specified file instead of /var/adm/smlogs/config.cdf.
-validate
Validates the file /var/adm/smlogs/config.cdf, or the file specified by
the optional file parameter. The validation pass consists of invoking
each component's built-in validation routine and the checksum number at
the top of the file.
OPERANDS
file
Specifies an alternate Configuration Description File (CDF).
DESCRIPTION
The sysman -clone command provides the ability to save certain SysMan
configuration information from a previously configured system and duplicate
that configuration information to one or more systems with a similar
hardware configuration. The configuration information is saved to a text-
based Configuration Description File (CDF). The CDF is organized as a
pseudo stanza(4) file, with a hierarchical listing of components, groups,
and attribute-value pairs describing the configuration of various
components of a system.
It is recommended that you use the sysman(8) command to accesssysman -clone
functions.
The following components can be cloned:
· Domain Name Service (DNS) client setup
· DOP actions and privileges
· Internet services
· Mail client setup
· Network File System (NFS)
· Network interface
· Network Time Protocol (NTP)
· Network Information Service (NIS)
· Printer setup
Supported components and groups, as well as their current values, can be
queried through the use of the -list option. For descriptions of each
component, group, and attribute, and how it affects the configured system,
refer to the sysman_cli(8) command.
The config.cdf file is particularly useful during a Full Installation of
the operating system to provide an automated and unattended system
configuration. Combining this ability with an Installation Cloning provides
for an efficient way to install and configure multiple systems in a non-
interactive fashion. The Full Installation process searches for the
installation CDF (named install.cdf) and the configuration CDF in these
locations in the order shown:
1. Diskette drive
2. Remote Installation Services (RIS) directory
3. CD-ROM drive
4. The /var/tmp directory
The Installation Guide -- Advanced Topics provides detailed information
about Installation Cloning, Configuration Cloning, the placement of CDFs,
and writing user-supplied scripts to dynamically modify CDFs. The Full
Installation process always searches for CDFs at predefined points in the
process. If a CDF is found in any of the supported locations, it will be
applied automatically to install, configure, or install and configure the
target system.
Generating Unique Client Configurations
When saving the configuration of a model system with the intention of
applying the configuration to multiple target systems, there are several
host-specific attributes that you need to modify to allow each target
system to be uniquely identified on a network. The specific host-specific
attributes that must be modified are:
systemName
The unique name of the system as it is known on a network. This
attribute is located in the netconfig component in the interface group,
and depending upon which other components are configured, the host name
may be specified in other attributes. Make sure to search for and
change all instances of host name.
networkAddress
The unique internet protocol address of the system as it is identified
on a network. This attribute is located in the netconfig component in
the interface and host groups.
devname
The network adapter attached to the system. This value is modified only
if the network adapter on the system to be cloned is different from the
one defined in the config.cdf file. Valid values for this attribute
include tu0 for Tulip devices, ln0 for Lance devices, and fddi0 for
FDDI devices.
To facilitate configuration cloning of multiple target systems, it is
suggested that you create a single template or representative CDF with the
values of these host-specific attributes set to dummy variables. You can
then manually enter a value for the dummy variables before applying them to
a target system, or you can create a user-supplied script, which is invoked
during a Full Installation to dynamically modify a config.cdf file before
it is applied to the system. This procedure is documented in the
Installation Guide -- Advanced Topics.
The Global Attribute CDFMODE
During the application of configuration information to a client system, it
is possible to specify how the values of databases with multiple records
(for example, entries in /etc/hosts or /etc/printcap) should be applied to
the system. The CDFMODE attribute is a global CDF attribute that can be
specified manually and placed outside of any component contained within the
CDF file. The CDFMODE attribute only affects databases with multiple
records; individual component/group data always will be overwritten by the
new value specified in the CDF. Once a CDFMODE has been specified in a
CDF, that value is in effect until another CDFMODE statement is
encountered, or the apply process completes.
There are three values associated with the CDFMODE attribute:
MERGE
Merges the component/group data that exists in the CDF with the data
that is currently configured on the system. Using the merge
functionality, rows of records that are duplicated between the CDF and
the configured system are ignored. MERGE is the default behavior and
is implied for the entire CDF if CDFMODE is not specified.
APPEND
Appends component/group data that exists in the CDF to the configured
system. Duplicate entries that exist between the CDF and the configured
system will not be ignored.
REPLACE
Replaces component/group data that exists on the system with the data
specified in the CDF. Data existing on the configured system but not
in the CDF will be removed. Data that exists in the CDF, but not on
the configured system, will be applied. Data that exists in the CDF, as
well as the configured system, will be modified accordingly.
RESTRICTIONS
You must be a privileged user to use this command.
Configuration cloning is not supported in a cluster.
EXAMPLES
1. The following example lists to stdout the components, groups, and
attribute-value pairs for the supported SysMan clonable configuration
data.
# sysman -clone -list
2. The following example saves SysMan configuration data to a CDF named
template.cdf in the /admin directory.
# sysman -clone -save /admin/template.cdf
3. The following example manually applies the saved configuration
information specified in /var/adm/smlogs/config.cdf to the target
system. The config.cdf file must be located in the /var/adm/smlogs
directory of the system to be cloned.
# sysman -clone -apply
4. The following example uses the CDFMODE global attribute to specify
that all entries in the /etc/hosts file should be replaced by the data
specified in the hostmappings group. The CDFMODE
attribute is then reset to merge for the rest of the apply process.
CDFMODE=REPLACE
#
# Component: networkedSystems
#
#
# Group: hostEquivalencies
#
/networkedSystems/hostEquivalencies:
#
# Group: hostMappings
#
/networkedSystems/hostMappings:
cdf_record=00000001
networkAddress=127.0.0.1
systemName=localhost
cdf_record=00000002
aliases=host1
networkAddress=16.29.1.1
systemName=host1.mydomain.com
cdf_record=00000003
networkAddress=16.29.1.15
systemName=host2
cdf_record=00000004
aliases=host3
networkAddress=16.29.1.27
systemName=host3.mydomain.com
CDFMODE=MERGE
FILES
/var/adm/smlogs/config.cdf
Default configuration description file.
SEE ALSO
Commands: sysman(8), sysman_cli(8)
Files: stanza(4)
Installation Guide
Installation Guide -- Advanced Topics
|
Index for
Section 8 |
|
|
Alphabetical
listing for S |
|
 |
Top of
page |
|