Setting Up for C# Development

These instructions show how to install all the required software. If your development workstation already meets some or all of the requirements, you generally do not need to re-install the software you already have.

Set Up a Development Workstation To Use C#

For general Web development work, you need a C# development environment and the .NET Framework. To work with the VMware vSphere Web Services API, you need the vSphere Web Services SDK and additional tools available from Microsoft.

To set up a development workstation to use C#

1	Install the Microsoft Visual programming environment, such as Microsoft Visual C# or Microsoft Visual Studio.

Use Microsoft Visual Studio 2008 or later, which includes the required .NET Framework.

2	Obtain the Microsoft .NET Framework, if it is not included in the Microsoft Visual programming environment.

Use .NET version 3.5 or later, depending on your Visual Studio version.

3	Download and install the Microsoft .NET Framework 2.0 SDK (x64) from http://www.microsoft.com/en-us/download/details.aspx?id=15354

Note Virtual Studio includes a version of .NET version 2.0, but that version does not contain the tools needed to build the DLLs.

4	Find the location where the Microsoft .NET Framework 2.0 SDK (x64) files were installed. Verify that the installation directory contains a subdirectory named Bin, which contains a file named wsdl.exe. Typically, the Framework SDK is installed at C:\Program Files\Microsoft.NET\SDK\v2.0 64bit.

5	Edit your Windows registry to identify the location where the Microsoft .NET Framework 2.0 SDK (x64) was installed.

a	Under the key HKLM\SOFTWARE\Microsoft\.NETFramework, verify the existence of a string value named sdkinstallRootv2.0 with a string value of the full path name to the installation directory.

b	If sdkinstallRootv2.0 is not present, add it.

6	Download and install Microsoft Web Services Enhancements (WSE) 3.0 from http://www.microsoft.com/en-us/download/details.aspx?id=14089.

Note The default option for the WSE installer includes only the runtime, not the WSDL tool. Select another option to include the Tools directory.

7	Download and unzip the VMware vSphere Web Services SDK package from the VMware Web site at http://www.vmware.com/download/sdk/.

Set Environment Variables To Build C# DLLs and Samples

Before you build the SDK sample programs, you must set your environment variables.

If your Microsoft software setup varies from the default paths, create a VSINSTALLDIR environment variable.

Environment Variable Names Used To Build Samples

Variable Name	Description	Usage Note
VSINSTALLDIR	Location of Microsoft ...\Common7 and ...\SDK subdirectories.	Required only if your development setup varies from Microsoft default installation paths. Use double quotation marks around directory path names that include spaces. For example: ''C:\devstuff\Microsoft Visual Studio 8\Common7'' ''C:\devstuff\Microsoft Visual Studio 8\SDK''
WSE_HOME	Location of WSE.	Directory where you installed WSE.
WS_SDK_HOME	Location of the WS SDK files.	Directory containing unzipped WS SDK files (usually Location of zip file\SDK\vsphere-ws).
WSDLHOME	Location of the WSDL files.	Directory containing unzipped WSDL files (usually Location of zip file\SDK\vsphere-ws\wsdl).

To set environment variables

1	Open a Visual Studio command shell window.

2	Create the WSE_HOME environment variable, setting its value to the absolute path to the directory where WSE was installed. For example:

set WSE_HOME="C:\Program Files (x86)\Microsoft WSE\v3.0"

3	Add the WSE tools directory to the PATH environment variable:

set PATH=%PATH%;%WSE_HOME%\Tools

4	Create the SDK_HOME environment variable, setting its value to the absolute path to the directory containing all the SDK files extracted from the zip file you downloaded. For example:

set WS_SDK_HOME="C:\Documents and Settings\yourusername\My Documents\Downloads\SDK"

5	Create the WSDLHOME environment variable, setting its value to the absolute path to the directory where the WSDL files were stored when you uncompressed the SDK download file. For example:

set WSDLHOME=%WS_SDK_HOME%\vsphere-ws\wsdl\vim25

6	If your Microsoft development and .NET software was not installed using default paths, create and set the VSINSTALLDIR environment variable to contain the location where the software was installed. For example:

set VSINSTALLDIR="C:\devstuff\Microsoft Visual Studio 8\SDK"