> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kinetica.com/llms.txt
> Use this file to discover all available pages before exploring further.

# admin_remove_host

### admin\_remove\_host

<ul>
  <li>
    admin\_remove\_host(\
    &#x20;host: string,\
    &#x20;options?: Record\<string, string>,\
    &#x20;callback?: [GPUdbCallback](https://docs.kinetica.com/content/api/typescript/types/GPUdbCallback.md),\
    ): Promise\<[AdminRemoveHostResponse](https://docs.kinetica.com/content/api/typescript/interfaces/AdminRemoveHostResponse.md)>

    Removes a host from an existing cluster. If the host to be removed has any ranks running on it, the ranks must be removed using `admin_remove_ranks` or manually switched over to a new host using `admin_switchover` prior to host removal. If the host to be removed has the graph server or SQL planner running on it, these must be manually switched over to a new host using `admin_switchover`.**Note:** This method should be used for on-premise deployments only.

    #### Parameters

    <ul>
      <li>
        host: string

        Identifies the host this applies to. Can be the host address, or formatted as 'hostN' where N is the host number as specified in gpudb.conf.
      </li>

      <li>
        `Optional`options: Record\<string, string>

        Optional parameters.
      </li>

      <li>
        `Optional`callback: [GPUdbCallback](https://docs.kinetica.com/content/api/typescript/types/GPUdbCallback.md)

        Optional callback function
      </li>
    </ul>

    #### Returns Promise\<[AdminRemoveHostResponse](https://docs.kinetica.com/content/api/typescript/interfaces/AdminRemoveHostResponse.md)>

    Promise\<Types.AdminRemoveHostResponse> - Promise resolving to the response

    <ul>
      <li>Defined in [src/GPUdb.ts:2501](https://github.com/kineticadb/kinetica-api-typescript/blob/master/src/GPUdb.ts#L2501)</li>
    </ul>
  </li>
</ul>

### admin\_remove\_host\_request

<ul>
  <li>
    admin\_remove\_host\_request(\
    &#x20;request: [AdminRemoveHostRequest](https://docs.kinetica.com/content/api/typescript/interfaces/AdminRemoveHostRequest.md),\
    &#x20;callback?: [GPUdbCallback](https://docs.kinetica.com/content/api/typescript/types/GPUdbCallback.md),\
    ): Promise\<[AdminRemoveHostResponse](https://docs.kinetica.com/content/api/typescript/interfaces/AdminRemoveHostResponse.md)>

    Removes a host from an existing cluster. If the host to be removed has any ranks running on it, the ranks must be removed using `admin_remove_ranks` or manually switched over to a new host using `admin_switchover` prior to host removal. If the host to be removed has the graph server or SQL planner running on it, these must be manually switched over to a new host using `admin_switchover`.**Note:** This method should be used for on-premise deployments only.

    #### Parameters

    <ul>
      <li>
        request: [AdminRemoveHostRequest](https://docs.kinetica.com/content/api/typescript/interfaces/AdminRemoveHostRequest.md)

        Request object containing the parameters for the operation
      </li>

      <li>
        `Optional`callback: [GPUdbCallback](https://docs.kinetica.com/content/api/typescript/types/GPUdbCallback.md)

        Optional callback function
      </li>
    </ul>

    #### Returns Promise\<[AdminRemoveHostResponse](https://docs.kinetica.com/content/api/typescript/interfaces/AdminRemoveHostResponse.md)>

    Promise\<Types.AdminRemoveHostResponse> - Promise resolving to the response

    <ul>
      <li>Defined in [src/GPUdb.ts:2471](https://github.com/kineticadb/kinetica-api-typescript/blob/master/src/GPUdb.ts#L2471)</li>
    </ul>
  </li>
</ul>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.