Table of Contents HOL-SDC-1422

Size: px

Start display at page:

Download "Table of Contents HOL-SDC-1422"

Damon Owen
5 years ago
Views:

1 Table of Contents - VMware Development Tools and SDKs... 2 Lab Overview... 3 Module 1 - Developer Center, Workbench IS, and the vsphere Management SDK (30 min)... 4 Introduction... 5 Using Workbench IS and the vsphere Management SDK... 6 Creating a new vsphere management sample application Next steps Make it yours (optional) Module 2 - pyvmomi - The Python SDK for VMware vsphere API (30 min)...23 Introduction Using PyDev and the pyvmomi SDK Inspecting the vcenter inventory from the Python interpreter Putting it all together Next Steps Module 3 - Workbench IS Tools (15 min) Introduction Using the Remote System Explorer (RSE) Using the Log Browser Page 1

2 - VMware Development Tools and SDKs Page 2

3 Lab Overview This introductory lab will get you up and running building cloud infrastructure solutions with VMware development tools and SDKs. These are developer focused modules and some familiarity with programming in Java or Python is expected. But don't worry, no coding is required. Complete sample code has been provided. The lab is broken into Modules and the Modules can be taken in any order. Use the "Table of Contents" button in the menu bar for quick access to the module content. You have 90 minutes per seating to work in the lab. This will be enough time to complete one or more modules. Each module may be completed individually. In some Modules, the Lessons build off of each other, so once you pick a module, you will need to follow each Lesson in order: Module 1 - Developer Center, Workbench IS and the vsphere Management SDK (30 Minutes) - You will build a Java application to manage resources on vcenter server and ESXi server. There is a Java sample already included that manages VMs in a vcenter cluster. Module 2 - pyvmomi - The Python SDK for VMware vsphere API (30 Minutes) - You will build a Python application to manage resources on vcenter server and ESXi server. There is a Python sample already included that lists the VMs in a vcenter cluster. Module 3 - Workbench IS Tools (15 Minutes) - This module is an introduction to tools included in Workbench IS including: RSE (Remote System Explorer) - A tool to inspect and manage resources on a remote ESXi or vcenter system and Log Browser - A tool to collect, analyze, and correlate log files from a remote system. NOTE: If you are using a device with non-us keyboard layout, you might find it difficult to enter CLI commands, user names and passwords throughout the modules in this lab. Refer to the file README.txt on the desktop for additional information on resolving any keyboard input issues. Lab Captain: Bob Fraser Page 3

4 Module 1 - Developer Center, Workbench IS, and the vsphere Management SDK (30 min) Page 4

5 Introduction This module will show you how to build a Java application to manage resources on vcenter server and ESXi server. There is a Java sample already included that manages VMs in a vcenter cluster. This module is expected to take approximately 30 minutes. At the end there is an optional section that will cover installation of the Eclipse-based Workbench IS tooling and the SDK on your own system. Page 5

6 Using Workbench IS and the vsphere Management SDK This lesson shows you how to use Workbench IS to run the sample and view the results. This also takes you through the code to understand how the SDK may be used to perform operations on the virtual infrastructure. For more detailed explanation refer to the SDK documentation at SDKs >> vsphere Management SDK. First you will run the sample application from the command line via a batch script. Then you will debug the sample application using Workbench IS and the Eclipse debugger. Page 6

7 Run sample application The sample can be run by double clicking PowerOnVM.bat on the desktop. Just hit "enter" four times to accept the defaults and connect to the vcenter instance in the lab, then follow the menu prompts to navigate the vcenter hierarchy. The image above shows an example run of the sample application. Press "0" to return to previous menu or press a number to select an item from the menu. Page 7

8 Debug sample application To debug the sample application, first launch Eclipse by double clicking the icon on the desktop. Press the triangle next to the debug icon and select Debug Configurations... Page 8

