To onboard a Cisco switch, you must first register a Network Service Orchestrator (NSO) instance in Bare Metal Orchestrator.
Register the NSO instance. For more information, see Register an NSO instance in Bare Metal Orchestrator.
- Establish a CLI session on the Bare Metal Orchestrator VM and log in. For high availability configurations, establish a CLI session using the virtual IP (VIP) of the Load Balancers for the Bare Metal Orchestrator cluster.
- Change the directory to ~/samples/switch-profiles.
- Create a switch YAML file by copying the sample file, mw_cisco_switch_nso_mode.yaml.
cp <mw_cisco_switch_nso_mode>.yaml <new-switch-id>.yaml
- Edit the <new-switch-id>.yaml file in Vim or a similar editor. For example:
vim cisco_switch_new.yaml
- Customize the <new-switch-id>.yaml file:
- Update the metadata. For more information, see Metadata.
- Update the fields mentioned in Cisco switch field definitions.
This is an example switch.yaml file for a Cisco switch:
apiVersion: mw.dell.com/v4
kind: Switch
metadata:
name: Ciswitch
labels:
site: gc
spec:
devicename: cisco-nexus
mgmtipaddress: <REPLACE THIS>
username: admin
password: "<REPLACE THIS>"
vendor: Cisco
model: Nexus
mode: nso
sdncontroller: nso3
devicetype: "cli"
nedid: cisco-nx-cli-5.22:cisco-nx-cli-5.22
port: "8080"
adminstate: "unlocked"
authgroup: "myauthgroup" - Save the file and quit the editor.
- Create the switch instance with the following command:
bmo create switch -f <new-switch-id>.yaml
For example:bmo create switch -f cisco_switch_new.yaml
- Verify that the Cisco switch was onboarded successfully. For more information, see View switches and switch status and View switch inventory.
After onboarding a Cisco switch, you can configure Layer 2 VLAN, Layer 3 VLAN, and Ethernet interface settings on the switch. For more information, see: