+ Developer Guide Overview

From OSNEXUS Online Documentation Site
Revision as of 12:59, 15 July 2010 by Qadmin (Talk | contribs)

Jump to: navigation, search

The QuantaStor Manager web interface and QuantaStor Remote Management CLI both manage the QuantaStor storage system via the QuantaStor WebServices / SOAP interface. The WebServices interface for QuantaStor is included with every QuantaStor system and can be accessed via your web browser by simply entering this URL:

https://<QuantaStor-system-IP-address>:5151/osn.wsdl

For example, if your QuantaStor storage system has an IP address of 192.168.0.88, then you can access the WSDL [Services Definition Language)] file using this URL: https://192.168.0.88:5151/osn.wsdl

In case you don't have a system handy, you can browse this copy but note you'll want to use the most recent version included with the [[1]] which is available from the downloads page.

What's in the SDK

The SDK includes a sample C# application that allows you to list and provision volumes in a storage system, some getting started documentation, the QuantaStor API/WSDL file, and a storage system simulator.

The QuantaStor Storage System Simulator runs on any Windows box and is installed automatically when you install the SDK package. You can run it from the Start menu in windows or you can run it on the command line with these arguments qs_service.exe --debug and it's up and running. From there you can manage the simulated storage system using the qs CLI or via your custom WebServices client application.

Supported Language / WebServices Compiler

  • C++ (all platforms) / gSOAP 2.7.x
  • Java (all platforms) / Apache Axis 1.4
  • Microsoft C# (Windows) / Microsoft VS WSDL Compiler
  • Microsoft VB (Windows) / Microsoft VS WSDL Compiler

There are other languages such as Python, Perl, PHP, and others that all have WebServices/SOAP implementations and should work fine with QuantaStor but we have as of yet not tested these out. (Note: QuantaStor storage systems utilize gSOAP and Axis internally)

SDK System Requirements

You need a Windows system to install the SDK but once you have the included WSDL file you can copy that to any system to do your development from. The simulator only uses about 20M of RAM so you can run it on pretty much anything so the SDK system requirements are very minimal.

Compiling the sample .NET application

Async vs. Sync API calls

Task Monitoring

Event Polling & Registration

Custom Roles

Supported SOAP / WebServices Implementations

  • gSOAP (C++, all platforms)
  • Apache Axis (Java, all platforms)
  • .NET (C# & Visual Basic, Windows)