OpenSwitch OPX Administration Guide Release 2.1.
017 - 7 Rev.
Contents 1 Administration................................................................................................................................................ 4 System utility commands ................................................................................................................................................. 4 Default XML configuration files........................................................................................................................................
1 Administration This information covers tasks needed to properly maintain and upgrade the system running OpenSwitch OPX including system defaults, configuring interfaces, installing Linux packages, logging, and upgrades. System defaults When the system boots up, default system configuration is applied: • All Linux interfaces are created and mapped to physical ports. • All Linux interfaces are in an Administratively Down state.
• opx-show-env — display environmental system components such as temperature, fan, and voltage (see opx-show-env) • opx-show-packages — display specific information for each package installed (see opx-show-packages) • opx-show-stats — display detailed port and VLAN statistics (see opx-show-stats) • opx-show-system-status — display system status information (see opx-show-system-status) • opx-show-transceivers — display information about the current transceiver types (see opx-show-transceivers) • o
If extra security is desired other than what is provided by SSH, use iptables to enable Linux firewall features. You can also set up rate limiting for incoming traffic to prevent denial of service attacks. Configure physical port See the OpenSwitch OPX Configuration Guide to configure physical port attributes. Create user accounts Use standard Linux commands to manage user accounts. Example Linux commands include useradd, userdel, usermod, and passwd. Configure access privileges with the usermod command.
Start service $ service snmpd start $ service snmpd status snmpd.service - LSB: SNMP agents Loaded: loaded (/etc/init.d/snmpd) Active: active (running) since Wed 2016-02-17 05:00:39 UTC; 1s ago Process: 3370 ExecStop=/etc/init.d/snmpd stop (code=exited, status=0/SUCCESS) Process: 3395 ExecStart=/etc/init.d/snmpd start (code=exited, status=0/SUCCESS) CGroup: /system.slice/snmpd.service └─3399 /usr/sbin/snmpd -Lsd -Lf /dev/null -u snmp -g snmp -I -smux...
Boot different ONIE mode You can boot a software image from the Linux shell (in OPX runtime) into ONIE. 1 Change the next boot to ONIE using Grub. $ sudo grub-reboot --boot-directory=/mnt/boot ONIE 2 Change ONIE mode to Install, Rescue or Uninstall mode. $ sudo /mnt/onie-boot/onie/tools/bin/onie-boot-mode -o install $ sudo /mnt/onie-boot/onie/tools/bin/onie-boot-mode -o rescue $ sudo /mnt/onie-boot/onie/tools/bin/onie-boot-mode -o uninstall 3 Reboot the switch.
2 Install and configure the Puppet agent on both systems by following the instructions at www.puppetlabs.com. 3 Verify if the Puppet master can communicate with the Puppet agents through the management network. Sample configuration—manifest managing two systems node 'R1.dell.com' { $int_enabled = true $int_loopback = '2.2.2.2' $int_layer3 = { e101-019-0 => {'int'=>'e101-019-0', 'address' => '19.0.0.1', 'netmask' => '255.255.255.
Sample configuration—Quagga configuration file ! This file is managed by Puppet hostname zebra log file /var/log/quagga/zebra.log hostname ospfd log file /var/log/quagga/ospfd.log log timestamp precision 6 hostname bgpd log file /var/log/quagga/bgpd.log ! password cn321 enable password cn321 ! <% @int_layer3.
Nagios Open Source Nagios provides remote monitoring using a remote plugin executor (NRPE), which communicates with the check_nrpe plugin in the Nagios server. This use case describes how to set up a system running the software as a Nagios client (see nagios-plugins for complete information). Configure Nagios client To set up a system running OpenSwitch OPX as a Nagios client, install the Nagios NRPE server and Nagios plugins. The Nagios NRPE server is the agent which allows remote system monitoring.
command_name command_line } define command{ command_name command_line } 3 check_remote_disk $USER1$/check_disk -w $ARG1$ -c $ARG2$ -p $ARG3$ check_remote_procs $USER1$/check_procs -w $ARG1$ -c $ARG2$ -s $ARG3$ Edit the clients.cfg file on the Nagios server to configure services to be monitored on the system.
2 Troubleshooting You can use methods and tools available for gathering information and debugging OpenSwitch OPX including coredumps and firmware versions. Firmware versions To display version information about installed firmware, open the /var/log/firmware_versions file. Transceivers See opx-show-transceivers to view current transceiver information.
• opx–switch-shell “l2 show” • opx–switch-shell “stp show” • opx–switch-shell “vlan show” Layer 3 troubleshooting Use opx_logging_cli commands to view the contents of NPU log files in Layer 3.
PAS logging Jun 16 18:16:52 OPX pas_svc: [PAS:PAS]:pas_entity.c:dn_entity_poll:366, PSU 1 is present Jun 16 18:16:52 OPX pas_svc: [PAS:PAS]:pas_entity.c:dn_entity_poll:366, Fan Tray 1 is present NAS logging Jun 24 18:49:18 OPX nas_svc: [INTERFACE:INT-CREATE]:port/nas_int_port.
• • ALL • STP • LAG • ROUTER_INTERFACE • NEXT_HOP • SCHEDULER level_name sets the SAI logging level to debug, info, notice, warning, critical, or error. Manage CPS API objects Common commands used to manage CPS API objects are included. See CPS API programmability in the OpenSwitch OPX Developers Guide for detailed information. get object Retrieve and view the contents of a CPS API object. cps_get_oid.py qualifier category/subcategory ...
Password recovery You may need to recover a lost password. 1 Connect to the serial console port and verify that the serials settings are 115200 baud, 8 data bits, no parity. 2 Reboot or power up the system, then press ESC at the GNU GRUB prompt to view the boot menu. +----------------------------------------------------------------------------+ |*OPX-A | | OPX-B | | ONIE | +----------------------------------------------------------------------------+ 3 Press e to open the OpenSwitch OPX GRUB editor.
3 Linux management Topics: • opx-config-fanout • opx-chassis-beacon • opx-config-switch • opx-ethtool • opx_logging_cli • opx-show-alms • opx-show-env • opx-show-packages • opx-show-stats • opx-show-system-status • opx-show-transceivers • opx-show-version • opx-switch-log opx-config-fanout Enables or disables interface fan-out on a specific port. Syntax opx-config-fanout portID {true | false} Parameter portID Enter the port ID to enable or disable.
opx-chassis-beacon Toggles the port LED of an interface to easily identify each time a beacon is sent to check for pending packets on the interface. Syntax Parameters opx-chassis-beacon [on | off] on Enable the beacon LED. off Disable the beacon LED. Default None Example $ opx-chassis-beacon on opx-config-switch Sets and gets values of different switching entities. Syntax Parameters opx-config-switch [set | show] set Reconfigure MAC age-timer and set switch values.
opx-ethtool Display statistics and media information from a Linux interface which maps to a physical port. The output is a subset of the show-stats output for the same physical port interface.
base-pas/media/rx-power-measurement-type = 0 base-pas/media/wavelength = 0 base-pas/media/cc_base = 54 base-pas/media/temp-low-alarm-threshold = base-pas/media/tx-power-low-warning-threshold = base-pas/media/insertion-timestamp = 0 base-pas/media/current-voltage = base-pas/media/bias-high-alarm-threshold = base-pas/media/high-power-mode = 1 base-pas/media/br-nominal = 0 base-pas/media/options = 0 base-pas/media/rx-power-high-warning-threshold = base-pas/media/date-code = 3131303632322000 base-pas/media/pres
opx_logging_cli Enables logging which is maintained in the var/log/syslog file. You must restart the module after changing logging levels. Syntax opx_logging_cli [show-id | show all module-id {log-level value} | enable | disable] Parameters show-id Display module IDs and current logging levels. show Display current logging status for all or specific module IDs and logging levels. enable Enable logging status for all or specific module IDs and logging levels.
Default None Example $ opx-show-env Node Vendor name: Service tag: PPID: Platform name: Product name: Hardware version: Number of MAC addresses: Base MAC address: Operating status: Power supplies Slot 1 Present: Vendor name: Service tag: PPID: Platform name: Product name: Hardware version: Operating status: Input: Fan airflow: Slot 2 Present: Vendor name: Service tag: PPID: Platform name: Product name: Hardware version: Operating status: Input: Fan airflow: Fan trays Slot 1 Present: Vendor name: Service
Fan 1, PSU slot 1 Operating status: Up Speed (RPM): 6720 Speed (%): 37 Fan 1, Fan tray slot 1 Operating status: Up Speed (RPM): 6916 Speed (%): 38 Fan 2, Fan tray slot 1 Operating status: Up Speed (RPM): 6803 Speed (%): 37 Fan 1, Fan tray slot 2 Operating status: Up Speed (RPM): 7188 Speed (%): 39 Fan 2, Fan tray slot 2 Operating status: Up Speed (RPM): 7175 Speed (%): 39 Fan 1, Fan tray slot 3 Operating status: Up Speed (RPM): 7201 Speed (%): 40 Fan 2, Fan tray slot 3 Operating status: Up Speed (RPM): 6698
opx-show-stats Displays a dump of port and VLAN statistics.
if/interfaces-state/interface/statistics/in-unicast-pkts = 17 if/interfaces-state/interface/statistics/out-multicast-pkts = 14 dell-if/if/interfaces-state/interface/statistics/ether-multicast-pkts = 28 dell-if/if/interfaces-state/interface/statistics/ether-broadcast-pkts = 1 dell-if/if/interfaces-state/interface/statistics/ether-out-pkts-65-to-127octets = 20 if/interfaces-state/interface/statistics/in-multicast-pkts = 14 dell-if/if/interfaces-state/interface/statistics/ether-in-pkts-512-to-1023octets = 1 de
... 32 Not Present opx-show-version Displays OpenSwitch OPX software version information. Syntax opx-show-version Parameters None Default None Example $ opx-show-version OS_NAME="OPX" OS_VERSION="2.1.0" PLATFORM="S6000-ON" ARCHITECTURE="x86_64" INTERNAL_BUILD_ID="OpenSwitch Blue Print 1.0.0" BUILD_VERSION="2.1.
level_name • ALL • STP • LAG • ROUTER_INTERFACE • NEXT_HOP • SCHEDULER SAI logging level: • debug • info • notice • warning • critical • error Default None Example $ opx-switch-log set wred debug 28 Linux management
4 Support resources The Dell Networking Support site provides a range of documents and tools to assist you with effectively using Dell Networking devices. Through the support site you can obtain technical information regarding Dell Networking products, access software upgrades and patches, download available management software, and manage your open cases. The Dell Networking support site provides integrated, secure access to these services. To access the Dell Networking Support site, go to www.dell.