imgimport.1
NAME
imgimport - Imports an xCAT image or configuration file into the xCAT tables so that you can immediately begin deploying with it.
SYNOPSIS
imgimport [-h|--help]
imgimport bundle_file_name [-p | --postscripts nodelist] [-f | --profile new_profile] [-R | --remotehost user@host] [-v | --verbose]
DESCRIPTION
The imgimport command will import an image that has been exported by imgexport from xCAT. This is the easiest way to transfer, backup, change or share images created by xCAT whether they be stateless or stateful. The bundle file will be unpacked in the current working directory. The xCAT configuration such as osimage and linuximage tables will then be updated.
For stateful, the following files will be copied to the appropriate directories
x.pkglist
x.otherpkgs.pkglist
x.tmpl
x.synclist
kits related files
For stateless, the following files will be copied to the appropriate directories
kernel
initrd.gz
rootimg.cpio.xz or rootimg.cpio.gz or rootimg.tar.xz or rootimg.tar.gz or rootimg.gz(for backward-compatibility)
x.pkglist
x.otherpkgs.pkglist
x.synclist
x.postinstall
x.exlist
kits related files
For statelite, the following files will be copied to the appropriate directories
kernel
initrd.gz
root image tree
x.pkglist
x.synclist
x.otherpkgs.pkglist
x.postinstall
x.exlist
where x is the profile name.
Any extra files, included by --extra flag in the imgexport command, will also be copied to the appropriate directories.
For statelite, the litefile table will be updated for the image. The litetree and statelite tables are not imported.
If -p flag is specified, the postscripts table will be updated with the postscripts and the postbootscripts names from the image for the nodes given by this flag.
If -f flag is not specified, all the files will be copied to the same directories as the source. If it is specified, the old profile name x will be changed to the new and the files will be copied to the appropriate directores for the new profiles. For example, /opt/xcat/share/xcat/netboot/sles/x.pkglist will be copied to /install/custom/netboot/sles/compute_new.pkglist and /install/netboot/sles11/ppc64/x/kernel will be copied to /install/netboot/sles11/ppc64/compute_new/kernel. This flag is commonly used when you want to copy the image on the same xCAT mn so you can make modification on the new one.
After this command, you can run the nodeset command and then start deploying the nodes. You can also choose to modify the files and run the following commands before the node deployment.
For stateful:
nodeset
For stateless:
genimage
packimage
nodeset
For statelite:
genimage
liteimg
nodeset
OPTIONS
-f|--profile new_profile
Import the image with a new profile name.
-h|--help
Display usage message.
-p|--postscripts nodelist
Import the postscripts. The postscripts contained in the image will be set in the postscripts table for nodelist.
-R|--remotehost user@host
Import the image from remote host. Passwordless ssh must be setup to the remote host.
-v|--verbose
Verbose output.
RETURN VALUE
0 The command completed successfully.
1 An error has occurred.
EXAMPLES
Simplest way to import an image. If there is a bundle file named ‘foo.gz’, then run:
imgimport foo.gz
Import the image with postscript names.
imgimport foo.gz -p node1,node2
The postscripts table will be updated with the name of the postscripts and the postbootscripts for node1 and node2.
Import the image with a new profile name
imgimport foo.gz -f compute_test
FILES
/opt/xcat/bin/imgimport
SEE ALSO
imgexport(1)|imgexport.1