Pluribus VirtualWire™ L1 Shell

[Quali-Community]

Pluribus VirtualWire™ L1 Shell

The Pluribus VirtualWire L1 shell provides you with the capability to communicate with network topology managed by the Pluribus Netvisor switch.

The shell allows CloudShell users to interact with the device, for example, create and modify route mappings, get device information, and more.

For more information on the Pluribus VirtualWire, see the official Pluribus VirtualWire product documentation.

Repository	Latest Release	README.md
Name cloudshell-L1-netvisor_virtualwire Owner QualiSystems Type L1 Driver Category Connectivity Min. Compatible CloudShell Version 7.0 Total Downloads (All Releases) 89	Link 3.0.1 (Version / Tag) TAR / ZIP 3.0.1 (TAR) 3.0.1 (ZIP) Author saklar13 Published On 11/22/2022 02:06 PM Assets cloudshell-L1-pluribus-virtualwire-3.0.1.zip [4.29 MB]	Pluribus VirtualWire L1 Shell Release date: 27/12/2018 Shell version: 2.0.0 Document version: 1.0 In This Guide Overview Downloading the Shell Importing and Configuring the Shell Updating Python Dependencies for Shells Upgrading the L1 Shell and Datamodel Typical Workflows References Release Notes Overview A shell integrates a device model, application or other technology with CloudShell. A shell consists of a data model that defines how the device and its properties are modeled in CloudShell, along with automation that enables interaction with the device via CloudShell. L1 Switch Shells L1 switch shells allow CloudShell to manage networking connectivity between physical resources and private cloud provider Apps, such as vCenter. For additional information, see the L1 Switches online help topic. Pluribus VirtualWire L1 Shell The Pluribus VirtualWire L1 shell provides you with the capability to communicate with network topology managed by the Pluribus Netvisor switch. The shell allows CloudShell users to interact with the device, for example, create and modify route mappings, get device information, and more. For more information on the Pluribus VirtualWire, see the official Pluribus VirtualWire product documentation. Standard version The Pluribus VirtualWire L1 shell is based on the Layer 1 Switch Shell Standard. Supported OS ▪ Netvisor Requirements Release: Pluribus VirtualWire L1 Shell ▪ CloudShell version: 8.0 and above Data Model The shell's data model includes all shell metadata, families, and attributes. Pluribus VirtualWire Families and Models The L1 switch families and models are listed in the following table: Family Model Description L1 Switch Pluribus Virtual Wire Chassis L1 Switch Chassis L1 Switch Blade Generic L1 Module Generic L1 Module L1 Switch Port Generic L1 Port Generic L1 Port Pluribus VirtualWire Attributes The Pluribus Virtual Wire Chassis attribute names and types are listed in the following table: Attribute Type Description Model Name String Model name Serial Number String Serial number OS Version String OS version The Generic L1 Module attribute names and types are listed in the following table: Attribute Type Description Model Name String Model name Serial Number String Serial number The Generic L1 Port attribute names and types are listed in the following table: Attribute Type Default Description Auto Negotiation Boolean True Port auto negotiation Duplex Lookup Full Port duplex Port Speed String Port speed Protocol Lookup Transparent Port protocol Protocol Type Value String Port protocol type value Protocol Value String Port protocol value Rx Power (dBm) String 0 Optical port Rx signal strength Tx Power (dBm) String 0 Optical port Tx signal strength Wavelength String 0 Optical Port wavelength Automation This section describes the automation (drivers) associated with the data model. The shell’s driver is provided as part of the shell package. There are two types of automation processes, Autoload and Resource. Autoload is executed when creating the resource in the Inventory dashboard, while resource commands are run in the sandbox. Command Description Autoload Discovers and creates the internal resources of the root resource (for example, switch cards and ports). MapBidi Creates a bi-directional mapping between two ports. MapUni Creates a uni-directional mapping between two ports. MapClear Clears any connection ending in this port. MapClearTo Clears a uni-directional connection between two ports. GetAttributeValue Extracts attribute values from the device. SetAttributeValue Sets attribute values on the device. MapTap Adds monitor ports to an existing connection. Note: You can only activate a TAP connection after activating a parent MapUni/MapBidi connection. Downloading the Shell The Pluribus VirtualWire shell is available from the Quali Community Integrations page. The shell comprises: File name Description cloudshell-L1-pluribus-virtualwire-x.x.x.zip Pluribus VirtualWire shell package install_driver.bat Pluribus VirtualWire shell installation script pluribus_virtualwire_runtime_config.yml Pluribus VirtualWire shell configuration file pluribus_virtualwire_ResourceConfiguration.xml XML file containing the resource structure, attributes and capabilities of the L1 switches of the same vendor Importing and Configuring the Shell This section describes how to import the L1 shell and configure and modify the shell’s devices. Importing and configuring the shell in CloudShell To import and configure the shell in CloudShell: Make sure you have the shell’s zip package. If not, download the shell from the Quali Community's Integrations page. Extract the Pluribus VirtualWire shell zip package to the following location on the Quali Server machine: C:\Program Files (x86)\QualiSystems\CloudShell\Server\Drivers Run the C:\Program Files (x86)\QualiSystems\CloudShell\Server\Drivers\cloudshell-L1-pluribus-virtualwire\install_driver.bat file. Import the new data model. In Resource Manager Client>Admin, right-click Resource Families and select Import. Select the C:\Program Files (x86)\QualiSystems\CloudShell\Server\Drivers\cloudshell-L1-pluribus-virtualwire\datamodel\pluribus_virtualwire_ResourceConfiguration.xml file. Click Open. Create an L1 resource. In Resource Explorer, right-click Root and select New>Resource. Enter the Name and Address. Select the L1 Switch family. Ensure that the correct Model Pluribus VirtualWire Chassis and Driver NETVISOR VIRTUALWIRE are selected. Click OK. Auto Load the new resource. In Resource Explorer, right-click the new resource and select Configuration. In the Internal Resources pane, right-click the switch and select Exclude. Click the Auto Load button at the bottom of the Configuration tab. Define the resource connections on the L1 switch. Right-click the resource and select Configuration>Connections. Connect a resource's port to a different port in the switch resource by clicking each port's Connected To button, selecting the resource's Family and Resource, and selecting the port to connect. Click OK in the Resource connection dialog box. Save your changes. Offline installation of a shell Shell installation installs the required dependencies from the shell's zip package. The install_driver.bat script creates a virtual environment on the Quali Server machine under C:\Program Files (x86)\QualiSystems\CloudShell\Server\Drivers\cloudshell-L1-pluribus-virtualwire and installs the required dependencies in this virtual environment from the extracted L1 shell folder (under ~cloudshell-L1-pluribus-virtualwire\packages). Updating Python Dependencies for Shells This section explains how to update your Python dependencies folder. This is required when you upgrade a shell that uses new/updated dependencies. It applies to both online and offline dependencies. L1 shells do not have separate Python dependencies files. All dependencies are included in the L1 shell itself and are installed along with the shell. Therefore, in order to update the shell's Python dependencies, you must upgrade the shell. See Upgrading the L1 Shell and Datamodel. Upgrading the L1 Shell and Datamodel Note: Upgrading an L1 shell requires the use of the QsMigrationUtility, which is provided out-of-the-box with CloudShell. To upgrade the L1 shell and datamodel: In the Quali Server machine, remove or rename the L1 shell's folder located in the Drivers folder: C:\Program Files (x86)\QualiSystems\CloudShell\Server\Drivers. Extract the new L1 shell to the Drivers folder: C:\Program Files (x86)\QualiSystems\CloudShell\Server\Drivers. In the extracted L1 shell's folder, run install_driver.bat. Create a new folder: C:\Program Files (x86)\QualiSystems\CloudShell\Server\Configuration. Copy the upgraded shell's datamodel file from: C:\Program Files (x86)\QualiSystems\CloudShell\Server\Drivers\cloudshell-L1-pluribus-virtualwire\datamodel\pluribus_virtualwire_ResourceConfiguration.xml to: C:\Program Files (x86)\QualiSystems\CloudShell\Server\Configuration. Run C:\Program Files (x86)\QualiSystems\CloudShell\Server\QsMigrationUtility.exe. References To download and share integrations, see Quali Community's Integrations. For instructional training and documentation, see Quali University. To suggest an idea for the product, see Quali's Idea box. To connect with Quali users and experts from around the world, ask questions and discuss issues, see Quali's Community forums. Release Notes What's New For release updates, see the shell's GitHub releases page.
* Updated Weekly	* Update Now	* Repository, release and asset info is updated weekly. * Please allow 30-60 seconds for manual update changes to take effect.

---

 ofir eldar 01/13/2018 07:29 AM

·  3253  ·