make_sys_image.1m (2012 03)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

make_sys_image(1M) make_sys_image(1M)

NAME

make_sys_image - create compressed ﬁle archive of a running system

SYNOPSIS

/opt/ignite/data/scripts/make_sys_image -s

IP | hostname | local

[

-d directory | device ][

-f ﬁle][-l 1 | 2 ][-n ﬁlename ][-r remsh_user ][

-m c | t | p][-c

z | g| n ][

-a archive_size ][-R ][-g ﬁle_list ][-t y|n|o|p]

[ -p ][-u ][-v ][-w

log_ﬁle ][-x ][

-L ][-? ]

DESCRIPTION

make_sys_image

is used to create a system archive of a running single-user or multi-user system.

This archive may be in

cpio, pax, or

tar format, and may be compressed with either compress or

gzip. make_sys_image

may be called as a post_config_script

by Ignite-UX as part of the

installation process, or invoked at the command line on a running system. The archive may be written to

a ﬁle, a tape, or a raw disk device on a remote or the local system. If the archive destination is a remote

system, that system must have a

.rhosts entry for the local system, or an

NFS mount available. The

options for this command may be a combination of command line arguments and environment variables

passed in with the Ignite-UX conﬁguration ﬁle via the

env_vars keyword.

The archives created by

make_sys_image

are designed for use with Ignite-UX as part of an archive-

based ignition process. Before the archive is used for installing systems, the ﬁle system impacts of the

archive must be obtained. See archive_impact(1M).

make_sys_image does not capture ﬁle system or

disk layout information. Use

save_config to capture this information. For details on integrating the

script into the GUI, see manage_index (1M) for /var/opt/ignite/data/INDEX

. For details on

using the script non-interactively, see instl_adm (4) for information on the

post_config_script and

env_vars keywords.

Options

The

make_sys_image command recognizes the following options:

-s IP|hostname|local

IP address or resolvable hostname of the server to send the archive to or local if the

destination is a local ﬁle system, NFS mount, disk or tape. If the destination is not

local, permission to remotely access the server is required. If a hostname is used in

this case, it must be resolvable through whatever means the name service switch is

set to use (see switch (4) for more information).

-d directory |device

Destination directory (for example, /var/tmp/foo) or device ﬁle name (for example,

/dev/rmt/0m). The default is /var/tmp/.

Note: Archives written to tape or raw disk cannot be used directly; they must ﬁrst

be extracted using

dd onto a ﬁle system where they may be accessed by an Ignite-

UX server. To use a directory that is an NFS mount point on the local system, use

-s local to specify the server destination.

-f file File contains a user-deﬁned list of ﬁles to be reset to the newconfig state or

ignored altogether. This list may be in addition to the default level 2 behaviors, or

it may replace the default level 2 reset and/or ignore behaviors.

The ﬁle may have one or two sections headed by the keywords

RESET or

NO_ARCHIVE. Following each keyword are the paths of ﬁles or directories (one per

line), or regular expressions that describe the ﬁles or directories. Each keyword

may be combined with the ONLY keyword. If the ONLY keyword is used, the ﬁles

in that section replace the default level 2 behavior. The keyword lines must begin

with a ’+’, and each keyword (except ONLY) must occur only once in the ﬁle. The

keywords are case sensitive and must be in all uppercase letters. This option over-

rides the -l option and sets the level to 2.

-l 1 | 2 Level of system identity clean-up:

1 None (overridden to 2 if the -f option is used).

2 Reset network and login information. Exclude device ﬁles, log ﬁles, and contents

of /stand except /stand/system and /stand/kernrel. Remove

hardware speciﬁc drivers from the /stand/system that gets archived. Files

reset to newconfig state:

HP-UX 11i Version 3: March 2012 − 1 − Hewlett-Packard Company 1

Summary of content (6 pages)

PAGE 1
make_sys_image(1M) make_sys_image(1M) NAME make_sys_image - create compressed file archive of a running system SYNOPSIS /opt/ignite/data/scripts/make_sys_image -s IP | hostname | local [ -d directory | device ] [ -f file ] [ -l 1 | 2 ] [ -n filename ] [ -r remsh_user ] [ -m c | t | p] [ -c z | g | n ] [ -a archive_size ] [ -R ] [ -g file_list ] [ -t y|n|o|p] [ -p ] [ -u ] [ -v ] [ -w log_file ] [ -x ] [ -L ] [ -? ] DESCRIPTION make_sys_image is used to create a system archive of a running single-user or
PAGE 2
make_sys_image(1M) make_sys_image(1M) /.profile /etc/rc.config.d/hpetherconf /etc/rc.config.d/hpfcgsc_lanconf /etc/rc.config.d/hpfcmsconf /etc/rc.config.d/netconf /etc/rc.config.d/netdaemons /etc/rc.config.d/namesvrs /etc/rc.config.d/mailservs /etc/rc.config.d/xfs /etc/hosts /etc/mail/sendmail.cw /etc/ntp.conf /etc/vue/config /var/adm/sw/security The default level is 2. If any of the above is a directory, then all files below that directory will be reset.
PAGE 3
make_sys_image(1M) make_sys_image(1M) -u Check the archive destination for sufficient storage capacity. The capacity of raw devices is not easily checked, so this option has no effect in the case where a raw device is the archive destination. The archive size is an approximation and is generally 5% larger than the final archive. The default is to not check capacity.
PAGE 4
make_sys_image(1M) make_sys_image(1M) cd /var/tmp dd ibs=10k if=/dev/rmt/0m of=archive.gz Note: Replace 10k with 5k for cpio archives. Replace .gz with .Z for compress’d archives. Create a local archive resetting /etc/motd and /etc/issue to newconfig state along with the level 2 default resets and ignore only the directory /data_area and files or directories beginning with "n" or "a" in /opt/apps.
PAGE 5
make_sys_image(1M) make_sys_image(1M) SEE ALSO compress(1), cpio(1), dd(1), gzip(1), pax(1), rcp(1), tar(1), archive_impact(1M), instl_adm(1M), make_config(1M), make_medialif(1M), manage_index(1M), save_config(1M), instl_adm(4), .rhosts(4), ignite(5), nfs(7).
PAGE 6
(Notes) A (Notes) mA 6 Hewlett-Packard Company −1− HP-UX 11i Version 3: March 2012