Table of Contents
Advertisement
Site Recovery Manager API Developer's Guide
Table 2-1. SDK directory structure
Directory or File
\samples
\samples\Axis\
\samples\DotNet\cs
\samples\DotNet\cs
\samples\JAXWS\
\wsdl\srm\srm.wsdl
\wsdl\srm\srm‐Service.wsdl
\wsdl\srm\*.xsd
Download and Setup Procedure
Setting up your environment to develop client applications with the SDK involves the following steps. If you
are already developing vSphere applications, some of the steps are unnecessary.
1
Choose a development language (C# or Java) for Web services client application development.
2
Identify the target vCenter Site Recovery Manager server (or servers) to use for development.
A "target server" is a vCenter Site Recovery Manager server that your client application will manage.
3
Install, or verify presence of, the development environment appropriate for your programming language.
For C#, you need one of the Microsoft development environments, such as Visual Studio 2008 or
Microsoft Visual C#. VMware recommends using Microsoft Visual Studio 2008, which includes the
required .NET Framework. For more information, visit the MSDN Web site.
For Java, you need the Java 2 Platform Standard Edition (J2SE) 5.0 or 6.0. VMware recommends the
Java Development Kit (JDK) 1.6.0_22 or later. For more information, visit the Oracle Java Web site.
4
Obtain the appropriate Web services client tools (XML parser, WSDL‐to‐proxy‐code generation tools, and
runtime) for your programming language.
For C#, you need Microsoft .NET Framework 2.0 or 1.1. If you already use Microsoft development
tools, it is likely you already have this. You can obtain the .NET Framework 2.0 from MSDN.
You also need the .NET 2.0 Software Development Kit, which includes the WSDL‐to‐stub generation
tool (wsdl.exe) and the command‐line C# compiler (csc.exe), both of which get called from the
gensrmstubs.cmd script. You can get the .NET 2.0 Software Development Kit from Microsoft:
http://www.microsoft.com/download/en/details.aspx?displaylang=en&id=19988
For Java with JAX‐WS, you can use the JAX‐WS framework that comes with the JDK.
For Java Axis, you need the Apache Axis 1.4 client‐side Web service libraries. For documentation and
downloads, visit the Axis Apache Web site.
5
The SDK includes sample code to list and prepare to test a recovery plan. To build and run the samples:
For C#
.NET, see "About the C#
For JAX‐WS, see "About the Java JAX‐WS Samples" on page 16.
For Java Axis, see "About the Java Axis Samples" on page 17.
14
Description
Top‐level directory for language‐specific versions of sample client applications.
Directory containing batch files and Java source code for the Axis framework.
Directory containing command scripts to generate the .NET proxy classes and
Web service stubs. The GeneratingStubs.txt file gives helpful notes about
how to generate stubs with your own namespace for Visual Studio 2008.
Directory containing Visual Studio 2008 solution (.sln) file and sub‐directories
with C# AppUtil support code and RecoveryPlan.cs sample application with
project (.csproj) file.
Directory containing Java source code for the JAX‐WS framework. Sample code
RecoveryPlan.java is in the com\vmware\recovery sub‐directory. Batch files
are provided to build and run the sample program.
The Web services description language (WSDL) file containing definitions for
the VMware vCenter Site Recovery Manager API.
The WSDL file defining the Web services endpoint at which the API is available.
This file references srm.wsdl with an import statement, so you should use the
appropriate generation tool with srm-Service.wsdl (not srm.wsdl directly).
XML schema definition files (six).
.NET Samples" on page 15.
VMware, Inc.
Advertisement
Table of Contents
