You can use lmvutil commands to remove a pod that was previously joined to a pod federation. You might want to remove a pod from a pod federation if it is being recommissioned for another purpose or if it was wrongly configured.

About this task

You cannot remove the last pod in a pod federation. If you want to disable the Cloud Pod Architecture feature, use the lmvutil command with the --uninitialize option. See Disable the Cloud Pod Architecture Feature.

Important:

Do not stop or start a View Connection Server instance while it is being unjoined from a pod federation. The View Connection Server service might not restart correctly.

Prerequisites

  • Become familiar with the lmvutil command authentication options and requirements and verify that you have sufficient privileges to run the lmvutil command. See lmvutil Command Authentication.

  • Determine the name of the pod to remove. You can use the lmvutil command with the --listPods option to list the names of the pods in a pod federation.

Procedure

  • If the pod is available, run the lmvutil comand with the --unjoin option.

    You must run this command on a View Connection Server instance in the pod that you want to remove from the pod federation.

    lmvutil --unjoin

    For example:

    lmvutil --authAs adminEast --authDomain domainEast --authPassword "*" --unjoin
  • If the pod is not available (for example, in the case of a hardware failure), run the lmvutil command with the --ejectPod option.

    You can run this command on any View Connection Server instance in the pod federation.

    Important:

    In most circumstances, you should use the lmvutil command with the --unjoin option to remove a pod from a pod federation.

    lmvutil --ejectPod --pod podname

    The --pod option specifies the name of the pod to remove.

    For example:

    lmvutil --authAs adminEast --authDomain domainEast --authPassword "*" --ejectPod --pod "East Pod 1"