9 Debug Select Java Application >> PowerOnVM. The image above shows how the debug configuration is set up. The Main class is com.vmware.samples.poweronvm.main Click on the Arguments tab and see the three program arguments: vcsa-01a.corp.local root VMware1! These arguments correspond to <vcenter IP> <vcenter User> <vcenter Password> respectively. Click Debug to run the sample application in the Workbench IS debugger. You can use the Eclipse debugger features to set breakpoints in the code, step through code, inspect variables, etc. Page 9

Sample application outline Navigate back to the Java perspective and open the PowerOnVM project in the package explorer. The image above shows the outline of the sample application.

10 Sample application outline Navigate back to the Java perspective and open the PowerOnVM project in the package explorer. The image above shows the outline of the sample application. A more detailed explanation can be found in the code comments. Connection.java: This class has methods for connecting and disconnecting from the vcenter Server. HelloSDK.java: This is the main program entry point and it drives the console based UI for the sample. Hosts.java: This class has methods for getting the ESXi host properties and Managed Object References (Morefs). Morefs are "handles" to remote objects in ESX or vcenter. When you manipulate the Moref, corresponding actions occur on the remote system. Page 10

11 SimpleUI.java: This class has helper methods used for rendering the menu based UI and capturing the users input. The user interface has intentionally been made simple and loosely coupled to allow easy reuse of this sample in a Web application or standalone Java application. SSLCert.java: This class is used by the Connection class to handle the SSL Certificates for the vcenter connection. VirtualMachine.java: This class has all the methods that interact with virtual machines such as getting VM properties, VM Power operations, getting VM name, getting VM Morefs etc VMTask.java: This class has some helper methods used by the VirtualMachine class. Page 11

Creating a new vsphere management sample application This lesson shows how to setup a vsphere Web Services Sample Application and configure it to run a sample.

12 Creating a new vsphere management sample application This lesson shows how to setup a vsphere Web Services Sample Application and configure it to run a sample. Create new Eclipse project Start the Eclipse IDE by double clicking on the desktop icon. From the "File" Menu select "New" then "Other" as shown in the image above. Page 12

13 Select a wizard Scroll down to the "VMware" folder and select the "Development Kit Projects" wizard and click Next. Page 13

14 VMware Development Kit Project Select the "vsphere Web Services Sample Application" and click Next. Page 14

15 vsphere Management SDK Sample Enter a project name. Leave Project location at default and click Finish. Run a sample SDK application Before we run any sample SDK application we need to configure the connection details used by the samples. You may cut and paste helpful text from the README.txt file on the desktop. Return to the Java perspective and in the newly created project, open the connection.properties file for editing. Since we are in a development environment we will use basic authentication. Comment out the line com.vmware.connection.connection = com.vmware.connection.ssoconnection Uncomment the line com.vmware.connection.connection = com.vmware.connection.basicconnection Page 15

Uncomment the line and set the vimservice.url property to https://vcsa-01a.corp.

16 Uncomment the line and set the vimservice.url property to Uncomment the line and set the vcenter Server Username to root Uncomment the line and set the vcenter Server Password to VMware1! Save the connection.properties file after finishing the edits. Please refer to the highlighted code lines in the image above. Page 16

17 Create a new Debug (or Run) configuration 1. In the Package Explorer select the newly created samples project (e.g. vspheresamples). 2. Press the triangle next to the debug icon. 3. Select Debug Configurations... Page 17

Create a Java launch configuration 1. Select Java Application 2. Press the New button to create a new launch configuration 3. Set the Name (e.g. vspheresamples) 4. Set the Main class to com.vmware.

18 Create a Java launch configuration 1. Select Java Application 2. Press the New button to create a new launch configuration 3. Set the Name (e.g. vspheresamples) 4. Set the Main class to com.vmware.common.main Set the Program arguments and debug To run a sample specify the sample class name in the arguments section of the launch configuration. You will run the SimpleClient sample. This sample will connect to a vcenter server and print out an inventory of datacenters, hosts, and virtual machines. 1. Select the Arguments tab 2. Set the Program arguments to com.vmware.general.simpleclient 3. Press Apply to save the configuration Page 18

