BRKDEV-1241

14632_05_2008_X1 © 2008 Cisco Systems, Inc. All rights reserved. Cisco Public 1

Applying the VFrame

Data Center API for
Service Orchestration

BRKDEV-1241

BRKDEV-1241
14632_05_2008_X1 © 2008 Cisco Systems, Inc. All rights reserved. Cisco Public 2

© 2006, Cisco Systems, Inc. All rights reserved. 1

Presentation_ID.scr
 Agenda

ƒ Brief introduction to VFrame Data Center

ƒ VFrame DC API example use cases
TIBCO ActiveMatrix integration
Data Synapse integration
Service provider web portal

ƒ A quick look at the web portal code

ƒ A formal walk through the VFrame DC APIs

BRKDEV-1241
14632_05_2008_X1 © 2008 Cisco Systems, Inc. All rights reserved. Cisco Public 3

VFrame Data Center

Virtual Application Services

Loa d

10

Service Service
Template VFrameDC Policies

Virtual Machine
Manager

Physical Physical
Virtual
Physical Virtual Network LUNs Virtual
Network
Servers Machines and and NAS Storage
Services
Services Volumes

BRKDEV-1241
14632_05_2008_X1 © 2008 Cisco Systems, Inc. All rights reserved. Cisco Public 4

© 2006, Cisco Systems, Inc. All rights reserved. 2

Presentation_ID.scr
 Datacenter Architecture

Physical Logical

Aggr Web
Servers

App
Servers
Access

Database
Servers

Storage

Ethernet Firewall SLB Storage Router SSL IDS Server Storage Blade
Switch Switch Switch Server
BRKDEV-1241
14632_05_2008_X1 © 2008 Cisco Systems, Inc. All rights reserved. Cisco Public 5

VFrame DC Services Virtualization

Design

Discover Firewall LAN Load Server Boot OS/ SAN Storage

Infrastructure Balancing I/O Application Infrastructure

Deploy Firewall Selection

Firewall Chaining
Switch Port
Config
VIPs, LB Policies Golden Images
Image Replication
Zones, VSANs,
LUNs, Masking,
Firewall Rules VLANs, DHCP, Remote Boot Mapping NFS
Trunks, SVIs, VM Mappings Volumes
Teaming

Operate Automated Failover Policy Based Resource Optimization

Management Integration Thru API Service Maintenance

BRKDEV-1241
14632_05_2008_X1 © 2008 Cisco Systems, Inc. All rights reserved. Cisco Public 6

© 2006, Cisco Systems, Inc. All rights reserved. 3

Presentation_ID.scr
 VFrame DC + TIBCO Active Matrix
Transaction Level Monitoring
Threshold Based Policies
Active Matrix
Service Performance Manager
Active Server Pool

API Messaging
High Load/Add Server
Low Load/Remove Server

Spare Server Pool

VFrame
Data Center
Policy Based Resource Remap
Requirements Based Resource Selection
Coordinated Server, Network and Storage Provisioning
BRKDEV-1241
14632_05_2008_X1 © 2008 Cisco Systems, Inc. All rights reserved. Cisco Public 7

VFrame DC + Data Synapse

Incoming Workloads Have
Different Infrastructure
Requirements
API Based Resource Availability Check
Server Bringup with Specific Image Load
Connectivity to Appropriate Network and Storage Resources
Resource Rebalance Based on Load

FabricServer

VFrame
Data Center

BRKDEV-1241
14632_05_2008_X1 © 2008 Cisco Systems, Inc. All rights reserved. Cisco Public 8

© 2006, Cisco Systems, Inc. All rights reserved. 4

Presentation_ID.scr
 VFrame DC + Service Provider Web Portal
Data Center Infrastructure
Customer
Customer
Service
Service
Request
Request

VFrame Device
Servers
GUI Managers

Custom
Custom
Infrastructure
Infrastructure API Network
Services
Services VFrame
Portal
Portal

Business Users IT Administrators Storage

•Simple
•Simple service
service turnup
turnup and
and shutdown
shutdown
•Abstract
•Abstract complexity
complexity from
from end
end customer
customer
•Common
•Common resource
resource pools
pools
BRKDEV-1241
14632_05_2008_X1 © 2008 Cisco Systems, Inc. All rights reserved. Cisco Public 9

