nowherecloud/xen-api repository overview

⁠XenServer API Adapter

This repository contains the source code of interacting a XenServer Hypervisor over its XML-RPC API.

Example: Communicate over RabbitMQ⁠

⁠Requirements // システム必要条件 // 系統要求

• Ruby >= 2.3.0 w/ Bundler
• Linux (M$ Windows から残念です、申し訳ございません) (不支援 M$ Windows)

⁠How To use/Test? // 使い方 (英語のみ) // 食用方法 (English Only)

# Set Environment Variables
cd .../xen-api
export XEN_SERVER_ADDR='192.168.0.123'
export XEN_SERVER_PORT=443
export XEN_SERVER_USER='root'
export XEN_SERVER_PASS='foo-change-me'

# Play the API on Interactive Ruby Script Environment
irb --noprompt

require './xenapi.rb'

# Login
xenapi = XenApi.new(ENV['XEN_SERVER_ADDR'], ENV['XEN_SERVER_PORT'], ENV['XEN_SERVER_USER'], ENV['XEN_SERVER_PASS'])

# logout
xenapi.logout

⁠Acknowledgements

• Nori XML Parser⁠
• XAPI Project⁠
  • Navigating in website farrrrrr better than 600 Pages PDF
  • The VM Provisioning Script is adapted from https://github.com/xapi-project/xen-api⁠
• JSON Test Code Snippet from ascendbruce⁠
• A Guide on using Ruby XMLRPC Client over HTTPS⁠
• An Answer on raising exception while some ENV is not set⁠
• Get IP Address of VIF⁠

⁠Documentations

• TODO

⁠Todo

• Deal with the 'struct' on 'last_booted_record'

⁠Footnote

• All Chinese (Traditional Script) and Japanese descriptions in this document are Machine-Translated Results. While Japanese results are interpreted afterwards, quality of Chinese descriptions are not assured.