Fabric Shrink/Expand
This article gives brief overview of how to add or remove switches within the fabric using Hedgehog Fabric API and manage connections between them.
Manipulating API objects done with assumption that target devices are correctly cabeled and connected.
This article operates terms that can be found in Hedgehog Concepts, User Guide documentation and Fabric API reference.
Add switch to the existing fabric
For every switch to be added into the Hedgehog fabric it should have a corresponding Switch
object. Example can be found in User Guilde.
If the
Switch
will be used inESLAG
orMCLAG
groups, appropriate groups should exist. Redundancy groups should be specified in theSwitch
object before creation.
After the Switch
object is created, dedicated device Connections
can be defined and created. Based on the Switch
role given to the device types of connections may be different. Please refer to Connections section.
If switch is facing control node connection on the front-panel port, such switch port should be described in
Management
connectionSwitch device should be booted in
ONIE
orHONIE
Installation mode to install SONiC OS and configure Fabric agent
Remove switch from the existing fabric
If the switch has to be decommissioned or removed there are several preparation steps before disabling it from the Fabric.
[!WARNING] Currently the
Wiring
diagram used for initial deployment is saved in/var/lib/rancher/k3s/server/manifests/hh-wiring.yaml
on theControl
node. Fabric will sustain objects within the original wiring diagram. In order to remove any of the object that is described in this chapter, dedicated API object should be first removed from this file. It's recommended to reapplyhh-wiring.yaml
after changing it's internals.
- If the
Switch
is aLeaf
switch (includingMixed
andBorder
leaf configuration) allVPCAttachments
bound to all switchesConnections
must be removed first. If theSwitch
was used forExternalPeering
allExternalAttachment
object that are bound toConnections
of theSwitch
must be removed. - All connections of the
Switch
must be removed. Switch
andAgent
object can be removed.
Created: February 6, 2024