Dell FORCE10 Open Automation Manual de usuario

Open Automation GuideConfiguration and Command Line ReferenceFebruary 2013

10 | Open Automation Frameworkwww.dell.com | support.dell.com• Programmatic Management• Web GUI and HTTP serverYou can use these components together o

Open Automation Framework | 11Smart ScriptingSmart Scripting provides:• Support for industry-standard languages, such as Perl and Python, avoiding the

12 | Open Automation Frameworkwww.dell.com | support.dell.comProgrammatic ManagementProgrammatic Management provides application programming interface

Smart Scripting | 133Smart ScriptingSmart Scripting is supported on platforms: z Smart Scripting allows you to add functionality to the FTOS operatin

14 | Smart Scriptingwww.dell.com | support.dell.comSmart Scripting also offers solutions in a UNIX environment that are useful to cloud administrators

Smart Scripting | 15• Reporting switch memory usage, configured VLANs, and other operating and configuration parameters.• Creating custom APIs for ext

16 | Smart Scriptingwww.dell.com | support.dell.comInstalling Smart ScriptingYou install the Smart Scripting file in the same way as you install an FT

Smart Scripting | 17To remove an installed Open Automation package, such as Smart Scripting, enter the package uninstall command.To follow the progres

18 | Smart Scriptingwww.dell.com | support.dell.comSupported UNIX UtilitiesSmart Scripting supports the invocation of the following UNIX utilities in

Smart Scripting | 19fc List the history of commands on the computer.fg Change the background process to foreground.file Determine file type.find Walk

Notes, Cautions, and Warnings NOTE: A NOTE indicates important information that helps you make better use of your computer. CAUTION: A CAUTION WAR

20 | Smart Scriptingwww.dell.com | support.dell.comCreating PERL, Python and UNIX ScriptsWhen you install the Smart Scripting package, sample PERL and

Smart Scripting | 21Running a Script from the FTOS CLIYou can run any PERL, Python, and UNIX script that is stored on the switch from the FTOS CLI.Whe

22 | Smart Scriptingwww.dell.com | support.dell.comLogging in to a NetBSD UNIX ShellTo log in to the NetBSD UNIX shell on a switch to directly enter a

Smart Scripting | 23Figure 3-2. Execution of a PERL, Python, and Shell Script from a UNIX Shell: Example Using the PERL API Use the information in thi

24 | Smart Scriptingwww.dell.com | support.dell.comFigure 3-3. PERL Script with API function call: Example Table 3-2 describes the supported functions

