> ## 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_switchover

### admin\_switchover

<ul>
  <li>
    admin\_switchover(\
    &#x20;processes: string\[],\
    &#x20;destinations: string\[],\
    &#x20;options?: Record\<string, string>,\
    &#x20;callback?: [GPUdbCallback](https://docs.kinetica.com/content/api/javascript/types/GPUdbCallback.md),\
    ): Promise\<[AdminSwitchoverResponse](https://docs.kinetica.com/content/api/javascript/interfaces/AdminSwitchoverResponse.md)>

    Manually switch over one or more processes to another host. Individual ranks or entire hosts may be moved to another host.**Note:** This method should be used for on-premise deployments only.

    #### Parameters

    <ul>
      <li>
        processes: string\[]

        Indicates the process identifier to switch over to another host. Options are 'hostN' and 'rankN' where 'N' corresponds to the number associated with a host or rank in the Network section of the gpudb.conf file; e.g., 'host\[N].address' or 'rank\[N].host'. If 'hostN' is provided, all processes on that host will be moved to another host. Each entry in this array will be switched over to the corresponding host entry at the same index in `destinations`.
      </li>

      <li>
        destinations: string\[]

        Indicates to which host to switch over each corresponding process given in `processes`. Each index must be specified as 'hostN' where 'N' corresponds to the number associated with a host or rank in the Network section of the gpudb.conf file; e.g., 'host\[N].address'. Each entry in this array will receive the corresponding process entry at the same index in `processes`.
      </li>

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

        Optional parameters.
      </li>

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

        Optional callback function
      </li>
    </ul>

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

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

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

### admin\_switchover\_request

<ul>
  <li>
    admin\_switchover\_request(\
    &#x20;request: [AdminSwitchoverRequest](https://docs.kinetica.com/content/api/javascript/interfaces/AdminSwitchoverRequest.md),\
    &#x20;callback?: [GPUdbCallback](https://docs.kinetica.com/content/api/javascript/types/GPUdbCallback.md),\
    ): Promise\<[AdminSwitchoverResponse](https://docs.kinetica.com/content/api/javascript/interfaces/AdminSwitchoverResponse.md)>

    Manually switch over one or more processes to another host. Individual ranks or entire hosts may be moved to another host.**Note:** This method should be used for on-premise deployments only.

    #### Parameters

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

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

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

        Optional callback function
      </li>
    </ul>

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

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

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


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