6.0

vSphere Web Services SDK Developer’s Setup Guide
12 VMware, Inc.
 Obtain the VMware vSphere Web Services SDK from https://developercenter.vmware.com. It is included
in the vSphere Management SDK package.
Set Up for Development Using JAX-WS
The samples generated using JAX-WS libraries and compiled using Java JDK 1.7 include vim25.jar and
samples.jar. You can use these libraries without generating new stubs and recompiling if you are using the
same version of the JDK.
The following instructions assume that the target server uses HTTPS, which is the default server configuration.
To set up a development workstation to use Java and JAX-WS
1 If the JDK is not installed, create directories for the JDK and for the vSphere Web Services SDK package.
Do not use spaces in the directory names, to avoid issues with some of the included SDK batch and script
files.
2 Install the Java 2 Platform, Standard Edition (J2SE) 6.0.
3 Unpack the components into subdirectories created in Step 1, using the provided installer if appropriate.
The J2SE uses an installation wizard. The SDK ZIP file unpacks into the directory you specify.
 Unpack with Use folder names selected, to maintain the organizational structure.
 On UNIX development systems, use the unzip command with the -a modifier, to ensure proper
line-endings in the shell scripts. For example:
unzip -a VMware-vSphere-SDK-4.1.0-251329.zip
4 (optional) Import server-certificates and use the Java keytool utility to create a vmware.keystore. See
“Import Server Certificates into the Java Keystore” on page 13 for details.
As an alternative, pass the --ignorecert argument at runtime to ignore server-certificate verification for
any of the sample Java applications.
5 Create the JAVAHOME environment variable.
The JAVAHOME environment variable must be set to the root path of the Java Runtime Environment
(JRE), such as
C:\Program Files\Java\jdk1.7.0_21. The root directory of your Java installation contains
bin\javac and other binary files needed to build the stubs and the samples.
6 If you are unable to use the run.bat script to run Java samples, add the precompiled sample files,
vim25.jar and samples.jar, to your system CLASSPATH environment variable.
To test your setup, run the Java version of SimpleClient, as described in “Running the SimpleClient Sample
Application to Validate Setup” on page 15.
Batch Files and Shell Scripts for Building and Running Samples
The vSphere Web Services SDK includes several batch files for Windows and shell scripts for Linux that
facilitate building and running the sample applications.
Some of the batch files are used by other batch files. For example, build.bat calls the lcp.bat and
clean.bat scripts. If you modify the batch files for any reason, be aware of the dependencies among them.
N
OTE If you are using the JAX-WS 2.1 libraries with JDK 1.7, you do not need to rebuild the samples.