Smart Scripting | 25Table 3-3. Supported FTOS API Functions in PERL ScriptsPERL API Function Arguments DescriptionF10AddLagIntToVlan (lagId, vlanId,

26 | Smart Scriptingwww.dell.com | support.dell.comRunning a PERL API ScriptWhen you run a PERL script that invokes the API functions in Table 3-2, lo

Smart Scripting | 27To configure the username and passwords in the smartutils.cfg file that are used to run PERL API scripts, do one of the following:

28 | Smart Scriptingwww.dell.com | support.dell.comFigure 3-4. Python Script with API function call: Example #!/usr/pkg/bin/pythonimport syssys.path.a

Smart Scripting | 29F10MakeVlanIntNoShutdown (vlanId) Enables the specified VLAN interface.F10MakeVlanIntShutdown (vlanId) Disables the specified VLAN

| 31 About this Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5Objectives . . . . . . . . . . . . .

30 | Smart Scriptingwww.dell.com | support.dell.comRunning a Python API ScriptWhen you run a Python script that invokes the API functions in Table 3-4

Smart Scripting | 31Using UNIX Shell Scripting Use the information in this section to create a UNIX script using the UNIX API and run the script on a

32 | Smart Scriptingwww.dell.com | support.dell.commakephyintnoshutdown stackUnitNum, portId Enables the specified port.makephyintshutdown stackUnitNu

Smart Scripting | 33Running a UNIX API ScriptWhen you run a UNIX shell script that invokes the API functions in Table 3-5, logon credentials are read

34 | Smart Scriptingwww.dell.com | support.dell.com

Smart Scripting CLI | 354Smart Scripting CLIOverviewSmart Scripting CLI is supported on platforms: zCommands• package install• package uninstall• s

36 | Smart Scripting CLIwww.dell.com | support.dell.comUsageInformationBecause the installing of an Open Automation package may take time, the install

Smart Scripting CLI | 37script zRun a Perl, Python, or UNIX shell script from the FTOS CLI.Syntaxscript [username name] script-name [script-parameter

38 | Smart Scripting CLIwww.dell.com | support.dell.comEnter the no script script-name command to stop a running script.To display the scripts that ar

Smart Scripting CLI | 39ExampleFTOS# show packages* Package Name: SMARTSCRIPTS Version: 2.0.0 Python 2.6.5 Perl 5.8.8 Da

4 |www.dell.com | support.dell.com5 Virtual Server Networking . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .43Overview . .

40 | Smart Scripting CLIwww.dell.com | support.dell.comExampleFTOS# show packages* Package Name:SMARTSCRIPTS-Z Version: 2.0.0 Python 2.6.5

Smart Scripting CLI | 41start shell zStart a NetBSD UNIX shell. Syntaxstart shellDefaultsNoneCommand ModesEXEC PrivilegeCommandHistoryUsageInformation

42 | Smart Scripting CLIwww.dell.com | support.dell.comusername zConfigure an additional user name and password to be used only to run scripts on a sw

Virtual Server Networking | 435Virtual Server NetworkingVirtual Server Networking is supported on platforms:As a part of the Open Automation package,

44 | Virtual Server Networkingwww.dell.com | support.dell.comBoth VMware and Citrix Xen provide SDKs and APIs for accessing their configuration object

Virtual Server Networking | 45Hypervisor ModesThere are two modes for retrieving configuration information from a hypervisor on a virtual server:• Che

46 | Virtual Server Networkingwww.dell.com | support.dell.comEnter the show vlan command to display the VSN hypervisor-learned VLANs on the switch. As

Virtual Server Networking | 47Prerequisites: - Smart Scripting is a prerequisite for using Virtual Server Networking. You must first install the Smart

48 | Virtual Server Networkingwww.dell.com | support.dell.comEnabling VSN in a Hypervisor SessionRestrictions: - VSN is not supported in stacked confi

Virtual Server Networking | 49After you enable VSN on an interface and enable a hypervisor session that connects to hypervisors on network servers, yo

About this Guide | 51About this GuideObjectivesThis document describes the components and uses of the Open Automation Framework designed to run on the

50 | Virtual Server Networkingwww.dell.com | support.dell.comDiscoveryThe discovery process starts after you enter the no disable command on the inter

Virtual Server Networking | 51If connectivity to a hypervisor is lost after information is retrieved and used to reconfigure a switch, the following l

52 | Virtual Server Networkingwww.dell.com | support.dell.comTo run a VSN script (Perl or Python) in all connected hypervisor sessions to retrieve vir

Virtual Server Networking | 53Uninstalling VSNUninstalling the VSN package removes it from the internal flash memory on a switch. Viewing VSN informat

54 | Virtual Server Networkingwww.dell.com | support.dell.comTo display the components of current hypervisor sessions, including the link, virtual swi

Virtual Server Networking | 55Figure 5-7. Display Virtual Machines Accessed on an Interface: show vmmapFTOS#show vmmap gigabitethernet 0/32VM Name

56 | Virtual Server Networkingwww.dell.com | support.dell.com

Virtual Server Networking CLI | 576Virtual Server Networking CLIOverviewVirtual Server Networking CLI is supported on platforms: Commands• access• di

58 | Virtual Server Networking CLIwww.dell.com | support.dell.comaccessConfigure the connection to access a hypervisor.Syntax[no] access url username

Virtual Server Networking CLI | 59hypervisor Specify the name of a hypervisor session with which VSN will connect.Syntax[no] hypervisor name Parameter

6 | About this Guidewww.dell.com | support.dell.com• S4810 switches require FTOS version 8.3.10.1 or later. • Z9000 switches require FTOS version 9.0.

60 | Virtual Server Networking CLIwww.dell.com | support.dell.comUsageInformationYou can use the mode command to change the way in which virtual-serve

Virtual Server Networking CLI | 61package uninstallRemove an installed Open Automation package, such as Virtual Server Networking, from the system.Syn

62 | Virtual Server Networking CLIwww.dell.com | support.dell.comscriptRun an installed VSN script (Perl or Python) on active hypervisor links to retr

Virtual Server Networking CLI | 63show hypervisor supportedDisplay the types of hypervisors currently supported by VSN. Syntaxshow hypervisor supporte

64 | Virtual Server Networking CLIwww.dell.com | support.dell.comExampleFTOS#show packages***************************************** Package Name:SMART

Virtual Server Networking CLI | 65show virtualswitchDisplay the components of current hypervisor sessions, including the virtual switch and name of th

66 | Virtual Server Networking CLIwww.dell.com | support.dell.comThe following command output displays information on the hypervisor session establish

Virtual Server Networking CLI | 67show vmmapDisplay the virtual machines accessed on a switch interface. Syntaxshow vmmap interfaceDefaultsNoneParamet

68 | Virtual Server Networking CLIwww.dell.com | support.dell.comtypeSet the hypervisor type to which you want to connect.Syntax[no] type {vmware | xe

Programmatic Management | 697Programmatic ManagementProgrammatic Management is supported on platforms: and is downloaded with the SmartScripts packag

About this Guide | 7Related DocumentsFor more information about the Dell Force10 Networks switches discussed in this document, refer to the following

70 | Programmatic Managementwww.dell.com | support.dell.comUsing the REST APIThe script-based REST API allows you to remotely access a switch that sup

Programmatic Management | 71The following example shows how to embed an HTTP get request in Python script.Figure 7-2. Python Sample with HTTP Get Requ

72 | Programmatic Managementwww.dell.com | support.dell.comTable 7-1. Supported Get Requests Invoked through the REST APIHTTP Get Request FTOS CLI Ope

Programmatic Management | 73Plug-In ModulesProgrammatic Management are third-party management tools and applications that run on host devices in a dat

74 | Programmatic Managementwww.dell.com | support.dell.com

Web GUI and HTTP Server | 758Web GUI and HTTP ServerWeb GUI and HTTP Server are supported on platforms and are downloaded with the SmartScripts pa

76 | Web GUI and HTTP Serverwww.dell.com | support.dell.comWeb Graphical User InterfaceIn the Open Automation package, the Web graphical user interfac

Web GUI and HTTP Server | 77Menu OptionsTable 8-1 describes the switch operation performed by each menu option.2 To retrieve or change configuration p

78 | Web GUI and HTTP Serverwww.dell.com | support.dell.comInterfaces > Management Displays the status and IP address of management interfaces. Pro

Web Graphical User Interface | 79Appendix AWeb Graphical User InterfaceThis appendix contains examples of the output displayed for each menu option in

8 | About this Guidewww.dell.com | support.dell.com

80 | Web Graphical User Interfacewww.dell.com | support.dell.comSystem > CPU Usage

Web Graphical User Interface | 81System > Boot Variables System > Running Config

82 | Web Graphical User Interfacewww.dell.com | support.dell.comSystem > Information

Web Graphical User Interface | 83Interfaces MenuInterfaces > All

84 | Web Graphical User Interfacewww.dell.com | support.dell.comInterfaces > Physical Interfaces > LAGs Interfaces > VLANs

Web Graphical User Interface | 85Interfaces > Management

86 | Web Graphical User Interfacewww.dell.com | support.dell.comProtocols MenuProtocols > VRRP

Web Graphical User Interface | 87Protocols > VRRP Brief Protocols > BGP Summary

88 | Web Graphical User Interfacewww.dell.com | support.dell.comProtocols > BGP Neighbors Protocols > OSPF Neighbors

Web Graphical User Interface | 89Protocols > ISIS Neighbors

Open Automation Framework | 92Open Automation FrameworkOpen Automation Framework is supported on platforms: z Dell Force10’s Open Automation Framewor

90 | Web Graphical User Interfacewww.dell.com | support.dell.comDiagnostics MenuDiagnostics > Arp TableDiagnostics > Mac Address TableDiagnostic

Web Graphical User Interface | 91Diagnostics > System Log

92 | Web Graphical User Interfacewww.dell.com | support.dell.comDiagnostics > VLANs Diagnostics > VLAN Members

Web Graphical User Interface | 93Diagnostics > Int Bandwidth

94 | Web Graphical User Interfacewww.dell.com | support.dell.comUtilities MenuUtilities > Ping Utilities > Traceroute

Web Graphical User Interface | 95Settings MenuSettings > SmartUtils Credentials

96 | Web Graphical User Interfacewww.dell.com | support.dell.com

Index | 97IndexAAPIsPerl25Python 28REST 72UNIX 31BBare Metal Provisioningdescription10switch autoconfiguration 10Ddisplaying installed OA packages 17D

98 | Indexwww.dell.com | support.dell.comPython API 27Python scripts 13REST API 69restrictions on CPU and memory usage 17running scripts from a UNIX s