Concept Guide
Table Of Contents
- Dell EMC Networking Open Automation Guide 9.14.1.0 November 2018
- About this Guide
- Open Automation Framework
- Bare Metal Provisioning
- Introduction
- How it Works
- Prerequisites
- Industry Standard Upgrades with BMP
- BMP Process Overview
- BMP Operations
- Configure BMP
- BMP Commands and Examples
- System Boot and Set-up Behavior in BMP Mode
- BMP Mode - Boot and Set-up Behavior
- DHCP Offer Vendor-Specific Option for BMP
- DHCP Offer Relay Option 82
- Software Upgrade Using BMP
- Apply Configurations Using BMP Scripts
- Using the Post-configuration Script
- Using Auto-Execution Script - Normal Mode Only
- Timers in Pre–configuration and Post–configuration Scripts
- Script Examples
- BMP Operations on Servers Overview
- File Server Settings
- Domain Name Server Settings
- BMP MIB Support
- Bare Metal Provisioning CLI
- Open Management Infrastructure
- Puppet
- Smart Scripting
- Overview
- Download the Smart Scripting Package
- Dell EMC Environment Variables
- Dell EMC Proprietary Utilities
- Dell EMC SmartScript Utilities
- SQLite
- NET SNMP Client
- Limits on System Usage
- Supported UNIX Utilities
- Creating a Username and Password for Smart Scripting
- Logging in to a NetBSD UNIX Shell
- Downloading Scripts to a Switch
- Network File System (NFS)
- Setting a Search Path for Scripts
- Scheduling and Executing Scripts
- Running a Script from the UNIX Shell
- Running Scripts with User Privileges
- Smart Scripting CLI
- disable
- execute
- mount nfs
- package clear-all
- package install
- package uninstall
- script (run)
- script (stop/resume/clear/kill/unschedule)
- script event-handler
- script execute (EXEC mode)
- script execute
- script get
- script path
- script remove
- script trigger-event
- show packages
- show script
- start shell
- triggered-by
- switch script limit
- username (event handler)
- username
- SNMP MIBs
- Virtual Server Networking
- Virtual Server Networking CLI
- REST API
- HTTP and HTTPS
- XML
- Important Points to Remember
- REST Authentication
- Request Query Parameters
- Sample BGP Configurations
- HTTP Status Error Codes
- REST API — Protocol Data Unit (PDU) Structure
- Configurations
- Operational
- Operational Data for IPv6
- Management Information Base (MIB)
- IETF Interface Operations
- REST API Framework to Execute the CLIs
- Samples of the config-command
- Samples of the EXEC command
- Samples of the show-command
- REST API CLI
- Web Server
Connectivity
If a network server is not reachable, a log message displays and the VSN agent tries periodically to establish the connection with the
hypervisor.
The initial log message is:
Xen-Citrix:Connection error for hypervisor testing:LOGIN FAILURE
If connectivity to a hypervisor is lost after information is retrieved and used to recongure a switch, the following log message displays. The
VSN agent tries to connect to the hypervisor in the background. The information that was retrieved from the hypervisor is not deleted.
Xen-Citrix:Lost connection to hypervisor xen217. Retrying...
Afterward, one of the following actions performs:
• If connectivity with the hypervisor is re-established within three minutes after the loss of connectivity, the following log message
displays and the retrieved information is retained:
Xen-Citrix:Reestablished connection with hypervisor xen217.
• If connectivity with the hypervisor is not re-established within three minutes after the loss of connectivity, the following log message
displays. The information retrieved from the hypervisor is deleted and the VLANs from the hypervisor are uncongured:
Xen-Citrix:Lost connection to hypervisor xen217. Removing learnt
information.
Running VSN Scripts
The VSN package contains the SDKs for VMware and Citrix Xen hypervisors.
The Perl and Python scripts required for VSN functionality are stored with the VSN package in the /usr/pkg/scripts/VSNAgent
directory as follows:
• For VMware hypervisors, the Perl script is stored is at /usr/pkg/scripts/VSNAgent/VMWare/VSNAgent.pl.
• For Citrix Xen hypervisors, the Python script is stored is at /usr/pkg/scripts/VSNAgent/Xen/hpAgtMain.py
CAUTION
: The Dell Open Automation Virtual Server Networking™ software package (the “Product”) may contain the VMware
SDK for Perl, which is licensed by VMware, Inc. VMware will not provide technical support for the VMware SDK included in the
Product. Users interested in writing scripts for VMware products must obtain the VMware SDK directly from VMware. You may
not create scripts for VMware products through use of the VMware SDK included in the Virtual Server Networking package. End
Users may use the Dell Virtual Server Networking according to the terms, conditions, and limitation of the pertinent Dell End
User License Agreement only.
To run a VSN script (Perl or Python) in all connected hypervisor sessions to retrieve virtual server congurations and update Dell EMC
Networking OS settings on the switch, enter the script command in Conguration mode.
• Run a VSN script in active sessions on VMware and Xen hypervisors.
CONFIGURATION mode
script script-name
For script-name, enter the directory path and lename where you stored the VSN script on the switch; for example:
script/usr/pkg/ scripts/VSNAgent/VMWare/VSNAgent.pl.
To stop a VSN script that is running, enter the no version of the script script-name command; for example: no
script /usr/pkg/scripts/VSNAgent/VMWare/VSNAgent.pl.
Virtual Server Networking
125