Managing host records in orcharhino

You can add a host record by cloning an existing host and choose whether orcharhino manages it. You can remove the record from orcharhino Server when the system is decommissioned or re-registered elsewhere.

Cloning hosts in orcharhino

You can clone an existing host in orcharhino to create a new host with the same configuration, then change the name and network settings.

Unlike cloning, creating a host is part of the host provisioning process. There are multiple provisioning methods and each requires different configuration of orcharhino and orcharhino Proxies. For more information, see Provisioning Hosts.
Procedure

  1. In the orcharhino management UI, navigate to Hosts > All Hosts.

  2. In the Actions menu, click Clone.

  3. On the Host tab, ensure to provide a Name different from the original host.

  4. On the Interfaces tab, ensure to provide a different IP address.

  5. Click Submit to clone the host.

Changing the managed status of a host

Hosts provisioned by orcharhino are Managed by default. When a host is set to Managed, you can configure additional host parameters from orcharhino Server.

Additional host parameters that you can configure for your hosts are listed on the Operating System tab. If you change any settings on the Operating System tab, they will not take effect until you set the host to build and reboot it.

If you need to obtain reports about configuration management on systems using an operating system not supported by orcharhino, set the host to Unmanaged.

Procedure

  1. In the orcharhino management UI, navigate to Hosts > All Hosts.

  2. Click the name of the host you want to modify.

  3. Click Edit.

  4. Click Manage host or Unmanage host to change the host’s status.

  5. Click Submit.

Removing a host from orcharhino by using orcharhino management UI

You can remove a host from orcharhino from the orcharhino management UI when you decommission the host or no longer need to manage it. The host is permanently deleted from the orcharhino database.

By default, deleting a host entry associated with a virtual machine does not destroy the virtual machine on the compute resource.

To change the default behavior, navigate to Administer > Settings > Provisioning and set Destroy associated VM on host delete to Yes.
Procedure

  1. In the orcharhino management UI, navigate to Hosts > All Hosts.

  2. Select the hosts that you want to remove.

  3. From the Select Action list, select Delete Hosts.

  4. Click Submit to remove the host from orcharhino permanently.

Removing a host from orcharhino by using Hammer CLI

You can remove a host from orcharhino by using Hammer CLI when you decommission the host or no longer need to manage it. The host is permanently deleted from the orcharhino database.

By default, deleting a host entry associated with a virtual machine does not destroy the virtual machine on the compute resource.

To change the default behavior, navigate to Administer > Settings > Provisioning and set Destroy associated VM on host delete to Yes.
Procedure

  • Delete your host from orcharhino:

    $ hammer host delete \
--id My_Host_ID \
--location-id My_Location_ID \
--organization-id My_Organization_ID

    Alternatively, you can use --name My_Host_Name instead of --id My_Host_ID.

The text and illustrations on this page are licensed by ATIX AG under a Creative Commons Attribution Share Alike 4.0 International ("CC BY-SA 4.0") license. This page also contains text from the official Foreman documentation which uses the same license ("CC BY-SA 4.0").