module 5 - surviving the hp insight dynamics io request xml

8/12/2019 Module 5 - Surviving the HP Insight Dynamics IO Request XML

http://slidepdf.com/reader/full/module-5-surviving-the-hp-insight-dynamics-io-request-xml 1/28

©2009 HP Confidential1 ©2009 HP Confidential1

11

HP BladeSystem MatrixIntegration Capabilities

A special 5-part TekTalk Edition Series

TekTalk Matrix Series – Part III

Surviving the Infrastructure OrchestrationRequest XML

Dec 16, 2010

WW Converged Infrastructure Lab




22

HP BladeSystem Matrix Integration - 5-Part SeriesSession Topic DatePart #1 – HP Insight Dynamics Infrastructure Orchestration (IO)

Integration ArchitectureNov 18 & Dec 7

Part #2 – Introduction to HP Operations Orchestration (OO)workflows Authoring tool

– Creating your first OO workflow

– Publishing an OO workflow as an IO Service ActionWorkflow

Dec 2, 2010

Part #3 – Inside the IO Request XML

– Standard XML query language

– Techniques used to Parse the IO Request XML in anOO Workflow

Dec 16, 2010

Part #4 – Controlling IO through the IO API

– IO API Command Line Interface – IO API Web Services

Jan 20, 2011

Part #5 – Integrating IO with external IT processes byexamples

Feb 10, 2011

All sessions will be recorded and made available at the TekTalk URL:http://enhanced2.sharepoint.hp.com/teams/presales/portalstools/tektalks/default.as

px




33

3

Goals of this Special TekTalk Edition SeriesHP BladeSystem Matrix Integration Capability

• Help You identify the value that IO/OO can provide to yourcustomers

• Make accessible to a large audience some of the majorsubjects related to HP IO integration capabilities by:

• Understanding the Infrastructure Orchestration integration Architecture

• Becoming an effective OO Workflow designer as it relates to IO

• Looking at the IO integration techniques with external IT processes

• Whet your appetite for more




44

4

AgendaSurviving the Infrastructure Orchestration Request XML

• The Story so far

• Analysis of the Request XML – Tree structure

• Parsing the Request XML: Standard XPath languages and

XSLT• Q&A



Infrastructure Orchestration Integration Architecture

VirtualMachines

Resource Pools

ServersStorage

Web

Portals Asset &Billing

Ticketingsystem

Applicationintegration

Networkintegration

Webservices

EnterpriseProcesses

ServiceManagementHP Insight

Orchestration

ProcessWorkflow

AutomationEnterpriseIntegration

Template specificWorkflows

Customer & hp partnersupplied content

Software

deployment

Administrator

Self-service user

Architect

1

2

3

4

i IntegrationInterface

1‟

CLI

RDP

SA

Ignite

3 rd PartyHardware

5




777

Global System Flows & Per-IO template Flows

• Global “System” Flows − Flows associated with „Global‟ actions

− Common to all IO service requests (for example: approval,notification, manual storage provisioning)

− Association configured in IO configuration file: hpio.properties

• Service Action Flows (Per-IO template flows)− Specific to an IO template

− Flows must be created by IT architect

− and then associated with IO Template using the IO Designer utility




IO Service Action Flow

• An Set of linked tasks written in OO Studio

• A task can be an operation (e.g.: ping, SSH, remote command, read/write file, send e-mail,

XPath Query, etc…) or another flow (aka „ subflow ‟) • IO-Supplied input data: Date, User Token, XML data stream (Request XML)

• Flow variables are used to allow the flow to run automatically (“headless” flow = no userinteraction)

• Use HP OO Studio Flow Debugger to test & validate your flow.

• You associate your flow to an IO Design Template using IO Designer• Use OO Central (OO Workflow Engine Server) for flow troubleshooting




Analyzing and Parsing the Request XML

• Anatomy of a IO Service Action Flow

• Analyzing the Request XML and its Tree structurerepresentation

• XML Standard Query Language – XPath Expressions

• Testing XPath Expressions with XML Tools• Using the XPath expressions in a Flow with OO Parsing

Operation „ GetXPathValue ’

• Retrieving Logical Servers‟ Network configuration for

pre-post configuration task or integration with ITprocesses.• Using GetXPathValue OO Parsing Operation• Using advanced OO Parsing Operations: XSL-Transform

(GetXslt)



12

The Request XML Data Stream



1313

The Request XML – Tree Structure Representation



1414

The Request XML – Tree Structure Representation (Cont…)



1515

What is XPath?

• XML Standard

• Used to navigate in an XML document and retrieve data from it

• Learn more from: http://www.w3schools.com/xpath/

• In OO, „Standard‟ XPath is used with two OO Parsing operations:• GetXpathValue which returns a single value (e.g: ServiceName)

• GetXpathValue s which returns a comma separated list of values (All LogicalServershost names defined in the XML file)

• Advanced XPath technique is XSLT



1616

Standard XPath Expressions (some examples)



1717

Examples of XPath Expressions mapping with XML tree



Using an XML Editor to build/validateyour XPath Queries

• Several tools exist:− Plugins to Firefox− Standalone products

• Altova “XMLSpy ”

− http://www.altova.com/xmlspy.html − Some licenses available (10 concurrent users)

• SyncRO Soft Ltd “ oXygen ”

− http://www.oxygenxml.com/ − License server within HP at: lic-rwan1.fc.hp.com:27020

http://www.altova.com/xmlspy.html

http://www.oxygenxml.com/

http://www.oxygenxml.com/

http://www.altova.com/xmlspy.html



Best Practices when using XML Editors1. Open XML Editor

2. Load RequestXML (cut/paste from input param in OO Studio)3. Run XPath Queries against the RequestXML

4. Copy/Paste XPath to OO Parsing Operations GetXPathValue(s)

5. Adapt for slight syntax requirement of GetXPathValue(s)

6. Run Flow



20

XML Tools – XMLSpy from Altova for Standard XPathqueries

Request XML

The XPathExpression

The result



2121

OO Parsing Operations (GetXPathValue) in a Per-IOtemplate Flow



2222

-template Flow (Example of an iteration over the list oflogical Servers)

OO Parsing Operations (GetXPathValue) in a Per IO



2323

OO Parsing Operations (GetXPathValue) in a Per-IOtemplate Flow (Example of an iteration over the list oflogical ServerS and list of Network Interfaces)



2424

What is XSLT?• XML Standard

• eXtensible Stylesheet Language

• Learn more from http://www.w3schools.com/xsl/

• Used to transform an XML document into another XMLdocument, or into HTML or TEXT

• In OO we use it with the OO Subflow: GetXslt

XML Document XSL Transform

New

Document

http://www.w3schools.com/xsl/

http://www.w3schools.com/xsl/



Best Practice for building XSLT• Take a look at existing examples (Approval Flow)

• Make sure there is not a simpler way to do it (with XPath)• Follow guidelines for result string: comma separated list of items, or

pipe separated list of items, themselves comma separated• a,b,c• a,b,c|a1,b1,c1|a2,b2,c2

• Fully qualify all elements (use name space hpio)

• Use an XML Editor to debug

• Copy XSLT to file on IO Server (<IO>\conf\OO) as .xsl

• Run in OO Studio Debug• Load Xsl file to OO Variable (Read File From Variable

operation)• Use GetXslt subflow to apply transformation• Use OO List Iterators and OO Table Filters to parse result string



2626

XSL Transform file



2727

XML Tools – XMLSpy from Altova for XSL-Transform

Request XMLXSL-Transform

Result of the XSLT




Q&A

module 5 - surviving the hp insight dynamics io request xml

Documents