diff options
Diffstat (limited to 'website/koan.html')
-rw-r--r-- | website/koan.html | 70 |
1 files changed, 70 insertions, 0 deletions
diff --git a/website/koan.html b/website/koan.html new file mode 100644 index 00000000..00fa9820 --- /dev/null +++ b/website/koan.html @@ -0,0 +1,70 @@ +<?xml version="1.0" ?> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml"> +<head> +<title>NAME</title> +<meta http-equiv="content-type" content="text/html; charset=utf-8" /> +<link rev="made" href="mailto:root@localhost" /> +</head> + +<body style="background-color: white"> + +<p><a name="__index__"></a></p> +<!-- INDEX BEGIN --> + +<ul> + + <li><a href="#name">NAME</a></li> + <li><a href="#synopsis">SYNOPSIS</a></li> + <li><a href="#description">DESCRIPTION</a></li> + <li><a href="#notes_for_users_of_cobbler_templating">NOTES FOR USERS OF COBBLER TEMPLATING</a></li> + <li><a href="#additional">ADDITIONAL</a></li> + <li><a href="#author">AUTHOR</a></li> +</ul> +<!-- INDEX END --> + +<hr /> +<p> +</p> +<h1><a name="name">NAME</a></h1> +<p>koan stands for ``kickstart-over-a-network'' and allows for both +network provisioning of new virtualized guests and destructive provisioning of +any existing system. For use with a boot-server configured with +'cobbler'.</p> +<p> +</p> +<hr /> +<h1><a name="synopsis">SYNOPSIS</a></h1> +<p>koan --server=<host> --list-profiles</p> +<p>koan --server=<host> --list-systems</p> +<p>koan --virt --server=<host> --profile=<name></p> +<p>koan --virt --server=<host> --system=<name></p> +<p>koan --replace-self --server=<host> --profile=<name></p> +<p>koan --replace-self --server=<host> --system=<name></p> +<p> +</p> +<hr /> +<h1><a name="description">DESCRIPTION</a></h1> +<p>When invoked, koan requests profile information from a remote boot server that has been configured with cobbler. What koan does with the profile data depends on whether it was invoked with --virt or --replace-self.</p> +<p>For --virt, cobbler will create new virtualized guests on a machine in accordance to the orders from cobbler. You can then, once finished, use ``virsh'' and ``xm'' commands on the guest. Cobbler automatically names domains based on their mac addresses.</p> +<p>For re-kickstarting ('--replace-self'), cobbler will reprovisioning the system, blowing away any current data and replacing it with the results of a network install.</p> +<p> +</p> +<hr /> +<h1><a name="notes_for_users_of_cobbler_templating">NOTES FOR USERS OF COBBLER TEMPLATING</a></h1> +<p>Cobbler contains an advanced templating feature that allows a single kickstart file to be customized on a per-system basis. See the cobbler manpage for more details.</p> +<p>If you have system specific customizations in your kickstarts and have cobbler system definitions defined server side for those systems, use --system and not --profile.</p> +<p> +</p> +<hr /> +<h1><a name="additional">ADDITIONAL</a></h1> +<p>Consult the man page for cobbler for more information.</p> +<p> +</p> +<hr /> +<h1><a name="author">AUTHOR</a></h1> +<p>Michael DeHaan <<a href="mailto:mdehaan@redhat.com">mdehaan@redhat.com</a>></p> + +</body> + +</html> |