Information
Unsupported content This version of the documentation is no longer supported. However, the documentation is available for your convenience. You will not be able to leave comments.

Refresh virtual cluster


This topic lists the XML samples and node element descriptions required for configuring the response of the VMware_Integration module for refreshing a virtual cluster.

The following table lists the workflow names used for refreshing a virtual cluster in the VMware and BMC Cloud Lifecycle Management integration:

Workflow type

Name

CLM_Integration

Virtual Cluster Search

VMware_Integration

Virtual Cluster Refresh Search

 

Response from VMware_Integration module

XML sample for configuring the response

<virtual-clusters>
   <virtual-cluster>
     <server-name>MICRO-CSM-VC01.bmc.com</server-name>
     <name>csm-cluster</name>
     <total-memory>0</total-memory>
     <vcpus>0</vcpus>
     <total-memory-unit>MB</total-memory-unit>
     <hosts-in-cluster>0</hosts-in-cluster>
     <switches />
   </virtual-cluster>
   <virtual-cluster>
     <server-name>MICRO-CSM-VC01.bmc.com</server-name>
     <name>SAP-Cluster</name>
     <total-memory>16384</total-memory>
     <vcpus>8</vcpus>
     <total-memory-unit>MB</total-memory-unit>
     <hosts-in-cluster>1</hosts-in-cluster>
     <switches>
       <switch>
         <switch-name>vSwitch0</switch-name>
         <switch-type>EXTERNAL_CLOUD_SIMULATED_SWITCH</switch-type>
       </switch>
     </switches>
     <virtual-datastores>
       <virtual-datastore>
         <id>datastore-3355</id>
         <name>datastore1</name>
         <capacity>1192390295552</capacity>
         <free-space>101868109824</free-space>
         <type>VMFS</type>
         <multiple-host-access>false</multiple-host-access>
       </virtual-datastore>
     </virtual-datastores>
   </virtual-cluster>
   <virtual-cluster>
     <server-name>MICRO-CSM-VC01.bmc.com</server-name>
     <name>SAP-Cluster1</name>
     <total-memory>131027</total-memory>
     <vcpus>12</vcpus>
     <total-memory-unit>MB</total-memory-unit>
     <hosts-in-cluster>1</hosts-in-cluster>
     <switches>
       <switch>
         <switch-name>vSwitch0</switch-name>
         <switch-type>EXTERNAL_CLOUD_SIMULATED_SWITCH</switch-type>
       </switch>
     </switches>
     <virtual-datastores>
       <virtual-datastore>
         <id>datastore-3601</id>
         <name>cmpl-bsm-dv01-vol2</name>
         <capacity>1099243192320</capacity>
         <free-space>655471149056</free-space>
         <type>VMFS</type>
         <multiple-host-access>false</multiple-host-access>
       </virtual-datastore>
       <virtual-datastore>
         <id>datastore-3275</id>
         <name>datastore1 (1)</name>
         <capacity>293936824320</capacity>
         <free-space>292917608448</free-space>
         <type>VMFS</type>
         <multiple-host-access>false</multiple-host-access>
       </virtual-datastore>
       <virtual-datastore>
         <id>datastore-3281</id>
         <name>cmpl-bsm-dv01-vol1</name>
         <capacity>2198754820096</capacity>
         <free-space>171371921408</free-space>
         <type>VMFS</type>
         <multiple-host-access>false</multiple-host-access>
       </virtual-datastore>
     </virtual-datastores>
   </virtual-cluster>
   <virtual-cluster>
     <server-name>MICRO-CSM-VC01.bmc.com</server-name>
     <name>Blueprint Cluster</name>
     <total-memory>131027</total-memory>
     <vcpus>12</vcpus>
     <total-memory-unit>MB</total-memory-unit>
     <hosts-in-cluster>1</hosts-in-cluster>
     <switches>
       <switch>
         <switch-name>vSwitch0</switch-name>
         <switch-type>EXTERNAL_CLOUD_SIMULATED_SWITCH</switch-type>
       </switch>
     </switches>
     <virtual-datastores>
       <virtual-datastore>
         <id>datastore-4492</id>
         <name>cmpl-bsm-dv02-vol2</name>
         <capacity>2198754820096</capacity>
         <free-space>1144279531520</free-space>
         <type>VMFS</type>
         <multiple-host-access>false</multiple-host-access>
       </virtual-datastore>
       <virtual-datastore>
         <id>datastore-3451</id>
         <name>cmpl-bsm-dv02-vol1</name>
         <capacity>2308813357056</capacity>
         <free-space>165605801984</free-space>
         <type>VMFS</type>
         <multiple-host-access>true</multiple-host-access>
       </virtual-datastore>
       <virtual-datastore>
         <id>datastore-3450</id>
         <name>datastore1 (3)</name>
         <capacity>293936824320</capacity>
         <free-space>107799904256</free-space>
         <type>VMFS</type>
         <multiple-host-access>false</multiple-host-access>
       </virtual-datastore>
     </virtual-datastores>
   </virtual-cluster>
   <virtual-cluster>
     <server-name>MICRO-CSM-VC01.bmc.com</server-name>
     <name>SAP-Cluster-2</name>
     <total-memory>131027</total-memory>
     <vcpus>12</vcpus>
     <total-memory-unit>MB</total-memory-unit>
     <hosts-in-cluster>1</hosts-in-cluster>
     <switches>
       <switch>
         <switch-name>vSwitch0</switch-name>
         <switch-type>EXTERNAL_CLOUD_SIMULATED_SWITCH</switch-type>
       </switch>
     </switches>
     <virtual-datastores>
       <virtual-datastore>
         <id>datastore-4257</id>
         <name>cmpl-bsm-dv03-vol2</name>
         <capacity>3298266447872</capacity>
         <free-space>600812027904</free-space>
         <type>VMFS</type>
         <multiple-host-access>false</multiple-host-access>
       </virtual-datastore>
       <virtual-datastore>
         <id>datastore-4235</id>
         <name>cmpl-bsm-dv03-vol1</name>
         <capacity>1099243192320</capacity>
         <free-space>517969281024</free-space>
         <type>VMFS</type>
         <multiple-host-access>false</multiple-host-access>
       </virtual-datastore>
       <virtual-datastore>
         <id>datastore-4234</id>
         <name>datastore1 (2)</name>
         <capacity>293936824320</capacity>
         <free-space>133722800128</free-space>
         <type>VMFS</type>
         <multiple-host-access>false</multiple-host-access>
       </virtual-datastore>
     </virtual-datastores>
   </virtual-cluster>
   <virtual-cluster>
     <server-name>MICRO-CSM-VC01.bmc.com</server-name>
     <name>field-cluster</name>
     <total-memory>32756</total-memory>
     <vcpus>4</vcpus>
     <total-memory-unit>MB</total-memory-unit>
     <hosts-in-cluster>1</hosts-in-cluster>
     <switches>
       <switch>
         <switch-name>vSwitch0</switch-name>
         <switch-type>EXTERNAL_CLOUD_SIMULATED_SWITCH</switch-type>
       </switch>
     </switches>
     <virtual-datastores>
       <virtual-datastore>
         <id>datastore-2491</id>
         <name>Storage1 (5)</name>
         <capacity>1197759004672</capacity>
         <free-space>138264182784</free-space>
         <type>VMFS</type>
         <multiple-host-access>false</multiple-host-access>
       </virtual-datastore>
     </virtual-datastores>
   </virtual-cluster>
   <virtual-cluster>
     <server-name>CLM-SP1-VC.bmc.com</server-name>
     <name>sp2-cluster</name>
     <total-memory>32756</total-memory>
     <vcpus>4</vcpus>
     <total-memory-unit>MB</total-memory-unit>
     <hosts-in-cluster>1</hosts-in-cluster>
     <switches>
       <switch>
         <switch-name>vSwitch0</switch-name>
         <switch-type>EXTERNAL_CLOUD_SIMULATED_SWITCH</switch-type>
       </switch>
     </switches>
     <virtual-datastores>
       <virtual-datastore>
         <id>datastore-1635</id>
         <name>Datastore 21</name>
         <capacity>1197759004672</capacity>
         <free-space>153616384000</free-space>
         <type>VMFS</type>
         <multiple-host-access>false</multiple-host-access>
       </virtual-datastore>
     </virtual-datastores>
   </virtual-cluster>
   <virtual-cluster>
     <server-name>CLM-SP1-VC.bmc.com</server-name>
     <name>sp1-cluster</name>
     <total-memory>32756</total-memory>
     <vcpus>8</vcpus>
     <total-memory-unit>MB</total-memory-unit>
     <hosts-in-cluster>1</hosts-in-cluster>
     <switches>
       <switch>
         <switch-name>vSwitch0</switch-name>
         <switch-type>EXTERNAL_CLOUD_SIMULATED_SWITCH</switch-type>
       </switch>
     </switches>
     <virtual-datastores>
       <virtual-datastore>
         <id>datastore-1690</id>
         <name>Datastore 14</name>
         <capacity>1797175377920</capacity>
         <free-space>103906541568</free-space>
         <type>VMFS</type>
         <multiple-host-access>false</multiple-host-access>
       </virtual-datastore>
     </virtual-datastores>
   </virtual-cluster>
 </virtual-clusters>

