xCAT/xcat-core
2
0
Fork 0
mirror of https://github.com/xcat2/xcat-core.git synced 2025-05-30 17:46:38 +00:00
Code Issues Releases Wiki Activity

refine cumulus support doc

Browse Source
This commit is contained in:
immarvin 2016-11-15 02:27:58 -05:00
parent 4f771e3dc3
commit 2e1e273267
2 changed files with 19 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

20
docs/source/advanced/networks/edgecore_switches/edgecore_switches.rst
View File

@ -1,7 +1,9 @@
Edgecore Switch
===============
The Edgecore switch from Mellanox is 1Gb top-of-rack switch. Usually, Mellanox ships the switch with Cumulus Network OS(https://cumulusnetworks.com) and along with a license file installed. In some case, user may get whitebox switch hardware without OS and license installed. Since edgecore switch is different from other traditional switches that xCAT supports, xCAT supports edgecore switch in a different way. Currently, the features provided by xCAT includes: ::
The Edgecore switch from Mellanox is 1Gb top-of-rack switch. Usually, Mellanox ships the switch with Cumulus Network OS(https://cumulusnetworks.com) and along with a license file installed. In some case, user may get whitebox switch hardware without OS and license installed.
Since edgecore switch is different from other traditional switches that xCAT supports, xCAT supports edgecore switch in a different way. Currently, the features provided by xCAT include: ::
1) Cumulus Network OS provision
2) switch discovery
@ -9,11 +11,21 @@ The Edgecore switch from Mellanox is 1Gb top-of-rack switch. Usually, Mellanox s
(a) enable root-passwordless ssh
(b) install licence file
(c) enable snmp
4) distribute files with ``xdcp``
5) invoke commands or scripts remotely with `xdsh``
6)
4) distribute files to switches with ``xdcp``
5) invoke remote commands or scripts on switches with `xdsh``
6) configure switches with ``updatenode``
This documentation presents a typical workflow on how to setup a edgecore switch from white box, then configure and manage the switch with xCAT.
Create a edgecore switch object
-------------------------------
If you have the information of the ip and mac information of the switch, the edgecore switch object definition can be created with the "cumulusswitch" template shipped in xCAT : ::
mkdef edgecoresw1 --template cumulusswitch arch=armv71 ip=192.168.5.191 mac=8C:EA:1B:12:CA:40
Discover the switch
ONIE Mode
---------

6
xCAT/templates/objects/node/cumulusswitch.stanza
View File

@ -4,11 +4,11 @@ cumulusswitch:
objtype=node
arch="OPTIONAL: the arch of the switch management service processor, such as armv71"
groups=switch
ip="MANDATORY:the ip address of the management interface"
mac="MANDATORY:the mac of the management interface"
ip="OPTIONAL:the ip address of the management interface"
mac="OPTIONAL:the mac of the management interface"
mgt=switch
netboot=onie
nodetype=switch
switchtype="OPTIONAL: the manufacturer of switch"
switchtype=edgecore
provmethod="OPTIONAL: the full path of the cumulus installer"
usercomment="the template for cumulus switch definition"