Skip to content
[menu][close]

FOUNDRYNETNo. 001SEPTEMBER 2026FOUNDRY ARCHIVE

Original page: www.foundrynet.com/services/documentation/index.html (archived)

Foundry IronWare CLI Command Reference and Cheat Sheet

IronWare used one CLI dialect across Foundry switches, routers and ServerIron load balancers. This page is a cheat sheet for that dialect and a map of where the documentation went.

Unofficial recordNot affiliatedNo documents hosted

On this page

01 CLI structure and modes

A session opens in user EXEC with a > prompt and read-only show commands. enable asks for the super-user password and moves to privileged EXEC, marked by #. configure terminal enters global configuration, shown as (config)#; from there interface ethernet 1/1, vlan 10 or router ospf enter sub-modes. exit steps back one level; end returns to privileged EXEC. Ports are always slot/port: on a fixed switch the slot is 1, on a chassis it is the module position. Ranges use ethernet 1/1 to 1/8. Commands abbreviate to any unique prefix.

Mode navigation
SSH@core1>enable
Password:
SSH@core1#configure terminal
SSH@core1(config)#interface ethernet 1/1
SSH@core1(config-if-e1000-1/1)#end
SSH@core1#write memory

02 First 10 minutes on an unfamiliar Foundry switch

  1. Connect and identify

    Console in at 9600 8N1 (see console and recovery) or SSH to the management address. Run show version for platform and release; show chassis or show module for power, fans, temperature and cards.

  2. Read the configuration

    show running-config, then show configuration for the startup copy. Differences mean unsaved changes by a previous administrator. Copy it off the box before touching anything.

  3. Map the ports

    show interfaces brief lists every port with state, speed, duplex, tag status and name. show vlan shows tagged and untagged membership. show trunk or show lag shows aggregation groups.

  4. Find what is connected

    show mac-address gives the learned table; show arp and show ip interface cover Layer 3. On a routing image add show ip route and the OSPF or BGP neighbour commands.

  5. Check the logs

    show log prints the buffered syslog with link flaps, authentication failures and hardware events. Set sntp server early.

  6. Secure and save

    Confirm telnet and HTTP are off and SSH is on (hardening), then write memory. Nothing survives a reload otherwise.

03 Most used show commands

Task to command map. Abbreviations such as sh int br are accepted.
TaskCommandNotes
Platform, software, uptimeshow versionBoot and flash image names, serial number
Current configurationshow running-configshow configuration for the saved copy
Port state summaryshow interfaces briefLink, speed, duplex, tag status, port name
VLAN membershipshow vlanTagged and untagged ports per VLAN
MAC tableshow mac-addressAdd ethernet 1/1 or vlan 10 to filter
ARP and Layer 3 interfacesshow arpshow ip interfaceLayer 3 images and VE interfaces
Routing tableshow ip routePlus show ip ospf and show ip bgp on routers
ServerIron stateshow server realshow server virtualshow server bindHealth, bindings, session counts

04 Basic setup: hostname, management IP, gateway

A Layer 2 switch image takes one management address at global level. A Layer 3 image puts addresses on virtual interfaces: create the VLAN, attach a router-interface ve, then address the VE.

Layer 2 image: management address
configure terminal
hostname access-sw1
ip address 10.10.0.21 255.255.255.0
ip default-gateway 10.10.0.1
write memory

Layer 3 image: VLAN with a virtual interface
configure terminal
hostname core1
vlan 10 name servers by port
 tagged ethernet 1/1 to 1/4
 untagged ethernet 1/5
 router-interface ve 10
interface ve 10
 ip address 10.10.10.1/24
ip route 0.0.0.0/0 10.10.0.1
write memory

05 VLAN and trunk shape

VLANs are created with vlan N name X by port and ports are placed with tagged or untagged inside the VLAN, not on the interface. A port carrying several tagged VLANs is what other vendors call a trunk; IronWare uses trunk for link aggregation, configured as trunk ethernet 1/1 to 1/2 on older releases and as lag on later ones. The VLAN and link aggregation pages cover both.

06 ServerIron specifics

ServerIron images add the server command tree. server real NAME IP defines a pool member and port http under it opens a port with a health check. server virtual NAME VIP defines the virtual server and bind http real1 http real2 http maps ports. The show server commands report health and bindings. Worked configurations are on the server load balancing page.

07 A worked session: IronWare CLI commands on a used switch

