Zhengsheng Zhou, Shaohe Feng, Wenruo Lv IBM Linux Technology Center Open Virtualization
20 Aug 2014
Kimchi: An On-Ramp Virtualization
Management Application
2009 IBM Corporation
IBM Presentation Template Full Version
Kimchi
Kimchi: Yet Another KVM Management Tool?
Various existing excellent virtualization management tools
API and command line: libvirt, virsh
GUI: virt-manager, gnome boxes
Cloud: oVirt, OpenStack, ...
Why do we need Kimchi?
What if the user
Is new to virtualization, but experienced in traditional IT management
Wants to evaluate KVM
Manages a few hosts and shared storage devices
Wants to use NAT, VLAN, Linux bridge, bonding, or even Open vSwitch
Wants access to management UI and VM display from Web
Wants a RESTful API to develop a KVM-based management solution
Doesn't want to setup a large complex cloud environment
Kimchi, a simple and smart KVM management tool with HTML5 interface and a REST API
LGPL 3 (Back-end), Apache License 2 (Front-end)
2014 IBM Corporation
Kimchi
Agenda
Kimchi Architecture
Templates and VMs
Storage Back-end Support
Various Virtual Networks Support
Host Management
REST API
Work In Progress
DEMO
Q&A
2014 IBM Corporation
Kimchi
Kimchi Architecture
Design Goals
Simple while Smart
Thin but provide
necessary intelligence
Cross-Platform
Fedora, RHEL,
Ubuntu, OpenSuSe
IE 10+, Chrome, Opera,
Firefox, Safari
Support I18N
English
Portugus
Extensible
Back-end: plugins, API
Front-end: tabs
CherryPy (Web Application Server)
VM, Template,
Storage, Network, ...
Controllers (Python)
UI (HTML 5,
Javascript,
CSS, ...)
VM, Template, Storage, Network, ...
Models (Python)
libvirt
VM
Userspace Libs, Tools
VM
VM
2014 IBM Corporation
Kimchi
Kimchi Architecture Plugin Framework
Front-end
VM UI Tab
Storage UI Tab
Plugin_x UI Tab
Back-end
CherryPy: Accept Request and Dispatch
/vms
/vms/vm_x/ifaces
/vms/vm_x/storages
/storagepools
/storagepools/poolx
/plugins/plugin_x
/plugins/plugin_x/foo
VM Controllers
Storage Controllers
Plugin Controllers
VM Models
Storage Models
Plugin Models
2014 IBM Corporation
Kimchi
Kimchi Architecture - Proxies
Nginx is a reverse proxy, run as normal user
Kimchi daemon (CherryPy) runs as root
Browser
Nginx
CherryPy
WebSockify translates between HTTPs and TCP
Back-end sets VNC/Spice ticket to prevent anonymous VM console access
Browser
https
https
WebSockify
VNC
Spice
QEMU
2014 IBM Corporation
Kimchi
Agenda
Kimchi Architecture
Templates and VMs
Storage Back-end Support
Various Virtual Networks Support
Host Management
REST API
Work In Progress
DEMO
Q&A
2014 IBM Corporation
Kimchi
Templates and VMs - A List View
2014 IBM Corporation
Kimchi
Templates and VMs
Template: Pre-defined VM configuration collection
CPU count, memory size, disk size, disk type
Storage pool
Graphics (VNC, Spice)
Network connectivity type (isolated, NAT, bridged)
VM: A libvirt domain
Compatible with other libvirt-based tools
Life-cycle operation
Manage extra disks (Images are reference counted)
Manage extra network interfaces
Authorization: assign users/groups to a VM
Graphics: noVNC, Spice (WebSocket and HTML5-based)
2014 IBM Corporation
Kimchi
Templates and VMs
Steps to Create the first VM
Step[0]: Select an OS installation ISO
Step[1]: Kimchi generates a template best configured for the guest OS
Step[2]: Create a VM from the template, Kimchi automatically allocates new disk
Step to Create more VMs
Goto Step[2]
ISO
Kimchi scans local ISOs in existing storage pools or /
Support using a remote ISO file directly (http://example.com/example.iso)
10
2014 IBM Corporation
Kimchi
Agenda
Kimchi Architecture
Templates and VMs
Storage Back-end Support
Various Virtual Networks Support
Host Management
REST API
Work In Progress
DEMO
Q&A
11
2014 IBM Corporation
Kimchi
Storage A List View
12
2014 IBM Corporation
Kimchi
Storage Supported Back-Ends
Directory
NFS
iSCSI
SCSI/FC
Logical Volume
13
2014 IBM Corporation
Kimchi
Storage On-Ramp
Common Use Cases
User often create storage pool from the same server
One NFS server with multiple exports, create pool from each export path
One iSCSI server with multiple LUN, each can be used as a pool
Long export path and long IQN
Kimchi
Remembers every storage server it used
Auto probes every target on the storage server
14
2014 IBM Corporation
Kimchi
Storage - NFS example
Using an NFS server for the first time
Kimchi probes all the usable exports
15
2014 IBM Corporation
Kimchi
Storage - NFS example
16
Using the NFS server for the second time
Kimchi presents the user with known NFS
servers
2014 IBM Corporation
Kimchi
Agenda
Kimchi Architecture
Templates and VMs
Storage Back-end Support
Various Virtual Networks Support
Host Management
REST API
Work In Progress
DEMO
Q&A
17
2014 IBM Corporation
Kimchi
Virtual Networks
Three Kinds of Networks from User's Perspective
Private Virtual Network (Isolated):
Masqueraded Virtual Network (Outside-reach):
Aggregated Public Network (In-outside Reach):
Macvtap (Default) + VLAN
Linux Bridge + VLAN
Open vSwitch (Work In Progress)
Bond (Planned)
18
2014 IBM Corporation
Kimchi
Virtual Networks - Private Virtual Network
VM1
VM2
VM3
VM4
nic
nic
nic
nic
br1
Host
19
br2
eth1
2014 IBM Corporation
Kimchi
Virtual Networks - Masqueraded Virtual Network
VM1
VM2
VM3
VM4
nic
nic
nic
nic
br1
Host
br2
NAT
eth1
20
2014 IBM Corporation
Kimchi
Virtual Networks - Aggregated Public Network
VM1
VM2
VM3
VM4
nic
nic
nic
nic
br1
br2
br1
br2
Vlan1
Vlan2
Vlan1
Vlan2
Host1
eth0
21
bond0
eth1
Host2
eth0
bond0
eth1
2014 IBM Corporation
Kimchi
Virtual Networks
22
Creating a Virtual Network
2014 IBM Corporation
Kimchi
Agenda
Kimchi Architecture
Templates and VMs
Storage Back-end Support
Various Virtual Networks Support
Host Management
REST API
Work In Progress
DEMO
Q&A
23
2014 IBM Corporation
Kimchi
Host Management
Host Information
Distro, processor, memory
System statistics
CPU utilization, memory usage, disk I/O, network I/O
Software Updates
Repository Management
Debug Reports Generating
24
2014 IBM Corporation
Kimchi
Host Management - Ginger
Ginger: A Kimchi Plugin
Focused on IBM PowerKVM Host Management
Power firmware update
Configuration backup
Host network configuration (IP, mask, DNS, gateway, DHCP)
Switching power profiles (tuned:latency-performance, throughput-performance,
balanced, virtual-host, virtual guest, ...)
SAN adapters information
System sensors information
https://github.com/kimchi-project/ginger
25
2014 IBM Corporation
Kimchi
Agenda
Kimchi Architecture
Templates and VMs
Storage Back-end Support
Various Virtual Networks Support
Host Management
REST API
Work In Progress
DEMO
Q&A
26
2014 IBM Corporation
Kimchi
Kimchi API
Resource maps to URI
VM List: /vms
Particular VM: /vms/vm_name
NICs of a VM: /vms/vm_name/ifaces
Disks of a VM: /vms/vm_name/storages
Use standard HTTP methods (GET, PUT, POST, DELETE) to list, create, modify and delete
resources
Kimchi front-end communicates with back-end solely using API
Browser
Kimchi
Front-end
GET host/vms
200 OK JSON
CherryPy
Kimchi
Back-end
listAllDomains()
libvirt
[{name:vm1, ...}]
27
2014 IBM Corporation
Kimchi
Kimchi API - Example
curl -k -u root \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
'https://127.0.0.1:8001/networks'
API Documentation
docs/API.md
API Schema
src/kimchi/API.json
Wrapper in the Front-end
ui/js/src/kimchi.api.js
Everyone can use Kimchi API and
develop KVM management solutions
28
2014 IBM Corporation
Kimchi
Agenda
Kimchi Architecture
Templates and VMs
Storage Back-end Support
Various Virtual Networks Support
Host Management
REST API
Work In Progress
DEMO
Q&A
29
2014 IBM Corporation
Kimchi
Work In Progress
Host Device Passthru
Directly assign host devices to VM, improve performance
PCI devices, USB devices, SCSI LUNs
Properly handling IOMMU groups and device tree
Open vSwitch Support
Bootable Image Support
Planned
Discovering Kimchi peers
Guest live migration
Download ISO file
Display detected iSCSI targets
Asynchronous event notification
Network bonding configuration
30
2014 IBM Corporation
Kimchi
Demo
Live Demo
Backup Screenshots
31
2014 IBM Corporation
Kimchi
Q&A
Github: https://github.com/kimchi-project/kimchi
IRC: irc.oftc.net, Channel #kimchi
WIKI: https://github.com/kimchi-project/kimchi/wiki
Mail List
Development kimchi-devel@ovirt.org
http://lists.ovirt.org/mailman/listinfo/kimchi-devel
User Feedback kimchi-users@ovirt.org
http://lists.ovirt.org/mailman/listinfo/kimchi-users
Thanks for attending! Obrigado!
32
2014 IBM Corporation
Kimchi
Create a VM Step[0] Select an ISO to Create a Template
33
2014 IBM Corporation
Kimchi
Create a VM Step[1] (optional) Customize the Template
34
2014 IBM Corporation
Kimchi
Create a VM Step[2] Create a VM from the Template
35
2014 IBM Corporation
Kimchi
VM Display Inside Browser
36
2014 IBM Corporation
Kimchi
Host Management Basic Information
37
2014 IBM Corporation
Kimchi
Host Management Software Updates & Repositories
38
2014 IBM Corporation
Kimchi
Host Management - Ginger
39
2014 IBM Corporation
