When invoked, koan requests install information from a remote cobbler boot server, it then kicks off installations based on what is retrieved from cobbler and fed in on the koan command line. The examples below show the various use cases.
koan --server=cobbler.example.org --list=profiles
koan --server=cobbler.example.org --list=systems
koan --server=cobbler.example.org --list=images
koan --server=cobbler.example.org --display --profile=name
koan --server=cobbler.example.org --display --system=name
koan --server=cobbler.example.org --display --image=name
koan --server=cobbler.example.org --replace-self --profile=name
koan --server=cobbler.example.org --replace-self --system=name
Additionally, adding the flag --add-reinstall-entry will make it add the entry to grub for reinstallation but will not make it automatically pick that option on the next boot.
Also the flag --kexec can be appended, which will launch the installer without needing to reboot. Not all kernels support this option.
koan --server=cobbler.example.org --virt --profile=name
koan --server=cobbler.example.org --virt --system=name
koan --server=cobbler.example.org --virt --image=name
Some of the overrides that can be used with --virt are:
Flag Explanation Example
--virt-name name of virtual machine to create testmachine
--virt-type forces usage of qemu/xen/vmware qemu
--virt-bridge name of bridge device virbr0
--virt-path overwrite this disk partition /dev/sda4
--virt-path use this directory /opt/myimages
--virt-path use this existing LVM volume VolGroup00
--nogfx do not use VNC graphics (Xen only) (does not take options)
Nearly all of these variables can also be defined and centrally managed by the Cobbler server.
If installing virtual machines in environments without DHCP, use of --system instead of --profile is required. Additionally use --static-interface=eth0 to supply which interface to use to supply network information. The installer will boot from this virtual interface. Leaving off --static-interface will result in an unsuccessful network installation.
koan --server=cobbler.example.org --update-config
Additionally, adding the flag --summary will print configuration run stats.
Koan passes in the system's FQDN in the background during the configuration request. Cobbler will match this FQDN to a configured system defined by Cobbler.
The FQDN (Fully Qualified Domain Name) maps to the system's hostname field.
The mailing list is cobbler@lists.fedorahosted.org.
Subscribe at https://fedorahosted.org/mailman/listinfo/cobbler