Open Automation Guide Configuration and Command Line Reference February 2013 Notes, Cautions, and Warnings NOTE: A NOTE indicates important information that helps you make better use of your computer. CAUTION: A CAUTION WARNING: A WARNING indicates a potential for property damage, personal injury, or death. Information in this publication is subject to change without notice. © 2013 Dell Force10. All rights reserved. Reproduction of these materials in any manner whatsoever without the written permission of Dell Inc. is strictly forbidden. Trademarks used in this text: Dell™, the DELL logo, Dell Precision™, OptiPlex™, Latitude™, PowerEdge™, PowerVault™, PowerConnect™, OpenManage™, EqualLogic™, KACE™, FlexAddress™ and Vostro™ are trademarks of Dell Inc. Intel, Pentium, Xeon, Core™ and Celeron are registered trademarks of Intel Corporation in the U.S. and other countries. AMD is a registered trademark and AMD Opteron™, AMD Phenom™, and AMD Sempron™ are trademarks of Advanced Micro Devices, Inc. Microsoft®, Windows®, Windows Server®, MS-DOS® and Windows Vista® are either trademarks or registered trademarks of Microsoft Corporation in the United States and/or other countries. Red Hat Enterprise Linux® and Enterprise Linux® are registered trademarks of Red Hat, Inc. in the United States and/or other countries. Novell® is a registered trademark and SUSE ™ is a trademark of Novell Inc. in the United States and other countries. Oracle® is a registered trademark of Oracle Corporation and/or its affiliates. Citrix®, Xen®, XenServer® and XenMotion® are either registered trademarks or trademarks of Citrix Systems, Inc. in the United States and/or other countries. VMware®, Virtual SMP®, vMotion®, vCenter®, and vSphere® are registered trademarks or trademarks of VMWare, Inc. in the United States or other countries. Other trademarks and trade names may be used in this publication to refer to either the entities claiming the marks and names or their products. Dell Inc. disclaims any proprietary interest in trademarks and trade names other than its own. February 2013 1 About this Guide . .5 Objectives . .5 Audience . .5 Supported Platforms and Required FTOS Versions . .5 Conventions . .6 Information Symbols . .6 Related Documents . .7 2 Open Automation Framework . .9 Bare Metal Provisioning . .10 Smart Scripting . .11 Virtual Server Networking . 11 Programmatic Management . .12 Web Graphical User Interface and HTTP Server . .12 3 Smart Scripting . .13 Overview . .13 Use Cases . .14 Downloading the Smart Scripting Package . .15 Installing Smart Scripting . .16 Displaying Installed Packages . .17 Uninstalling Smart Scripting . .17 Limits on System Usage . .17 Supported UNIX Utilities . .18 Creating PERL, Python and UNIX Scripts . .20 Creating a User Name and Password for Smart Scripting . .20 Running a Script from the FTOS CLI . .21 Logging in to a NetBSD UNIX Shell . .22 Running a Script from the UNIX Shell . .22 Using the PERL API . .23 Creating a PERL API Script . .23 Running a PERL API Script . .26 Using the Python API . .27 Creating a Python API Script . .27 Running a Python API Script . .30 Using UNIX Shell Scripting . .31 Creating a UNIX API Script . .31 Running a UNIX API Script . .33 4 Smart Scripting CLI. .35 Overview . .35 Commands . .35 | 3 5 Virtual Server Networking . .43 Overview . .43 Hypervisor Modes . .45 VSN Persistency . .45 VLAN configuration . .45 Management VLAN . .45 Data VLANS . .45 Hypervisor-unaware VLANs . .46 Installing VSN . .46 Enabling VSN in a Hypervisor Session . .48 Discovery . .50 Connectivity . .50 www.dell.com | support.dell.com Running VSN Scripts . .51 Stopping a Hypervisor Session . .52 Disabling a Session . .52 Removing a Session . .52 Uninstalling VSN . .53 Viewing VSN information . .53 6 Virtual Server Networking CLI. .57 Overview . .57 Commands . .57 7 Programmatic Management . .69 Overview . .69 Using the REST API . .70 Plug-In Modules . .73 8 Web GUI and HTTP Server . ..