ViPR 2.2 - Disconnect and Reconnect an EMC ViPR VDC in a Geo Federation

Table of Contents

Disconnect and reconnect an EMC ViPR VDC in a geo federation

If a virtual data center in a geo federation becomes inaccessible, then all write operations to geo-replicated resources will fail. In this case you should disconnect the inaccessible VDC, so that writes can continue to geo-replicated resources via the other VDCs in the federation.

After disconnecting the VDC to perform the necessary repairs, you can then return it to the federation with the Reconnect operation.

If you decide that a VDC should not be part of the federation, use the Delete operation, which permanently removes the VDC from the geo database, and the VDC cannot be added back. After deletion the VDC continues to function as an isolated VDC.

Back to Top

Disconnect a virtual data center

Disconnect the inaccessible VDC so that writes can continue to the other VDCs in the federation.

  • This operation requires the Security Administrator role in ViPR.
  • All VDCs in the federation must be at ViPR version 2.1 or higher.
  • The target VDC must be inaccessible by all living VDCs in the federation.
  • You cannot run the disconnect operation on the local VDC.
  • In the case of a planned outage, before issuing the Disconnect operation, either shut down and power off the VDC, or close the socket port 4443.
  • All VDCs in the federation must be in the Stable state.

The viprcli command for disconnecting a VDC is viprcli vdc disconnect -name vdc_name

The REST API method is POST /vdc/{id}/disconnect.

To disconnect using the ViPR UI:

  1. Log in to an accessible VDC in the federation as a user with the Security Administrator role (not root user).
  2. Go to Virtual Assets > Virtual Data Centers
  3. Select the disconnected VDC and click Disconnect.

    Note that the ViPR UI that is running on the disconnected VDC will show its status as Connected, even after it was disconnected. You can see the actual status by viewing the disconnected VDC's status from a ViPR UI running on a different VDC in the federation.

Back to Top

Reconnect an EMC ViPR virtual data center

You can reconnect a disconnected virtual data center to return it to the geo federation.

  • This operation requires the Security Administrator role in ViPR.
  • All VDCs in the federation must be at ViPR version 2.1 or higher.
  • The target VDC must be reachable from all living VDCs in the federation.
  • You cannot run the Reconnect operation on the target VDC.
  • After the reconnect operation, allow several minutes, in general, for data to be propagated to the target VDC.
  • All VDCs in the federation must be in the Stable state.

The viprcli command for reconnecting a VDC is viprcli vdc reconnect -name vdc_name

The REST API method is POST /vdc/{id}/reconnect.

To reconnect using the ViPR UI:

  1. Log in to an accessible VDC in the federation as a user with the Security Administrator role (not root user).
  2. Go to Virtual Assets > Virtual Data Centers
  3. Select the disconnected VDC and click Reconnect.
Back to Top

Delete a Virtual Data Center

You can delete a virtual data center from a geo federation. This operation will remove it entirely from the ViPR internal database. Once you delete a virtual data center from a geo federation, it cannot be added back. If you want to remove a VDC from a federation temporarily, you should disconnect it instead of deleting it.

After you delete a virtual data center from the geo federation, each VDC works independently; tenants and projects are no longer shared, and single sign-on through a shared authentication provider is no longer available.
  • This operation requires the Security Administrator role in ViPR.
  • All VDCs in the federation must be at ViPR version 2.0 or higher.
  • The target VDC must be reachable.
  • All VDCs in the federation must be in the Stable state.
  • You cannot run the Delete operation on the local VDC.
  • If the VDC is in the disconnected state, deletion is not supported. Contact customer support and refer to KB 000192433 for the workaround.

The viprcli command for deleting a VDC is viprcli vdc delete -name vdc_name

The REST API method is POST /vdc/{id}/delete.

To delete using the ViPR UI:

  1. Log in to an accessible VDC in the federation as a user with the Security Administrator role (not root user).
  2. Go to Virtual Assets > Virtual Data Centers
  3. Select the VDC and click Delete.
Back to Top