NAME

osimage - a logical object definition in the xCAT database.


SYNOPSIS

osimage Attributes: bosinst_data, crashkernelsize, dump, exlist, fb_script, home, image_data, imagename, imagetype, installp_bundle, kerneldir, kernelver, krpmver, lpp_source, mksysb, netdrivers, nimmethod, nimtype, nodebootif, osarch, osdistro, osname, osvers, otherifce, otherpkgdir, otherpkglist, otherpkgs, paging, permission, pkgdir, pkglist, postbootscripts, postinstall, postscripts, profile, provmethod, resolv_conf, root, rootfstype, rootimgdir, script, shared_home, shared_root, spot, synclists, template, tmp, usercomment


DESCRIPTION

Logical objects of this type are stored in the xCAT database in one or more tables. Use the following commands to manipulate the objects: mkdef, chdef, lsdef, and rmdef. These commands will take care of knowing which tables the object attributes should be stored in. The attribute list below shows, in parentheses, what tables each attribute is stored in.


osimage Attributes:

bosinst_data (nimimage.bosinst_data)

The name of a NIM bosinst_data resource.

crashkernelsize (linuximage.crashkernelsize)

the size that assigned to the kdump kernel. If the kernel size is not set, 256M will be the default value.

dump (linuximage.dump, nimimage.dump)

The NFS directory to hold the Linux kernel dump file (vmcore) when the node with this image crashes, its format is ``nfs://<nfs_server_ip>/<kdump_path>''. If you want to use the node's ``xcatmaster'' (its SN or MN), <nfs_server_ip> can be left blank. For example, ``nfs:///<kdump_path>'' means the NFS directory to hold the kernel dump file is on the node's SN, or MN if there's no SN.

or

The name of the NIM dump resource.

exlist (linuximage.exlist)

The fully qualified name of the file that stores the file names and directory names that will be excluded from the image during packimage command. It is used for diskless image only.

fb_script (nimimage.fb_script)

The name of a NIM fb_script resource.

home (nimimage.home)

The name of the NIM home resource.

image_data (nimimage.image_data)

The name of a NIM image_data resource.

imagename (osimage.imagename)

The name of this xCAT OS image definition.

imagetype (osimage.imagetype)

The type of operating system image this definition represents (linux,AIX).

installp_bundle (nimimage.installp_bundle)

One or more comma separated NIM installp_bundle resources.

kerneldir (linuximage.kerneldir)

The directory name where the 3rd-party kernel is stored. It is used for diskless image only.

kernelver (linuximage.kernelver)

The version of linux kernel used in the linux image. If the kernel version is not set, the default kernel in rootimgdir will be used

krpmver (linuximage.krpmver)

The rpm version of kernel packages (for SLES only). If it is not set, the default rpm version of kernel packages will be used.

lpp_source (nimimage.lpp_source)

The name of the NIM lpp_source resource.

mksysb (nimimage.mksysb)

The name of a NIM mksysb resource.

netdrivers (linuximage.netdrivers)

The ethernet device drivers of the nodes which will use this linux image, at least the device driver for the nodes' installnic should be included

nimmethod (nimimage.nimmethod)

The NIM install method to use, (ex. rte, mksysb).

nimtype (nimimage.nimtype)

The NIM client type- standalone, diskless, or dataless.

nodebootif (linuximage.nodebootif)

The network interface the stateless/statelite node will boot over (e.g. eth0)

osarch (osimage.osarch)

The hardware architecture of this node. Valid values: x86_64, ppc64, x86, ia64.

osdistro (osimage.osdistro)

Not used.

osname (osimage.osname)

Operating system name- AIX or Linux.

osvers (osimage.osvers)

The Linux operating system deployed on this node. Valid values: rhels*,rhelc*, rhas*,centos*,SL*, fedora*, sles* (where * is the version #).

otherifce (linuximage.otherifce)

Other network interfaces (e.g. eth1) in the image that should be configured via DHCP

otherpkgdir (linuximage.otherpkgdir)

The base directory where the non-distro packages are stored.

otherpkglist (linuximage.otherpkglist)

The fully qualified name of the file that stores non-distro package lists that will be included in the image.

otherpkgs (nimimage.otherpkgs)

One or more comma separated installp or rpm packages. The rpm packages must have a prefix of 'R:', (ex. R:foo.rpm)

paging (nimimage.paging)

The name of the NIM paging resource.

permission (linuximage.permission)

The mount permission of /.statelite directory is used, its default value is 755

pkgdir (linuximage.pkgdir)

The name of the directory where the distro packages are stored.

pkglist (linuximage.pkglist)

The fully qualified name of the file that stores the distro packages list that will be included in the image.

postbootscripts (osimage.postbootscripts)

Comma separated list of scripts that should be run on this after diskfull installation or diskless boot. On AIX these scripts are run during the processing of /etc/inittab. On Linux they are run at the init.d time. xCAT automatically adds the scripts in the xcatdefaults.postbootscripts attri bute to run first in the list.

postinstall (linuximage.postinstall)

The fully qualified name of the script file that will be run at the end of the packimage command. It is used for diskless image only.

postscripts (osimage.postscripts)

Comma separated list of scripts that should be run on this image after diskfull installation or diskless boot. For installation of RedHat, CentOS, Fedora, the scripts will be run before the reboot. For installation of SLES, the scripts will be run after the reboot but before the init.d process. For diskless deployment, the scripts will be run at the init.d time, and xCAT will automatically add the list of scripts from the postbootscripts attribute to run after postscripts list. For installation of AIX, the scripts will run after the reboot and acts the same as the postbootscripts attribute. For AIX, use the postbootscripts attribute. Support will be added in the future for the postscripts attribute to run the scripts before the reboot in AIX.

profile (osimage.profile)

The node usage category. For example compute, service.

provmethod (osimage.provmethod)

The provisioning method for node deployment. The valid values are install, netboot or statelite. It is not used by AIX.

resolv_conf (nimimage.resolv_conf)

The name of the NIM resolv_conf resource.

root (nimimage.root)

The name of the NIM root resource.

rootfstype (osimage.rootfstype)

The filesystem type for the rootfs is used when the provmethod is statelite. The valid values are nfs or ramdisk. The default value is nfs

rootimgdir (linuximage.rootimgdir)

The directory name where the image is stored. It is used for diskless image only.

script (nimimage.script)

The name of a NIM script resource.

shared_home (nimimage.shared_home)

The name of the NIM shared_home resource.

shared_root (nimimage.shared_root)

A shared_root resource represents a directory that can be used as a / (root) directory by one or more diskless clients.

spot (nimimage.spot)

The name of the NIM SPOT resource.

synclists (osimage.synclists)

The fully qualified name of a file containing a list of files to synchronize on the nodes.

template (linuximage.template)

The fully qualified name of the template file that is used to create the kick start file for diskful installation.

tmp (nimimage.tmp)

The name of the NIM tmp resource.

usercomment (nimimage.comments)

Any user-provided notes.


SEE ALSO

mkdef(1), chdef(1), lsdef(1), rmdef(1)