cisco — Restrictions for Guest Shell

Guest Shell Guestshell is a virtualized Linux-based environment, designed to run custom Linux applications, including Python for automated control and management of Cisco devices. It also includes the automated provisioning (Day zero) of systems. This container shell provides a secure environment, decoupled from the host device, in which users can install scripts or software packages and run them. This module describes Guest Shell and how to enable it.

Restrictions for Guest Shell, on page 1 Information About the Guest Shell, on page 2 How to Enable the Guest Shell, on page 12 Configuration Examples for the Guest Shell, on page 21 Additional References for Guest Shell, on page 27 Feature Information for Guest Shell, on page 27 Restrictions for Guest Shell • NETCONF sessions cannot be established on the standby Route Processor (RP). • Python scripts fail when running commands like the show tech-support wireless command, when the scale is set to 2000Aps, and clients are set to 10000. The output of commands like show tech-support wireless is huge and can cause memory exhaustion inside the Guest Shell.

When using commands with huge output, redirect the output to a file. The IOS CLI can write the output to a file in the /bootflash/guest-share directory, and it can be accessed from the Guest Shell. • Cisco Catalyst 9200CX Series Switches do not support the Management interface, AppGigabitEthernet interface, or VirtualPortGroup interface. Applications or scripts running in the Guest Shell will not be able to communicate with the external network. • In Cisco IOS XE 17.16.1 and later releases, Catalyst 9200CX Series Switches will use VirtualPortGroup interface with Network Address Translation (NAT) to communicate with the external network.

This communication is only supported for day zero ZTP running in Guest Shell. • When you run a Python script inside Guest Shell, background services are unable to access the dohost command. As a workaround, run the Python script without the sudo command, or use sudo with the -E option. Guest Shell 1