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.

                                                                                           dtc_install_centos(8)