Closing a host

Close a host without removing it from the cluster if you need to run diagnostic tests or troubleshoot.

Before you begin

The host must belong to the cluster and be open before you can close it. Only administrators can open and close hosts.

You may need to run egosetsudoers.sh on the host running the cluster management console processes to be able to open and close hosts from the cluster management console.

About this task

Close a host so that you can perform maintenance on it and return it to the cluster. Closed hosts do not accept new workload, but they do continue to run existing work.

Once a host is closed, EGO does not re-allocate it. Closing a host does not change its allocation status. If the host is currently allocated to a consumer, the host remains allocated until the consumer returns it voluntarily. If the host is not currently allocated to a consumer, the host remains in its unallocated state.

Closing a host can cause a shortage of owned slots, and open hosts can then reclaim these slots. Here is an example flow:
  1. You have cluster with two management hosts (host1 and host2), with 10 slots each, and two customers (consumer1 and consumer2).
  2. Consumer1 owns the 10 slots and consumer2 uses shared slots.
  3. You create a five-slot allocation for consumer1 on host1; and a 15-slot allocation for consumer2 on host2.
  4. You close host1 for maintenance.
  5. The five slots on host2 are reclaimed from consumer2 to satisfy consumer1's ownership requirement.

Procedure

  1. From the cluster management console Dashboard, choose your navigation:
    • To close an allocated host, select Resources > Allocated Hosts.
    • To close any other host, select Resources > All Hosts.
  2. Select the Hosts (List View) tab.

    The Hosts (List View) page displays.

  3. Locate the host you want to close.

    Use Filter Settings to narrow down your search quickly, to sort, or to search for a specific host by name.

  4. For the host you want to close, select Actions > Close.
  5. Indicate if you want the host to be reclaimed when you close it.

    If the host is reclaimed, it will continue to run the work until the end of the grace period, at which time the work is terminated and the host is released from its allocation. If the host is not reclaimed, the host will not be allocated in response to any new demands, but existing allocations on the host remain.

  6. If necessary, enter a comment for closing the host.
    Note: If the EGO_HOST_COMMENT_ENFORCE parameter is set to Y in the ego.conf file, a comment is required before you can close a host.
  7. Click Apply.

Results

Your host closes and the status of the host changes to closed, with one of the following reasons:
  • Host is unlicensed.
  • Host is locked by administrator.
  • Host is locked by time window.
  • Host is locked by the primary host.
  • Host is locked due to no CPU.
  • Host is busy due to load.
  • Host is closed by administrator.
  • Cluster administrator closes and reclaims host.
  • Harvesting agent closes and reclaims host.

If you use filter settings to display hosts in a specific state, the host may not display in the list. Change your filter settings to display hosts in the state you want.

You can open the host again at any time. A closed host does not accept any additional requests until it is opened again. The host still belongs to the cluster but now its state is Closed.