# vCenter Single Sign On SDK: JAX-WS Samples Readme |
This document describes how to run the VMware sample code that uses the JAX-WS bindings for the vCenter Single Sign On API. The samples have been developed to work with the JAXWS bundled in libs/JAXWS-RI 3.0.2. They are located in sub-directories contained in the following vSphere Management SDK directory: `SDK/sso/java/JAXWS/samples/com/vmware/sso/client/` The following sections contain information about building and running the JAX-WS vSphere API samples. JAVAHOME Environment Variable Converting Shell Scripts for Linux Samples usage Generating Stubs from WSDL ## JAVAHOME Environment Variable You must set the JAVAHOME environment variable to the base directory of a JDK 8 and above ## Converting Shell Scripts for Linux The vCenter Single Sign On SDK includes the following shell scripts in the `SDK/sso/java/JAXWS/` directory. run.sh - Runs a sample in linux. run.bat - Runs a sample in windows. The shell files in the distribution kit have DOS-style line endings. These do not work when running these scripts on Linux. Use the Linux command `dos2unix` to convert these files before you use them. To run these scripts, set the Execute permission on the files: `chmod u+awx *.sh` ## Samples usage All samples print a usage summary if you do not specify any options or if you specify --help on the command line. You can also find usage information for all samples in the JAX-WS Samples Reference Documentation. Each package has a class summary that describes one or more samples. ## Generating Stubs from WSDL and Compiling Samples The JAXWS-RI 3.0.2 is required to generate the stubs from the provided WSDL. You can generate the JAXWS stubs from the shipped WSDL by using the `wsimport` tool in JAXWS-RI. After the stubs have been generated, you can compile the shipped samples by adding these stubs to the classpath. The SDK stubs and samples are compiled using JDK 11 with target and source set to 1.8, therefore, making the SDK compatible with JDK 8.
Copyright © 2011-2014,2018, 2021, 2023 VMware, Inc. All rights not expressly granted herein are reserved. | Last updated: 27 June 2023 | VMware Single Sign On SDK