You can restore your VMware Integrated OpenStack deployment from a backup.

Important:
  • The temporary configuration file created in this procedure contains the vCenter Server credentials in plaintext. For security purposes, delete this file after the backup is finished.
  • Do not perform multiple restore operations concurrently. If a restore operation is incorrectly configured, wait until the operation fails or times out before trying again.
  • Unless the current database is corrupted, or there exists other paramount reasons that requires an earlier version, the current database should be backed up and used for restoration for the control plane. Restoration from an earlier version of backup could cause potential data loss.

Prerequisites

Procedure

  1. Log in to the Integrated OpenStack Manager as the root user.
    ssh root@mgmt-server-ip
  2. In a text editor, create the restoration configuration file in YAML format.
    • If you want to restore your VMware Integrated OpenStack on an existing control plane, use the following template:

      ---
      name: backup-file-name
      description: restore-description
      source:
         kind: contentLibrary
         contentLibrary:
            name: content-library-name
      datastore: control-plane-storage

      The parameters are described as follows.

      Option Description

      backup-file-name

      Enter the name of the backup file to restore.

      restore-description

      Enter a description for the restoration task.

      content-library-name

      Enter the name of the content library containing the backup file.

      control-plane-storage

      (Optional) Enter the name of a datastore on which to store control plane information.

    • If you want to restore your VMware Integrated OpenStack on a new control plane, use the following template:

      ---
      cluster:
        network_info:
        - networkName: mgmt-network-name
          type: management
          static_config:
            ip_ranges:
            - mgmt-ip-range-begin, mgmt-ip-range-end
            netmask: mgmt-subnet-mask
            gateway: mgmt-gateway-address
            dns:
            - mgmt-dns-server
        - networkName: api-network-name
          type: api
          static_config:
            ip_ranges:
            - api-ip-range-begin, api-ip-range-end
            netmask: api-subnet-mask
            gateway: api-gateway-address
            dns:
            - api-dns-server
        - networkName: trunk-network-name
          type: dvs_trunk_network
          static_config:
            ip_ranges:
            - trunk-ip-range-begin, trunk-ip-range-end
      ---
      datacenter: datacenter-name
      datastore: datastore-name
      resourcePool: resource-pool-name
      count: controller-count
      size: controller-size
      ---
      name: backup-file-name
      description: restore-description
      source:
         kind: contentLibrary
         contentLibrary:
            name: content-library-name
      datastore: control-plane-storage

      The parameters are described as follows.

      Table 1. Management Network Configuration
      Option Description

      mgmt-network-name

      Enter the name of the management network.

      If your management network uses static IP addresses instead of DHCP, enter the following values. These values are not required for DHCP networks.

      Option Description

      mgmt-ip-range-begin, mgmt-ip-range-end

      Enter the IP address ranges on your management network in dotted-decimal format, separated by commas. For example, 192.0.2.10, 192.0.2.50.

      mgmt-subnet-mask

      Enter the subnet mask for the management network.

      mgmt-gateway-address

      Enter the IP address of the network gateway for the management network.

      mgmt-dns-server

      Enter the IP address of one or more DNS servers for the management network. Enter each IP address on a separate line. For example:

      - 192.0.2.1

      - 192.0.2.100

      Table 2. API Access Network Configuration
      Option Description

      api-network-name

      Enter the name of the API access network.

      If your API access network uses static IP addresses instead of DHCP, enter the following values. These values are not required for DHCP networks.

      Option Description

      api-ip-range-begin, api-ip-range-end

      Enter the IP address ranges on your API access network in dotted-decimal format, separated by commas. For example, 198.51.100.10, 198.51.100.50.

      api-subnet-mask

      Enter the subnet mask for the API access network.

      api-gateway-address

      Enter the IP address of the network gateway for the API access network.

      api-dns-server

      Enter the IP address of one or more DNS servers for the API access network. Enter each IP address on a separate line. For example:

      - 198.51.100.1

      - 198.51.100.100

      If your deployment uses VDS networking, enter the following values. These values is not required for NSX deployments.

      Table 3. Trunk Network Configuration
      Option Description

      trunk-network-name

      Enter the name of the trunk network.

      trunk-ip-range-begin, trunk-ip-range-end

      Enter the IP address ranges on your trunk network in dotted-decimal format, separated by commas. For example, 169.254.0.1,169.254.0.254.

      Enter the following information for all deployment types.

      Table 4. Control Plane Configuration
      Option Description

      datacenter-name

      Enter the name of the vSphere data center in which to create the VMware Integrated OpenStack control plane.

      datastore-name

      Enter the name of the datastore for the VMware Integrated OpenStack control plane.

      resource-pool-name

      Enter the name of the resource pool for the VMware Integrated OpenStack control plane.

      controller-count

      Specify the number of controllers to create.

      controller-size

      Specify the size of the controllers. The following values are accepted:

      • small (4 vCPUs and 16 GB of RAM)
      • medium (8 vCPUs and 32 GB of RAM)
      • large (12 vCPUs and 32 GB of RAM)
      Table 5. Backup Configuration
      Option Description

      backup-file-name

      Enter the name of the backup file to restore.

      restore-description

      Enter a description for the restoration task.

      content-library-name

      Enter the name of the content library containing the backup file.

      If your content library and VMware Integrated OpenStack are located in separate vCenter Server instances, enter the configuration for the vCenter Server instance containing the content library. The following values are not required if your content library and control plane are located in the same vCenter Server instance.

      Table 6. Content Library Configuration
      Option Description

      control-plane-storage

      (Optional) Enter the name of a datastore on which to store control plane information.

  3. Specify the vCenter Server for the VMware Integrated OpenStack deployment restoration.
    viocli create vcenter --vc_hostname <host> --vc_password <password> --vc_username <user>
    Or use an alias for the Kubernetes command-line utility to get the vCenter Server from the deployment.
    osctl get vcenter
  4. Restore your deployment with the configuration file, specifying the destination vCenter Server where you want to restore the deployment.
    viocli restore deployment -f <configuration-file> --destination-vcenter <vcenter-name> [--content-vcenter <vcenter-name>] [--skip-control-plane]

    If the --skip-control-plane flag is set, restore your deployment by including the vCenter Server that contains the backup image that you want to restore.

    viocli restore deployment -f <configuration-file> --destination-vcenter <vcenter-name> --content-vcenter <vcenter-name> --skip-control-plane

Results

The OpenStack deployment is restored to the state of the backup.