VFrame DC + Service Provider Web Portal

ƒ Web portal customer use case

Login to the WebPortal
Browse through a catalogue of Service Networks
Add one or more Service Networks to Shopping Cart
Checkout
Go to Operations page
Start/Stop Service Networks
Add/Start/Stop Servers
Add/Delete Storage
View usage based charges and pay bill

ƒ Web portal uses VFrame in the back-end to provision Servers,

LAN, SAN, and Storage
Servers are automatically remapped on server hardware failure by VFrame

ƒ Service Provider’s Web Portal Demo

BRKDEV-1241
14632_05_2008_X1 © 2008 Cisco Systems, Inc. All rights reserved. Cisco Public 10

© 2006, Cisco Systems, Inc. All rights reserved. 5

Presentation_ID.scr
 Service Provider Web Portal

ƒ Implemented using Ruby on RAILS in 2 days!

ƒ Used Ruby’s SOAP4R package to interface to VFrame
DC’s Webservices APIs
wsdl = "http://localhost/sdk/vframe/wsdl/serviceoperations-service.wsdl"
snops = SOAP::WSDLDriverFactory.new(wsdl).create_rpc_driver

url = 'http://localhost/services/ServiceOperationsService'
snops.options["protocol.http.basic_auth"] << [url,user,pass]

snops.startServiceNetwork(:serviceRef =>
{:templateName => x.templateName,
:serviceName => y.serviceName})

snops.executeServiceElementOperation(:ref => server.ref,

:eventId => event.eventId)

ƒ It is this simple. Really!

ƒ VFrame DC online WSDL Documentation Demo
BRKDEV-1241
14632_05_2008_X1 © 2008 Cisco Systems, Inc. All rights reserved. Cisco Public 11

VFrame API SDK

ƒ Software Development Kit is a zip file which

contains all necessary data to help start client
development based on APIs
ƒ WSDL and ( associated XML files ) : This is how user
get access to wsdl files. One can also access the
service wsdl’s at /services url but its not recommended
ƒ Sample programs with source code : In java to help
users get started
ƒ Documentation : Developer’s guide in PDF and HTML
format and WSDL documentation serves as API
reference

BRKDEV-1241
14632_05_2008_X1 © 2008 Cisco Systems, Inc. All rights reserved. Cisco Public 12

© 2006, Cisco Systems, Inc. All rights reserved. 6

Presentation_ID.scr
 VFrame SDK

ƒ Point your browser

to your VFrame DC
appliance
ƒ Find more information
about VFrame SDK at
http://<vcc-server>/sdk

BRKDEV-1241
14632_05_2008_X1 © 2008 Cisco Systems, Inc. All rights reserved. Cisco Public 13

Other Goodies

ƒ VFrame DC simulator is available for partners,

under NDA, for API development
ƒ Perl SDK is available by request
ƒ Web Portal Sample code based on Ruby on RAILS
is available by request

BRKDEV-1241
14632_05_2008_X1 © 2008 Cisco Systems, Inc. All rights reserved. Cisco Public 14

© 2006, Cisco Systems, Inc. All rights reserved. 7

Presentation_ID.scr
 A Formal Walk Through
the VFrame DC APIs

BRKDEV-1241
14632_05_2008_X1 © 2008 Cisco Systems, Inc. All rights reserved. Cisco Public 15

Introduction

ƒ VFrame DC Web Services APIs expose a set of the

functionality through a collection of SOAP based
web services
ƒ SOAP based Web services provide a set of standards
based, platform independent protocols for
communication between applications
ƒ Thus applications written in any programming
language, for any platform, can integrate with the
VFrame Director through the SOAP based Web
Services API

BRKDEV-1241
14632_05_2008_X1 © 2008 Cisco Systems, Inc. All rights reserved. Cisco Public 16

© 2006, Cisco Systems, Inc. All rights reserved. 8

Presentation_ID.scr
 Authentication and Authorization

ƒ Each SOAP session make use of the same HTTP

