HP Matrix Operating Environment Software - Manual (Page 255)

HostnameOperationTypeEnum RESERVE option
The HostnameOperationTypeEnum RESERVE is used during create service and add server requests.
Configure the workflow parameters as follows:
•
PropertyXML contains the name/value pairs representing the server IDs of all servers for a
create service request, and only the IDs of the added servers for an add server request. The
value field of each pair is empty.
•
The workflow must find the appropriate logical servers in the InfrastructureServiceXML based
on the specified server IDs.
•
The corresponding host name must be generated for the specified logical server(s) according
to the desired naming scheme.
•
The generated host names must be returned from the workflow as an identical structure to the
PropertyXML; that is, a list of name/value pairs, where the name is the logical server ID, and
the value is the generated host name. The return XML must be attributed to workflow’s Primary
Output.
Example 1 Received XML (PropertyXML)
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<PropertyList xmlns="http://hp.com/2007/ess/sw/model/InfrastructureUtilitySchema">
<Property>
<Name>LogicalServer:0577a0cc-8122-4802-8173-6161b2f8dcc4</Name>
<Value> </Value>
</Property>
<Property>
<Name>LogicalServer:15d20b1d-abee-45bb-88d8-d951dc1495d9</Name>
<Value> </Value>
</Property>
</PropertyList>
The empty Value element is replaced by the host name creation workflow. See the returned XML
example below.
Example 2 Returned XML
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<PropertyList xmlns="http://hp.com/2007/ess/sw/model/InfrastructureUtilitySchema">
<Property>
<Name>LogicalServer:0577a0cc-8122-4802-8173-6161b2f8dcc4</Name>
<Value>hostname-01</Value>
</Property>
<Property>
<Name>LogicalServer:15d20b1d-abee-45bb-88d8-d951dc1495d9</Name>
<Value>hostname-02</Value>
</Property>
</PropertyList>
The new host names are inserted in the appropriate Value elements. Matrix infrastructure
orchestration uses these values as the host names.
If the OO workflow RESERVE operation fails, the current request also fails since no host names are
generated. No partial results are accepted. It is expected that the workflow is able to generate all
requested host names. In case it fails, for example, by generating only 9 of the 10 host names
requested, none of the host names are used. The workflow must ensure such host names can be
reused in a subsequent RESERVE operation if applicable.
HostnameOperationTypeEnum RESERVE option 255