Skip to main content
Kinetic Community

Rackspace Adapter

Overview

The Rackspace Adapter is an adapter that is installed into Kinetic Bridgehub that allows access to data about Virtual Machines from your Rackspace Server to be pulled back using bridging.

Installation

Note: Check to ensure that this adapter isn't already installed into your bridgehub as part of the base installation before undertaking the installation tasks.

  • Download the kinetic-bridges-adapter-rackspace.jar file and it's dependencies here
  • Put all of the downloaded files into the WEB-INF/lib folder for you kinetic-bridgehub installation
  • Restart the tomcat that your kinetic-bridgehub installation is located in

Setup

Configuration Values

Name Description
Username Rackspace username
Password Rackspace password
Regions Comma separated list of regions to pull data from

Example Configuration

Name Value
Username joe.user
Password secret-password
Regions ord,dfw,iad

Configuration Details

The comma separated list of regions is used to determine which servers the adapter will retrieve data from. For example, if you want to pull back server information from the Chicago and Northern Virginia regions, the Regions configuration value would be ord,iad. A full list of regions and their abbreviations is below.

Region Name Abbr.
Chicago ord
Northern Virginia iad
Dallas dfw
London lon
Hong Kong hkg
Sydney syd

Structures, Fields, and Queries

Structures

  • servers
  • images
  • flavors

Fields

  • servers
    • OS-DCF:diskConfig
    • OS-EXT-STS:power_state
    • OS-EXT-STS:task_state
    • OS-EXT-STS:vm_state
    • accessIPv4
    • accessIPv6
    • addresses
    • created
    • flavor
    • hostId
    • id
    • image
    • links
    • metadata
    • name
    • progress
    • status
    • tenant_id
    • updated
    • user_id
  • images
    • OS-DCF:diskConfig
    • created
    • id
    • links
    • metadata
    • minDisk
    • minRam
    • name
    • progress
    • status
    • updated
  • flavors
    • OS-FLV-WITH-EXT-SPECS:extra_specs
    • name
    • links
    • ram
    • vcpus
    • swap
    • rxtx_factor
    • OS-FLV-EXT-DATA:ephemeral
    • disk
    • id

Queries

  • The qualifications for the Rackspace Bridge mirror the qualifications that are used in the Rackspace API. Qualifications are generally made in the form of Name=Value
  • The following are the searchable fields and the expected value for each structure

servers

Field Name Value Type
image imageId
flavor flavorId
name serverName
status serverStatus
marker markerId
limit integer
changes-since dateTime

images

Field Name Value Type
server serverRef
name imageName
status imageStatus
changes-since dateTime
marker markerId
limit integer
type {BASE|SNAPS HOT}

flavors

Field Name Value Type
minDisk minDiskInGB
minRam minRamInMB
marker markerId
limit integer

Changelog

v1.0.0 (2016-04-06)

  • Initial Version