NAME¶

dtc_install_centos - bootstrap a CentOS install to use in a chroot or VM

SYNOPSIS¶

dtc_install_centos <install root> <yum environment>

DESCRIPTION¶

This shell script is part of the dtc-xen package, generally to be used by the dtc panel to install a new a Xen VPS server. This script is called by dtc_reinstall_os when the user chooses to install the CentOS operating system.

How it works: it generates a temporary yum configuration in the yum environment directory, that directs yum to act inside the install root instead of in the base system; then it kindly requests yum to install the basesystem, centos-release and yum packages onto it. Yum then uses the configuration to download the required (usually, security-updated) packages and then perform the RPM installation process under the install root.

It requires both RPM and yum. It does work under Debian (it was developed in Ubuntu first). It should also work on RPM-based systems without destroying the system-wide RPM and yum configurations.

OPTION¶

<install root>

Target directory where CentOS will be deployed. Must exist beforehand.

<yum environment>

Directory where yum will store the repository manifests and configuration. Will be automatically created. Cached RPMs and manifests will be left, as usual, in a directory var/cache/yum inside the install root.

EXAMPLE¶

dtc_install_centos /root/yum /xen/13

This will setup the operating system in /xen/13, with the CentOS configuration folder in /root/yum.

BUGS¶

It's limited to CentOS 5 at the moment.

It must be run as root.

Under some circumstances, the installation process itself may kill processes running on the host machine. The chroot yum does should be sufficient to avoid this, but we haven't been able, yet, to ascertain why this fails sometimes.

SEE ALSO¶

dtc_reinstall_os(8)

VERSION¶

This documentation describes dtc_install_os version 0.3.1.

See http://www.gplhost.com/software-dtc-xen.html for updates.