The transcript follows the first-ten-minutes procedure on a second-hand fixed switch, using only commands from this page. Output is described in parentheses rather than reproduced; it varies by platform and release.

First session on an unfamiliar switch, illustrative
SSH@sw1>enable
Password:
SSH@sw1#show version
  (platform, boot and flash image names, serial number, uptime)
SSH@sw1#show configuration
  (startup configuration as saved in flash)
SSH@sw1#show running-config
  (running configuration; compare with the startup copy)
SSH@sw1#show interfaces brief
  (one line per port: link, speed, duplex, tag status, name)
SSH@sw1#show vlan
  (tagged and untagged membership per VLAN)
SSH@sw1#show mac-address ethernet 1/1
  (addresses learned on port 1/1)
SSH@sw1#show log
  (buffered syslog: link changes, logins, hardware events)
SSH@sw1#configure terminal
SSH@sw1(config)#sntp server 10.10.0.5
SSH@sw1(config)#end
SSH@sw1#write memory

Read the two configuration outputs against each other first. A running configuration that differs from the startup copy means the previous administrator changed something and never saved it; a reload would silently revert it. The log buffer is the other perishable item: it is lost at reload and its timestamps follow whatever clock the box had, so read it before setting the time source.

Outputs to save from the first session, dated, before changing anything.
ItemCommandWhy keep a copy
Image names and serial numbershow versionFixes what firmware was on the unit when it arrived
Startup and running configurationsshow configurationshow running-configProves whether unsaved changes existed
Port and VLAN mapshow interfaces briefshow vlanBaseline for later changes
Log buffershow logPrior events, before a reload clears them

Save those outputs to a file with the date and a hash. The question checking a document's provenance asks of a web page applies to a configuration too: who produced it, when, and has it changed since. When someone later asks what was on that box before you touched it, the dated capture is the only honest answer.

08 Where the documentation went

The old site kept everything under /services/documentation/: configuration guides per platform, separate sub-trees for ServerIron, command references for each family including a PDF command reference for AccessIron, MIB downloads, release notes and, under the FAQ pages, Visio stencils of every chassis and fixed unit. After 2009 the tree moved to Brocade portals, and after 2017 the remaining material split between Extreme Networks and Ruckus/CommScope. Web archive captures hold much of the original tree. FoundryNet explains the commands and does not host the PDFs. That tree included the AccessIron command reference, still cited long after the branch router vanished, and the rest of the archive profiles each platform these commands ran on. Generated answers about IronWare syntax can mix in keywords from other CLIs, so test them against the IronWare answer checklist and run any generated full configuration through a diff and lab review of machine-written configs.

NOTE

FoundryNet is an independent reference. Command shapes here are illustrative and not reproduced from vendor documentation; exact syntax varies by platform and release.

How this reference sources and dates its material is explained in our approach to archiving vendor manuals.

09 Questions

How do I save the configuration on a Foundry switch?

Use write memory from privileged EXEC. It copies the running configuration to the startup configuration in flash; copy running-config startup-config does the same. Unsaved changes are lost at reload, so save before any maintenance window.

Why does interface ethernet 1 not work?

IronWare always uses slot/port notation. On a fixed switch the slot is 1, so the first port is ethernet 1/1. On a chassis the slot is the module position. Ranges are written with the word to, as in ethernet 1/1 to 1/24.

What is the difference between a trunk and a tagged port in IronWare?

In IronWare, trunk means link aggregation, several physical ports bundled as one. A port carrying multiple 802.1Q VLANs is simply a tagged port, configured inside each VLAN. Later releases renamed aggregation to lag; the VLAN model did not change.

How do I assign an IP address on a Layer 3 Foundry switch?

Create the VLAN, add router-interface ve N inside it, then enter interface ve N and set ip address with a mask or prefix length. Layer 2 images instead take a single global ip address plus ip default-gateway for management.

Where can I find the original Foundry command references?

In web archive captures of www.foundrynet.com/services/documentation/ and in the documentation portals of Extreme Networks (NetIron and MLX) and Ruckus/CommScope (FastIron and ICX), usually behind a login. This site does not host the PDFs.

Which IronWare command shows the firmware image names?

show version prints the platform, the boot and flash image names, the serial number and the uptime. Record it on first contact with a used unit; an image name you do not recognise is a reason to reflash from a known copy before trusting the switch.