Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

rinse(8) [debian man page]

RINSE(8)						 Perl Programmers Reference Guide						  RINSE(8)

NAME

       rinse - RPM Installation Entity.

SYNOPSIS

	 rinse [options]

	 Help Options:
	  --help     Show help information.
	  --manual   Read the manual for this script.
	  --version  Show the version information and exit.

	 Mandatory Options:

	  --arch	 Specify the architecture to install.
	  --directory	 The directory to install the distribution within.
	  --distribution The distribution to install.

	 Customization Options:

	  --add-pkg-list	Additional packages to download and install

	  --after-post-install	Additionally run the specified script after
				the post install script.
	  --before-post-install Additionally run the specified script before
				the post install script.
	  --post-install	Run the given post-install script instead of the
				default files in /usr/lib/rinse/$distro

	 Misc Options:

	  --cache		Should we use a local cache?  (Default is 1)
	  --cache-dir		Specify the directory we should use for the cache.
	  --clean-cache 	Clean our cache of .rpm files.
	  --config		Specify a different configuration file.
				(Default is /etc/rinse/rinse.conf)
	  --pkgs-dir		Specify a different directory containing
				<distribution>.packages files.
	  --mirror		Specify the URL of the mirror.
				(Default is to read it from /etc/rinse/rinse.conf)
	  --list-distributions	Show installable distributions.
	  --print-uris		Only show the RPMs which should be downloaded.
				default files in /usr/lib/rinse/$distro
	  --verbose		Enable verbose output.

OPTIONS

       --arch Specify the architecture to install.  Valid choices are 'amd64' and 'i386' only.
       --add-pkg-list Add a list of additional packages.
       --cache Specify whether to cache packages (1) or not (0).
       --cache-dir Specify the directory we should use for the cache.
       --clean-cache Remove all cached .rpm files.
       --directory Specify the directory into which the distribution should be installed.
       --distribution Specify the distribution to be installed.
       --help Show help information.
       --mirror Specify the URL of the mirror. Normally this is read from /etc/rinse/rinse.conf.
       --list-distributions Show the distributions which are installable.
       --manual Read the manual for this script.
       --print-uris Only show the files we would download, don't actually do so.
       --verbose Enable verbose output.
       --version Show the version number and exit.

DESCRIPTION

	 rinse is a simple script which is designed to be able to install
	a minimal working installation of an RPM-based distribution into
	a directory.

	 The tool is analogous to the standard Debian GNU/Linux debootstrap
	utility.

USAGE

	 To use this script you will need to be root.  This is required
	to mount /proc, run chroot, and more.

	 Basic usage is as simple as:

	  rinse --distribution fedora-core-6 --directory /tmp/test

	 This will download the required RPM files and unpack them into
	a minimal installation of Fedora Core 6.

	 To see which RPM files would be downloaded, without actually
	performing an installation or downloading anything, then you
	may run the following:

	  rinse --distribution fedora-core-6 --print-uris

TODO

	 Short of supporting more distributions or architectures there aren't
	really any outstanding issues.

AUTHOR

	Steve
	--
	http://www.steve.org.uk/

LICENSE

       Copyright (c) 2007-2010 by Steve Kemp.  All rights reserved.

       Copyright (c) 2011-2013 by Thomas Lange.

       This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself.  The LICENSE file contains the
       full text of the license.

2.0.1								    2013-01-28								  RINSE(8)

Check Out this Related Man Page

dtc_install_centos(8)					      System Manager's Manual					     dtc_install_centos(8)

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)
Man Page