copycds.8

NAME

copycds - Copies Linux distributions and service levels from DVDs/ISOs to the xCAT /install directory.

SYNOPSIS

copycds [{-n|--name|--osver} distroname] [{-a|--arch} architecture] [{-p|--path} ospkgpath] [-o | --noosimage] [-w | --nonoverwrite] {iso | device-path} …

copycds [-i | --inspection] {iso | device-path}

copycds [-h | --help]

DESCRIPTION

The copycds command copies all contents of Distribution DVDs/ISOs or Service Pack DVDs/ISOs to a destination directory. The destination directory can be specified by the -p option. If no path is specified, the default destination directory will be formed from the installdir site table attribute, distro name and architecture, for example: /install/rhels6.3/x86_64. The copycds command can copy from one or more ISO files, or the CD/DVD device path.

You can specify -i or --inspection option to check whether the DVDs/ISOs can be recognized by xCAT. If recognized, the distribution name, architecture and the disc no (the disc sequence number of DVDs/ISOs in multi-disk distribution) of the DVD/ISO is displayed. If xCAT doesn’t recognize the DVD/ISO, you must manually specify the distro name and architecture using the -n and -a options. This is sometimes the case for distros that have very recently been released, and the xCAT code hasn’t been updated for it yet.

You can get xCAT to recognize new DVDs/ISOs by adding them to /opt/xcat/lib/perl/xCAT/data/discinfo.pm (the key of the hash is the first line of .discinfo) and reloading xcatd (service xcatd reload).

OPTIONS

-n|--name|--osver distroname

The linux distro name and version that the ISO/DVD contains. Examples: rhels6.3, sles11.2, fedora9. Note the ‘s’ in rhels6.3 which denotes the Server version of RHEL, which is typically used.

-a|--arch architecture

The architecture of the linux distro on the ISO/DVD. Examples: x86, x86_64, ppc64, s390x.

-p|--path ospkgpath

The destination directory to which the contents of ISO/DVD will be copied. When this option is not specified, the default destination directory will be formed from the installdir site table attribute and the distro name and architecture, for example: /install/rhel6.3/x86_64. This option is only supported for distributions of sles, redhat and windows.

-i|--inspection

Check whether xCAT can recognize the DVDs/ISOs in the argument list, but do not copy the disc. Displays the os distribution name, architecture and disc no of each recognized DVD/ISO. This option is only supported for distributions of sles, redhat and windows.

-o|--noosimage

Do not create the default osimages based on the osdistro copied in. By default, copycds will create a set of osimages based on the osdistro.

-w|--nonoverwrite

Complain and exit if the os disc has already been copied in. By default, copycds will overwrite the os disc already copied in.

RETURN VALUE

0: The command completed successfully. For the --inspection option, the ISO/DVD have been recognized successfully

Nonzero: An Error has occurred. For the --inspection option, the ISO/DVD cannot be recognized

EXAMPLES

To copy the RPMs from a set of ISOs that represent the DVDs of a distro:

copycds dvd1.iso dvd2.iso

To copy the RPMs from a physical DVD to /depot/kits/3 directory:

copycds -p /depot/kits/3 /dev/dvd

To copy the RPMs from a DVD ISO of a very recently released distro:

copycds -n rhels6.4 -a x86_64 dvd.iso

To check whether a DVD ISO can be recognized by xCAT and display the recognized disc info:

copycds -i /media/RHEL/6.2/RHEL6.2-20111117.0-Server-ppc64-DVD1.iso
Output will be similar to:
OS Image:/media/RHEL/6.2/RHEL6.2-20111117.0-Server-ppc64-DVD1.iso
DISTNAME:rhels6.2
ARCH:ppc64
DISCNO:1
For the attributes that are not recognized, the value will be blank.

To copy the packages from a supplemental DVD ISO file:

copycds /isodir/RHEL6.5/RHEL6.5-Supplementary-20131114.2-Server-ppc64-DVD1.iso -n rhels6.5-supp

Also, remember to add the new directory to your osimage definition:

chdef -t osimage myosimage -p pkgdir=/install/rhels6.5-supp/ppc64