19 4. Press Debug to run the sample Page 19

20 Sample output The image above shows an example run of the SimpleClient code sample Page 20

21 Next steps You now know how to build a Java application to manage resources on vcenter server or ESXi server. For further study, try some of the following: Set a breakpoint in the PowerOnVM application and debug. Step through the code and inspect the returned data structures. Extend the PowerOnVM sample. Inspect and copy code fragments from the sample created in "Creating a new vsphere management sample application" and add them to PowerOnVM. For example "clone" the VM (see class VMclone.java). Page 21

22 Make it yours (optional) Go to to find out more about Workbench IS, additional SDKs, and to download the sample code used in this hands-on lab. Page 22

23 Module 2 - pyvmomi - The Python SDK for VMware vsphere API (30 min) Page 23

24 Introduction This module will show you how to build a Python script or application to manage resources on vcenter server and ESXi server. There is a Python sample already included that lists the VMs in a vcenter cluster. This module is expected to take approximately 30 minutes. At the end there is an optional section that will cover installation of the pyvmomi SDK on your own system. Page 24

25 Using PyDev and the pyvmomi SDK This lesson shows you how to use Workbench IS and the PyDev plugin to run the sample and view the results. This also takes you through the code to understand how the SDK may be used to perform operations on the virtual infrastructure in a vsphere or vcenter environment. First you will run the sample application from the command line via a Python script. Then you will debug the sample application using Workbench IS with the PyDev plugin and the Eclipse debugger. Run sample application The sample can be run by double clicking GetAllVMs.bat on the desktop. The image above shows an example run of the sample application. Edit sample application Start Workbench IS by double clicking on the Eclipse icon on the desktop 1. Navigate to the PyDev perspective. Page 25

26 2. Open the GetAllVMs project in the PyDev Package Explorer. 3. Open getallvms.py. The image above shows the sample application. A more detailed explanation can be found in the code comments. Debug sample application In this lesson you will learn how to debug a pyvmomi Python application. Page 26

Select Add Breakpoint Verify breakpoint You will know that the breakpoint is set when you see the green debug icon

27 Set a breakpoint In getallvms.py scroll down into the main function. At the line vm_folder = datacenter.vmfolder right click in the left margin to get the context menu as shown in the image above. Select Add Breakpoint Verify breakpoint You will know that the breakpoint is set when you see the green debug icon to the left of the line of code. Select Debug Configurations Press the triangle next to the debug icon and select Debug Configurations... Page 27

Debug Select Python Run >> GetAllVMs getallvms.py The image above shows how the debug configuration is set up. Click on the Arguments tab and see the three program arguments: -s vcsa-01a.corp.

28 Debug Select Python Run >> GetAllVMs getallvms.py The image above shows how the debug configuration is set up. Click on the Arguments tab and see the three program arguments: -s vcsa-01a.corp.local -u root -p VMware1! These arguments correspond to <vcenter IP> <vcenter User> <vcenter Password> respectively. Click Debug to run the sample application in the Workbench IS debugger. Page 28

29 Inspect the results The image above shows the Eclipse graphical debugger. Try inspecting the datacenter variable or stepping through the code. Page 29

30 Inspecting the vcenter inventory from the Python interpreter. One of the benefits of the Python programming language is its interpretive nature and powerful interactive shell. In this lesson you will learn how to use these tools to inspect the vcenter hierarchy of objects (Datacenter, Host, VM, etc.). While you can always get to the Python interpreter by typing python in a terminal window, using a special purpose Python shell has advantages such as command completion. If you prefer using command line and no IDE, then try IDLE, the shell that comes with your Python installation. You may run it by double clicking the icon on the desktop. The examples below will use the console shell that comes with PyDev. You may cut and paste helpful text from the README.txt file on the desktop. Page 30

