Show Table of Contents
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.

Where did the comment section go?
Red Hat's documentation publication system recently went through an upgrade to enable speedier, more mobile-friendly content. We decided to re-evaluate our commenting platform to ensure that it meets your expectations and serves as an optimal feedback mechanism. During this redesign, we invite your input on providing feedback on Red Hat documentation via the discussion platform.