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.

Onboard virtual host


This topic lists the XML samples and node element descriptions required for configuring the request and response of the VMware_Integration module for onboarding a virtual host

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

Workflow type

Name

CLM_Integration

Virtual Host Onboard

VMware_Integration

Virtual Host Onboard Implementation

Request to VMware_Integration module

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

Name

Description

Sample values

<server-name>

Specifies the management server that manages virtual clusters and hosts.  

MICRO-CSM-VC01.bmc.com 

<cluster-name>

Specifies the name of the cluster managing the virtual host.  

field-cluster 

<host-name>

Specifies the virtual host to be onboarded.
For VMware, this name is an ESX/ESXi host.

pe-pun-asp-dv03.bmc.com

Response from VMware_Integration module

XML sample for configuring the response

<virtual-host>
<server-name>MICRO-CSM-VC01.bmc.com</server-name>
<cluster-name>SAP-Cluster</cluster-name>
<name>pe-pun-asp-dv03.bmc.com</name>
<total-memory>16383</total-memory>
<cpu-clock-speed>1861</cpu-clock-speed>
<total-cpus>8</total-cpus>
<switches>
 <switch>
<switch-name>vSwitch0</switch-name>
<switch-type>EXTERNAL_CLOUD_SIMULATED_SWITCH</switch-type>
 </switch>
</switches>
 </virtual-host>

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

Name

Description

Required

<virtual-host>

Represents a valid virtual host entry

Yes

<server-name>

Specifies the vCenter server name to which the cluster belongs

Yes

<cluster-name>

Specifies the name of the virtual cluster

Yes

<name>

Specifies the name of the virtual host

Yes

<total-memory>

Specifies the total memory, in MB, of the virtual host 

Recommended value: 32576

Yes

<cpu-clock-speed>

Contains the speed of the CPU cores, in MHz 

Yes

<total-cpus>

Specifies the number of CPU resources of the host

Recommended value: 4

Yes

<switches>

Defines switches aggregated within the cluster

Only if a host contains at least one valid virtual switch

<switch>

Represents one switch entry

Only if a valid virtual switch entry is returned

<switch-name>

Specifies the name of the switch

Only if a valid virtual switch entry is returned

<switch-type>

Specifies the type of the switch.

Valid values:

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

Only if a valid virtual switch entry is returned

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