Basic authentication mechanism as VFrame
DC GUI does
ƒ For inbound calls, the username field is formatted
similarly to the GUI as <username>@<context>
ƒ These credentials are be used to enforce the same role
based access control (RBAC and Domain Filtering)
used by the GUI
ƒ HTTPS is supported to provide encrypted
communications between the client and server

BRKDEV-1241
14632_05_2008_X1 © 2008 Cisco Systems, Inc. All rights reserved. Cisco Public 17

Overview

ƒ The user can then make use of the APIs to perform

operations such as managing
Device Credentials,
Retrieving Resource Inventory
Managing/Un-managing Resources
Server Images Export/Import
Service Templates Export/Import and Service Operations
Receive Event Notifications.

ƒ The functionality exposed by the VFrame APIs

is covered in next few slides, organized by
functional groups

BRKDEV-1241
14632_05_2008_X1 © 2008 Cisco Systems, Inc. All rights reserved. Cisco Public 18

© 2006, Cisco Systems, Inc. All rights reserved. 9

Presentation_ID.scr
 List of API’s… AboutVframe

ƒ GetVersion: Gets the VCC Product Information such

as product version, build etc. Same as “About VFrame”
in GUI

BRKDEV-1241
14632_05_2008_X1 © 2008 Cisco Systems, Inc. All rights reserved. Cisco Public 19

List of API’s… Credentials

ƒ (Device) Credentials Management
List : Queries based on criteria
Add : Allows creation of device credentials
Save : Allows credentials to be modified
Remove : Allows credentials to be deleted

BRKDEV-1241
14632_05_2008_X1 © 2008 Cisco Systems, Inc. All rights reserved. Cisco Public 20

© 2006, Cisco Systems, Inc. All rights reserved. 10

Presentation_ID.scr
 List of API’s… Resources
ƒ Resource Management
Query Resources : Get Resource info based on criteria
Query Resource Pools : Get Pools details
Label Resources : Allows resource name and description to be set
Manage Resources : ‘Manages’ resource(s)
Un-manage Resources : ‘UnManages’ resource(s)
Maintain Resources : Puts a resource to a maintenance state
Create Resources : ( IPV4Range , VLAN )
Create Resource Pools : Both Static and Dynamic
Update Resource Pools : Allows pool membership to be modified
Query Physical to Logical Mappings : Gets P2V Mapping

BRKDEV-1241
14632_05_2008_X1 © 2008 Cisco Systems, Inc. All rights reserved. Cisco Public 21

List of API’s… ServerImages

ƒ GoldenImage Management
ListGoldenImagesFolders : Lists GI folders and Images
Export GoldenImage : Export GI from VFDC to external location
Import GoldenImage : Import GI from external location
into VFDC

BRKDEV-1241
14632_05_2008_X1 © 2008 Cisco Systems, Inc. All rights reserved. Cisco Public 22

© 2006, Cisco Systems, Inc. All rights reserved. 11

Presentation_ID.scr
 List of API’s… ServiceTemplates
ƒ Service Template Management
List Templates : List all service templates
Export Logical Template : Exports a given service template
Import Logical Template : Imports a given service template

BRKDEV-1241
14632_05_2008_X1 © 2008 Cisco Systems, Inc. All rights reserved. Cisco Public 23

List of API’s… ServiceDesign

ƒ Service Network Design
List Service Networks : List service networks for a service template
List Service Elements : List service elements for a service network.

BRKDEV-1241
14632_05_2008_X1 © 2008 Cisco Systems, Inc. All rights reserved. Cisco Public 24

© 2006, Cisco Systems, Inc. All rights reserved. 12

Presentation_ID.scr
 List of API’s… ServiceOperations
ƒ Service Operations
Start Service Network : Starts service network
Stop Service Network : Stops service network
Verify Service Network : Verifies a service network
Add Logical Servers : Creates Servers in a given ServerGroup
Image Logical Servers : Images logical server(s)
Remove Logical Servers : Deletes logical servers
List Service Element Events : Gets Event list
Execute Service Element Event : Executes a event
for a service element
Query Logical to Physical Mappings : Gets V to P Mapping Info

BRKDEV-1241
14632_05_2008_X1 © 2008 Cisco Systems, Inc. All rights reserved. Cisco Public 25

List of API’s… Notifications

