Preparation Development VMInfoFace Programming

• Install SOWI Framework library (folder lib) and tools (folder tools) in folder

  ..\VMInfoFace\Source\packages\SOWI.Components.17.0.0

Example for batch file (_SOWIComponentsCopyToPackage.bat)

@Echo off 
cls

echo ----------------------------------------------------------------------
echo SOWI Framework DLLs copy to SOWI Components Package directory
echo ----------------------------------------------------------------------
:start
choice /c jn /m "to run press j"
if "%errorlevel%"=="1" goto runto
if "%errorlevel%"=="2" goto end

:runto
echo declaration paths...
set packagesourcepath=C:\Daten\Projekte\SOWIApp\Source\packages\SOWI.Components.17.0.0\
set packagetargetpath=C:\Daten\Projekte\SOWIApp\Project\VMInfoFace\Source\packages\SOWI.Components.17.0.0\

echo clear package directory...
del %packagetargetpath%*.* /s /q

echo copy SOWI components ...
xcopy %packagesourcepath%*.* %packagetargetpath% /s

pause

:end

1. Go to Solution Explorer and select project to usage SOWI Framework components

2. Select item References in project

3. Open context menu over References item and click Add Reference...

4. Dialog Reference Manager ..

   Push button Browse...

5. Dialog Select the files to reference...

   Navigation folder to SOWI Framework DLL files

6. Select to uses DLL files

7. Push button Add

8. Close dialogue Reference Manager .. by button OK

1. Install the Microsoft Visual Studio programming environment with Microsoft Visual C#.

   Choose include the option Microsoft Foundation Classes for C++.

   Link to Microsoft Visual Studio web site

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

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

   Download .NET Framework

3. Install Microsoft Windows Driver Kit (WDK).

   Download the Windows Driver Kit (WDK)

4. Download and unzip the VMware vSphere Web Services SDK package from the VMware Web site at

   https://developercenter.vmware.com

1. Open a Visual Studio Native Tools command prompt.

2. Navigate to the .NET subdirectory for SSO client samples.

   cd path_to_sdk\ssoclient\dotnet\cs\samples

3. Generate a test certificate and STSService stubs using the build.bat script.

   build.bat

File STSService.dll copy to folder path_to_sdk\vsphere-ws\dotnet\cs\samples\lib\

1. Open a Visual Studio Native Tools command prompt.

2. Navigate to the .NET subdirectory for SSO client samples.

   path_to_sdk\vsphere-ws\dotnet\cs\samples\lib\

3. Create a key pair using the Strong Name tool (sn.exe). Key pair files have an .snk extension.
   sn -k VMwareSDK.snk

   Note: Strong Name tool (sn.exe) store in folder
   C:\Program Files\Microsoft SDKs\Windows\v10.0A\bin\NETFX 4.6.1 Tools\

4. Create a IL file from DLL ildasm /all STSService.dll /out:STSService.il

   Note: IL Disassembler tool (ildasm.exe) store in folder
   C:\Program Files\Microsoft SDKs\Windows\v10.0A\bin\NETFX 4.6.1 Tools\

5. Sign DLL assembly from IL file and key file ilasm STSService.il /dll /key=VMwareSDK.snk

   Note: IL Assembler tool (ilasm.exe) store in folder
   C:\Windows\Microsoft.NET\Framework\v4.0.30319\

Batch example to singed STSService.dll

@Echo off 
cls

echo ---------------------------------
echo Certification STSService.dll file
echo ---------------------------------

:start
choice /c jn /m "to run press j"
if "%errorlevel%"=="1" goto runto
if "%errorlevel%"=="2" goto end

:runto

echo set path.....
rem if command prompt run from "Administrator: Developer Command Prompt for VS2015" then not using next command Path
rem Path=C:\Program Files\Microsoft SDKs\Windows\v10.0A\bin\NETFX 4.6.1 Tools\;C:\Windows\Microsoft.NET\Framework\v4.0.30319;

echo set variable.....
set KeyFile=VMwareSDK.snk

echo generate certification key file for sign.....
sn -k %KeyFile%

echo create IL file from DLL.....
ildasm /all STSService.dll /out:STSService.il

echo sign DLL assembly from IL file and key file.....
ilasm STSService.il /dll /key=%KeyFile%

Pause

:end

1. Open a Visual Studio Native Tools command shell as Administrator.

   Note: Use Visual Studio 2012 or 2013. Visual Studio 2015 is not supported for this step.

   Solution for Visual Studio 2015

   1. copy %programfiles%\Microsoft Visual Studio 14.0\Common7\Tools\VsDevCmd.bat path_to_sdk\vsphere-ws\dotnet\bin

   2. Run command shell as administrator

   3. cd path_to_sdk\vsphere-ws\dotnet\bin

   4. Run the batch for command settings

      VsDevCmd.bat

2. Navigate to the .NET subdirectory for vSphere client samples.

   cd path_to_sdk\vsphere-ws\dotnet\bin

3. Run the build script to generate the VimService*.dll files from the WSDL.

   Note: command shell to call batch file must as an administrator and path access to windows system files

   build.bat

   The script builds the client-side API bindings and compiles them into the Vim25Service DLL.

