imgimport - Imports an xCAT image or configuration file into the xCAT tables so that you can immediately begin deploying with it.
imgimport bundle_file_name [-p | --postscripts nodelist] [-f | --profile new_profile] [-R | --remotehost user@host] [-v | --verbose]
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:
- For stateless:
- genimage packimage nodeset
- For statelite
- genimage liteimg nodeset
Import the image with a new profile name.
Display usage message.
Import the postscripts. The postscripts contained in the image will be set in the postscripts table for nodelist.
Import the image from remote host. Passwordless ssh must be setup to the remote host.
0 The command completed successfully.
1 An error has occurred.
- Simplest way to import an image. If there is a bundle file named ‘foo.gz’, then run:
- 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