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.
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
Connect and identify
Console in at 9600 8N1 (see console and recovery) or SSH to the management address. Run
show versionfor platform and release;show chassisorshow modulefor power, fans, temperature and cards.Read the configuration
show running-config, thenshow configurationfor the startup copy. Differences mean unsaved changes by a previous administrator. Copy it off the box before touching anything.Map the ports
show interfaces brieflists every port with state, speed, duplex, tag status and name.show vlanshows tagged and untagged membership.show trunkorshow lagshows aggregation groups.Find what is connected
show mac-addressgives the learned table;show arpandshow ip interfacecover Layer 3. On a routing image addshow ip routeand the OSPF or BGP neighbour commands.Check the logs
show logprints the buffered syslog with link flaps, authentication failures and hardware events. Setsntp serverearly.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 | Command | Notes |
|---|---|---|
| Platform, software, uptime | show version | Boot and flash image names, serial number |
| Current configuration | show running-config | show configuration for the saved copy |
| Port state summary | show interfaces brief | Link, speed, duplex, tag status, port name |
| VLAN membership | show vlan | Tagged and untagged ports per VLAN |
| MAC table | show mac-address | Add ethernet 1/1 or vlan 10 to filter |
| ARP and Layer 3 interfaces | show arpshow ip interface | Layer 3 images and VE interfaces |
| Routing table | show ip route | Plus show ip ospf and show ip bgp on routers |
| ServerIron state | show server realshow server virtualshow server bind | Health, 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.
configure terminal hostname access-sw1 ip address 10.10.0.21 255.255.255.0 ip default-gateway 10.10.0.1 write memory
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.
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.
| Item | Command | Why keep a copy |
|---|---|---|
| Image names and serial number | show version | Fixes what firmware was on the unit when it arrived |
| Startup and running configurations | show configurationshow running-config | Proves whether unsaved changes existed |
| Port and VLAN map | show interfaces briefshow vlan | Baseline for later changes |
| Log buffer | show log | Prior 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.
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.