Cisco IOS XE Terminal Pagination: Capture Complete Console Transcripts

← Back to Blog

Short answer

For an authorized IOS or IOS XE CLI collection, use terminal length 0 in the current EXEC session to remove page pauses. Prepare logging before requesting a long output, inspect the terminal settings, and restore the recorded values afterward. A missing pager is only one requirement: the transcript also needs the command, complete output, and final prompt.

Scope: a session setting, not a line configuration change

This procedure covers IOS and IOS XE terminal sessions that expose the commands below. For a Catalyst 9300 on IOS XE 17.x, record the exact build and check command help before collection. A bootloader prompt, ASA CLI, and an NX-OS terminal have their own command behavior; identify the operating environment first.

Run the collection with the site's approved account. Do not enter configuration mode to change console or VTY line settings merely to make one capture easier. The EXEC terminal commands adjust the current session; they do not require a startup-config save.

A fresh SSH login or an automation tool may negotiate or initialize terminal settings again. Treat each connection as a new collection context rather than assuming a previous tab's settings still apply.

Record the starting state

Start private session logging, then collect the device identity and terminal display settings:

show version
show terminal

Write down the reported length and width. Associate the transcript with the correct device, software build, access path, and collection time. Store the original privately; version output and configuration captures can contain identifiers that should not appear in a public handoff.

Inspect the command help in EXEC mode:

terminal length ?
terminal width ?

If either command is unavailable or denied, stop and resolve the actual CLI or authorization context. Do not convert a read-only collection task into an improvised privilege or line-configuration change.

Remove the pager and check the result

For the session being recorded:

terminal length 0
show terminal

Confirm that the reported length changed before starting the long command. If your collector also requires the IOS XE zero-width setting, apply it only after checking support:

terminal width 0
show terminal

Zero width is used in automated IOS XE session preparation, but it does not make every device's command output a universal machine-readable format. Tables, indentation, escape sequences, and terminal-client wrapping still need inspection.

Collect one approved command at a time. A basic private baseline might include:

show clock
show running-config

Wait for the final prompt before sending the next line. Set a sensible collector timeout and preserve timeout or parser errors. Do not flood a slow serial link with a large pasted command bundle just because page pauses are disabled.

Verification note: prove completeness, not just absence of More

Accept the capture when the command is visible, its expected sections are present, and the final prompt is recorded. Check long lines in the saved file, not only in the terminal window.

EvidenceAcceptance criterion
Terminal stateLength change confirmed in the same session
Command boundaryCommand and final prompt both present
Saved outputExpected sections and long lines readable
Collection errorsNo unresolved timeout or truncated result

If the transcript stops halfway through output, investigate the logger, connection, storage limit, and collector timeout. Increasing the timeout may help a slow capture, but it does not establish that a missing section was actually returned.

Restore and hand off

Restore the values recorded at the start. For example, only if the original display was 24 lines by 80 columns:

terminal length 24
terminal width 80
show terminal

Do not treat those example values as the site's required defaults. Recheck settings after reconnecting and document any automation that changes them on login.

Keep the transcript, terminal settings, commands collected, completeness checks, and exceptions together. CliDeck Workspace can hold that record alongside the session logging checklist. Sanitize any copy shared outside the approved team.

Who this is for

This guide is for network engineers, field technicians, remote hands, lab engineers, and system administrators who need to connect to, troubleshoot, log, or verify a serial console session on switches, routers, firewalls, appliances, servers, and other devices with console ports.

When to use this

Use this guide when:

  • You need direct console access to a switch, router, firewall, appliance, server, or lab device.
  • SSH or management-plane access is unavailable, unreliable, or not yet configured.
  • You need to troubleshoot a USB serial adapter, COM port, baud rate, or terminal session.

When not to use this

Do not use this guide when:

  • Do not use this guide as a substitute for vendor documentation, site policy, or a verified device-specific runbook when the operation is risky.
  • Do not continue if the console output suggests you are connected to the wrong device.

Quick checklist

  • Identify the device and console connector
  • Use the correct console cable or adapter
  • Find the correct serial port or COM port
  • Start with the expected baud rate and 8N1 settings
  • Press Enter to confirm the prompt
  • If output is unreadable, check baud rate and line settings
  • If the port will not open, check permissions, drivers, and whether another program is holding the port
  • Save useful session notes or logs when the work matters

Traditional cable vs CliDeck workflow

A traditional USB serial cable is still the simplest option for quick local work. CliDeck becomes useful when the console session needs browser access, notes, runbooks, sharing, logs, remote hands support, or a portable controller workflow.

Console Server Go can work like a wired USB serial adapter when connected by USB, but it also adds SSH Console on SSH-enabled firmware builds, browser Workspace, live sharing, 24h+ battery operation, OLED status, and magnetic rack mounting.

Practical runbook format

A runbook does not need to be a complex script. For many operations, it can be a plain command list with notes, expected output, stop conditions, verification steps, and rollback instructions.

What to include

  • Purpose
  • When to use it
  • When not to use it
  • Target system or device
  • Access path
  • Read-only checks
  • Change steps
  • Expected output
  • Stop conditions
  • Rollback steps
  • Verification steps
  • Handoff notes
  • Final summary format

Workflow

  • Identify the device, connector, cable, adapter, and host operating system.
  • Find the correct serial port or COM port and confirm permissions or drivers.
  • Open the session with the expected baud rate and line settings, usually 8N1 unless documented otherwise.
  • Press Enter and verify the prompt before running commands.
  • Save notes or logs when the session supports a change, recovery, handoff, or evidence workflow.

Verification checklist

  • The detected serial port or COM port matches the connected adapter.
  • Baud rate, data bits, parity, stop bits, and flow control match the device expectation.
  • The terminal shows a readable prompt after pressing Enter.
  • No other terminal application is holding the port.
  • Useful notes or logs are saved when the work matters.

Common mistakes

  • Using the wrong cable or adapter for the console connector.
  • Opening the wrong COM port or /dev/cu.* device.
  • Assuming unreadable output means hardware failure before checking baud rate and 8N1 settings.
  • Leaving another terminal application attached to the port.

CliDeck workflow fit

A traditional USB serial cable is still the simplest option for quick local work. CliDeck becomes useful when the console session needs browser access, notes, runbooks, sharing, logs, remote hands support, or a portable controller workflow.

Console Server Go can work like a wired USB serial adapter when connected by USB, but it also adds SSH Console on SSH-enabled firmware builds, browser Workspace, live sharing, 24h+ battery operation, OLED status, and magnetic rack mounting.

FAQ

Is a USB serial cable still enough?

Yes, for simple local work where one engineer is sitting next to one device. CliDeck is more useful when the console session needs sharing, runbooks, browser Workspace, remote hands support, logs, or longer operational context.

What should I check first when serial output looks like garbage?

Check the baud rate, data bits, parity, stop bits, flow control, cable type, and whether the device is actually using the expected console port.

Can CliDeck help with serial console work?

Yes. CliDeck Workspace helps organize terminal sessions, notes, runbooks, and logs. Console Server Go adds portable rack-side access, and Net Controller supports larger batch workflows.

Related guides