Provided by: dtc-xen_0.5.17-1_all bug

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)