31 Understanding the vcenter Inventory Hierarchy VMware vcenter allows you to manage physical and virtual infrastructure in a datacenter. The pyvmomi SDK provides Python bindings that allow you to programmatically manage the inventory of that same infrastructure. The inventory is managed as a collection of virtual datacenters. Each datacenter contains compute, data storage, and networking resources. Virtual machines and virtual applications can be created in these datacenters that consume these resources. Folders can be used to hierarchically group objects of the same type. The nested structure allows you to organize the objects in the datacenter into an easily manageable structure. Possible reasons include aligning with various functions and/or organizational structure. The image above shows the hierarchy of objects in the vcenter inventory. For many pyvmomi applications, the flow of applications is similar. You connect to a vcenter server, get a service instance, and starting with the root folder, navigate the hierarchy. You can then perform various operations on these managed objects. Page 31

32 Launching the PyDev console Navigate to the PyDev perspective and make sure a console is visible. If no console is visible, you can launch one with menu Window >> Show View >> Console. In the console view, press the triangle next to the Open Console icon and select PyDev Console. Page 32

Configure the console Select Python console and press OK. The Python interpreter shell will start. Double click the console tab to expand or restore the console view.

33 Configure the console Select Python console and press OK. The Python interpreter shell will start. Double click the console tab to expand or restore the console view. Press the stop icon to exit the console. Initial setup and useful commands In the console type from pyvim import connect Nothing is returned but this loads parts of the pyvmomi library into the interpreter. Useful commands Use the up and down arrows to navigate the command history. Use <tab> or <control>- <space> for command completion. Try the import again as from pyvi<tab> import con<tab> help(connect) will print out module information. Page 33