All of the following node elements are required for configuring the response:

Element

Description

Sample values

<virtual-clusters>

Represents the list of one or more virtual cluster detail(s) to be returned

None

<virtual-cluster>

Represents one valid virtual cluster entry

Note: This is required only if there are one or more virtual clusters to be returned.

None

<server-name>

Specifies the vCenter server name to which the cluster belongs

MICRO-CSM-VC01.bmc.com

<name>

Specifies the name of the virtual cluster

csm-cluster

<total-memory>

Specifies the total memory, in MB, of all hosts within the virtual cluster

32576

<total-memory-unit>

Specifies the unit of total-memory value

MB

<vcpus>

Specifies the total number of CPU resources of all hosts

4

<switches>

Defines the switches within the cluster

None

<switch>

Represents one switch entry

Note: A virtual cluster should have at least one valid virtual switch entry. 

None

<switch-name>

Specifies the name of the switch

vSwitch0

<switch-type>

It specifies the switch type

Valid values:

  • DVS_SWITCH (For distributed switches), 
  • EXTERNAL_CLOUD_SIMULATED_SWITCH (For standard switches) 

EXTERNAL_CLOUD_SIMULATED_SWITCH

<virtual-datastores>

Defines the datastores contained within this virtual cluster

Note: A virtual cluster should have at least one valid virtual datastore entry. 

None

<virtual-datastore>

Defines one virtual datastore entry

None

<id>

Specifies the datastore ID

datastore-1690

<name>

Specifies the name of the datastore

Datastore 14

<capacity>

Specifies the maximum capacity, in bytes, of a datastore

1797175377920

<free-space>

Specifies the free space, in bytes,of a datastore

103906541568

<type>

Specifies the type of a datastore

VMFS

<multiple-host-access>

Specifies if the multiple host access is enabled for a datastore

Valid values: true, false

false

If an error occurs during execution, error XML code is returned in the following format:

<value>
   <error>Error Message</error>
</value>

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

BMC Cloud Lifecycle Management 3.1