Merge "docs: add status for force10 os"

Author: Zuul

doc/source/supported-devices.rst

@@ -12,8 +12,8 @@ The following devices are supported by this plugin:
 * Cisco NX-OS switches (Nexus)
 * Cumulus Linux (via NCLU)
 * Cumulus Linux (via NVUE)
-* Dell Force10
-* Dell OS10
+* Dell Force10 (netmiko_dell_force10)
+* Dell OS10 (netmiko_dell_os10)
 * Dell PowerConnect
 * HPE 5900 Series switches
 * Huawei switches
@@ -32,4 +32,49 @@ of any type.
 
 These device plugins use `Netmiko <https://github.com/ktbyers/netmiko>`_
 library, which in turn uses `Paramiko` library to access and configure
-the switches via SSH protocol.
+the switches via the SSH protocol.
+
+Dell Force10 OS9 (netmiko_dell_force10)
+---------------------------------------
+
+Known working firmware versions: 9.13.0.0
+
+Notes:
+
+ * Dell Force10 Simulator for 9.13.0 lacks the ability to set a switchport
+   mode to trunk, which prevents automated or even semi-automated testing.
+   That being said, creating VLANs and tagging/untagging works as expected.
+ * Uplink switchports to the rest of the network fabric must be configured in
+   advance if the ``ngs_trunk_ports`` switch device level configuration
+   option is *not* utilized.
+ * Use of SSH is expected and must be configured on the remote switch.
+ * Set each port to "switchport" to enable L2 switchport mode.
+ * Use of an "enable" secret through the switch level configuration option
+   ``secret`` was the tested path. Depending on precise switch configuration
+   and access control modeling, it may be possible to use without an enable
+   secret, but that has not been tested.
+
+Known Issues:
+
+ * `bug 2100641 <https://bugs.launchpad.net/ironic/+bug/2100641>`_ is
+   alieviated by setting a port to "switchport" *before* attempting to utilize
+   networking-generic-switch.
+
+Dell Force10 OS10 (netmiko_dell_os10)
+-------------------------------------
+
+Known working firmware version: 10.6.0.2.74
+
+Notes:
+
+ * Uplink switchports may need to be configured as Trunk ports prior to the
+   use of networking-generic-switch through a "switchport mode trunk" command.
+   Further specific trunk configuration may be necessary, however NGS can
+   leverage the ``ngs_trunk_ports`` configuration option and does appropriately
+   tag switchports as permitted when creating/deleting attachments.
+ * Password authentication for networking-generic-switch needs to be setup in
+   advance, specifically "ip ssh server enable" and
+   "ip ssh server password-authentication" commands.
+ * This driver was tested *without* the use of an enable secret to
+   permit a higher level of configuration access within the Switch.
+