34 Connect to vcenter Connect to vcenter and create a service instance: si = connect.smartconnect(host='vcsa-01a.corp.local', user='root', pwd='vmware1 Two useful commands are type and dir. type(si) returns the type of the object. The output is: <class 'pyvmomi.vmomisupport.vim.serviceinstance'> dir(si) will print the directory of the object, showing properties and methods. Navigate to a VM Type the following commands to get to a VM. Remember to use <tab> or <control>- <space> for command completion. Get the inventory: inv = si.retrievecontent() Get the (first) datacenter: dc1 = inv.rootfolder.childentity[0] Make sure we really have a datacenter: type(dc1) returns: <class 'pyvmomi.vmomisupport.vim.datacenter'> The type command is useful in the interpreter, but when writing scripts, there is a another way to check types at runtime. First import the vim module: from pyvmomi import vim This imports the vim and vmodl symbol tables and allows you to use shorter class names. isinstance(dc1, vim.datacenter) == True Page 34

35 can now be used to ensure that we really have a datacenter object. Now get a list of VMs: vmlist = dc1.vmfolder.childentity Get the first VM vm = vmlist[0] Verify the type. type(vm) But wait, this is a folder not a VM. Remember the vmfolder may be just a collection of VMs, but it really is a hierarchy of VMs grouped using subfolders. The same is true for other folders (datacenter, datastore, network, etc.) Try again seting vm = vmlist[1]. Use the up arrow to go up the command history and edit the 0 into a 1 to save typing. This time type(vm) returns: <class 'pyvmomi.vmomisupport.vim.virtualmachine'> Get the vm name: vm.name returns 'w12-core1' vm.summary will return a wealth of information about this VM, including runtime, configuration, and guest properties. Power on VM Now you will power on the VM. First check the power state of the VM: vm.runtime.powerstate returns 'poweredoff' Page 35

36 Power on the VM with the following command: t = vm.poweron() Code completion can be used to quickly get you to relevant properties and functions. Type t = vm.p and wait for the pop up completion menu. If the menu doesn't appear, use <control>-<space>. Use the arrow key to select PowerOn(). The image above shows how code completion works. Press <enter> twice to execute the power on command. A task is launched on the remote server. t.info returns status of the task. Specifically: t.info.state will return 'success' when the PowerOn task has successfully completed on the server. Verify the state of the VM: vm.runtime.powerstate returns 'poweredon' Page 36

37 Page 37

Use vcenter to check VM power state You can verify the VM is really powered on in vcenter. Launch the firefox browser and go to the vsphere Web Client page.

38 Use vcenter to check VM power state You can verify the VM is really powered on in vcenter. Launch the firefox browser and go to the vsphere Web Client page. Log in as user root password VMware1!. Navigate the hierarchy and get the summary for VM w12-core. The summary shows that the VM is up and running. Page 38

Putting it all together The project powercyclevm contains a Python script to select a VM by name, power it off and power it back on. It optionally answers any VM questions on power on.

39 Putting it all together The project powercyclevm contains a Python script to select a VM by name, power it off and power it back on. It optionally answers any VM questions on power on. Edit powercyclevm Edit the file virtual_machine_power_cycle_and_question.py This script uses Tasks and you can see it check the state of the tasks to ensure previous steps have completed. Try debugging this application and stepping through the code. Use the powercyclevm debug configuration to launch the script. Page 39

40 Next Steps You now know how to build a Python application to manage resources on vcenter server or ESXi server. You can find the pyvmomi libraryon GitHub at: You can install pyvmomi (on your own system) with Pip by running the following command: pip install pyvmomi On Windows systems, you may need to be an administrator. On Unix based systems, you may need to use the sudo command. You can find community contributed pyvmomi samples at: pyvmomi-community-samples/ Page 40

41 Module 3 - Workbench IS Tools (15 min) Page 41

42 Introduction Module 3 - Workbench IS Tools This module is an introduction to two tools included in Workbench IS: RSE - Remote System Explorer - This tool allows you to inspect and manage resources on a remote ESXi or vcenter system including files, the datacenter inventory, virtual machines and ssh sessions. Log Browser - This tool allows you to collect, analyze, and correlate log files from a remote system. This module is expected to take approximately 15 minutes. Page 42

Using the Remote System Explorer (RSE) In this lesson you will use the Remote System Explorer to connect to an ESX host or vcenter server, explore the inventory of resources, power on a virtual

43 Using the Remote System Explorer (RSE) In this lesson you will use the Remote System Explorer to connect to an ESX host or vcenter server, explore the inventory of resources, power on a virtual machine, and launch an SSH terminal window on an ESX host. Think of the Remote System Explorer as a mini vsphere Client (albeit with limited functionality) embedded in the Eclipse IDE. This can be useful if you need to connect to an ESX host directly or prefer an experience, integrated with your development environment, for inspecting and manipulating the vcenter infrastructure. RSE is cross platform and runs on Windows, Linux, and Mac OSX. Switch to the Remote System Explorer perspective Launch Eclipse by double clicking the icon on the desktop. Switch to the Remote System Explorer (RSE) perspective by clicking the icon on the upper right. Page 43

44 Connect to a vcenter server Right click in the Remote System panel and select New >> Connection Page 44

45 Select the connection type Select Virtual Center for Linux and click Next Page 45

46 New Connection wizard In the New Connection wizard set the Host name to vcsa-01a.corp.local, the User name to root, and the Password to VMware1! and click Finish. Page 46

Explore vcenter resources You will now see a new connection. Expand the hierarchy. You can see the inventory of resources such as datacenters, clusters, and hosts, as well as a list of VMs.

47 Explore vcenter resources You will now see a new connection. Expand the hierarchy. You can see the inventory of resources such as datacenters, clusters, and hosts, as well as a list of VMs. Click on a VM and, in the Properties panel, you will see a summary of properties for the VM such as memory, cpus, etc. Power on a Virtual Machine In the Remote System panel, find a VM in the vcenter inventory and right click to get a context menu. Then select Power On. Page 47

48 If the VM is already powered on, you will see options to power off, suspend or reset the VM. Page 48

49 Connect to an ESX host Open the Remote System Explorer perspective. Right click in the Remote System panel and select New >> Connection Page 49

50 Select the connection type Select ESX and click Next Page 50

51 New Connection wizard In the New Connection wizard set the Host name to esx-01a.corp.local, the User name to root, and the Password to VMware1! Click Finish Page 51

Explore ESX resources You will now see a new connection. Expand the hierarchy. You can see resources such as datastores and network devices, as well as a list of VMs.

52 Explore ESX resources You will now see a new connection. Expand the hierarchy. You can see resources such as datastores and network devices, as well as a list of VMs. Click on a VM and, in the Properties panel, you will see a summary of properties for the VM such as memory, cpus, etc. Open an SSH terminal on an ESX host In the Remote Systems panel, right click on Ssh Terminals to get a context menu and select Launch Terminal. Page 52

If this is the first time you are connecting to this host, you may see a message about unknown SSH hosts. Click Yes to allow the connection to proceed.

53 If this is the first time you are connecting to this host, you may see a message about unknown SSH hosts. Click Yes to allow the connection to proceed. SSH terminal A Terminals panel appears with a remote connection to the ESX host. You may now perform administrative tasks such as running ESXCLI commands. Page 53

Using the Log Browser Log Browser allows you to collect, analyze, and correlate log files from a remote ESX or vcenter system. In normal development, you may never need Log Browser.

54 Using the Log Browser Log Browser allows you to collect, analyze, and correlate log files from a remote ESX or vcenter system. In normal development, you may never need Log Browser. However, if something goes wrong, this can be a powerful diagnostic tool. In this lesson you will use Log Browser to connect to an ESX host, collect system log files, and analyze one of them to find errors and specific events such as the power on of a virtual machine. Open the resource perspective Click the Open Perspective button and select Resource. Page 54

55 Create a new Log Analysis In the menu select File >> New >> Log Analysis. Page 55

56 New Log Analysis wizard Set the Source host by selecting esx-01.corp.local from the pull down menu. This connection should already exist from the lesson Using the Remote System Explorer >> Connect to an ESX host. If it does not exist you may create it by clicking the Add button. Set the Log format by selecting [Standard Log Collection] from the pull down menu. Set the Project container with any project name such as esxlogs (the project will be created if it doesn t exist). Click Next. Page 56

57 Summary Click Finish to create the new log analysis. Page 57

58 Open the Log Browser views Double click on esx-01a.corp.local_hostd.logx to open the Log Viewer with that log file. Double click on the log entry "Current working directory..." to open the Log Entry Details view with that log entry. Page 58

Analyzing a log file You can use filtering to find patterns or events in log files. Type error in the Filter input field and click the Filter button (the button label will change to Unfilter).

59 Analyzing a log file You can use filtering to find patterns or events in log files. Type error in the Filter input field and click the Filter button (the button label will change to Unfilter). You will now see all log entries with the string error. You can use this same technique to find warnings as well. You can also use the filter with any set of keywords to find specific events. Page 59

Find PowerOn events Type PowerOn in the Filter input field and also check the Case sensitive checkbox. Click the Filter button (the button label will change to Unfilter).

60 Find PowerOn events Type PowerOn in the Filter input field and also check the Case sensitive checkbox. Click the Filter button (the button label will change to Unfilter). You will now see all of the PowerOn events. If you double click on the log entry you can find detailed information down to the path to the virtual machine VMX files. You can use this technique to help diagnose various development tasks. If you were writing vsphere programs or scripts to add a datastore, you could filter the logs using the datastore keyword to find all log messages related to datastores on this ESX host. Page 60

61 Conclusion Thank you for participating in the VMware Hands-on Labs. Be sure to visit to continue your lab experience online. Lab SKU: Version: Page 61

Table of Contents HOL-PRT-1467

Table of Contents HOL-PRT-1467 Table of Contents Lab Overview - - Virtual Volumes with Dell EqualLogic... 2 Lab Guidance... 3 Pre-flight Instructions... 5 Module 1 - Working with Dell EqualLogic and VVOLs (60 Mins)... 11 Creating a