4.3. Koan

The koan (kickstart over a network) utility allows RHN Satellite to be accessed remotely from hosts that have already been provisioned. Koan allows you to perform kickstart provisioning, create virtual guests (on virtual hosts), and can list the kickstarts available from the RHN Satellite host. It is available in the koan package.

Table 4.3. Koan Commands

Command Usage
man koan Read the koan manual page
koan --replace-self --server=satellite.example.org --profile=profile-name or koan --replace-self --server=satellite.example.org --system=system-name Reprovision an existing system. Reboot after running this command to install the new operating system. This can also be used with upgrade kickstarts (for instance, to upgrade a large number of machines from one version of Red Hat Enterprise Linux to the next).
koan --virt --server=satellite.example.org --profile=profile-name or koan --virt --server=satellite.example.org --system=system-name Provision a virtual guest
koan --list=profiles --server=satellite.example.org or koan --list=systems --server=satellite.example.org Query Cobbler to display a list of profiles or systems available for remote installation

Note

For troubleshooting purposes, note that Koan logs data in /var/log/koan.