File Vim25Service.dll copy to folders
path_to_sdk\vsphere-ws\dotnet\cs\samples\lib\
path_to_sdk\ssoclient\dotnet\cs\samples\lib\

1. Open a Visual Studio Native Tools command prompt.

2. Navigate to folder
   cd path_to_sdk\vsphere-ws\dotnet\bin

3. Create a key pair using the Strong Name tool (sn.exe). Key pair files have an .snk extension.
   sn -k VMwareSDK.snk

   Note: Strong Name tool (sn.exe) store in folder
   C:\Program Files\Microsoft SDKs\Windows\v10.0A\bin\NETFX 4.6.1 Tools\

4. Create a IL file from DLL
   ildasm /all Vim25Service.dll /out:Vim25Service.il

   Note: IL Disassembler tool (ildasm.exe) store in folder
   C:\Program Files\Microsoft SDKs\Windows\v10.0A\bin\NETFX 4.6.1 Tools\

5. Sign DLL assembly from IL file and key file
   ilasm Vim25Service.il /dll /key=VMwareSDK.snk

   Note: IL Assembler tool (ilasm.exe) store in folder
   C:\Windows\Microsoft.NET\Framework\v4.0.30319\

6. Copying DLL to lib folders
   copy Vim25Service.dll ..\cs\samples\lib\
   copy Vim25Service.dll ..\..\..\ssoclient\dotnet\cs\samples\lib\

Batch example to singed Vim25Service.dll and coping to lib folders

@Echo off 
cls

echo -----------------------------------
echo Certification Vim25Service.dll file
echo -----------------------------------

:start
choice /c jn /m "to run press j"
if "%errorlevel%"=="1" goto runto
if "%errorlevel%"=="2" goto end

:runto

echo set path.....
rem if command prompt run from "Administrator: Developer Command Prompt for VS2015" then not using next command Path
rem Path=C:\Program Files\Microsoft SDKs\Windows\v10.0A\bin\NETFX 4.6.1 Tools\;C:\Windows\Microsoft.NET\Framework\v4.0.30319;

rem folders to store Vim25Service.dll
set SDK_LIB="%~dp0..\cs\samples\lib\" 
set STS_SDK_LIB="%~dp0..\..\..\ssoclient\dotnet\cs\samples\lib\" 

echo set variable.....
set KeyFile=VMwareSDK.snk

echo generate certification key file for sign.....
sn -k %KeyFile%

echo create IL file from DLL.....
ildasm /all Vim25Service.dll /out:Vim25Service.il

echo sign DLL assembly from IL file and key file.....
ilasm Vim25Service.il /dll /key=%KeyFile%

echo copying DLL to lib folders.....
copy Vim25Service.dll %SDK_LIB%
copy Vim25Service.dll %STS_SDK_LIB%

Pause

:end

1. In Solution Explorer, open the shortcut menu for the project, and then choose Properties.

2. Choose the Signing tab.

3. Select the Sign the assembly box.

4. In the Choose a strong name key file box, choose "Browse…", and then navigate to the key file. To create a new key file, choose "New…" and enter its name in the Create Strong Name Key dialog box.

1. Launch Visual Studio and load the solution file, Samples2012.sln.

   The solution file is found in the path_to_sdk\vsphere-ws\dotnet\cs\samples directory.

2. From the Visual Studio menu, select Build > Build Solution. All the sample programs build. The Output pane at the bottom of the Visual Studio window shows build errors, if any.

3. Correct any errors in the build, and repeat the build.

1. Open a Visual Studio Tools command shell.

2. Navigate to the subdirectory where the compiled object code is located. From the top-level directory of the SDK download, the directory is as follows:

   path_to_sdk\dotnet\cs\samples\SimpleClient\bin\Debug

3. Run the application, passing at least the service URL, an authenticating user name, and a password on the command line. For a development environment, you do not need to use SSO or certificate authentication. You can authenticate directly with the server by specifying --disablesso and --ignorecert on the command line. For example:

   simpleclient --url https://esx.exampledomain.com/sdk --username root --password secret --disablesso --ignorecert

   The application connects to the server and displays a list of inventory objects managed by the server.

   Sample Output of a Successful Run of SimpleClient

   Object Type : Datacenter

   Reference Value : ha-datacenter

   Property Name : name

   Property Value : ha-datacenter

   Reference Value : ha-folder-root

   Object Type : Folder

   Reference Value : ha-folder-root

   Property Name : name

   Property Value : ha-folder-root

1. Go to Solution Explorer and select project to VMInfoFace.Interface

2. Select item References in project

3. Open context menu over References item and click Add Reference...

4. Dialog Reference Manager ..

   Push button Browse...

5. Dialog Select the files to reference...

   Navigation folder to VMware vSphere API files

   

6. Select to DLL files

7. Push button Add

8. Close dialogue Reference Manager .. by button OK

The DLLs AcquireBearerTokenByUserCredentialSample.dll and AppUtil.dll doesn't works as a GAC install because this DLLs has link to Vim25Service.dll and STService.dll (hasn't strong name).