ƒ Notifications Management
Notifications are based on a topic ( named communication channel)
publish/subscribe model. Intended receivers need to implement SOAP
Service to handle notification
Get Topics : Lists all topics that can be subscribed
Register Receiver : Creates receiver and allows subscription to
various topics
Unregister Receiver : Deregisters a receiver or a topic
List Receivers : List all notification receivers info with the topics they
have subscribed to

BRKDEV-1241
14632_05_2008_X1 © 2008 Cisco Systems, Inc. All rights reserved. Cisco Public 26

© 2006, Cisco Systems, Inc. All rights reserved. 13

Presentation_ID.scr
 List of API’s… Jobs

ƒ Job Management
ƒ The Jobs API allows third party applications to perform
job related operations. In the current release, the API
will only provide operations to query job information

GetJobRuns : Get Job Schedule, Job Run Status and Job Logs

BRKDEV-1241
14632_05_2008_X1 © 2008 Cisco Systems, Inc. All rights reserved. Cisco Public 27

Session Management

ƒ The server uses cookie based session management

ƒ The client must be able to support cookies. Subsequent
requests using the same session will not have to be
re-authenticated. This is the desired approach
ƒ In sessionless mode (not recommended), every
inbound connection will be re-authenticated and a new
session will be created
ƒ For security, the session times out after a period
of inactivity
ƒ One can view, all active clients including SOAP
Sessions using VFrame GUI->Reports->Logged
In Users
BRKDEV-1241
14632_05_2008_X1 © 2008 Cisco Systems, Inc. All rights reserved. Cisco Public 28

© 2006, Cisco Systems, Inc. All rights reserved. 14

Presentation_ID.scr
 Error Handling

ƒ In Web services, an exception thrown by the Web

service end point is passed on to the client as a
SOAP fault
ƒ The Fault objects contains information regarding errors
or exceptions encountered during a particular
operation. There are currently 3 types of Fault defined
VFAuthorizationFault : Indicates tasks authorization errors
VFInvalidValueFault : Indicates missing or invalid input
exception
VFFault : Indicates general VFrame exceptions
ƒ The VFrame API shares the error code to message
mapping scheme and infrastructure used by the
VFrame server code and GUI
BRKDEV-1241
14632_05_2008_X1 © 2008 Cisco Systems, Inc. All rights reserved. Cisco Public 29

Interoperability Considerations

ƒ Web Services are supposed to be platform and

implementation independent. Unfortunately that’s not
the reality always (e.g.: J2EE vs .NET)
ƒ WS-I Basic Profile standard created to address
this issue
ƒ VFrame API meets the WS-I Basic Profile requirements
ƒ VFrame Web Services based API’s follow the
“document/literal wrapped” style WSDL to allow full
parameter validation
ƒ Document/literal is WS-I compliant

BRKDEV-1241
14632_05_2008_X1 © 2008 Cisco Systems, Inc. All rights reserved. Cisco Public 30

© 2006, Cisco Systems, Inc. All rights reserved. 15

Presentation_ID.scr
 Complete Your Online
Session Evaluation
ƒ Give us your feedback and you could win Don’t forget to activate
fabulous prizes. Winners announced daily. your Cisco Live virtual
account for access to
ƒ Receive 20 Passport points for each session all session material
evaluation you complete. on-demand and return
for our live virtual event
ƒ Complete your session evaluation online now in October 2008.
(open a browser through our wireless network Go to the Collaboration
to access our portal) or visit one of the Internet Zone in World of
stations throughout the Convention Center. Solutions or visit
www.cisco-live.com.

BRKDEV-1241
14632_05_2008_X1 © 2008 Cisco Systems, Inc. All rights reserved. Cisco Public 31

Q and A

BRKDEV-1241
14632_05_2008_X1 © 2008 Cisco Systems, Inc. All rights reserved. Cisco Public 32

© 2006, Cisco Systems, Inc. All rights reserved. 16

Presentation_ID.scr
 BRKDEV-1241
14632_05_2008_X1 © 2008 Cisco Systems, Inc. All rights reserved. Cisco Public 33

© 2006, Cisco Systems, Inc. All rights reserved. 17

Presentation_ID.scr