---
name: "si_getimage"
section: "8"
platform: "linux"
package: "systemimager-server"
version: "3.6.3dfsg1-3"
release: "Debian 4.0 (Etch)"
platforms: ["linux"]
url: "https://new.carta.tech/si_getimage"
---

# si\_getimage(8)

pull an image from a golden client

## NAME

si\_getimage - pull an image from a golden client

## SYNOPSIS

**si\_getimage** \[ **OPTION** *...* \] **-golden-client** *HOSTNAME* **-image** *IMAGENAME*

## DESCRIPTION

This manual page documents briefly the **si\_getimage** command.

**si\_getimage** is a program that pulls an image to the image server.  The source for this image can be either a golden client or an image stored on another image server

## OPTIONS

A summary of options is included below.

- **-help**

  Show summary of options

- **-version**

  Display version and copyright information

- **-golden-client** *HOSTNAME*

  Hostname or IP address of the "golden" client

- **-image** *IMAGENAME*

  Where IMAGENAME is the name to assign to the image you are retrieving.  This can be either the name of a new image if you want to create a new image, or the name of an existing image if you want to update an image.  If you are using the **-server** option, the same imagename is used for both the source and destination.

- **-ssh-user** *USERNAME*

  Username for ssh connection to the client.  Only needed if a secure connection is required.

- **-log** *STRING*

  Quoted string for log file format.  See the [*rsyncd.conf*(5)](/rsyncd.conf/5.md) man page for options.

- **-quiet**

  Don't ask any questions or print any output (other than errors). In this mode, no warning will be given if the image already exists on the server.

- **-directory** *PATH*

  The full path and directory name where you want this image to be stored.  The directory bearing the image name itself will be placed inside the directory specified here.

- **-exclude** *PATH*

  Don't pull the contents of *PATH* from the golden client.  *PATH* must be absolute (starting with a "/").

  To exclude a single file use:

  \-exclude */DIRECTORYNAME/FILENAME*

  To exclude a directory and it's contents use:

  \-exclude */DIRECTORYNAME/*

  To exclude the contents of a directory, but pull the directory itself use:

  \-exclude "*/DIRECTORYNAME/\**"

- **-exclude-file** *FILE*

  Don't pull the *PATH*s specified in *FILE* from the golden client.  See the [rsync(1)](/rsync/1.md) for details on creating this file.

- **-update-script** *YES\|NO*

  Update the $image.master script? Defaults to NO if -quiet.  If not specified you will be prompted to confirm an update.

- **-no-listing**

  Don't show each filename as it is copied over during install.  This is useful for times when your console device is slow (e.g. serial console), and is the  bottleneck of your installation.

The following options affect the autoinstall client after autoinstalling.

- **-ip-assignment** *METHOD*

  Where METHOD can be:

  - •

    static\_dhcp -- A DHCP server will assign the same static address each time to clients installed with this image.  The DHCP server in this case also assigns the corresponding host name.  It is possible therefore, when using static dhcp, to change a machine's hostname and IP address by simply changing one value in the dhcpd.conf file.  Some may find this desirable.  Also see the **si\_mkdhcpstatic** command.

  - •

    dynamic\_dhcp -- A DHCP server will assign IP addresses dynamically to clients installed with this image.  In dynamic dhcp, the IP address of a machine may change, but you want it to retain the same host name.  Therefore the hostname is set by the machine itself.  They may be assigned a different address each time.

  - •

    static -- The IP address the client uses during autoinstall will be permanently assigned to that client.

  - •

    replicant -- Don't mess with the network settings in this image.  I'm using it as a backup and quick restore mechanism for a single machine.

- **-post-install** *ACTION*

  ACTION can be:

  - •

    beep -- Clients will beep incessantly after successful completion of an autoinstall.

  - •

    reboot -- Clients will reboot themselves after successful completion of an autoinstall.

  - •

    shutdown -- Clients will halt themselves after successful completion of an autoinstall.

## SEE ALSO

[**si\_addclients**(8)](/si_addclients/8.md), [**si\_mkdhcpserver**(8)](/si_mkdhcpserver/8.md), [**si\_mkdhcpstatic**(8)](/si_mkdhcpstatic/8.md),

More details can be found in the *SystemImager* *manual.*

## AUTHOR

This manual page was compiled by dann \<\<dannf@debian.org\>\> for the Debian GNU/Linux system (but may be used by others).