Managing Oracle Cloud VMware Solution SDDCs

This topic describes how to manage your Oracle Cloud VMware solution software-defined data center (SDDC) resources by using the Oracle Cloud Infrastructure Console or API. SDDC resources include SDDCs and ESXi hosts. To create and manage VMs on the ESXi hosts, you use VMware's vCenter utility.

Required IAM Policy

To use Oracle Cloud Infrastructure, you must be granted security access in a policy  by an administrator. This access is required whether you're using the Console or the REST API with an SDK, CLI, or other tool. If you get a message that you don’t have permission or are unauthorized, verify with your administrator what type of access you have and which compartment  you should work in.

Using the Console

The procedures that follow include steps for managing SDDCs and ESXi hosts.

To update basic properties of an SDDC

You can modify basic properties of the SDDC, including the name, the VMware software version, and the SSH keys.

Note

Changing properties such as the software version or the SSH key by using the Oracle Cloud Infrastructure Console, API, or CLI apply only to ESXi hosts that you add to the SDDC. To change these properties for existing hosts, you must make the applicable updates in vCenter manually.
  1. Open the navigation menu. Under Solutions and Platform, click VMware Solution.
  2. Click the name of the SDDC to view details about it.
  3. Click Edit SDDC.
  4. Make the applicable changes:

    • SDDC Name: Enter a new name for SDDC. This name must be unique among all SDDCs in the creating, active, or updating state across all compartments in the region. Avoid entering confidential information.

      Note

      Unlike most display names in the Oracle Cloud Infrastructure Console this name has the following additional requirements because it is used by vCenter to build URLs:

      • It must be from 1-16 characters long and must start with a letter
      • It can contain only alphanumeric characters and hyphens (-), and hyphens cannot be next to each other

      This name is not case sensitive. For example, "test" and "Test" are treated as the same name.

    • VMware Software Version: Select the version of VMware software to install on new ESXi hosts. While the VMware software bundle includes vSphere, vSAN, NSX, and vCenter components, the new version you specify here is the vSphere version only. The update does not impact the versions of the vSAN, NSX, or vCenter components.
    • SSH Key: Provide the public key portion of the SSH key. This key is required for remote connections to the ESXi hosts.
  5. (Recommended) Click the vSphere Client link to go to vCenter, and make the appropriate updates for the SDDC properties you changed in the Console. You can do this task now or after you save your changes.
  6. Click Save Changes.
To add an ESXi host to an SDDC
  1. Open the navigation menu. Under Solutions and Platform, click VMware Solution.
  2. Click the name of the SDDC to view details about it.
  3. Click Create ESXi Host.
  4. (Optional) Enter a name for the new host that helps to identify it later. The name must be from 1-16 characters long, must start with a letter, and can contain only alphanumeric characters and hyphens (-). Hyphens cannot be next to each other.
  5. (Optional) Show the ESXi host details to view or modify the following host properties:

    • VMware software version
    • SSH key
    • VLANs
  6. When you are satisfied with the properties for this host, click Create ESXi Host.
To rename an ESXi host
  1. Open the navigation menu. Under Solutions and Platform, click VMware Solution.
  2. Click the name of the SDDC to view details about it.
  3. In the list of ESXi hosts, click the Actions icon (three dots) for the host you want to rename, and then click Rename.
  4. Enter the new name for the host. The name must be from 1-16 characters long, must start with a letter, and can contain only alphanumeric characters and hyphens (-). Hypens must not be next to each other. Ensure that the name is unique within the SDDC.
  5. Click Rename.
To remove ESXi hosts from an SDDC
  1. Open the navigation menu. Under Solutions and Platform, click VMware Solution.
  2. Click the name of the SDDC to view details about it.
  3. In the list of ESXi hosts, click the Actions icon (three dots) for the host you want to remove, and then click Terminate ESXi Host.
To change VLANs the SDDC uses
  1. Open the navigation menu. Under Solutions and Platform, click VMware Solution.
  2. Click the name of the SDDC to view details about it.
  3. Under Resources, click SDDC Networks.
  4. On the VLANs tab, click Change VLANs.
  5. Make the applicable changes. See VLANs Required for an SDDC for information about VLANs.

    Note

    Changes that you make to the SDDC's VLAN assignments by using the Oracle Cloud Infrastructure Console, API, or CLI are not automatically made in vCenter. You must make these updates in vCenter manually.
  6. Click Save Changes.
To move an SDDC to a different compartment
  1. Open the navigation menu. Under Solutions and Platform, click VMware Solution.
  2. Click the name of the SDDC to view details about it.
  3. Click Move Resource.
  4. Choose the destination compartment from the list.
  5. Click Move Resource.
To terminate an SDDC

SDDC termination automatically removes the SDDC's associated instances and boot volumes. With a failed SDDC, you can opt to also delete all of its associated networking resources. These resources include the subnet and its route table and security list, and the VLANs and their route tables and NSGs. A networking resource cannot be deleted if that resource is used by another SDDC or networking resource. A networking resource in use will remain after the SDDC is terminated.

  1. Open the navigation menu. Under Solutions and Platform, click VMware Solution.
  2. Click the name of the SDDC to view details about it.
  3. Click Terminate.

    Termination removes the SDDC and its associated resources. Terminated resources cannot be restored.

  4. Follow the prompt to confirm termination, and click Terminate All.